Oracle Server E10293-02 Benutzerhandbuch

Using the Presence Web Services Interfaces

OCMS Parlay X Web Services  6-3

This section describes how to use each of the operations in the interfaces, and includes 
code examples.

This is the first operation the application must call before using another operation in 
this interface. It serves two purposes:

■

It allows the Web services to associate the current HTTP session with a user.

■

It provides a context for all the other operations in this interface by subscribing to 
at least one presentity (SUBSCRIBE presence event).

// Setting the attribute to activity

PresenceAttributeType pa = PresenceAttributeType.Activity;

PresenceAttributeType[] pat = new PresenceAttributeType[]{pa};

startPresenceNotification

Not supported.

endPresenceNotification

Not supported.

statusChanged

Not supported.

statusEnd

Not supported.

notifySubscription

Not supported.

subscriptionEnded

Not supported.

publish

Maps directly to a SIP PUBLISH.

getOpenSubscriptions

Called by the presentity (supplier) to check if any watcher 
wants to subscribe to its presence data. No SIP message maps 
to this method. Returns pending subscriptions currently in 
the Web services server.

updateSubscriptionAuthorizati
on

The supplier uses this method to answer any open pending 
subscriptions. An XCAP PUT message is sent to the XDMS 
server to update the presence-rule document.

getMyWatchers

Retrieves the local list of watchers from the Web services 
server.

getSubscribedAttributes

Retrieves the local list of subscribed attributes from the Web 
services server. Currently, only returns Activity.

blockSubscription

Causes the Web services server to end a watcher subscription 
by modifying the XCAP document on the XDMS server (i.e., 
putting the watcher on the block list).