Customize an Existing Mapping

This example shows you how to add a new attribute to the integration, including the TQL query, and Push Adapter Mapping. It enables the integration to push the attribute to Service Anywhere.

After completing the following steps, you may run the job with the customized mapping:

  1. Add the new attribute to an existing Service Anywhere TQL query layout.

    In this step you add the attribute of a specific CI to the integration TQL query, so that you can use the attribute and value in the mapping.

    1. Go to Modeling > Modeling Studio >Resources and select the Queries Resource Type.

    2. Go to Queries > Root > Integration > Service Anywhere Push.

    3. Select the TQL query containing the CI to which you want to add a new attribute, and double-click. The query is displayed in the main pane.

      For example, if you are adding a new attribute bt_example to the Business Transaction CI, double-click the SAW_BusinessElement query.

    4. Select the specific CI for which you want to add an attribute, right-click and select Query Node Properties. The Query Node Properties dialog box is displayed.

    5. Go to the Element Layout tab.

    6. Move the new attribute to the Specific Attributes box.

    7. Click OK.

    8. Save the query.

  2. Add the new attribute to the corresponding push adapter mapping.

    In this step, you take the value from the TQL result, and remodel it to the Service Anywhere data model.

    1. Go to Data Flow Management > Adapter Management > Packages > SAWPushAdapter > Configuration Files, and select the XML file corresponding to the CI to which you have added a new attribute.

      For example, if you are adding a new attribute bt_example to the Business Transaction CI, select the businessElementCisMappings.xml file.

    2. Go to the source_ci_type XML tag for the element that matches the name of the element in the TQL you edited.

      Continuing the previous example, you go to:

       <source_ci_type query-element-name="BusinessTransaction*" 
        extends="AbstractBusinessNode">
    3. Add the target mapping to hold the value of the new attribute.

      Continuing the previous example:

      <target_mapping name="bt_example" datatype="STRING" 
       value ="BusinessTransaction.attributeExists('bt_example') ? BusinessTransaction['bt_example']: 'MISSING'"/>
    4. Click OK.