Token Grammar
AdminStudio 2022 | 23.0 | Application Manager | Rules Wizard
Edition:Application Manager is included with AdminStudio Professional and Enterprise Editions.
What are Tokens?
Tokens represent data in the database that is inserted at runtime. In Application Catalog, tokens are used to insert values at runtime from the Application Catalog Database or an external MSI package into an Error or Display String.
How to Insert Tokens
Tokens are specified on the Custom Options panel of the Rules Wizard. To use token replacement in a string, click the arrow to the right of the Error String and Display String text boxes and select a column name from the list. The column name is then inserted into the string in the following format:
| • | Source Only Packages ACEs—[ColumnName] |
| • | Source and Target Packages ACEs—[Source.ColumnName] and [Target.ColumnName], with the prefix identifying whether the column is in the Source or Target package. If no prefix is used, Application Catalog assumes the “Source.” prefix. |
Note:The Token list on the Custom Options panel is provided for your convenience; if you prefer, you can type the variables directly in the text boxes. For more information see, Token Grammar.
Caution:While you are creating a user-defined ACE in the Rules Wizard, if you initially select a Rule Type of Custom - Source and Target Packages, and then insert tokens in the Error String and Display String fields, the “Source.” prefix will be used. But, before you finish creating this ACE, if you go back and change your Rule Type selection to Custom - Source Only Packages, the tokens that you initially entered into the Display and Error string text boxes will not automatically be updated to remove the “Source.” prefix. For Application Catalog to correctly interpret this ACE, you need to manually go back to the Error and Display String fields and delete the “Source.” prefix.
Using the ProductName Pseudo-tokens
You can use the pseudo-tokens of [ProductName], [Source.ProductName] and [Target.ProductName] to insert the name of the Source or Target package in an Error or Display String, even though ProductName is not a table column name.
See Also