Variable Replacements

You may have specific aspects of your UI Meta Model which need to be replaced at runtime. For example, you may want to change your Help URL based on which environment you are in (Test versus Prod). To achieve this, you can use the following syntax to dynamically replace a value in the UI Meta Model with a value from the EXTERNAL_REFERENCE table.

This will check the EXTERNAL_REFERENCE table, attempting to find a row with REF_TYPE = 'HELP_URL' and EXTERNAL_VALUE matching the uppercased value of the Stage specified in your InstanceConfig.xml (for example, "DEV"). If it finds such a row, it will replace the string with the LOCAL_VALUE from that row.

HELP_URL is only provided as an illustration - any element or attribute in the UI Meta Model can contain an $ExternalReference$ macro value, and you can specify any name for the REF_TYPE you like, such as MY_URL.