This feature converts USSD text to/from encoded forms
Feature cheat sheet
Feature Name | Network Operator Data | Used in PlanId(s) | Stateful or Stateless | POJO Feature or SBB Feature |
---|---|---|---|---|
ConvertUssiText |
No |
USSI |
Stateless |
POJO |
Feature parameters
The Convert USSI Text feature supports the following parameters that may be passed in a feature execution script run statement:
Name | Allowed Values | Description |
---|---|---|
mode |
|
This is used to determine what action the feature should take when run. |
Session Input variables
The feature reads the following fields in Session State
Session State variable name | Variable type | Comments |
---|---|---|
UssdTextAsText |
String |
USSD text to be encoded into a byte array |
UssdTextAsBytes |
byte[] |
Byte array to be decoded to USSD text |
Session Output variables
The feature sets the following fields in Session State
Session State variable name | Variable type | Comments |
---|---|---|
UssdTextAsText |
String |
USSD text that has been decoded from a byte array |
UssdTextAsBytes |
byte[] |
Byte array that has been encoded from USSD text |
Statistics
ConvertUssiText statistics are tracked by the sentinel.ipsmgw SBB
and can be found under the following parameter set in REM:
SLEE-Usage → sentinel.ipsmgw service → sentinel.ipsmgw SBB → feature → ConvertUssiText
or with rhino-stats:
"SLEE-Usage.Services.ServiceID[name=sentinel.ipsmgw,vendor=OpenCloud,version=4.1].SbbID[name=sentinel.ipsmgw,vendor=OpenCloud,version=4.1].feature.ConvertUssiText"
Name | Description |
---|---|
Started |
Incremented when the feature is started. |
FailedToStart |
Incremented when Sentinel encounters an error while attempting to start the feature. |
IssuedWarning |
Incremented when a non-fatal problem is encountered and the feature and issues a warning. |
FailedDuringExecution |
Incremented when a fatal problem is encountered and the feature cannot execute correctly. |
TimedOut |
Incremented when the feature takes too long to complete and Sentinel aborts execution. |
StartedXmlToEncoded |
Incremented when the feature is started in the XmlToEncoded mode |
StartedEncodedToXml |
Incremented when the feature is started in the EncodedToXml mode |
RejectWithDefaultMessage |
Incremented when the feature is started in the XmlToEncode mode and the configuration states that the feature should reject with a default message |
Behaviour
This feature reads one of the two session state fields and encodes or decodes it into the other session state field. The encoding is done as GSM 7-bit.
The feature will encode or decode based on the feature parameter passed to it from the feature script.
-
When started with
xmlToEncoded
the feature reads fromUssdTextAsText
and encodes it intoUssdTextAsBytes
ifRejectAllUssiWithDefaultErrorMessage
is not set. In the event thatRejectAllUssiWithDefaultErrorMessage
is set the feature will instead stop Ussi conversation and a static message will be generated by another feature downstream. Also the features for ussi will not contact the HLR. -
When started with
encodedToXml
the feature reads fromUssdTextAsBytes
and decodes it intoUssdTextAsText
.