Tasks

Tasks are collections of input connectors, input topics, processors, output connectors and output topics; these define the data flow from inputs to outputs. A task can be started to initiate the data flow and it can be stopped to end the data flow.

Add Task

Select the “Tasks” node in the navigation panel and click “Add” to add an empty task. The task will have the default settings with no connector or processor added.

../_images/tasks-add.png

Tip

To create similar tasks, select an existing task in the content panel, use “Duplicate” to create a copy, then edit the new task as required. If you have configured an output connector with an “Auto” topic (for example, the ODBC connector) then you can right-click on an input connector topic (for example, an OPC UA topic) and select “Send to” to create a task that transfers data from the input to the output connector.

Edit Task Settings

Select the task in the navigation panel to edit its settings. Settings are:

  • Name
    The task’s name.
  • Start this task automatically
    If ticked, then the task is automatically started when the UA Office Link Core Service starts. By default, the service is configured to start automatically and in that case tasks will start automatically after a reboot, for example.
  • Auto-start delay
    The number of seconds the auto-start should be delayed for; useful if data sources need some initialisation time, for example, to avoid intial error messages.
  • Max pending count
    UA Office Link maintains an in-memory data update queue for each output connector. The maximum pending count limits the number of queued data updates for each connector. If the maximum count is exceeded then incomimg data sets are dropped instead of forwarding the data to the respective connector. Setting the “Max pending count” property to zero (the default) means that there is no limit on the number of queued updates.
../_images/tasks-edit.png

Add Input Connectors

Click on the task’s “Inputs” node to add input connectors by dragging the connector from the “Connector Browser” onto the task’s “Input Connector” content panel. Each type of connector can only be added once.

../_images/tasks-add-input-connector.png

Add Input Topics

Click on the task’s input connector node that you have added and add input topics by dragging the topics from the “Topic Browser” onto the task’s “Topics” content panel. If you don’t see any topics listed then connector topics may be write-only or no connector topics have been created yet. Please check the topic configuration in the relevant connector.

../_images/tasks-add-input-topics.png

Add Output Connectors

Click on the task’s “Outputs” node to add output connectors by dragging the connector from the “Connector Browser” onto the task’s “Output Connector” content panel. Each type of connector can only be added once.

../_images/tasks-add-output-connector.png

Add Output Topics

Click on the task’s output connector node that you have added and add output topics by dragging the topics from the “Topic Browser” onto the task’s “Topics” content panel. If you don’t see any topics listed then connector topics may be read-only or no connector topics have been created yet. Please check the topic configuration in the relevant connector.

../_images/tasks-add-output-topics.png

Add Processors

Click on the task’s “Processing” node to add processors by dragging the processor from the “Processor Browser” onto the task’s “Processor” content panel. Click on the added processor node to configure the processor.

../_images/tasks-add-processor.png

Start Tasks

Select the “Tasks” node in the navigation panel and select one or more tasks from the list in the content panel. Press the “Start” button to start the selected task(s).

../_images/tasks-start.png

Tip

You can also use the right-click menu to start individual tasks.

Inspect the message panel for any error relating to the tasks. If anything goes wrong, then error messages will inform about the cause and the task icon will indicate an error.

../_images/tasks-running.png

Tasks may be in a state of:

  • Stopped

    The task has not been started.

  • Running

    The task is running normally.

  • Interrupted

    The task is not running due to an error but may recover and continue to run later.

  • Aborted

    The task has encountered an error and cannot continue to run.

Monitor Tasks

Expand the task and drilldown to topic level to inspect live values as they flow through the task stages. Note that “Live Values” must be ticked in the application’s “View” menu.

../_images/tasks-monitoring.png

Stop Tasks

Select the “Tasks” node in the navigation panel and select one or more running tasks from the list in the content panel. Press the “Stop” button to stop the selected task(s).

../_images/tasks-stop.png

Tip

You can also use the right-click menu to stop individual tasks.