Adding Mappings to a Messaging Relationship

You can add a custom mapping that contains a unique target field and condition, or for child relationship mappings, a unique target field, condition, and target child type. If a managed mapping exists with the same information, the custom mapping overrides it.

Note:

We recommend that you do not create mappings for fields that are specified as an identifier reference on the target:

  • To view the identifier reference on a declarative relationship, click Manage Relationship.
  • To view the identifier reference on a custom child relationship mapping, click next to the relevant relationship mapping and click Edit.

To add mappings to a relationship:

  1. On the Message Types tab, click the name of the message type that contains the relationship you want to customize. The message type is displayed.
  2. In the Relationship & Mapping Details section, click Manage Relationship and select the publication and subscription that make up the relationship.
  3. Complete one of the following steps:
    • Add a top-level mapping, click Add Mapping.
    • Add a mapping to an existing child relationship, click in the child relationship row and click Add Child Mapping.
  4. Specify the key that identifies the data you want to send. Keys are unique within their section of the mapping hierarchy. If a key already exists with the same name, a number is appended to the new key when you save, for example, (1).
  5. Select a source type to define the type of data being published and complete the relevant steps.
  6. [Optional and Not Available for Child Relationship Target Types] Specify a condition field to apply a mapping to the target in specific circumstances. If specified, the message value for the condition field must evaluate to true for the mapping to be applied to the target.
    You can select any checkbox or formula field of type checkbox that exists on the source object.
    Leave this field blank to always apply the mapping to the target.
  7. Select an appropriate target type based on the source type you selected.
    Note:

    You can only select targets that you have permission to edit.

  8. [For Child Mappings Only] Select a target child type or enter the name of a new target child type. If blank, the mapping is assigned the Default target child type.
    For more information about target child types, see Splitting Source Data into Multiple Target Records.
  9. Click Save to save the mapping or Save & New to save the mapping and create a new mapping.
Tip:

If fields or objects with duplicate labels exist, API names are also displayed for clarity.

Additional Actions

You can now decide whether you want to enable return data for the messaging relationship to send confirmation data back to the source record. For more information, see Return Data Overview.

You can also add filters to your subscriptions so that they only receive information when specific criteria is met. For more information, see Adding Filters to Subscriptions.

Next Steps

When you have completed the optional steps above, you must specify when to send messages for the relationship. For more information, see Activating a Messaging Relationship.