Running Published Tasks

When you publish a task to an Application in Oracle Cloud Infrastructure Data Integration, a task entry is created in the Application.

The Tasks section of an Application details page shows the list of tasks you have published to the Application. You run published tasks from the list. To filter the list, in the search field enter the complete name of the task to do a full text search.

On the Tasks list of the Application details page, the Actions menu for a published task has these options:

  • View details: Displays the most recently published details in read-only mode. For an integration task or a pipeline task, you have the option to save a copy of the associated data flow or pipeline.
  • Run: Runs the task.
  • Schedule: Lets you create a task schedule for the task.
  • View runs: Displays the runs created for the task.
  • Copy task key: Copies to the clipboard the key of the published task, which you can use with APIs.
  • Unpublish: Lets you unpublish the task from the Application. A patch entry is created in the Application when you unpublish a task.
    Note

    You cannot unpublish tasks in an Application that was created as a copy of another Application.

When you run a task, a run entry is created in the Runs section of the Application details page, and also on the Runs section of the task details page. On either Runs list, you can rerun a task from a run entry.

Running a Task

Only published tasks can be run from an Application.

To schedule a task for automated runs, see Scheduling Published Tasks.

To run a task manually:

  1. In the tab bar, click Open tab (plus icon) and then select Applications.
    You can also click Applications on the workspace home page.
  2. From the Applications list, select the Application that you had published your task to.

    You can also click the Actions menu for the Application and select View details.

  3. On the Application details page, click Tasks. Then from the list of tasks, select Run from the Actions menu for the task you want to run.

    If the task uses parameters, a Run Task: <task name> panel opens, letting you configure the parameter values for this specific run.

A run entry is created in the Runs section of the Application details page. See Viewing Task Runs. To manually terminate a run, see Terminating a Task Run.

To initiate a task run using REST APIs, see CreateTaskRun. See also Using the APIs.

Rerunning a Task

When you run a task, a run entry is created in the Runs section of the Application details page, and also on the Runs section of the published task details page. You can rerun a task from a run entry on either Runs list.

Only failed or successfully completed tasks can be selected for rerunning. For pipeline tasks, you can rerun the main task only. You cannot rerun individual tasks within the pipeline. Similarly for a data loader task that loads data into multiple entities using a run entry for each entity loading operation, you can rerun the parent task only.

To rerun a task:

  1. In the tab bar, click Open tab (plus icon) and then select Applications.
    You can also click Applications on the workspace home page.
  2. From the Applications list, select the Application.
  3. On the Application details page, click Runs. Then in the Runs list, select Rerun from the Actions menu of the run entry of the task you want to rerun.
  4. Alternatively, on the Application details page, click Tasks.
    1. In the published Tasks list, click the task name.
    2. On the published task details page, click Runs.
    3. In the Runs list of the task, select Rerun from the Actions menu of the run entry.

Unpublishing a Task

You can unpublish a task if a task run for the task is not currently running.

To unpublish a task manually using the Console:

  1. In the tab bar, click Open tab (plus icon) and then select Applications.
    You can also click Applications on the workspace home page.
  2. From the Applications list, select the Application that you had published your task to.

    You can also click the Actions menu for the Application and select View details.

  3. On the Application details page, click Tasks. Then from the list of tasks, select Unpublish from the Actions menu for the task you want to unpublish.
    Note

    You cannot unpublish tasks in an Application that was created as a copy of another Application. The action is not available.

Saving a Copy of the Object from a Published Task

When a published task is associated with a data flow or pipeline, you can save a copy of the associated object.

By saving a copy of the associated data flow or pipeline, you can make and test modifications without affecting the existing flow.

  1. From the Applications list, select the Application that has the published tasks.

    You can also click the Actions menu for the Application and select View details.

  2. On the Application details page, click Tasks.
  3. From the Tasks list, select an integration task or a pipeline task.
  4. On the published task details page, click View definition.
  5. On the integration task or pipeline task page that displays, click the name of the data flow or pipeline for the task.
    Data Integration displays the data flow or pipeline in read-only mode.
  6. If you need to save a copy of the data flow or pipeline, click Save as.
  7. In the Save as panel that displays, enter a Name and Description (optional) for the data flow or pipeline copy.
    The Identifier is a system-generated value based on the name. You can change the value, but after you save the object, you cannot update the identifier.
  8. To save the copy in a different project or folder, click Edit. Select another project or folder in the Edit project or folder panel, then click Select.
  9. In the Save as panel, click Save.