Using Aliases
Aliases are a type of object which replace the numerical identifier of processes and state diagrams with a readable name. This makes it easier to call objects in other processes without having to remember a numerical identifier. Aliases can be used as shortcuts to interact with processes and state diagrams in nodes and through the MPO API.
Working with Aliases
You can create and manage aliases in the Aliases tab of the main menu bar.
A list of all the aliases is visible to everyone who has access to your MPO instance, but only an alias’s creator may use it in a process. You may only create aliases for process and state diagrams that you have access to. You can click on any linked object that is highlighted blue to open the linked object in a new tab.
Creating an Alias
In order to create an alias, simply click the Create button in the top-left and enter a name, a short name, a description. Then bind the process or a state diagram to the alias. The following conditions apply when creating your alias:
- Name: mandatory, 255 characters maximum. May use any alphanumeric character and have spaces.
- Short name: mandatory, 128 characters maximum, minimum length 3 characters. Lowercase letters (a-z) and a dash (-) are allowed.
- Description: optional, maximum length 2,000 characters.
Editing an Alias
In order to change the name, short name, description, or bound object, right-click on the alias you want to edit in the list and select Edit.
Finding out more about an Alias
You can view more information on an alias by opening its information box. To do so, select the alias in the list and click the i
icon on the right-hand side. This opens an information box with three tabs:
- Info: This tab summarizes the properties of the alias, including the linked object, the short name, the ID of the alias, the creation and last modified dates. You can also edit the description and change the linked object from this tab.
- History: The modification history of the alias.
- Webhook: In this tab, you can toggle a direct URL to upload data to an alias, process, or state diagram in JSON, XML, and NVP formats. You can also copy the direct URL to call the alias via API. This tab is only available to the owner of the alias.
Using Aliases in Nodes
There are three nodes that allow you to use aliases: Call Process, Copy Task, and Modify Task nodes. Each of these nodes requires either the process ID or alias of another process to call, copy or modify.
To enter an alias as an input open the Info panel of the node you need to edit by clicking on the node. In the Alias or process input under Basic settings, you can do one of the following:
- Click the Tree Search icon (the blue icon in the search box), select the Aliases tab, and pick the Alias you want.
- Search for the alias by name by starting with @ symbol to limit search to aliases.
- Pass the alias’s name as a task parameter containing the short name of the alias, such as
@{{alias_shortname}}
. You need to start with an@
symbol to declare an alias as a a parameter.