Upgrading to SAAPI Version 6.0

This topic outlines the changes to SAAPI in version 6.0 that will or could affect existing SAAPI 5.0 clients.

General

In 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

  • Custom Command

  • Custom Viewer

  • Database Manager

  • Mail Message

  • Realtime Manager

  • Recycle Bin

  • ServerDiagnostics

  • Synchronous Event Handler

  • Synchronous Event Manager

  • Task

  • Timezone Manager

  • XMLQueryProcessor

Obsolete Interfaces

  • IERURepositoryManager

  • IERURepositoryConnection

  • IERURepositoryConnector

  • IERURepositorySendContext

Obsolete Properties and Methods

This section lists the properties and methods have been removed from SAAPI for release 6.0.

The following property was removed from the IERUDirectoryGroup interface:

  • Count

The following property was removed from the IERUDiscussionPage interface:

  • ShowDescription

The following property was removed from the IERUFolderPage interface:

  • ShowDescription

The following properties and methods were removed from the IERUFacility interface:

  • DirectoryName (replaced by IERUMemberManager::DirectoryName)

  • DirectoryType (replaced by IERUMemberManager::DirectoryType)

  • EmailAddress (replaced by InboxAddress)

  • RepositoryManager

  • Synchronize

  • SynchronizeDirectory (replaced by IERUMemberManager::SynchronizeDirectory)

  • ValidatePassword (replaced by IERUMemberManager::ValidatePassword)

The following property was removed from the IERUGroup interface:

  • DirectoryMemberUniqueID

The following property was removed from the IERUItem interface:

  • SendToRepository

The following properties were removed from the IERUMemberManager interface:

  • DirectoryGroups

  • DirectoryName

  • DirectoryType

The following properties were removed from the IERUPoll interface:

  • AllowMultipleVotes

  • AllowWriteIn

  • Ballots

  • Choices

  • ShowVotes

  • Question

The following property was removed from the IERUSvrManager interface:

  • FacilityNames (replaced by FacilityNames2)

The following property was removed from the IERUTopic interface:

  • Items (replaced by TopicItems)

The following property was removed from the IERUTopicPage interface:

  • ShowDescription

The following property was removed from the IERUUser interface:

  • DirectoryMemberUniqueID

Other Changes to Properties and Methods

IERUUser::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.