Configuring Multi-Instance Structure Key Mapping

Multi-instance data mapping is available when the target of a data-element-to-data-element mapping is a multi-instance structure. The key uniquely identifies a specific instance of the structure. Key values must be unique in an order item.

To configure the key for a multi-instance structure:

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

  2. In the Entries table, select the mapping you would like to configure.

  3. In the Mapping subtab, select a mapping target that is part of a multi-instance structure.

    The Multi-Instance and Multi-Instance Expression subtabs are displayed in the Mapping Rule Item area.

  4. Do one of the following:

    • To use an order item property as the key, in the Multi-Instance subtab, in the Source Property Key field, select an order item property to use as the key element.

    • To use the element defined as the structure key in the data schema, in the Multi-Instance subtab, select the Use Default Key option.

    • Do select the key using an XQuery expression, in the Multi-Instance Expression subtab, provide XQuery information to determine the key. See "About Creating XQuery Expressions with Design Studio" for more information about entering information into XQuery controls. See "About Multi-Instance XQuery Expressions" for more information about this XQuery field.