Some string attributes in the AWM model support the use of variable references. Referenced variables can be defined dynamically (as part of a string) and can reference AWM properties, environment properties and certain static variables (see table below).If AWM properties are referenced, values will be resolved at runtime and preferably taken from the “previous tool” execution context pool (if available).
Variable references are only resolved by the following attributes:
Attributes "Title", "Description" and "Help Text" of modeled dialogs. See Open Modeled Dialogs in the AWM function package for more information.
References can be defined by using the Start Reference and End Reference symbols (default "&" and ".") which are defined in the application options. See Application Options for more information. It is possible to define a value containing several references as well as static characters. The following table shows the syntax of all variables that are available:
| Variable/Syntax | Description | Example |
|---|---|---|
| %<env-var> | Reference to an environment variable on the client’s local operating system | &%PUBLIC. = |
| <property ID> | Reference to a property in the execution context | &PROP_WorkspaceFilename. = |
| wspath | Path of the active Eclipse Workspace on the client’s local machine | &wspath. = C:\workspaces\workspace1 |
The following examples show the definition of a dynamic file path:
Attribute value of "Name_Physical" (File Descriptor):
|
Reference |
Resolved Value |
|
&%PUBLIC.\MyCache\&PROP_FileName. |
C:\Users\Public\MyCache\MyFile.txt |
|
&userid..SOURCE(&PROP_Membername.) |
USER123.SOURCE(MEMXYZ) |