> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Advanced DataFlow Triggering

export const InlineImage = ({src, alt = '', height = '1.6em'}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: 'inline',
    verticalAlign: 'start',
    height: height,
    margin: '0'
  }} />;
};

## Intro

Advanced DataFlow Triggering allows you to schedule your DataFlow to run using triggers and conditions that must be satisfied for the triggers to activate. These are highly customizable to allow you to give your end users timely access to the most recent data.

***

## Access Your DataFlow

Follow these steps to access your DataFlow and be able to make any changes described in the tasks below:

1. In the navigation header, selecting **Data**.

   The Data Center displays.
2. In the left side panel, select
   <InlineImage src="/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006use7.jpg" /> **DataFlows**.
3. Locate and open your DataFlow.

## Common Triggers

1. Navigate to your DataFlow. For assistance, see
   [Access Your DataFlow](#access_your_dataflow).

2. In the **Settings** tab of your DataFlow, locate the list of common triggers.

   <Frame>
     <img alt="common triggers.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006useW.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=38198ba8294b5b7ab22d6d97cad0f55d" style={{width: 677, height: 426}} width="2454" height="1544" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006useW.jpg" />
   </Frame>

   If you select one of these triggers to use, a configuration section displays with the predefined trigger and condition(s) that you can either keep or adjust.

   <Frame>
     <img alt="predefined fields.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usel.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=6b27ab3c7d74eb9cb2c352b43988069c" style={{width: 677, height: 578}} width="2516" height="2150" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usel.jpg" />
   </Frame>

3. (Optional) Make any adjustments to the trigger and conditions.

4. Give your trigger a title by selecting
   <InlineImage src="/images/kb/ka05w00000125lS-00N5w00000Ri7BU-0EM5w000005wtzY.jpg" /> **Edit** and entering the title you want.

   <Frame>
     <img alt="edit trigger title.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usg8.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=8b7db56d9651231fa21dd8323f5afafb" style={{width: 662, height: 137}} width="2092" height="434" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usg8.jpg" />
   </Frame>

5. Select a
   [time zone](#time_zone) for your trigger. <InlineImage src="/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utno.jpg" />

6. Select **Apply** to save your trigger.

## Create a New Trigger

If you would rather configure your new trigger from the beginning, follow the steps below.

1. Navigate to your DataFlow. For assistance, see
   [Access Your DataFlow](#access_your_dataflow).

2. In the **Settings** tab of your DataFlow, select **+ Add Trigger**.

   A configuration section displays.

3. Give your trigger a title by selecting
   <InlineImage src="/images/kb/ka05w00000125lS-00N5w00000Ri7BU-0EM5w000005wtzY.jpg" /> **Edit** and entering the title you want.

   <Frame>
     <img alt="edit trigger title.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usg8.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=8b7db56d9651231fa21dd8323f5afafb" style={{width: 662, height: 137}} width="2092" height="434" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usg8.jpg" />
   </Frame>

4. Select your trigger type from the **Trigger** list. The options are described below:
   * **When DataSets update —** This trigger activates when any of the selected DataSets (next step) update. If conditions are defined for the trigger, these conditions are assessed before initiating the DataFlow. Without any conditions, the DataFlow initiates immediately after any selected DataSet updates.

     <Frame>
       <img alt="configure trigger.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usfo.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=3fce4034201c2d019a7cbb19fd470df4" style={{width: 655, height: 541}} width="2348" height="1940" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usfo.jpg" />
     </Frame>

   * **On a schedule —** This option allows you to create a schedule for the trigger so you can initiate the DataFlow whenever it is needed. If conditions are defined for the trigger, these conditions are assessed before initiating the DataFlow. Without any conditions, the DataFlow runs on the schedule. If you choose this option, you need to select **Open Schedule Details** and configure the schedule.

     <Frame>
       <img alt="Screenshot 2023-06-01 at 9.45.03 AM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utm7.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=e896a9230a148948d82ae2eff0409bb9" style={{width: 657, height: 176}} width="2082" height="556" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utm7.jpg" />
     </Frame>

5. Select **+** **Add Condition** to configure any conditions you want satisfied before your trigger activates. You can have multiple conditions. The options for conditions are described below:
   * **DataSets have updated —** This condition lets you activate the trigger when one or multiple DataSets have updated. If you choose this option, you must also specify the secondary condition for when the selected DataSets updated. These secondary conditions are described below:
     1. **Since the last successful run —** This option activates the trigger if the DataSets you specify in the condition have updated since the last successful run.
     2. **In the last —** This option activates the trigger if the DataSets you specify in the condition have updated in the last *insert interval*. You can make the interval a number of minutes, hours, or days.
     3. **Within —** This option activates the trigger if the DataSets you specify in the condition have updated within *insert interval* of each other. You can make the interval a number of minutes, hours, or days.
   * **Current time is —** This condition lets you activate the trigger when the current time is between a start time and an end time. These times are affected by the [time zone](#time_zone) you select for your trigger.
   * **Current day is —** This condition lets you activate the trigger depending on the current day. The day is affected by the [time zone](#time_zone) you select for your trigger.

     <Frame>
       <img alt="add condition.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utr2.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=b5c6558dcb5d17e7727808a7b2ff9289" style={{width: 671.989, height: 216.996}} width="2144" height="694" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utr2.jpg" />
     </Frame>

6. If you have not already done so, select a
   [time zone](#time_zone) for your trigger.

   <Frame>
     <img alt="Screenshot 2023-06-01 at 9.54.49 AM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utno.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=efcff2f33cf32e659cf6519371a93244" style={{width: 645, height: 241}} width="3018" height="1128" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utno.jpg" />
   </Frame>

7. Select **Apply** to save your configuration.

### Delete a Trigger or Condition

To delete a trigger or condition, select the trigger action menu <InlineImage src="/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utml.jpg" /> or condition action menu <InlineImage src="/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utnA.jpg" /> and select **Delete**.

<Frame>
  <img alt="Screenshot 2023-06-01 at 9.53.06 AM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utnZ.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=5295b662c152f1b9131e9050c6c84e77" style={{width: 385, height: 128}} width="774" height="258" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utnZ.jpg" />
</Frame>

You can also duplicate a condition by selecting the condition action menu and selecting **Duplicate condition**.

<Frame>
  <img alt="Screenshot 2023-06-01 at 9.52.13 AM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utnK.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=e5f3548663339a8870ce8a582d8c3168" style={{width: 385, height: 214}} width="748" height="416" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006utnK.jpg" />
</Frame>

## Configure Multiple Triggers

Domo allows you to create up to three separate triggers (each trigger can have multiple conditions). By using multiple triggers, you can optimize your DataFlow according to varied DataSets, operational hours, or specific project requirements.

To create multiple triggers, follow the process to [create a new trigger](#create_a_new_trigger) up to three times. Each trigger is independent and uses a different set of criteria. Activating one trigger does not influence the other triggers.

## Time Zone

Be sure to specify a time zone for your trigger, as this is crucial when evaluating triggers and conditions. For example, if a trigger is set to activate on Wednesdays at 1:00 PM, the conditions for that trigger are assessed based on the selected time zone.

<Frame>
  <img alt="select a time zone.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usf5.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=5419a240d218f305fd94b9eb3fec0f8d" style={{width: 695, height: 594}} width="2582" height="2206" data-path="images/kb/ka05w00000128xX-00N5w00000Ri7BU-0EM5w000006usf5.jpg" />
</Frame>

## FAQ

<AccordionGroup>
  <Accordion title="If I use the *When DataSets update* trigger, does the trigger activate when any of the input DataSets are updated, or only when all of them have updated?">
    If you use the **When DataSets update** trigger without specifying any conditions, the DataFlow initiates immediately after any of the DataSets you select in the trigger have been updated.

    However, if you only want the DataFlow to run when all of the specified DataSets have been updated, you can use the **DataSets have updated** condition. When using this condition, the DataFlow only initiates after the trigger activates and all the DataSets you select in the condition have been updated. This condition functions similarly to an AND statement, requiring all specified DataSets to be updated before the trigger activates the DataFlow.
  </Accordion>

  <Accordion title="Video — Advanced DataFlow Triggering">
    <Frame>
      <iframe allowfullscreen="" frameborder="0" height="315" src="https://www.youtube.com/embed/cewchcI2zTs" title="YouTube video player" width="560" />
    </Frame>
  </Accordion>
</AccordionGroup>
