Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

Show Page Sections

About Definition Initiators

Definition initiators allow you to take process execution to the next level. When setting up an initiator, you tell Conga Orchestrate which object (an account, contact, or event) and which operations (insert and/or update) to monitor on that object. Additionally, you provide rules (criteria) about when the initiator should run based on the definition you select. Finally, you provide the information (assignment, due date, custom and standard field settings) for the initiated process. Conga Orchestrate waits and initiates your process when all definition initiator criteria are met.

When the Definition Initiator criteria are met, Orchestrate automatically creates a new record. This record is created based on the object selected under Object Display Name in the Capture Process Information section. The values configured in this section are automatically populated on the newly created record.

For example, you can initiate a client onboarding process when an account’s Type field changes from prospect to client, or you can create a definition initiator that starts an Address Change process when the address is updated on the Contact or account.

Definition Initiators perform in a specific manner:

  • If your initiator is monitoring updates (i.e. account updates), Conga Orchestrate only initiates a process the first time the fields specified in your criteria are modified and match the initiator. Subsequent updates to the record that match the initiator do not run additional processes unless the fields are modified again.
  • Definition initiators have an operator in the criteria called “Is Changed”. If you select this operator for your criteria item, Conga Orchestrate verifies if the field value changes and evaluates the criteria to see if they are true. This enables you to initiate a process if a field, or series of fields, changes regardless of what they were changed.
  • If you are creating a definition initiator to monitor the Contact object, you can create criteria that evaluate fields from the Contact and Account objects. This allows you to be very specific when initiating processes from contact record changes by joining information from its related account. To gain maximum visibility within Salesforce, relate all processes to an account or contact.
  • If you are creating a definition initiator to monitor the events, create the events using a contact specified in the event's Name field. This ensures that the initiated process is associated with the correct contact and account.
  • Definition initiators automatically select an associated contact record when initiating a process. To do so, Conga Orchestrate initially looks for the following (in this order):
    1. A specified Contact Lookup field on the monitored account. Create a custom Contact Lookup field on the account object, edit the Conga Orchestrate Setup setting labeled "Initiator Custom Object - Contact Field" and "Initiator Custom Objects" as shown in the screenshot, and populate the new Contact Lookup field on all account records.
    2. Contact roles related to the monitored account. If a contact is specified in a contact role and is set as primary, it is used first.
    3. If neither a specific contact lookup nor contact roles have been configured on the monitored account, Conga Orchestrate queries all related contacts alphabetically, based on the full name, and selects the first one returned.
    4. If there are no contacts related to the monitored account, the Contact field on the initiated process is left blank.
    5. If using a custom object as the monitored object on the initiator, create a custom Contact Lookup field on the custom object, edit the Conga Orchestrate Setup labeled "Initiator Custom Object - Contact Field" and "Initiator Custom Objects", and populate the new Contact Lookup field on all records.

Creating a Definition Initiator

Orchestrate uses the information captured in this section to create a new record automatically when the Definition Initiator criteria are met. The record is created for the object selected under Object Display Name, and the configured values are populated on the record at runtime.

  1. Go to the Definition Initiators tab.
  2. Click New.
  3. Enter the definition initiator name.
  4. Select the Active checkbox to make this initiator active.
  5. Click Search to chose the type of definition to initiate.
  6. Select the object to monitor from the Monitored Object list.
The Definition Initiator is created and associated with the selected object. Orchestrate monitors the specified object records and starts the process automatically when the Definition Initiator criteria are met.
Configure a trigger to add object records to the monitored list so Orchestrate can evaluate the Definition Initiator criteria.

Configuring a Trigger for Adding Objects to the Monitored List

This task is part of creating a Definition Initiator. Use this configuration to define how Orchestrate adds object records to the monitored list so it can evaluate Definition Initiator criteria and start the process when the criteria are met.
  1. Select the monitored operation(s) that triggers the definition. Hold the Ctrl key to select multiple monitored operations, if applicable.
    • Update: When the monitored object's record is updated to meet the criteria, the process starts.
    • Insert: When the monitored object's record is created and meets criteria, the process starts.
    • Record Matches Criteria - Button Click: After you have configured and saved the definition initiator with a monitored operation of Record Matches Criteria - Button Click, a button labeled "Initiate Process on Matching Records" appears. Clicking it starts a process for each record that matches criteria based on the parameters and fields defined in the definition initiator. See Record Match Initiators - Button Click to see it in action.
    • Record Matches Criteria - Daily Check: After you have configured and saved the definition initiator with a monitored operation of Record Matches Criteria - Daily Check, a batch job checks daily to find records that match the criteria defined in the definition initiator. See Record Match Initiators - Daily Check to see it in action. Go to Conga Orchestrate's Setup tab to auto-schedule the batch job.
  2. Select + Add Criteria to link to provided rules about when the initiator should run.
    • The object name defaults to the monitored object.
    • Select the field name to qualify. This field changes depending on the chosen object name.
    • Select the type of operator to compare the value to.
    • Select the field value to compare the value to.
    • Data Type automatically displays the chosen field name's data type.
    • Select a joining operator. This is only applicable when there are multiple criteria for the definition.
      Note: The Joining Operator field indicates how this value is combined with the other values. Conga Orchestrate combines OR operators first, then AND operators for a final AND operation. If there are six criteria wih Criteria 1 through 3 joined by an AND operator and Criteria 4 through 6 joined with an OR operator, it looks like: Criterion 1 AND Criterion 2 AND Criterion 3 AND (Criterion 4 OR Criterion 5 OR Criterion 6) .
  3. Click + Add Row to include additional criteria.
  4. Select an assignee type from the Assign Process Object By drop-down.
  5. Select the process object owner based on your selection in the Assign Process Object By field.
  6. Enter a positive number in the Due Date Adjustment field to add a number of days to the date the process initiates. This calculates the date on which the process is due.
  7. Enter a description detailing what this definition initiator does.
  8. Select this definition initiator's owner.
  9. Populate any necessary information in the Capture Process Information section.
  10. Click Save.
See this video for more in-depth information on creating definition initiators.