Adding BOD mappings to entity types

  1. On the dashboard, click Entity Types.
  2. If multiple accounting entities are available in PIM, ensure that you have selected the accounting entity that you want to use.
  3. In the records pane, click the entity type that you are editing.
  4. Click the Edit button.
  5. In the Map Key Identifier field, specify the xpath that contains the unique key identifier for the entities that are created when the ItemMaster BOD is processed. For example, specify /ItemMasterHeader/ItemID/ID.
    Note: The xpath that you specify depends upon the ERP that you use and the structure of the ItemMaster BOD.
  6. In the Map Entity Type Selection fields, specify the conditions that an ItemMaster BOD must meet for the item in the BOD to be classified as the current entity type. Use these guidelines:
    • Use the AND operator to require more than one condition be met.
    • Use the OR operator if one condition in a list of conditions must be met.
    • Use the AND and OR operator multiple times to create groups of conditions.
    • Use text()= to indicate that an xpath must contain a certain value for the condition to be met. For example, you can specify /ItemMasterHeader/Classification/Codes/Code and text()="Clothes" if the xpath must contain the value Clothes to meet the condition. Values are not case sensitive.
    • Use text()!= to indicate than an xpath must not contain a certain value for the condition to be met.
  7. Optionally, map attributes to BOD xpaths.
    1. In the Defined attributes section, click Edit to edit an existing attribute or click Add Attribute to add a new attribute. Use the AND and OR operator multiple times to create groups of conditions. For example, you can specify that a BOD must contain xpath 1 AND xpath 2 OR xpath 3 AND xpath 4. A BOD would meet the criteria if it contained both xpath 1 and xpath 2, or if it contained both xpath 3 and xpath 4.
    2. In the BOD Element Mapping field, specify the mapping to use. For example, you could link a Net Weight attribute to /ItemMasterHeader/PackagingUnit/NetWeightMeasure.
    3. Specify whether users can override the value that is replicated from the ERP.

      If an attribute can only be updated through replication of the ItemMaster BOD, slide the Read Only switch to the right. When an attribute is read-only, users cannot manually enter a value.

      If users can manually specify values for this attribute, slide the Read Only switch to the left. Users can overwrite the value that is replicated from the ERP. If a user manually enters a value, then that value is retained even if an ItemMaster BOD is sent from the ERP to PIM.

    4. Click Apply.
  8. Click Update. If you specified a mapping in the Map Key Identifier field, then a fallback entity type is created in the hierarchy.