Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. From Designer or Manager, open the Create Task dialog:

    • In Designer with the Pipeline open, in the toolbar, click More Tools. Click Create Task and select Ultra Task:

    • In Manager, from the left navigation, select the Project containing the Pipeline. In the toolbar, click Create and select Task > Ultra Task.

      The Create Task dialog displays:

      Image RemovedImage Added
  2. Edit the required fields:

    1. Name. Enter a name, which can include UTF-8 alphanumeric characters and special characters !"#$%&'()*+,-.:;<=>?@[\]^_`{|}~. This name is used in the URL when the Pipeline has unconnected inputs/outputs. 

    2. Pipeline. If not already selected, click the drop-down menu and select the Pipeline to be triggered by the Ultra Task. 

      If you choose a Pipeline that contains parameters, the parameters display in the Create Task dialog, where you can modify them. In the following example, the parameter keys path, full, and table name are displayed, with their entries as the corresponding values. In the full field, the values contain nested JSON.

    3. Snaplex. From the drop-down menu, select a Snaplex that has a Feedmaster. 

  3. Modify the applicable optional fields as described in Configuration Options.

  4. Click Save.

...

Field

Description

Notifications

Enables email notifications based on the status of the Scheduled Task. If your Org supports Slack notifications, you can add Slack channels or recipients. 

To use notifications:

  1. In Notifications, enter each recipient's email address, separated by commas.

  2. If Slack notifications are configured for your Org, the following fields display. You can select from the dropdown list or start typing a name to find it in the list:

    • Direct Message(s). Select individuals to receive notifications.

    • Channels. Select channels to receive notifications.

  3. Select the status that triggers notifications from the When Task has selector:

    • Started. The Task is activated.

    • Completed. The Task is completed.

    • Failed. The associated Pipeline did not execute.

    • Stopped. The associated Pipeline has stopped abruptly and the Task is no longer running.

Instances (per Snaplex)

Specifies how many instances of the Pipeline should be running on a Snaplex. For example, to achieve redundancy, you can configure an Ultra instance per document. 

The default value is 1.

The Snaplex distributes instances across nodes. For example, If a Snaplex has five nodes and this value is set to 10, the Snaplex starts two instances on each node. The algorithm for distributing executions on nodes is based on the number of currently running Ultra Task instances. Each instance connects to the input queue, and receives notifications of message delivery as they come in.

When multiple instances are running, the message is delivered to a single instance. If the Pipeline or node fails for any reason, then the message is unacknowledged in the queue. Consequently, when the consumer is recognized as no longer being connected, the message returns to the queue and is picked up by another instance. In the correct configuration, messages should not be lost.

Alias

Use an alias to run an Ultra Task in multiple regions for high availability and disaster recovery. Use the same alias in multiple Ultra Tasks that run the same Pipeline. When an Ultra Task in one region fails, a Snaplex in another region can run the Pipeline by invoking the Ultra Task that shares the Alias name. The Ultra Task that shares the Alias must be in the same project folder as the primary Ultra Task, but be deployed to different Snaplex instances.

Bearer Token

An automatically generated token for the HTTP Authorization header. If you clear this field, the Pipeline authenticates requests. You can also set the value yourself. 

Anchor
max_failures
max_failures
Maximum Failures

Specifies an optional threshold for a Pipeline failing to start. When the number of failures reaches the threshold, the Snaplex disables the Ultra Task. The default value is 10. Set the value to 0 to avoid having the Snaplex disable the Ultra Task. 

During development a Pipeline can be in an invalid state and fail to start multiple times. Consider setting the value for Maximum Failures to 0 until the Pipeline is ready for production.

Max In-Flight

Specifies a threshold for documents to be processed on a single Pipeline instance. Once the execution reaches the threshold, the Snaplex distributes to other instances of the Ultra Pipeline. This enables you to prevent an excessive number of documents from being queued on a single, slow execution.

Set the Max In-Flight value to the maximum number of documents that can be processed by one instance at a time.

The default value is 200 documents. Set this value higher if the Ultra Task executions take a long time.

A value of 1 disables the prefetching of documents and can negatively affect performance. 

...

  1. In Manager, navigate to the Ultra Task and select Details from the dropdown menu:

  2. On the Task Details page, view execution statistics by clicking Run Details:

    Image RemovedImage Added

Related Information

...