Running & Managing Jobs

You can learn more about managing and running jobs, and navigating the job page here.

Find the following sections below:

Continue reading to learn about managing jobs.

Managing Jobs

Jobs are the main component of Loome Integrate and they can be executed using various methods and strategies, such as creating a schedule or making a job dependent on another job.

Choose your project from the left-hand menu list of projects.

Beside each job on the project page, there are action buttons to manage each job.

job actions

These actions (from left to right) are:

Run Now

You can use Run Job to run a job at anytime as an adhoc execution.

You can run a job on both the project page and at the top-right corner of a job’s sequenced tasks page.

run now on job page

run now on tasks page

Click on run on the right of a job to run the job.

You will need to confirm that you would like to run the job now, and whether you want to be redirected to the real-time execution logs page.

run now modal

Note that unlike scheduled jobs, running a job manually will not factor in if the job is running already and will run no matter what.

View Execution History

View a history of this job’s executions and the logs of each execution.

You will be notified in the logs if your agent fails or is shut down while running the job. If logging is offline while the job is run, the logs will be prefixed with ‘[Offline Log]’ when loaded, and will resync according to its refresh period.

For each execution, you can find a log of events such as information, debug and any errors.

You can filter each column of log time, task, log messages, and events.

Execution History filters

To filter each column, click on the filter button that appears when you hover over a column title.

Execution History filters

You can then filter on your log data and choose from checkboxes, like the example in the following image for the ‘Event’ column, or choose a time or time range, text value, or task depending on the type of the column.

Execution History filters

Log Time

You can filter on the logs by time.

Select a condition and then choose a time. If you choose ‘In range’ you can choose a time range.

Execution History log time

Log Messages

You can filter log messages by entering a text value.

Execution History log message

Filter by Tasks

If you would like to view the logs for a specific task and not the complete job, you can select the checkbox of a task. It will filter the logs for your selected tasks.

Execution History task name filter

Sort

You can also sort your columns using the sort button by clicking on each column title. Click on it again to switch between ascending and descending order.

Execution History sorting

Previous Logs

The duration and the time of each execution of a job will be listed on the left-hand side of the page.

You can choose one of the past executions in this list to view the logs of that run.

Execution History page

Download Execution Logs

You can download the logs of a job execution as a text file using the Download button at the top-right of the Executions page.

It will contain the logs of each task and all logs for the job. It will download the log of the execution you have selected from the left-hand execution history. It will be titled with the execution log number and date, and job name.

Download Execution History logs

Refresh Logs

You can refresh the logs of a job execution by clicking refresh.

Refresh Execution History logs

View Job

You can go back to the job page by clicking ‘View Job’.

Go back to job page

Enable Schedules

This will display the schedules available for this job that can be enabled.

The schedule toggle

Please click on the schedules you would like to enable.

View of schedules

Turn Off Schedules

If you would like to turn off any enabled schedules, just click on the schedule toggle to turn off all schedules.

Schedules

This will direct you to the schedules page for this job. You can add and remove schedules for the job. Learn more about setting and managing Schedules here.

Manage schedules

Edit Job

Click Edit to edit the details of the job such as its name, log level, email notification settings and job dependencies. Learn more about editing jobs here.

Edit button

Delete Job

Click Delete to remove the job from Loome Integrate. Note that the tasks sequenced in the job will still exist in the project as an available task.

Delete button

Manage Job Dependencies

What is a Job Dependency

You can manage and view the jobs that this job is dependent on. If it is dependent on another job, that job’s last execution will need to be successful so that this job can run.

Running a job that is dependent on jobs in other projects will not cause those jobs to also run. It will only run this job, and its outcome will depend on the status of the jobs it is dependent on.

How to Make a Job Depend on another Job

On the right of your chosen job in a project, click on the Dependency action.

Job Dependency button

Browse jobs from all projects and select the jobs that this job will be dependent on. All your projects will be displayed on the left, and the jobs relevant to the project will be displayed on the right.

Check the box next to each applicable job to select the jobs that this job will be dependent on.

You can make a job from one project dependent on a job from another project by choosing the other project in the left project section.

Cross project dependency window

You can also view any existing dependencies. They will be indicated with a yellow icon beside the dependent job and project.

Any selected jobs will display as pictured

If you have chosen for a job to be dependent on a job that has the Retry Count enabled, the dependent job will wait for all necessary re-attempts to complete and will run if the first or a subsequent attempt was successful.

Run this Job on Dependent Failure?

Then choose whether a dependent job should still run if the job it is dependent on failed on its last execution.

This behavior is not enforced by default, you will need to set ‘Run this Job on Dependent Failure?’ to ‘Yes’ in order to utilize job dependencies.

Select whether this job will run on dependent failure:

  • If this is set to ‘Yes’, this job will run regardless of the status of the job it is dependent on.
  • If it is set to ‘No’, this job will fail if the job it is dependent on has a failed job status. But if the status of the job that it is dependent on is successful, then the job will run.

Dependent Failure Option

Sort and Filter the Job Page

You can filter a list of jobs in a project by clicking on the Filter button that appears when you hover over a column title.

Sort and Filter here

Use the text filter for the job names, highlighted in the image below, to filter and search the list of jobs in this project.

Search your job list

Sort Jobs

Sort the list of jobs in this project using the arrow button that appears beside each column title, highlighted in the image below.

Sort the list of jobs by last execution

Reset Filters

Reset your filters by clicking on the filter button beside a column, select the right-hand filter option, and then ‘Reset All Filters’.

Clear filters here

Filter on Columns

You can also filter on columns in the second filter tab, and choose to hide or show columns, pin columns to the left or right, autosize or reset your applied filters in the third filter tab.

Filter on columns

Hide or Display Columns

You can hide or display columns on the job page, for example the ‘Created by’ and ‘Created Date’ columns will be hidden by default.

You can use the filter option on any column to select which columns will be displayed or not.

Just select the checkboxes of the columns you would like to view.

Selecting columns

Some columns may only have two filtering tabs, but you can still find them in the column selector here.

Selecting columns