Configuring Service Action Responses

You create data structures in OSM to contain the response information returned from ASAP or IP Service Activator. For each event and exception returned by the activation system, you select which parameter values to retain, then identify the data structure to which these parameters are added. When the activation system returns an event or exception, OSM updates the order data with the selected response parameter values.

To configure service action responses:

  1. In the Activation Task editor Response Data tab, select an event or exception from the Event/Exception area.

    All of the data an event or exception returns appears in the Activation Response area.

  2. Add an OSM data structure from the order template or from a data dictionary to contain the information returned by the service action response:

    1. Right-click in the Response Data Location area or the OSM Data Binding area and select Select from Order Template or Select from Data Dictionary.

      If you select a structure from a data dictionary, Design Studio automatically adds that structure to the order template.

    2. Select a structure from the dialog box and click OK.

      The structure is displayed in the Response Data Location and OSM Data Binding area.

      Note:

      Do not add a data structure that uses a distributed order template. Attempting to map a response value to a data element in a distributed order template will cause an error. For more information about distributed order templates, see OSM Concepts.

  3. Do at least one of the following:

    • Map fixed activation response structures to task data structures:

      1. Click the Set Data Location subtab.

      2. In the Activation Response area, check the activation response elements or structures that you want to map to task data structures.

      3. In the Response Data Location area, right-click a task data structure and select Set as Data Location.

        Design Studio adds the data you selected for the event or exception in the Activation Response area to the structure in the Response Data Location area. When the event or exception is returned from the activation system, OSM adds the data values to the OSM structure.

    • Bind activation response elements to arbitrary task data elements:

      1. Click the Response Data Mapping subtab.

      2. In the Activation Response area, drag an activation response data element onto a task data element in the OSM Data Binding area.

        The task data element is checked.

    If you select no data in the Activation Response area for an event or exception, OSM ignores that event or exception when it is returned by the activation system.

  4. (Optional; ASAP only) Define conditional mappings for service action response parameters. See "Filtering ASAP Response Data."

    This step enables you to reduce the response data returned to OSM.

    Note:

    The information returned by IP Service Activator infoparms is structured to enable a detailed mapping of return data back to OSM order data. Therefore, there is no need to filter the amount of response data.

    The ASAP Infoparm is less structured.

  5. Right-click the OSM structure and select Open Properties View.

    The Properties view for the task data node is displayed.

  6. Click the Identification tab.

    See "Task Data Node Properties View Identification Tab" for more information.

  7. Select Override Data Dictionary Minimum/Maximum.

  8. In the Maximum field, select Unbounded.

  9. Click Save.