Skip to main content Skip to complementary content

Task chaining

Automations make it easy to use events and actions to trigger other events and actions. This is called task chaining. A task chain is a set of tasks that are executed in an automation, either in parallel or one after the other. This tutorial walks you through an end-to-end example in steps of increasing complexity that shows you how to build a task chain. The goal of this automation is to trigger app reloads for multiple apps in your tenant by chaining multiple reloads together.

Create a simple reload automation

Start by creating an automation that triggers an app reload.

  1. From the Block library on the left side of the automation canvas, select the Qlik Cloud Services connector.

  2. Drag the Do reload block onto the canvas and attach it to the start block.

    A simple reload automation

  3. In the Inputs field for the Do reload block, enter the App ID for the app you want to reload.

    Information note

    You can use the lookup function in the App ID field to find the App ID.

  4. Click Run.

  5. Verify in the block output that you see status: SUCCEEDED. This indicates that the reload was successful.

    Output of reload block showing succeeded

Reload run modes

In the steps above, you did not specify the run mode for the Do reload block. However, when creating task chains, this input is important. You have two options: Wait for reload to complete and Start reload and continue. That is, run the reloads one after the other or run them in parallel.

The default setting is Wait for reload to complete, which is a run mode where the automation waits for the current reload to return the status before proceeding to the next block.

The alternative setting is Start reload and continue, which is a run mode where the reload is triggered, a reload ID is returned, and the automation moves to the next block. If there are multiple reload blocks, they are triggered before waiting for the preceding reload to return a status.

Tip note

Use the reload ID in the block Get reload record block to get the reload status.

Create a reload task chain

Continuing with the same reload automation from above, add another reload block to create a task chain to reload two apps.

  1. Set the run mode for the Do reload block to Wait for reload to complete.

  2. Drag a second Do reload block onto the canvas and attach it to the existing Do reload block.

    Task chain with two reloads

  3. Click Run.

  4. Verify in the block output that you see status: SUCCEEDED for both reload blocks. This indicates that the reloads were successful.

Add a condition to the task chain

In the task chain above, both reloads are triggered regardless of the reload status. Add a condition to trigger the second reload only if the first reload is successful.

  1. Remove the second reload block from the automation by dragging to another place on the canvas.

    Taks chain reload block removed

  2. From the block selector pane, drag a basic condition block onto the canvas and attach it below the first reload block.

  3. In the Inputs field for the condition block, field map the status of the app reload from the Do reload block and set the condition statement to equals SUCCEEDED.

    Task chain condition settings

  4. Re-add the second reload block to the YES branch of the condition. This means that if the condition is true, the second reload block is executed.

    Tip note

    Add block comments so you can see what each block does without opening it.

    task chain with two reload blocks and condition

  5. Click Run to see the output.

Run reloads in parallel

Next, add multiple reloads to your automation. For each automation, set the run mode to Start reload and continue.

  1. Move the condition block to the side so you are left with the start block and a single Do reload block.

  2. Take the second Do reload block from inside the condition and reattach it below the first reload block.

  3. Set the run mode for each reload block to Start reload and continue.

    The automation looks like this, with both reloads running in parallel:

    Task chain with two reloads

  4. Below the second reload block, add a Wait for reloads to complete block.

  5. In the Reload IDs field, add the reload ID from the first two reload blocks, separated by a comma.

    The raw input looks like this: {$.DoReload.id},{$.DoReload2.id}.

    Tip note

    Make sure to use the reload ID and not the app ID.

  6. Add another Do reload block and configure it to reload another app.

    An automation with 3 reload blocks

Add a loop to the task chain

In this example, use a loop block to loop over all the apps in your tenant and to trigger a reload for each one.

  1. Move all of the blocks below the start block to the side.

  2. Add a List apps block to the start block. This block is a loop block.

  3. Click Test run on the block to get the IDs you need for the next block.

  4. Inside the loop, add a Do reload block.

  5. Add the app ID to the Do reload block from the List apps output.

    The raw format looks like this: {$.listApps.item.resourceAttributes.id}. The input to the reload block will loop through the app IDs in the list until it reaches the end of the list.

Information note

If you don't have reload permission for all apps on the tenant, specify a space ID to which you have reload permission in the List Apps block. Alternatively, you can set the On error field to Ignore or Warning.

Add a loop and condition to the task chain

Finally, add a condition inside the loop from the previous example.

  1. Add a basic Condition block inside the loop, above the Do reload block.

  2. Set the condition to reload apps only if the app name contains the word production.

  3. Add the Do reload block to the YES branch of the condition.

    The full automation looks like this:

    Full task chain automation with loop and condition

The final result is an automation that loops through all of the apps on your tenant, and if the app name contains the word production, the app reload is triggered. Modify this automation to build your own custom task chain.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!