Creating New Mappings in a Mapping Rule

You create new mappings in a mapping rule to define the correct transformed order items and their data elements. There are two methods of creating new mappings. You can define a new mapping between any two parameters manually. In addition, if the names of the source and target data elements are the same, you can create new mappings by inference.

Note:

If you update an order either to add a parameter (which includes providing a value to a parameter that did not previously have one) or to delete a parameter (which includes setting the value of a parameter to null), the OSM order transformation manager will not propagate the change in either the forward or reverse direction. To avoid the need to add or delete values, you can set values (such as NOT_SET) as defaults on the conceptual model entity or in the order item parameter binding and ensure that a parameter always has a value.

To create a new mapping manually:

  1. Open a mapping rule and click the Mapping tab.

  2. In the Named Relationships area, click Add.

    The Create Named Relationships Element dialog box is displayed.

  3. Select the relationship you would like to use and click OK.

    The list of relationships displayed is determined by the provider function and domain that you selected in the Properties tab when creating the mapping rule.

  4. In the Named Relationships area, select a relationship.

    After you have selected a relationship, in the Named Relationships area, in the Mapping subtab, the source entity of the relationship and its data elements are displayed on the left. The target entity and its data elements are displayed on the right.

  5. Do any of the following:

    • To map an entity to an entity, drag the entity on the left to the entity on the right.

    • To map an entity to a data element, expand the data element tree for the target entity and drag the source entity to the appropriate data element on the target entity.

    • To map a data element to another data element, expand the data element trees for both the source and target entities and drag the source data element to the target data element.

To create a single new mapping by inference:

  1. Open a mapping rule and click the Mapping tab.

  2. Right-click the target of the desired mapping and select Infer Mapping for Selection.

    If a data element with the same name (case-sensitive) exists on the source entity, a mapping is created between the two data elements and a dialog box, indicating that a mapping was created, is displayed. The type of mapping created depends on the data types of the source and target data elements. See "Configuring a Data-Element-to-Data-Element Mapping" for information about the default types of mappings between data elements.

    If no appropriate data element on the source element is found, a dialog box, indicating that no mapping was created, is displayed.

  3. Click OK in the dialog box.

To create multiple new mappings by inference:

  1. Open a mapping rule and click the Mapping tab.

  2. Right-click any element of the target entity and select Infer All Mappings.

    If any data elements with the same name (case-sensitive) exist on both the source and target entities, mappings are created between the data elements, and a dialog box, indicating how many mappings were created, is displayed. The type of mappings created depends on the data types of the source and target data elements. See "Configuring a Data-Element-to-Data-Element Mapping" for information about the default types of mappings between data elements.

    If no appropriate data elements were found, a dialog box is displayed indicating that no mapping was created.

  3. Click OK in the dialog box.

Related Topics

Mapping Rule Editor