This chapter explains how to use the Oracle Communications Services Gatekeeper subscriber profile extended web service interface to add subscriber profile information applications.
The Subscriber Profile Extended Web Service interface allows an application to get subscriber-specific data from data sources within the network operator's domain.
Examples of data sources are subscriber databases containing information about terminal types in use, preferred language, and currency types. This information can be used by applications in order to control rendering options for rich media, charging information, and the language to be used in voice and text interaction with the end-user.
The interface is built around a model where the data can be retrieved in two different ways:
Individual attributes, identified using a path.
A collection of attributes.
The attributes are keyed on a subscriber ID that uniquely identifies the subscriber for whom the attributes are valid or by an address that uniquely identifies the terminal for which the attributes are valid. An attribute is identified by a path name, which corresponds to a specific property. The following is an example of a path name:
serviceName/accessControlId/accessControlId
The syntax for the path is similar to relative file system paths in UNIX.
A collection of attributes is specified in a subscriber profile filter for the application or the service provider. Only allowed attributes, as specified in the filter, are returned.
The returned attributes are returned in the form of name-value pairs, or property tuples, where the name is expressed as a path name with a associated property value.
The interface is based on a proposal for a Parlay X Subscriber Profile Web service interface.
The SubscriberProfile interface and service use these namespaces:
http://www.bea.com/wlcp/wlng/wsdl/ews/subscriber_profile/interface
http://www.bea.com/wlcp/wlng/wsdl/ews/subscriber_profile/service
The data types are defined in the namespace:
http://www.bea.com/wlcp/wlng/schema/ews/subscriber_profile
In addition, the Subscriber Profile Extended Web Service interface uses definitions common for all Extended Web Services interfaces:
The datatypes are defined in the namespace:
http://www.bea.com/wlcp/wlng/schema/ews/common
The faults are defined in the namespace:
http://www.bea.com/wlcp/wlng/wsdl/ews/common/faults
The endpoint for the PushMessage interface is: http://
host:
port/ews/subscriber_profile/SubscriberProfile
Where host and port are the host name and port of the system on which Services Gatekeeper is installed.
Table 34-1 Supported Address Schemes
Address scheme | Valid for Communication service |
---|---|
tel |
Subscriber Profile Extended Web Service profile for LDAPv3 |
id |
Subscriber Profile Extended Web Service profile for LDAPv3 |
imsi |
Subscriber Profile Extended Web Service profile for LDAPv3 |
ipv4 |
Subscriber Profile Extended Web Service profile for LDAPv3 |
The following data structures are used in the Subscriber Profile Extended Web Service.
Defines the response that Services Gatekeeper returns from "Operation: get" and "Operation: getProfile".
The following describes the interfaces and operations that are available in the Subscriber Profile Extended Web Service.
Operations to obtain specific subscriber profile attributes and operations to obtain a set of profile properties grouped together in a profile.
Gets specific subscriber profile attributes. The requested attributes are identified by the pathNames parameter, and the possible values are restricted by the configured capabilities of the underlying data source. The allowed path name values are also restricted individually per service provider and application in the SLA.
Input message: get
Part name | Part type | Optional | Description |
---|---|---|---|
address |
xsd:anyURI |
N |
Identity to get profile attributes for. |
pathNames |
xsd:string [1..unbounded] |
N |
Requested subscriber properties. Expressed as a relative UNIX path. Example: serviceName/accessControlId/accessControlId |
Output message: getResponse
Table 34-4 Output Message: getResponse
Part name | Part type | Optional | Description |
---|---|---|---|
properties |
PropertyTuple [1..unbounded] |
N |
All retrieved subscription property name and value pairs which are requested by application and allowed by the usage policies as specified in a filter. |
Referenced faults
Table 34-5 Exceptions and Error Codes
Exception | Error code | Reason/Action |
---|---|---|
ESVC0001 |
WNG000002 |
Internal problem in Services Gatekeeper. Contact your Services Gatekeeper administrator. |
ESVC0001 |
SP000001 |
Internal problem in Services Gatekeeper. The LDAP connection is not working. There might be a configuration error for with the underlying LDAP server or a network error. Contact your Services Gatekeeper administrator. |
ESVC0001 |
SP000002 |
Internal problem in Services Gatekeeper. LDAP operation failed. Contact your Services Gatekeeper administrator. |
ESVC0001 |
SP000003 |
Internal problem in Services Gatekeeper. Contact your Services Gatekeeper administrator. |
ESVC0001 |
SP000004 |
Internal problem in Services Gatekeeper. Contact your Services Gatekeeper administrator. |
Gets a set of profile properties grouped together in a profile identified by a certain profile ID.
Input message: getProfile
Table 34-6 Input Message: getProfile
Part name | Part type | Optional | Description |
---|---|---|---|
subscriberID |
xsd:string |
N |
Identity to get profile attributes for. |
profileID |
xsd:string |
N |
Identity of the profile to get. |
Profile ID is ignored when connecting the to the network using the LDAPv3 network protocol plug-in. The collection of attributes that identifies the profile are provisioned as filters.
Output message: getProfileResponse
Table 34-7 Output Message: getProfileResponse
Part name | Part type | Optional | Description |
---|---|---|---|
properties |
PropertyTuple [1..unbounded] |
N |
All retrieved subscription property name and value pairs which are requested by application and allowed by the usage policies as specified in a filter. |
Referenced faults
Table 34-8 Exceptions and Error Codes
Exception | Error code | Reason/Action |
---|---|---|
SVC0001 |
WNG-000002 |
Internal problem in Services Gatekeeper. Contact your Services Gatekeeper administrator. |
SVC0001 |
SP-000001 |
Internal problem in Services Gatekeeper. The LDAP connection is not working. There might be a configuration error for with the underlying LDAP server or a network error. Contact your Services Gatekeeper administrator. |
SVC0001 |
SP-000002 |
Internal problem in Services Gatekeeper. LDAP operation failed. Contact your Services Gatekeeper administrator. |
SVC0001 |
SP-000003 |
Internal problem in Services Gatekeeper. Contact your Services Gatekeeper administrator. |
SVC0001 |
SP-000004 |
Internal problem in Services Gatekeeper. Contact your Services Gatekeeper administrator. |
SVC0001 |
PLG-000004 |
General plug-in routing error |
The document/literal WSDL representation of the SubscriberProfile interface can be retrieved from the Web services endpoint, see "Endpoint", or:
http://host:port/ews/subscriber_profile/SubscriberProfile?WSDL
http://host:port/ews/subscriber_profile/SubscriberProfile?WSDL/ews_subscriber_profile_interface.wsdl
http://host:port/ews/subscriber_profile/SubscriberProfile?WSDL/ews_common_types.xsd
Where host and port are the host name and port of the system on which Services Gatekeeper is installed.