This event executes a job when a single record is added to a related data set with the API method ​relatedDataCreateRecord.​


WARNING!

This event cannot be used to execute (C) jobs that affect individual contacts. For this purpose, use Related Data: User-Specific Record Added (C)

Hint:

In Mapp Engage, the designation ​(S)​ means system-related. Generally, you only combine ​system (S) events​ with ​system (S) jobs​. For more information, see ​Contact (C) vs. System (S) Automations​

General

​Name​

Defines the name of the automation. The name is used to identify the automation in the system. The maximum length is 100 characters.

​Description​

Provides information about the automation. The description makes it easier to identify the automation in the system.

​Event​

Selects the type of event that, when combined with a job, forms the automation. Every time this event occurs, the system executes the dependent job. The job is defined in the ​Edit Event-based Jobwindow.

Define Event​

This area defines the specific parameters of the event.

  • Related Data Set: This drop-down field defines the related data set to which the record is added.

  • Related Data Key: These fields limit the event to records added to a specific related data key. When blank, the event includes all records added with any key.

    • Equals: The related data key exactly matches the value in the input field.

    • Does Not Equal: The related data key does not match the value in the input field.

    • Starts with: The related data key starts with the value in the input field.

    • Ends with: The related data key ends with the value in the input field.

    • Matches [Regex]: The related data key matches the regular expression in the input field.

  • Case Insensitive: This checkbox ignores differences in uppercase and lowercase.

  • Success: This drop-down field limits the event to a successful or unsuccessful addition. When blank, both successful and unsuccessful attempts to add a related data record initiate the job.

    • Yes: The job is only initiated if the related data record was successfully addded.

    • No: The job is only initiated if the related data record was not successfully addded.

  • Parameters: These fields are not appropriate for this event.

Actions

The following actions are available: