This documentation is archived and is not being maintained.

Work with Enhanced Presence Using Unified Communications Managed API version 1.0

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

In Unified Communications Manage API (UCMA) version 1.0, to publish enhanced presence, the application makes a SERVICE request. The SERVICE request is exposed by the SipServiceRequest class of the API. Making such a request amounts to sending a message of the Service type with the message body containing the data. For Office Communicator to receive and parse the data published by the UCMA version 1.0 application, the data must conform to the Unified Communications Enhanced Presence Schemas. Generating the data from the Enhanced Presence Schemas (XSD) files ensures conformance. For more information about generating the presence data from the XSD files, see Work with Enhanced Presence Schema Files.

To subscribe to a specified presence data by a given publisher, the application implements the ISipSubscriptionProcessor interface, instantiates the SipSubscription class exposed by the API, and then calls the synchronous Subscribe or asynchronous BeginSubscribe method on the SipSubscription class. The procedure amounts to sending a SUBSCRIBE message to Office Communications Server. The ISipSubscriptionProcessor interface defines a callback function and an event handler. The application implements the interface members to get notified of any presence publication or updates and to receive the presence data, and then parses them following the specifications given in the XSD files and Unified Communications Enhanced Presence Schema Reference.