{"id":5163,"date":"2017-09-22T19:37:41","date_gmt":"2017-09-22T19:37:41","guid":{"rendered":"https:\/\/alt2.minisoft.com\/support\/?p=5163"},"modified":"2021-02-09T15:30:11","modified_gmt":"2021-02-09T23:30:11","slug":"set-value-from-a-keyed-declared-constant","status":"publish","type":"post","link":"https:\/\/c002.minisoft.com\/support\/set-value-from-a-keyed-declared-constant\/","title":{"rendered":"Set Value from a Keyed Declared Constant"},"content":{"rendered":"

For examples on how to implement Declared Constants, consult the following: Declared Constants for Production vs. Dev\/Sandbox Accounts<\/a><\/p>\n

A Keyed Declared Constant from an eFORMzCfg_User.xml file provides the value for this Variable Function.<\/p>\n

\"\"<\/a><\/p>\n

The form of a declaration is:<\/p>\n

<KeyedConstant Name=\u201cOrderNbrLabels\u201d>\n <Entry Key=\u201cEN\u201d>\n <![CDATA[Order Number]]>\n <\/Entry>\n <Entry Key=\u201cFR\u201d>\n <![CDATA[French Order Number]]>\n <\/Entry>\n <\/KeyedConstant><\/pre>\n
If this Function is used in a number of Projects to refer to the same Keyed Declared Constant, when the Keyed Declared Constant must change, only the eFORMzCfg_User.xml file needs to be modified, not each Project.<\/p>\n
Note: Changes to the eFORMzCfg.xml will get overwritten as this file is updated or overwritten on upgrades and installs.<\/strong><\/p>\n
You should consider using a Keyed Declared Constant when you need to choose one of several static values, depending on the value of some variable. Here are some examples:<\/p>\n
\u2022 In a drop-ship packing slip project<\/a>, you support several packing slip types, and you want to choose the one to use based on the value of the customer ID.
\n\u2022 You have test and production credentials to be passed to a web service call<\/a> and you need to choose the appropriate set of credentials depending on whether you\u2019re running in test or in production. Create a Keyed Declared Constant for each credential, such as URL to call, user name, password, token, etc.\u201d<\/p>\n
Language Substitution<\/h2>\n
1. Add another Variable by position and enter \u2018OrderNbrLabel1\u2019 in the Name field.
\n2. Right click the Variable and select Add Function > Set value from a keyed declared constant.
\n3. Select the \u2018OrderNbrLabels\u2019 Keyed Declared Constant which was declared in the eFORMzCfg_Translations.xml. The Key Value should should be the Language Variable. The Keyed Constant is as follows:<\/p>\n
<KeyedConstant Name=\u201cOrderNbrLabels\u201d>\n <Entry Key=\u201cEN\u201d>\n <![CDATA[Order Number]]>\n <\/Entry>\n <Entry Key=\u201cFR\u201d>\n <![CDATA[French Order Nbr]]>\n <\/Entry>\n <Entry Key=\u201cGE\u201d>\n <![CDATA[German Order Number]]>\n <\/Entry>\n <\/KeyedConstant><\/pre>\n
The two-letter language code from the incoming data file will be picked up by the Language Variable. This is the Key Value, or the \u2018Entry Key.\u2019 For example, if the language code is \u2018FR\u2019 then the value of the \u2018OrderNbrLabel1\u2019 Variable will be the French Order Number.<\/p>\n
Load Variable From a Keyed Declared Constant Pre-condition Procedure<\/h3>\n
1. Add another Variable by position and enter \u2018OrderNbrLabel2\u2019 in the Name field.
\n2. Right click the Form and select Add Pre-condition Procedure > Load Variable from a Keyed Declared Constant.
\n3. Enter a value for the Name field and select the System Variable \u2018N\/A\u2019 from the Use variable drop-down menu.
\n4. Select the \u2018OrderNbrLabels\u2019 Keyed Declared Constant which was declared in the eFORMzCfg_Translations.xml. The Key Value should should be the Language Variable. The Variable should be the \u2018OrderNbrLabel2\u2019 Variable. The Keyed Constant is as follows:<\/p>\n
<KeyedConstant Name=\u201cOrderNbrLabels\u201d>\n <Entry Key=\u201cEN\u201d>\n <![CDATA[Order Number]]>\n <\/Entry>\n <Entry Key=\u201cFR\u201d>\n <![CDATA[French Order Nbr]]>\n <\/Entry>\n <Entry Key=\u201cGE\u201d>\n <![CDATA[German Order Number]]>\n <\/Entry>\n <\/KeyedConstant><\/pre>\n
The two-letter language code from the incoming data file will be picked up by the Language Variable. This is the Key Value, or the \u2018Entry Key.\u2019 For example, if the language code is \u2018FR\u2019 then the value of the \u2018OrderNbrLabel2\u2019 Variable will be the French Order Number.<\/p>\n","protected":false},"excerpt":{"rendered":"
For examples on how to implement Declared Constants, consult the following: Declared Constants for Production vs. Dev\/Sandbox Accounts A Keyed Declared Constant from an eFORMzCfg_User.xml file provides the value for this Variable Function. The form of a declaration is: <KeyedConstant Name=\u201cOrderNbrLabels\u201d> <Entry Key=\u201cEN\u201d> <![CDATA[Order Number]]> <\/Entry> <Entry Key=\u201cFR\u201d> <![CDATA[French Order Number]]> <\/Entry> <\/KeyedConstant> If this […]<\/p>\n","protected":false},"author":75,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[682],"_links":{"self":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5163"}],"collection":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/users\/75"}],"replies":[{"embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/comments?post=5163"}],"version-history":[{"count":5,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5163\/revisions"}],"predecessor-version":[{"id":8954,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5163\/revisions\/8954"}],"wp:attachment":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/media?parent=5163"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/categories?post=5163"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/tags?post=5163"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}