WebSphere brand IBM WebSphere IP Multimedia Subsystem Connector, Version 6.2

notifyUserDataChange Web service method

This Web service method receives notifications for the following types of user profile data as an XML string representation: Repository Data, IMSUserState, S_CSCFName, and InitialFilteCriteria. To receive notification data as an XML string, you must subscribe to the notifications using the Sh subscriber profile Web service subscribeUserData method. Notifications can be received for both data modifications and deletions.

Usage

This Web service method receives notification requests from the Sh subscriber profile Web service for the following types of user profile data: Repository Data, IMSUserState, S_CSCFName, and InitialFilteCriteria. The type of data received is indicated by the dataReference value; however, it is possible to receive updates for more than one data type in the XML file. The user profile data is returned as an XML string representation that adheres to the format defined in the ShDataType.xsd schema file. Data that has been deleted from the HSS is indicated by an empty element for that user data. For example, if the filter criteria for a particular subscriber has been deleted from the HSS, the InitialFilterCriteria element in the userData XML received will be empty or null.

Example

public void notifyUserDataChange(int dataReference, 
                                     String userData,
                                     String publicIdentity)
                                     throws Exception {

         // application logic 
 }

Parameters

Parameter Name Type Description
dataReference int

Data reference values indicate the type of user data received from the HSS.

  • 0 = Repository Data
  • 11 = IMSUserState
  • 12 = S_CSCFName
  • 13 = InitialFilterCriteria
  • 17 = MSISDN
  • 18 = PSI Activation
userData String

The XML string representation of the modified or deleted user profile data received in the HSS notification request. The XML data must comply with the ShDataType.xsd schema.

publicIdentity String

This parameter is the publicIdentity associated with the updated UserData.

Specifies the public user identity or public service identity. This can be either a SIP URL or a TEL URL. Example:
  • sip:Alice.Smith@example.com:transport=tcp
  • sips:carol@ws1234.example.com
  • sip:+358-555-1234567;postd=pp22@example.com;user=phone
  • sip:alice;day=tuesday@example.com
  • tel:+919-123-4567
  • tel:+358-555-1234567;postd=pp22



Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.