# Application Development Guide

# Document Roadmap

This chapter describes the audience for and the organization of this document: It includes:

- Document Scope and Audience
- Guide to This Document
- Terminology
- Related Documentation

## Document Scope and Audience

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.

## Guide to This Document

The document contains the following chapters:

Document Roadmap: This chapter

Creating Applications for Oracle Communications Services Gatekeeper: A general introduction to the concepts involved in using Oracle Communications Services Gatekeeper

Interacting with Oracle Communications Services Gatekeeper: SOAP message requirements in Oracle Communications Services Gatekeeper

Session Manager Web Service: A detailed description of the Session Manager Web Service

Extended Web Services Subscriber Profile: A detailed description of the available operations used to get subscriber profile data

Extended Web Services Binary SMS: A detailed description of the available operations used to send SMSes with binary content

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

Access Web Service (deprecated): A description of the Access Web Service

## Terminology

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-facing interface—The Application Services Provider facing interface
- 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:

- System Administrator’s Guide
- Integration Guidelines for Partner Relationship Management
- SDK User Guide
- Managing Accounts and SLAs
- Statement of Compliance and Protocol Mapping
- Concepts and Architectural Overview
- Communications Services Reference
- Handling Alarms
- Licensing
- Installation Guide
- Platform Development Studio - Developer’s Guide
- RESTful Application Development Guide