Action Processor Editor Request Tab
Use the Request tab in the Action Processor editor to define the parameters for a CLI command request messages. In the Command Definition Area area, you can define:
-
Separators: In this area, you can specify command parameter separators that override the CLI command structure you defined in the Action Project editor Command Structure tab.
-
Command: In this area, you can parse sample CLI commands and generate CLI code for the action processor.
-
Parameters: In this area, the elements are either automatically generated from the sample CLI command you parsed in the Commands area or you can manually add elements.
Field | Use |
---|---|
Overwrite |
Select to override the default command structure defined in the Activation Project editor Command Structure tab. You must select this check box to make the separator fields editable. For more information about the fields in the Separators area, see the field definitions in "Activation Project Editor Cartridge Layout Tab". |
Command Auto-Parse Override |
Select if you want to automatically parse sample CLI input commands. This enables the Parse Input Command button. |
Input Command |
Enter a sample CLI command that represents the CLI command elements you want to use in the action processor. |
Command Parameter |
Click to designate the CLI parameter you entered in Input Command as a command parameter. If you designate a parameter as a Command Parameter, then you must choose the following: After you make your selection, the highlighted parameter appears in the Element Name list. When you select one of the auto-generated parameters from the Element Name list, the associated atomic action parameters appear in the Maps To field (except for StaticString parameters). |
Command Header |
Specifies the command header. You can:
|
Parse Input Command |
Click to automatically Parse Input Command button after you have entered a sample CLI command that you want to tokenize. |
Element Name |
Lists the parameters that you want to use in the action processor. You can automatically generate these parameters by parsing a sample command or manually add them. |
Type |
When you select an parameter from the Element Name list, you can apply one of the following parameter types from the Type list.
|
Maps To |
When you designate a parameters from the Element Name list as Name Value Pairs or ValueOnly, you must map the parameter to an atomic action parameter in the Maps To field. The action processor includes the value of the atomic action parameter in the request message. |
Parameter Logic |
In the Parameter Logic field, you can add one line logic for Name Value Pairs and ValueOnly parameters that further specifies how a atomic action parameter maps to a parameter in the Element Name list. This field calls the methods defined in the Utils.java file that Design Studio generates when you add a sample command to the Input Command field. All methods defined in Utils.java throw exceptions defined in the ProvCartridgeException.java file, which is auto-generated when you add a sample command. For more information about the methods contained in the Utils.java file, see ASAP Cartridge Development Guide. You can also nest two or more command together in the Parameter Logic field. For example the following uses the encloseWith method within the concat method: concat("*",encloseWith(MCLI,"#","#"),MY_TEST) Design Studio also generates the ReusableMethods.java file where you can define your own one line utility methods that you can use in the Parameter Logic field. The methods you define in this Java file should throw exceptions defined in the ProvCartridgeException.java file. |
Edit Parameter Logic |
Click to modify or add logic for a particular parameter. For example, if you have a parameter that maps to more one compound parameter, you must enter additional logic. Clicking this button generates additional Java files where you can make these modifications. For more information about the files generated when you click the Edit Parameter Logic button, see ASAP Cartridge Development Guide. |
Preview |
Displays a preview of the structure of the CLI command as you map CLI command elements to atomic action parameters. For example, the following command shows a header named HSDPA, a value-only parameter, two value-pair parameters, two static parameters, and ends with the COMMIT control character: HSDPA:<mcliVal>,LCC_CODE=<user_routingVal>,LINE=<lineVal>,static, program,;COMMIT |