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.

The Alias tab on MPO

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.

Creating an Alias in MPO

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.

Adding an Alias using tree search

  • Search for the alias by name by starting with @ symbol to limit search to aliases.

Adding an Alias via Search

  • 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.

Adding an Alias via parameter