Managing a Job's Tasks

How Loome Integrate runs Jobs

The main functionality of Loome Integrate is used to execute “jobs” which consist of a sequence of “tasks”.

job page

When viewing the tasks for a job, the “Sequenced Tasks” list shows which tasks will run in and in what order they will run in.

With this in mind, Loome Integrate jobs can be seen as a list of tasks which will execute individually in order.

All of the functionality detailed in this page require the user to at least be a “BI Developer” or higher.

Adding a New Task

If you wish to add a task to a job which doesn’t exist yet, clicking the “Add Task” button in the page header will take you to the new task form. Once you submit the new task, it will automatically be added to the sequenced tasks for the related job.

adding a new task

Adding an Existing Task

Tasks that are created in projects are completely re-usable across multiple jobs.

To add an existing task to a job, use the “Available Tasks” lists and select the tasks you wish to add with the + button.

adding an existing task

Ordering Tasks

Using the drag handles on the left of the tasks, you can easily drag and drop tasks in the order you wish them to be executed.

ordering tasks

View which Agents are used for Tasks

You can view which agent is attached to a particular task on the job page. This will display the agent that a task will use and will also display whether this agent is healthy or unhealthy.

It can be viewed beside the task’s last modified date.

Agent display

Managing Task Sequence Entries

On the right side of the task sequence entry, you will notice there are a few actions that can be used to configure the task sequences even more.

These include (from left to right):

Enable Sequence

By default this is enabled, ‘Enabled’ sequenced tasks will be run as part of the job. When unchecked, the sequenced task will be skipped for future job executions until it is enabled again.

If you click on the toggle again, it will disable the task and it will not be included in the sequence when the task is run.

Enable a sequence via this toggle

Manage Dependencies

When a job runs, by default a failed task will not stop latter tasks from executing. By configuring task dependencies, tasks can require earlier steps in a job run to succeed before it can run. If any dependency fails, the tasks execution will be considered a failure.

manage dependencies

Edit Parameters

Parameter Values

Certain task types allow for parameters to be set when the task is sequenced. This allows for the same task to be re-usable across different jobs with different configurations.

Task parameters in Loome Integrate will always be treated as a string/varchar, this means your tasks must explicitly convert parameter values to other types such as numeric types explicitly.

Clicking the “Edit Parameters” button allows you to edit the parameter values for that particular task sequence.

edit params

Parameter Defaults

In some cases your task parameter values will be shared across multiple jobs. Rather than providing the same values multiple times, you can easily provide Parameter Defaults in the task create/edit form.

Parameter Defaults will only be used when there has been no parameter value provided for the tasks usage in a job.

Examples

If we used a simple Powershell script as an example, where $Name refers to a parameter with the same name:

Write-Output "Hello $Name";

We could map the defaults and values to an output like so:

Parameter Default Parameter Value Final Output
Alex Hello Alex
Alex Matt Hello Matt
Shane Hello Shane

Edit Task

You can edit a task directly from the sequence list by clicking the “Edit Task” button.

Editing the task in the sequence will affect the task in all jobs. If you don’t wish to affect other jobs that use the task, it may be worth either creating a new task or cloning the task you wish to edit.

Remove from Sequence

Clicking the trash button on the task sequence will remove it from the job sequence. Removing the task from the sequence does not delete the task and you can re-add the task to the job sequence from the “Available Tasks” list.