You add upstream interface parameters to service bundles to describe the parameters that are expected from the upstream system.
See the following topics:
To define upstream interface parameters manually:
On the Service Bundle editor, click the Upstream Interface tab, and then click Add in the Service Bundle Details area.
In the Upstream Interface Details tab, enter the following information:
In the Name field, enter the name of the upstream parameter.
In the Default field, enter the default value of the upstream parameter. If the upstream parameter does not have a value, the default is supplied to ASAP.
In the Data Type field, enter the parameter's data type.
Select Multi Instance 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.
Enable Required if this upstream parameter is required.
Working with Upstream Interface Parameters
Mapping Upstream Interface Parameters to Service Action Parameters
To import upstream parameters from a sample upstream service request:
On the Service Bundle editor, click the Upstream Interface tab, and then click Import in the Service Bundle Details area.
The Import Interface Parameter Wizard appears.
In the Sample XML field, identify the XML file that represents a sample upstream service request.
In the Stylesheet field, identify the XML stylesheet (XSLT) that transforms the service request into SRT format.
Click OK.
Design Studio parses the service request and adds the upstream parameters to the Upstream Interface tab.
Working with Upstream Interface Parameters
Defining Upstream Interface Parameters Manually
Mapping Upstream Interface Parameters to Service Action Parameters
You map upstream interface parameters to service action parameters to enable the SRT to map the incoming data from the translated order to the service actions selected to run for the service bundle.
Note:
When importing an SRT cartridge, error messages may appear indicating that some service bundles are not synchronous with the service actions they reference. This can happen when some service action parameters have not been mapped in the service bundle. If this occurs, you can synchronize the parameters in the Service Bundle editor. See "Synchronizing SRT Cartridge Parameters" for more information. See "Importing Activation SRT Cartridges from SAR Files" for more information about importing an SRT cartridge.To map an upstream interface parameter to a service action parameter (method 1):
On the Service Bundle editor, click the SA Parameter Map tab, and increase the size of the Source Type field by dragging the slider to the right.
You can also double-click the tab to increase the editor area.
For each service action parameter listed in the SA Parameter Map tab, select the parameter and change the value in the Source Type field (in the Service Bundles Details area) as follows:
If the source of the service action parameter comes from an upstream system, select Interface as the source type). Select an upstream parameter and drag it to the corresponding service action parameter. The upstream parameter label appears in the Source column.
If the source of the service action parameter comes from a lookup, select Lookup as the source type. Select a lookup result and drag it to the corresponding service action parameter. The lookup output label appears in the Source column.
To map an upstream interface parameter to a service action parameter (method 2):
On the Service Bundle editor, click the SA Parameter Map tab, and select from the list a service action parameter that you want to map to an upstream parameter.
In the Parameter Map Detail area, specify one of the following values in the Mapping Type field:
Select Override to impose a specific value on the service action parameter. If you select this option, you must specify a default value in the Default field. The default value is used if the incoming parameter value is not provided.
Select Interface to map the service action parameter to an upstream parameter. If you select this option, you must specify the upstream source parameter and an optional default value. In the Source field, identify the upstream source parameter that you want to map to the service action parameter. If required, specify a default value for this parameter in the Default field. The default value is used if the incoming parameter value is not provided.
Select Lookup to map the service action parameter to a lookup. If you select this option, you must identify the lookup that is to be performed by either selecting the appropriate lookup from the Lookup list, or by clicking Open to define the lookup in the Lookup editor. See "Configuring Lookups" for instructions on defining lookups. In the Lookup Output Parameter field, select the output parameter that is provided by the lookup. If required, specify a default value for this parameter in the Default field. The default value is used if the lookup does not generate a value for this parameter.
Verify that all parameters in the service action parameters list are valid.
A parameter can become invalid if an atomic action parameter has been removed after the service bundle has referenced the service action to which the atomic action is mapped. A red circle with an X appear next to invalid parameters.
It is recommended that you investigate whether the invalid parameters were changed or removed in error. If they are unnecessary for the service bundle, select these parameters and click Remove Invalid. You can optionally add a service action parameter by clicking Add, or clear the mappings by clicking Clear.
Save your changes.
About Upstream Interface Parameters
Defining Upstream Interface Parameters Manually
When importing SRT cartridges, error messages may appear indicating that some service bundles are not synchronous with the service actions they reference. This can happen when some service action parameters have not been mapped in the service bundle. If this occurs, you can synchronize the parameters in the Service Bundle editor.
To synchronize parameters after importing an SRT cartridge:
In the Activation SRT Project editor, click the Properties tab, and then click Unsealed to unseal the SRT cartridge project.
In the Studio Projects view, right-click the Service Bundle entity icon and select Properties.
The Properties dialog box appears.
In the Properties dialog box, select the Read-write status option and click OK.
Open the Service Bundle editor.
A dialog box prompts you to synchronize the Service Bundle parameters.
Click OK.
Rebuild the project.
Mapping Upstream Interface Parameters to Service Action Parameters