Set up Partner Mappings

  • How do I set up partner mappings?
  • How do I create a partner mapping card?
  • How do I process and send messages?
  • How do I receive and process messages?
Tip

Summary: The Partner Mapping links the execution of a Mapping to a Partner. This chapter explains how to create a partner mapping card and how to process messages with the Process and Send Message and Receive and Process actions. The Process and Send Message action is equal to an Export Mapping, while the Receive and Process action is equal to an Import Mapping.

A Partner Mapping links the execution of a Mapping to a Partner. This is important for transferring the result of a Mapping to a Partner, as well as filtering records within a Mapping (for example, Record Pool Entries) to a Partner. In addition, it defines with which Mapping a received message is performed, for example, import of records.

To create a partner mapping card

  1. Choose the Lightbulb that opens the Tell Me feature icon, enter Partner Mappings - Data Integration Framework, and then choose the related link.
  2. Choose the New action.
  3. On the Partner Mapping Card page, fill in the fields as necessary. Hover over a field to read a short description.

To process messages

Two actions on the Partner Mapping Card are used to process, send, and receive messages between Partners. The steps for each action are described in the following sections.

Process and Send Message

Running this action is equal to an Export Mapping. The general steps are as follows:

  1. Create Sent Message Entry.
  2. Process Partner Mapping.
    1. Process Sent Message.
    2. Write Sent Message.
    3. Abort if any Sent Message contains an error.
    4. Delete Sent Messages with Status = Delete.
  3. Send all Sent Messages for Partner Mapping with Status = Written.

Use the Process and Send Message action to process the current certified Mapping (Mapping Code) for the Partner (Partner Code). All messages are then sent to the Partner. For each execution of a Mapping (Mapping Entries), one received message is created. Only messages created by the execution are sent to the Partner.

Existing messages, in case of a sending error, are not mailed. These messages must be handled manually on the Sent Messages page, where the messages are rewritten and sent again. For more information, see Sent Messages.

Receive and Process

Running this action is equal to an Import Mapping. The general steps are as follows:

  1. Import Files.
    1. Create Received Message Entry.
    2. Import file into Received Message Entry.
    3. (Sender and Mapping are not set yet)
  2. Read all Received Messages with Status = Imported.
  3. Abort if any Received Message for Partner Mapping contains errors (keep order).
  4. Process all Received Messages with Status = Read for Partner Mapping.

First all messages of the Partner are imported to the Received Messages table. Afterwards, all received messages are read and then – according to their Sender Code and Mapping Code – the executed Mapping is determined. Finally, all received messages with Setup Sender Code = Partner Code and Mapping Code to be performed = Mapping Code are processed in sequence and in ascending order by their serial number. For more information, see Received Messages.

Error Handling on Received Messages

By default, the error handling is set to Stop Execution on the Partner Mapping Card. When Ignore Messages is selected, the execution of the partner mapping ignores the message with the error and proceeds with the next message.

Feedback

Submit feedback for this page .