...
The superuser admin can configure server-wide global _data, and the Tenant Admin Tenant has the same functionality at tenant level. One common use is for forms deployed from a development/test form server to a production form server. You often need information such as URLs configured one way in your dev/test environment and another way in your production environment. For example, a database in the dev/test environment might be located at http://mytest:1024/database/listManagers and in your production environment at http://myprod:1044/database/listManagers.
frevvo makes deployment from dev/test to production easier by enabling you to configure global data variables. For example, rather than hard-coding the URL to your database server you can write the URL using a template such as {dbUrl}/database/listManagers. Then define variable dbUrl one way in dev/test and another way in production.
To see all the places where templates can be used, refer to the chapter Templatized Strings.
Column | ||
---|---|---|
| ||
On This Page:
|
Setting Global Data in _data properties file
...
- From the Server Admin hompage, click Manage Default _data.
- Click the Download icon. This will download an empty default _data.properties file.
Add your global data to the _data.properties file. Save the file.
Code Block title Example syntax for _data.properties file dbUrl=http://localhost:8080/database/listManagers ManagerName=Joe
- Return to the Manage Default _data page. Click Choose File.
- Locate your newly created _data.properties file.
- Click Upload.
For subsequent edits of the _data.properties file, simply download the _data.properties file previously uploaded by clicking on the Download icon. Edit the file and upload the modified file as described above.
Info Upon subsequent downloads of the _data.properties file you may notice a) a timestamp on line 1, b) certain characters escaped with \, and c) some lines reordered from the way you originally entered them. This is expected and does not cause any problems in the function of the file.
You will see the message "Properties were successfully updated." when the _data.properties file has been successfully uploaded to frevvo.
Info |
---|
Parameters defined in the _data.properties file can be retrieved using _data.getParameter in rules. Dynamic Labels, Help or Hints is an example showing how you can set the value of control labels, help and hints dynamically in a rule. |
...
- From the Tenant Admin Homepage, click Manage Tenant _data.
- Click the Download icon. This will download an empty _data.properties file.
Add your global data to the _data.properties file. Save the file.
Code Block title Example syntax for _data.properties file: dbUrl=http://localhost:8080/database/listManagers ManagerName=Joe
- Return to the Manage Tenant _data page. Click Choose File.
- Locate your newly created _data.properties file.
- Click Upload.
For subsequent edits of the _data.properties file, simply download the _data.properties file previously uploaded by clicking on the Download icon. Edit the file and upload the modified file as described above.
Info Upon subsequent downloads of the _data.properties file you may notice a) a timestamp on line 1, b) certain characters escaped with \, and c) some lines reordered from the way you originally entered them. This is expected and does not cause any problems in the function of the file.
...
You will see the message "Properties were successfully updated." when the _data.properties file has been successfully uploaded to frevvo.
Info |
---|
Parameters defined in the _data.properties file can be retrieved using _data.getParameter in rules. Dynamic Labels, Help or Hints is an example showing how you can set the value of control labels, help and hints dynamically in a rule. |
...
As mentioned above, you can write the URL using a template such as {dbURLl}/database/listManagers. Then define the variable dbURL for the development, UAT and Production environments in the properties file you are using.
Valid Properties Files
Property names must start with one of these characters: a-zA-Z0-9_.$
Attempting to upload a file with invalid property names will produce an error.