Welcome
Orchestrating
Orchestrate anything with HCL Universal Orchestrator.
Task definition
A task definition is a unit of work that specifies an action to be performed on specific workstations in the HCL Universal Orchestrator network.
Creating and referencing a task template from the UI
The purpose of the following scenario is to show how to create a task template in the context of an example.

What's new
HCL Universal Orchestrator is constantly evolving to offer you the most comprehensive orchestration capabilities. For known limitations, workarounds, and contact information of HCL Customer Support, see Release notes.
What is HCL Universal Orchestrator
An introductory overview of HCL Universal Orchestrator.
Deploying and Administrating
All the information you need to deploy and administrate HCL Universal Orchestrator.
Using the UI
The UI is the HCL Universal Orchestrator interface, from which you can smoothly design your scheduling environment and monitor every process.
Orchestrating
Orchestrate anything with HCL Universal Orchestrator.
- Orchestration CLI commands
  You can use the various command options in Orchestration CLI to achieve specific results. The command options are not case sensitive and you can use either uppercase or lowercase letters.
- Workflow definition
  A workflow is a set of tasks to be run, together with times, priorities, and other dependencies that define the processing order.
- Task definition
  A task definition is a unit of work that specifies an action to be performed on specific workstations in the HCL Universal Orchestrator network.
  - Executable tasks
  - File monitor tasks
    You can use the file monitor tasks to create tasks that track changes in files. File monitor tasks can track changes in a single file or multiple files in HCL UnO agent installed in your local machine or mounted virtual machine.
  - Managing a task definition from the Orchestration CLI
    In this topic you can find the syntax to manage a task definition.
  - Creating and referencing a task template from the UI
    The purpose of the following scenario is to show how to create a task template in the context of an example.
  - Creating file monitor tasks from the Orchestration CLI
    You can create a file monitor task by adding the specific attributes related to file monitor with the mandatory task definition attributes.
  - Using variables in tasks
    This section explains how to add variables to your tasks.
  - Selecting tasks in Orchestration CLI
    In Orchestration CLI you can perform actions either on a single task or on multiple tasks in the same instance. When you want to run commands on multiple tasks, instead of the task name, select the set of tasks by means of attributes and task qualifiers.
- Event source definition
  An event source is an item that allows HCL Universal Orchestrator to receive events from specific event plug-ins.
- Calendar definition
  Calendars define the days in which workflows do or do not run.
- Folder definition
  You can use folders to organize your items accordingly to your business needs.
- Credentials definition
  Credential definitions are used to store user IDs and passwords, or tokens.
- Variable table definition
  Variables are values that can change according to the purpose of workflows and task templates.
- Workstation definition
  A workstation is a scheduling item that runs tasks.
- Event plug-in structure
- Managing matching criteria
  In this topic you can find a description of matching criteria.
- Parsing OCLI files in streaming
  HCL Universal Orchestrator enables you to add or replace files containing multiple item types through OCLI in a single command.
- Data exchange and transformation
  This topic explains how you can streamline your workflows using data exchange and transformation.
Orchestrating from Mobile
You can use your mobile devices to manage quickly and easily your whole HCL Universal Orchestrator environment.
Monitoring
Take your environment under control.
Using REST API
Use REST APIs to easily integrate workload scheduling capabilities with external products and solutions.
Uno AI Pilot
Welcome to the HCL Universal Orchestrator AI Pilot documentation. This resource is designed to guide you through everything you need to know about using UnO AI Pilot effectively. You will find detailed instructions, feature overviews, and helpful tips to ensure you get the best experience with UnO AI Pilot.
Troubleshooting
Recover your environment if any issue occurs.
Notices

Creating and referencing a task template from the UI

The purpose of the following scenario is to show how to create a task template in the context of an example.

About this task

Tasks can either be an embedded task, or they can reference a task template.

For information about how to define an embedded task from the UI, see Creating an embedded task from the UI.

David is an HCL Universal Orchestrator user who needs to upgrade the Java version on the existing backup server named BK_server. To automate the process, David decides to create a workflow that references a task template. David prefers to reference a task template instead of creating an embedded task because he needs to use the same task template in other workflows and he wants to avoid to duplicate the definition. In this way, if David needs to modify any parameter, he can modify just one task template and every workflow that references the task template definition will be affected by the change.

To create a task template named UPGRADE_JAVA_VERSION and then reference the task template inside the existing UPGRADE_JAVA workflow, perform the following steps:

Procedure

Create a task template named UPGRADE_JAVA_TEMPLATE and enter the command that performs the Java upgrade procedure.
1. In the Graphical Designer page, from the Assets tab, click Add new.
2. From the drop-down menu, select Task template.
3. In the search bar, type Executable, then select the executable task template and click Next.
4. In General information, in Workstation, select the existing workstation BK_server.
5. In Folder, select the already existing folder IT_operations.
6. In Name, type UPGRADE_JAVA_TEMPLATE.
7. In Task, select Inline script from the drop-down menu.
8. In Command text or script name, enter apt install --only-upgrade openjdk-11-jre-headless -y.
9. Click Add to add the task template to the database.
Reference the UPGRADE_JAVA_TEMPLATE task template into the existing UPGRADE_JAVA workflow.
1. From the Assets tab, use the search bar to find the UPGRADE_JAVA_TEMPLATE task template
2. Drag the UPGRADE_JAVA_TEMPLATE task template into the UPGRADE_JAVA_VERSION workflow.
3. Click Deploy to deploy the workspace.
You created a task template to upgrade the Java version on the backup server named BK_server and you referenced the UPGRADE_JAVA_TEMPLATE task template into a workflow.