Use the Service Bundle editor to associate service actions with the service bundle and associate upstream parameters with service actions.
You can create the Service Bundle editor using the Service Bundle Wizard. In the Studio Projects view, double-click a service bundle entity to open the editor.
When working with the Service Bundle editor, see the following topics:
Use the Editor tab to not only associate service action entities to the service bundle, but also to add additional service action and upstream parameters for the service bundle.
| Field | Use |
|---|---|
| Description | Specify a description for the Service Bundle editor. |
| Product Label and Product Value | Select a product label and specify a corresponding product value. These values map the upstream order (that contains the label and value) to this service bundle. During run time, the mapping enables SRT to determine the service bundle to execute based on the incoming XML document. |
| Include order data in response | Select to pass a more comprehensive response back upstream (beyond just the simple success or failure response) for this service bundle. |
When working with the Editor tab, see the following topics:
Use the Service Actions tab to associate service action entities with the service bundle and define conditions to spawn the service actions.
| Field | Use |
|---|---|
| Remove | Click to remove a service action from this tab. |
| Add | Click to add a service action to this tab. |
| Field | Use |
|---|---|
| Always | Select for ASAP to always spawn this service action for this service bundle. Always is selected by default when you add a service action to the Service Bundle editor. |
| Equals | Select for ASAP to spawn this service action only if the specified service action parameter, in the Parameter Label field, is defined on the service action and has a parameter value as defined in the Parameter Value field. |
| Defined | Select for ASAP to spawn this service action only if the service action parameter specified in the Parameter Label field is defined on the service action. |
| Not Defined | Select for ASAP to spawn this service action only if the service action parameter specified in the Parameter Label field is not defined on the service action. |
| Parameter Label | Select a label name from the list. |
| Parameter Value | Specify a value in the field. This field is available when you select the Equals button. |
| Include Expression | Define a logical expression using a number of criteria. The range of options available allows a service action to be executed if the service action parameter value is within a set range of values, or if the service action parameter is greater than, less than, or equal to, a specified value. You can combine multiple expressions using an AND or OR operator. See "Understanding Service Action Spawning Conditions" for more information. |
Service Bundle Editor Upstream Interface Tab
Service Bundle Editor SA Parameter Map Tab
Use the Upstream Interface tab to modify the upstream parameter values. Apart from the upstream parameters added automatically, you can further add upstream parameters manually on this tab.
| Field | Use |
|---|---|
| Add | Click to manually add upstream interface parameters. |
| Remove | Click to remove upstream interface parameters. |
| Import | Click to import the upstream parameters from a sample upstream service request (in XML format). |
| Export Schema | Click to export the service bundle interface to an .xsd file and save it to your machine. |
When working with the Upstream Interface tab, see the following topics:
Service Bundle Editor Service Actions Tab
Service Bundle Editor SA Parameter Map Tab
Understanding Upstream Interface Parameters
Use the Details tab to view and edit the parameters.
| Field | Use |
|---|---|
| Name | Modify the name (label) of a parameter to match a parameter that will come from upstream. |
| Default | Specify an optional default value for an upstream parameter. If the upstream parameter does not have a value, the default is supplied to ASAP. |
| Description | Modify or provide a description for a parameter. |
| Data Type | Select to modify the data type for a parameter. Valid types include integer, string, boolean, and so on. |
| Required | Select if this upstream parameter is required. |
| Multi Instance | Select if the specified label is the stem of a series of parameters. This allows for a dynamic number of instances and possible use with ASAP's indexing capability for spawning multiple atomic actions. |
Understanding Upstream Interface Parameters
Use the Upstream Parameter Map tab to display the mapping between the selected upstream interface parameter and service action label (service action parameters) associated with the service bundle.
Use the Lookup Map tab to display how the selected upstream interface parameter is used in different lookups for further data processing. For example in a mobile scenario, for a given MSISDN value, the SRT may need to perform a database lookup to determine which HLR to send the work order to or possibly split the MSISDN into country code, operator code, and the number parameters for use with a particular service action. See "Configuring Lookups" for information on creating lookups.
Use the Advanced tab to specify complex data types for the selected upstream interface parameter that are different than those available in the Details tab.
In the XML Schema field, enter the complex data type for the selected upstream interface parameter.
Use the SA Parameter Map tab to associate upstream parameters with service action parameters. This association enables SRT to map the incoming data from the translated order to the selected service action to run for the service bundle.
| Field | Use |
|---|---|
| Source Type | Select a parameter in the Name grid and modify the value to any one of the following:
|
| Name | Specify a name for an upstream parameter and click Add. |
| Mapping Type | Select any one of the following:
|
| Add | Click to add a service action parameter to this tab. |
| Remove | Click to remove a user defined parameter from the service action parameter list. |
| Remove Invalid | Click to remove any unnecessary invalid parameter (a red circle with an X appears next to an invalid parameter) for the service bundle. |
| Clear | Click to clear the editable contents of the service action parameter such as Mapping Type, Source and Default. |
Service Bundle Editor Service Actions Tab
Service Bundle Editor Upstream Interface Tab
Mapping Upstream Interface Parameters to Service Action Parameters
Use the Blueprint tab to view the generated documentation for the service bundle entity. This tab is read only.