| |
Upgrading to SAAPI Version 6.0This topic outlines the changes to SAAPI in version 6.0 that will or could affect existing SAAPI 5.0 clients. GeneralIn 6.0 we have improved the SAAPI Toolkit so that it can be used from scripting languages other than VBScript, most especially JavaScript. There are two consequences to this change. The first is that the following properties are no longer default properties on their respective interfaces: IERUContainer::Items IERUComment::Body IERUVersion::VersionName IERULink::TargetURL If you have any existing code that took advantage of these properties as default properties, then you will have to modify the code so that it calls these properties explicitly. The second effect is that there is a new property on the IERUTopic interface called TopicItems. This property should be used for enumerating the comments in a topic. If you call the Items property off of a Topic object inside of VBScript or JavaScript code, then you will be returned the collection of items in the Container, not the collection of Comments in the Topic. The same holds true for enumerating Comments from a Comments column in a database. Make sure to call TopicItems in order to get the collection of Comments. For example, Set topic = dbCell.Content Set comments = topic.TopicItems If in VisualBasic code you call the Items property off an interface that is defined as IERUTopic, then it will return a collection of Comments in the Topic. You can take advantage of this fact in order to update as little existing code as possible. However, for future development, it is simplest to remember to always use TopicItems in order to enumerate Comments in a Topic. There have also been changes to enforce that room participants and observers only see users that are members of the same eRooms. Facility-level and server-level directory APIs now restrict access to member queries and member lookups at the facility- and SML-levels. A new MemberManager property has been added to the IERURoom interface to allow room coordinators to access facility members lists and to allow participants and observers to look up anyone within the same room context. For example, methods such as IERUMemberManager::GetMember() will block non-administrators if the interface was obtained from IERUFacility::MemberManager. For users that are not administrators use the interface returned from IERURoom::MemberManager. New Objects
Obsolete Interfaces
Obsolete Properties and MethodsThis section lists the properties and methods have been removed from SAAPI for release 6.0. The following property was removed from the IERUDirectoryGroup interface:
The following property was removed from the IERUDiscussionPage interface:
The following property was removed from the IERUFolderPage interface:
The following properties and methods were removed from the IERUFacility interface:
The following property was removed from the IERUGroup interface:
The following property was removed from the IERUItem interface:
The following properties were removed from the IERUMemberManager interface:
The following properties were removed from the IERUPoll interface:
The following property was removed from the IERUSvrManager interface:
The following property was removed from the IERUTopic interface:
The following property was removed from the IERUTopicPage interface:
The following property was removed from the IERUUser interface:
Other Changes to Properties and MethodsIERUUser::FirstName, MiddleName, and LastName are now read/write properties instead of read-only. IERUUser::SetName can still be used to set all three of these properties at once. |
|