Promoted Variables are an extension of the Process Instance, where the developer of the integration Process can decide which information in the Process execution is important for monitoring and auditing purposes. As such, they can promote that information, making it available to:
Find and filter the Process Instance list to locate a specific execution more easily.
Configure Monitoring Rules across multiple Processes.
To configure a Promoted Variable, simply select the "Promote Result" option when configuring a Task. After that, it will be available for the above scenarios in the Frends Control Panel.
The most common use cases for Promoted Variables include:
Promoting the identifier of the data being processed, such as a GUID or date.
Promoting the most relevant information of a Process execution, such as the amount in an order or the due date of an invoice.
Promoting information based on which you can monitor the Process executions as a whole using Monitoring Rules.
In this example, version 8 of the executed Process has a Promoted Variable called "timestamp."