GetMetaDataMessage

Syntax

GetMetaDataMessage(key);

key	A string, uniquely identifying the GUID or the name of the metadata (case sensitive). Note: If name is used, make sure the name is not updated in the Design Center configuration.

Description

Returns the current value of a metadata. The metadata must have the Message context.

Using the GetMetaDataMessage scripting function for a metadata without the Message context is not supported. To save space in the repositories and to improve search performance, you should not use the Message context unless the metadata really has to be available to external applications.

This function is typically used in an exception rule to get the value of a metadata. The metadata is assigned its value before the exception rule is executed. By using the scripting function instead of referring directly to a variable, any changes made to the metadata by external applications are considered.

The scripting function can be used in:

•	Scripts related to a Process

•	Scripts inside the Process.

•	Before and after scripts.

For example, if you want to use the same metadata in a Process as in an exception rule, the scripting function can be used in the Process as well.

Returns

A string with the value of the metadata. If the metadata is not found or the metadata value is yet not set, an empty string is returned.

Example

$Category = GetMetaDataMessage("a86199fd-5f5a-4e53-a3af-47c72ae6321f");