Defining nomenclature configuration

Nomenclature Configuration allows you to define the rules to be applied and the entities that need to be transformed when data is exchanged between Sterling Selling and Fulfillment Foundation and external systems or trading partners. The configuration is captured for each document exchanged.

About this task

To create a unique configuration between two systems:

Procedure

  1. Open the Applications Manager and select the application that you want.
  2. From the tree in the application rules side panel, choose Nomenclature > Nomenclature Configuration. The Nomenclature Configuration Search window displays in the work area.
  3. Choose the Create New icon. The Create Nomenclature Configuration pop-up window displays.
  4. Enter information in the applicable fields. Refer to the following table for field level descriptions.
    Table 1. Nomenclature configuration
    Property Description
    XML Name Enter a unique name for the document being exchanged between two systems or participants.
    From System Enter the system name from which document is originating.
    To System Enter the system name to which the document is delivered to
    From Organization Enter the organization from which the document is originating.
    To Organization Enter the organization to which the document is delivered to
  5. Choose the Save icon. The Configuration Details window displays.
  6. Choose the Create New icon. The Configuration Detail pop-up window displays capturing all the fields in the document that need to be transformed.
  7. Enter information in the applicable fields. Refer to the following table for field level descriptions.
    Table 2. Nomenclature configuration details
    Property Description
    XML Name The unique name by which the document exchanged is identified.
    Attribute Location Enter the full XML path of the element under which the attributes that need transformation are present.

    If this is a repeating node in the XML document, the transformation is applied to all the nodes.

    For example, if the publishShipAdvice output XML is being sent to a warehouse management system for fulfillment and the carrier code needs to be transformed, the attribute location should be entered as ShipmentAdvices/ShipmentAdvice.

    Attribute 1-4 Enter the XML attribute name(s) that need to be transformed when the document is being published.

    For example, if the publishShipAdvice output XML is being sent to a warehouse management system for fulfillment and the carrier code needs to be transformed, the attribute should be entered as Scac in the document location ShipmentAdvices > ShipmentAdvice.

    New Attribute 1-4 For each attribute being transformed, either the existing value can be replaced in the document or a new attribute can be inserted in the XML in the same level. Enter the new XML attribute name to be inserted when the transformation occurs.

    For example, the publishShipAdvice output XML is being sent to a warehouse management system for fulfillment and the carrier code needs to be transformed in the location ShipmentAdvices > ShipmentAdvice in the document for the SCAC attribute. This is specified as WhseCarrier and a new attribute is inserted in the location ShipmentAdvices > ShipmentAdvice called WhseCarrier. This XML attribute carries the new transformed value and the old attribute and value are left intact.

    Mapping Type Select Nomenclature if the values are retrieved from the mapping specified in the Nomenclature transformation Engine.

    Select Constant if the value is always transformed to a Constant value.

    Abort Processing on Error If this is selected and the Mapping Type is set to nomenclature, if mapping is not found a ‘No Default' is set and processing stops.
    Nomenclature Specifies the entity definition to use for the system participant to determine the transformed values. Select the from/to code descriptions to use.
    Use Default Values If this is selected, enter the default values to apply when mapping is not found.
    Constant 1-4 If you selected Constant, enter the constant value for XML attribute transformation.