Logical Names Usage (Magic xpa 3.x)
At runtime, whenever Magic xpa compiles a file name in order to perform some I/O process, the Logical Names algorithm is executed. File names are scanned, from left to right, and any logical name is substituted with the Translation from the Logical Names repository. Multiple logical names may be used in one file name (for example, one for disk drive, another for directory and another for file name).
Logical name information is contained in the [MAGIC_LOGICAL_NAMES] section of the Magic.ini file.
Note: In functions, logical names are only supported in server-side functions in Rich Client tasks.
The syntax for logical names is:
%logicalname%
Where: % means Start logical name, logicalname is the logical name, and % means End logical name.
Note: In Magic xpa, logical names are case sensitive.
The '%' symbol is not allowed in any file name for purposes other than delimiting logical names.
During translation, the logical name and its delimiters are replaced by their Translation according to the Logical Names repository. So, if you want to use a logical name in an expression, it should be part of a string, surrounded by single straight quotation marks (' ').
If the logical name is not found in the repository, it is cleared from the file name.
If the closing delimiter is missing, all the text from the first delimiter to the end of text is treated as the logical name.
Note: In previous versions the following syntax was valid: $logicalnameTerminator
Where: $ means Start logical name, logicalname is the logical name, and Terminator means any character that is not between 0-9 or between a-z, A-Z or the '_' character.
This syntax is deprecated and should be replaced with %logical name%
