Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r100

...

In the following sections, you can review short summaries of specific features and explore more detailed information on them.

Terms

TermDescription
planA plan is a sequence of tasks that are executed
on one or more flows to
from the platform or on assets to which you have access. To orchestrate tasks, you build a plan. A plan can be scheduled for execution, triggered manually, or invoked via API.
triggerA task is executed based on a trigger. A trigger is a condition under which a task is executed. In many cases, the trigger for a task is based on the schedule for the plan.
task

A task is a unit of execution in the platform.

For example, one type of task is the execution of a flow, which executes all recipes in the flow, as well as the flow's upstream dependencies.

 

snapshot

A snapshot of the plan is captured, and the plan is executed against this snapshot. For more information on snapshots, see "Plan execution" below.

Task Types

...

The following types of tasks are available.

...


  • flow task

...

  • : An ad-hoc or scheduled execution of the transformations required to produce one or more selected outputs from a flow.

  • HTTP task

...

  • : A request submitted to a third-party server as part of a plan run.
  • Slack task

...

  • : Send a message with information about the plan run to a specified Slack channel. 
  • Delete task

...

  • : Delete files and folders from backend data storage. 

Limitations

  • You cannot specify parameter overrides to be applied to plans specifically.
    • Plans inherit parameter values from the objects referenced in the plan's tasks.
    • If overrides are applied to flow parameters inside of assets in a plan, those overrides are passed to the plan at the time of flow execution.

      TipTip: Prior to plan execution, you can specify parameter overrides at the flow level. These values are passed through to the plan for execution. For more information, see Manage Parameters Dialog for Plans

      task execution.

Basic Task

You create a plan and schedule it using the following basic task.

  1. Create the plan. A plan is the container for definition of the tasks, triggers, and other objects. See Plans Page.
  2. In Plan View, you specify the objects that are part of your plan. See Plan View Page.
    1. Schedule: The schedule defines the set of triggers that queue the plan for execution.
      1. Trigger: A trigger defines the schedule and frequency at which the plan is executed. A plan can have multiple triggers (e.g. monthly versus weekly executions).
    2. Task(s): Next, you specify the tasks that are executed in order.
    3. Flow task: A flow task includes the specification of the flow to run and the outputs from the flow to generate.

      Info

      NOTE: You can select the outputs from the recipe that you wish to generate. You do not need to generate all outputs.

      Info

      NOTE: When a flow task is executed, the execution plan works back from the selected outputs to execute all of the recipes required to generate the output, including the upstream dependencies of those recipes.

      See Plan View for Flow Tasks.

    4. HTTP task: An HTTP task is a request issued when it is triggered from the application to a target endpoint. This request supports a variety of API methods. See Plan View for HTTP Tasks.
    5. Slack task: A Slack task is a message between the
      D s platform
       and a specified Slack channel that is triggered within the plan. See Plan View for Slack Tasks.
    6. Delete task: A Delete task deletes specific files or folders from backend storage. See Plan View for Delete Tasks.
    7. Continue building tasks in a sequence.
  3. As needed, you can apply override values to any flow parameters that are included in the tasks of your recipe. These overrides are applied during a plan run. For more information, see Manage Parameters Dialog for Plans.
  4. To test:
    1. Click Run now.
    2. To track progress, click the Runs link.
    3. In the Run Details page, you can track the progress.
    4. The first task is executed and completes, before the second task is started.
    5. Individual tasks are executed as separate jobs, which you can track through the Job History page. See Job History Page.
    6. When the plan has completed, you can verify the results through the Job details page. See Job Details Page.
  5. If you are satisfied with the plan definition and your test run, the plan will execute according to the scheduled trigger.

...

  • These schedules are independent of schedules for individual flowsother asset types.
  • You cannot create schedules for individual tasks.

...

When a plan is triggered for execution, a snapshot of the plan is taken. This snapshot is used to execute the plan. Tasks are executed in the sequence listed in Plan View.

Important notes:

Info

NOTE: Any subsequent changes to the flows, datasets, recipes, and outputs referenced in the plan's tasks can affect subsequent executions of the plan. For example, subsequent removal of a dataset in a flow referenced in a task can cause the task to fail to execute properly.

At the flow level, you can define webhooks and email notifications that are triggered based on the successful generation of outputs. When you execute a plan containing an output with one of these messages, the message is triggered and delivered to stakeholders.

...