This document provides information for those developers who wish to integrate functionality provided by telecom networks into their programs by using the SOAP-based Web Services offered by Oracle Communications Services Gatekeeper. It includes a high-level overview of the process, including the login and security procedures, and a description of the interfaces and operations that are available for use.
Note:
This document covers the SOAP-based interface and the native interface for Oracle Communications Services Gatekeeper. A separate document in this set, RESTful Application Development Guide, describes how to use the RESTful interface.
Extended Web Services Common: A detailed description of the datatypes shared among the Extended Web Services interfaces
Parlay X 2.1 Interfaces: A description of the Parlay X 2.1 interfaces available with details on how they are implemented in Oracle Communications Services Gatekeeper.
Parlay X 3.0 Interfaces: A description of the Parlay X 3.0 interfaces available with details on how they are implemented in Oracle Communications Services Gatekeeper.
Native Interfaces.: A description of the MM7 and SMPP interfaces available with details on how they are implemented in Oracle Communications Services Gatekeeper
The following terms and acronyms are used in this document:
Account—A registered application or service provider. An account belongs to an account group, which is tied to a common SLA
Account group—Multiple registered service providers or services which share a common SLA
Administrative User—Someone who has privileges on the Oracle Communications Services Gatekeeper management tool. This person has an administrative user name and password
Alarm—The result of an unexpected event in the system, often requiring corrective action
API—Application Programming Interface
Application—A TCP/IP based, telecom-enabled program accessed from either a telephony terminal or a computer
Application Service Provider—An organization offering application services to end users through a telephony network
AS—Application Server
Application Instance—An Application Service Provider from the perspective of internal Oracle Communications Services Gatekeeper administration. An Application Instance has a user name and password or certificate
CBC—Content Based Charging
End User—The ultimate consumer of the services that an application provides. An end user can be the same as the network subscriber, as in the case of a prepaid service or they can be a non-subscriber, as in the case of an automated mail-ordering application where the subscriber is the mail-order company and the end user is a customer to this company
Enterprise Operator —See Service Provider
Event—A trackable, expected occurrence in the system, of interest to the operator
HA —High Availability
HTML—Hypertext Markup Language
IP—Internet Protocol
JDBC—Java Database Connectivity, the Java API for database access
Location Uncertainty Shape—A geometric shape surrounding a base point specified in terms of latitude and longitude. It is used in terminal location
MAP—Mobile Application Part
Mated Pair—Two physically distributed installations of Oracle Communications Services Gatekeeper nodes sharing a subset of data allowing for high availability between the nodes
MM7—A multimedia messaging protocol specified by 3GPP
MPP—Mobile Positioning Protocol
Network Plug-in—The Oracle Communications Services Gatekeeper module that implements the interface to a network node or OSA/Parlay SCS through a specific protocol
NS—Network Simulator
OAM —Operation, Administration, and Maintenance
Operator—The party that manages the Oracle Communications Services Gatekeeper. Usually the network operator
OSA—Open Service Access
PAP—Push Access Protocol
Plug-in—See Network Plug-in
Plug-in Manager—The Oracle Communications Services Gatekeeper module charged with routing an application-initiated request to the appropriate network plug-in
Quotas—Access rule based on an aggregated number of invocations. See also Rates
Rates—Access rule based on allowable invocations per time period. See also Quotas
Rules—An optional set of customizable criteria in addition to those located in SLAs according to which requests are evaluated
SCF—Service Capability Function or Service Control Function, in the OSA/Parlay sense.
SCS—Service Capability Server, in the OSA/Parlay sense. Oracle Communications Services Gatekeeper can interact with these on its network-facing interface
Service Capability—Support for a specific kind of traffic within Oracle Communications Services Gatekeeper. Defined in terms of communication service
Service Provider—See Application Service Provider
SIP—Session Initiation Protocol
SLA—Service Level Agreement
SMPP—Short Message Peer-to-Peer Protocol
SMS—Short Message Service
SMSC—Short Message Service Centre
SNMP—Simple Network Management Protocol
SOAP—Simple Object Access Protocol
SPA—Service Provider APIs
SS7—Signalling System 7
Subscriber—A person or organization that signs up for access to an application. The subscriber is charged for the application service usage. See End User
SQL—Structured Query Language
TCP—Transmission Control Protocol
Communication Services—The data flow of a particular request through Oracle Communications Services Gatekeeper. Different Service Capabilities use different communication services
USSD—Unstructured Supplementary Service Data
VAS—Value Added Service
VLAN—Virtual Local Area Network
VPN—Virtual Private Network
Oracle Communications Services Gatekeeper Core—The container that holds the Core Utilities
Oracle Communications Services Gatekeeper Core Utilities—A set of shared utilities
WSDL —Web Services Definition Language
XML—Extended Markup Language
Related Documentation
This application development guide is a part of the Oracle Communications Services Gatekeeper documentation set. The other documents include: