4 Generic and Call User Interaction and Administration SCF

29.198-053GPPOpen Service Access (OSA) Application Programming Interface (API)Part 5: User interaction Service Capability Feature (SCF)Release 9TS

4.1 Generic and Call User Interaction SCF

The Generic User Interaction service capability feature is used by applications to interact with end users. It consists of three interfaces:

1) User Interaction Manager, containing management functions for User Interaction related issues.

2) Generic User Interaction, containing methods to interact with an end-user.

3) Call User Interaction, containing methods to interact with an end-user engaged in a call.

The Generic User Interaction service capability feature is described in terms of the methods in the Generic User Interaction interfaces.

The following table gives an overview of the Generic User Interaction methods and to which interfaces these methods belong.

Table 1: Overview of Generic User Interaction interfaces and their methods

User Interaction Manager

Generic User Interaction

createUI

sendInfoReq

createUICall

sendInfoRes

createNotification

sendInfoErr

destroyUINotification

sendInfoAndCollectReq

reportEventNotification

sendInfoAndCollectRes

userInteractionAborted

sendInfoAndCollectErr

userInteractionNotificationInterrupted

release

userInteractionNotificationContinued

userInteractionFaultDetected

changeNotification

reportEventRes

getNotification

reportEventErr

enableNotifications

disableNotifications

abortMultipleUserInteractions

reportEventReq

The following table gives an overview of the Call User Interaction methods and to which interfaces these methods belong.

Table 2: Overview of Call User Interaction interfaces and their methods

User Interaction Manager

Call User Interaction

As defined for the Generic User Interaction SCF

Inherits from Generic User Interaction and adds:

recordMessageReq

recordMessageRes

recordMessageErr

deleteMessageReq

deleteMessageRes

deleteMessageErr

abortActionReq

abortActionRes

abortActionErr

getMessageReq

getMessageRes

getMessageErr

The IpUI Interface provides functions to send information to, or gather information from the user, i.e. this interface allows applications to send SMS and USSD messages. An application can use this interface independently of other SCFs. The IpUICall Interface provides functions to send information to, or gather information from the user (or call party) attached to a call.

4.2 Generic User Interaction Administration SCF

The Generic User Interaction Administration service capability feature is used by application to interact with the service to manage the user announcement and recorded messages. It consists of one interface:

1) User Interaction Administration Manager, containing message management functions for User Interaction.

Table 3: Overview of Generic User Interaction Administration interfaces and their methods

User Interaction Administration Manager

getMessageReq

putMessageReq

deleteMessageReq

getMessageListReq

4.3 Generic User Interaction SCF Design Aspects

The following clauses describe each aspect of the Generic User Interaction and Generic User Interaction Administration Service Capability Features (SCF).

The order is as follows:

  • The Sequence diagrams give the reader a practical idea of how each of the SCFs is implemented.
  • The Class relationships clause shows how each of the interfaces applicable to the SCF, relate to one another
  • The Interface specification clause describes in detail each of the interfaces shown within the Class diagram part. This clause also includes Call User interaction.
  • The State Transition Diagrams (STD) show the transition between states in the SCF. The states and transitions are well-defined; either methods specified in the Interface specification or events occurring in the underlying networks cause state transitions.
  • The Data Definitions clause shows a detailed expansion of each of the data types associated with the methods within the classes. Note that some data types are used in other methods and classes and are therefore defined within the Common Data types part of this specification.

4.4 General requirements on support of methods

An implementation of this API which supports or implements a method described in the present document, shall support or implement the functionality described for that method, for at least one valid set of values for the parameters of that method.

Where a method is not supported by an implementation of a Service interface, the exception P_METHOD_NOT_SUPPORTED shall be returned to any call of that method.

Where a method is not supported by an implementation of an Application interface, a call to that method shall be possible, and no exception shall be returned.