Differences
This shows you the differences between two versions of the page.
|
jvx:common:setup:external_config [2018/02/02 12:40] admin created |
jvx:common:setup:external_config [2020/06/15 14:53] (current) cduncan Edited for English grammar (capitalization, punctuation, correct verb conjugation) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ~~NOTRANS~~ | ~~NOTRANS~~ | ||
| - | ~~Title: Include external configuration~~ | + | ~~Title: Include External Configuration~~ |
| Every application has its own application zone with one configuration file. The name of the file is config.xml. This file should contain the whole configuration for your application. | Every application has its own application zone with one configuration file. The name of the file is config.xml. This file should contain the whole configuration for your application. | ||
| - | But sometimes your configuration has external dependencies or you have a different configuration for your test and production system. In that case, it's better to use an external configuration which contains all system dependent properties. Such an external configuration will reduce your deploment/build effort because your config.xml can be the same for every system/server. | + | Sometimes your configuration has external dependencies or you have a different configuration for your test and production system. In that case, it's better to use an external configuration which contains all system dependent properties. Such an external configuration will reduce your deploment/build effort because your config.xml can be the same for every system/server. |
| == Usage == | == Usage == | ||
| Line 44: | Line 44: | ||
| </file> | </file> | ||
| - | As you can see in above example, it's possible to use placeholders for values. The placeholders will be replaced automatically with values, but only if you use an external properties file. If you don't use the include tag, the placeholder replacement won't work! | + | As you can see in above example, it's possible to use placeholders for values. The placeholders will be replaced automatically with values only if you use an external properties file. If you don't use the include tag, the placeholder replacement won't work! |
| - | It's also possible to use system and environment parameters as values, with following prefixes: | + | It's also possible to use system and environment parameters as values with following prefixes: |
| <file script> | <file script> | ||
| Line 89: | Line 89: | ||
| **<fs 20px>Attention</fs>** | **<fs 20px>Attention</fs>** | ||
| - | Be careful, if you try to modify/save an application configuration which contains include tags, it won't work because of external references. It will be possible if you modify the file directly via XmlWorker but not via Zone or UpToDateConfigFile. In that case, an Exception with following message will be thrown: | + | Be careful if you try to modify/save an application configuration that contains include tags. It won't work because of external references. It will be possible if you modify the file directly via XmlWorker but not via Zone or UpToDateConfigFile. In that case, an exception with following message will be thrown: |
| //Couldn't save configuration file! The content was modified by <include> declarations.// | //Couldn't save configuration file! The content was modified by <include> declarations.// | ||