class MtasGenSscCmd

ManagedElement
+-MtasFunction
+-MtasServices
+-MtasMmt
+-MtasSsc
+-MtasGenSsc
+-MtasGenSscGroup
+-MtasGenSscCmd

The MtasGenSscCmd MO represents a Generic SSC command that can be configured by the Operator and can be invoked by the Subscriber by using Supplementary Service Codes (SSC).

Attributes
MtasString1to064DT
key
mandatory
noNotification
restricted
mtasGenSscCmd
This attribute is the primary key of MtasGenSscCmd.
MtasString1to16384DT
mandatory
mtasGenSscCmdAnnouncements
This attribute defines the announcements to be played to the user and the conditions when a given announcement shall be played in the form of an <announcements> XML document. Detailed description of the <announcements> XML document can be found in the MTAS Generic Supplementary Service Codes Management Guide.

Takes effect: New session
MtasGenSscCmdContentTypeDT
mtasGenSscCmdContentType = EMPTY
This attribute indicates the Content-Type of the XCAP request. It must match the type of the object referred to by the UtPath.

Takes effect: New session
MtasGenSscCmdHeaderDT
mandatory
mtasGenSscCmdHeader
This attribute includes the leading digits of the input command string. It contains a combination of numeric digits '0'-'9', the asterix '*' and the hashmark '#' symbols. Multiple header values can be merged with the vertical bar '|' symbol.

Takes effect: New session
MtasString0to32768DT
mandatory
mtasGenSscCmdLayout = ""
This attribute defines the "layout" of the modified items within the simservs.xml document in the form of a <layout> XML document. It describes how the simservs.xml shall be updated with the user defined and preconfigured values. Detailed description of the <layout> XML document can be found in the MTAS Generic Supplementary Service Codes Management Guide.

Takes effect: New session
MtasString0to4096DT
mandatory
mtasGenSscCmdReplaces
This attribute includes mappings between symbolic and literal values. It includes one or more lists of symbol-literal pairs. The mappings are separated by semi colons ";". The mappings must be in the form of "name1: symbol1=literal1, symbol2=literal2, ..., symbolN=literalN". Each list begins with a name closed by a colon ":".

Eg.: workdays: 1=Monday, 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday.


Takes effect: New session
MtasString1to4096DT
mandatory
mtasGenSscCmdSyntax
This attribute contains the matching pattern and the syntax expression of the Generic SSC command string. They are given as a regular expression in the form of "/<pattern>/<substitution>/". The matching pattern validates the input SSC command string and captures the relevant data pieces. The syntax expression resides in the substitution part and contains the following elements:

- schema of the input command string: a name identifying the format of the input command string.

- action: a name identifying the operation to be performed on the user's service data.

- data definition: it includes the type, the name and the predefined or captured value of the atomic data pieces.

- function invocation: specifying the name and the captured or predefined parameter values.

The syntax expression has the following internal structure:

schema=<schema name>[;action=<predefined action name or captured action code>][;<type> <name>=<captured or predefined value>][;function functionName(captured or predefined parameters)]

Examples for pairs of user command string and command syntax are given below.

User input: "#78#00467891#"

Command syntax: "/^#78#([0-9]{7-10})#$/schema=simple; action=verify; digits forward-to=\1/"

The above example verifies if the entered forward-to number is equal to the stored value. The service code is "78". The forward-to number shall consist of 7-10 digits.

User input: "#81#15"

Command syntax: "/^#81#([1-9][0-9]*)#$/schema=simple; action=set; number timeout=\1/~~/^#81#$/schema=simple; action=set; number timeout=20"

The above example sets the timeout of a service. The service code is 81. If the input command string includes a timeout value then it is copied to the "timeout" data item. If the timeout is not present in the input command string then the predefined default value (20) is used in the "timeout". The two syntax expressions are separated by the "~~" delimiter string.


Takes effect: New session
MtasString0to4096DT
mandatory
mtasGenSscCmdUriInChargingMsgs
This attribute contains one or more regular expressions which define the rules how the incoming Request-URI shall be translated for charging purposes. The rules use the substitution function of the regular expressions in the format of "/<pattern>/<substitution>/". The pattern matches the Request-URI and captures the relevant data parts. The substitution expression defines the format of the URI as it shall be used in the charging messages.

Example for URI translation:

"/^#47#[0-9]{4}#(.*)/#47#0000#/"

The above example specifies the service code and the PIN and captures the remaining part of the SSC command string in the pattern part. The substitution part includes the service code, replaces the PIN with zero digits and copies the captured tail of the SSC command string.


Takes effect: New session
MtasString0to4096DT
mandatory
mtasGenSscCmdUtPath
This attribute includes the XPath pointing to the target item (XML element or attribute) within the simservs XML document. It may also include the necessary XML namespace bindings.

It's format shall conform to the XML Path Language (XPath) Version 1.0 W3C. The namespace bindings consist of a question mark '?' followed by the list of alias/namespace pairs in the format of "?xmlns(alias1=namespace1)xmlns(alias2=namespace2)...xmlns(aliasN=namespaceN)".


Takes effect: New session

  class MtasGenSscCmd