Set Value from a Declared Constant

For examples on how to implement Declared Constants, consult the following: Declared Constants for Production vs. Dev/Sandbox Accounts

A Declared Constant from an eFORMzCfg_User.xml file provides the value for this Variable Function. The form of a declaration is:

<Constant Name="OrderNbr">
 <![CDATA[Order Number]]>
</Constant>

If this Function is used in a number of Projects to refer to the same Declared Constant, when the Declared Constant must change, only the eFORMzCfg_User.xml file needs to be modified, not each Project.

Language Substitution

Use eFORMzCfg_Translations.xml and update the values accordingly. A sample configuration is shown below:

<?xml version="1.0" encoding="UTF-8"?>
<eFORMzConfiguration>
 <Constant Name="OrderNbr_EN">
 <![CDATA[Order Number]]>
 </Constant>
 <Constant Name="OrderNbr_FR">
 <![CDATA[French Order Nbr]]>
 </Constant>
 <Constant Name="OrderNbr_GE">
 <![CDATA[German Order Number]]>
 </Constant>
 <KeyedConstant Name="OrderNbrLabels">
 <Entry Key="EN">
 <![CDATA[Order Number]]>
 </Entry>
 <Entry Key="FR">
 <![CDATA[French Order Nbr]]>
 </Entry>
 <Entry Key="GE">
 <![CDATA[German Order Number]]>
 </Entry>
 </KeyedConstant>
</eFORMzConfiguration>

In the eFORMzCfg_User.xml file, enter the eFORMzCfg_Translations.xml file name and its directory:

<File Name="\Projects\Documentation\eFORMzCfg_Translations.xml"/>

From there, a report built with the Document Template can be configured for language substitution.

1. First, create a Variable by right-clicking the Form and selecting Add Variable > By position.
2. Enter ‘Language’ in the Name field and select OK.
3. Add another Variable by position. Enter ‘OrderNbrConstantName’ in the Name field.
4. Right click the Variable and select Add Function > Set Value.
5. Enter a Constant value of ‘OrderNbr_’ and select OK.
6. Right click the Variable and select Add Function > Concatenate.
7. Select the Language Variable.
8. Add another Variable by position and enter the name ‘OrderNbrLabel.’
9. Right click the Variable and select Add Function > Set value from a declared constant.
10. Select the ‘OrderNbrConstantName’ Variable.

The ‘OrderNbrConstantName’ Variable has been set to ‘OrderNbr_’ and the concatenated value of the ‘Language’ Variable. This Variable is picking up the two-letter language code from the incoming data file. This corresponds to the format of the Declared Constants in the eFORMzCfg_Translations.xml file:

<Constant Name="OrderNbr_EN">
 <![CDATA[Order Number]]>
 </Constant>
 <Constant Name="OrderNbr_FR">
 <![CDATA[French Order Nbr]]>
 </Constant>
 <Constant Name="OrderNbr_GE">
 <![CDATA[German Order Number]]>
</Constant>

For example, if the language code is ‘FR’ then the value of ‘OrderNbrConstantName’ will be ‘OrderNbr_FR’ and the value of the ‘OrderNbrLabel’ Variable will be the French Order Number.