Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • file
    The XML file path to read from.
  • type := "options" | "ini" | "xml" (optional, defaults to "options")
    The file type, must be "XMLxml" to assume a XML file.
  • key
    The XPath path to the entry to read the value for.
    Note: Currently, the XPath language revision depends on the JRE version the installer runs on. JRE 6/7 support XPath 1.0.

Example:

Code Block
titleDynamic variable assignment from XML file contents
langxml
<dynamicvariables>

    <variable name="XMLReadTest.1" checkonce="true" ignorefailure="false"
              file="${INSTALL_PATH}/../old_installation/test.xml" type="xml"
              key="/installations/installation[path='/usr/local']/title[@lang='en']/text()"/>

    <variable name="XMLReadTest.2" checkonce="true" ignorefailure="false"
              file="${INSTALL_PATH}/../old_installation/test.xml" type="xml"
              key="//title[@lang='en']/text()"/>

</dynamicvariables>

...

  • jarfile
    The jar file path to read from.
  • zipfile
    The zip file path to read from.
  • type := "options" | "ini" | "xml" (optional, defaults to "options")
    The archived file's type.
  • section
    The INI section to lookup the entry in, is evaluated only if type = "ini".
  • key
    The INI, option or property entry key to read the value for.
  • escape := "true" | "false" (optional: defaults to "true")
    Whether to apply escape sequences escaped by backslashes, like defined for Java properties files.
    Set "false" especially if you want to read values with backslashes where backslashes are not assumed to introduce escape sequences, like Windows paths.

Example:

Code Block
titleAssigning a dynamic variable from an configuration entry in a JAR/ZIP file
langxml
<dynamicvariables>

    <variable name="previous.version" jarfile="${INSTALL_PATH}/${INSTALL_SUBPATH}/libs/config.jar"
              entry="release.properties" type="options"
              key="release.version"
              checkonce="false" ignorefailure="true">
    </variable>

    <variable name="other.stuff" zipfile="${INSTALL_PATH}/${INSTALL_SUBPATH}/libs/misc.zip"
              entry="app.ini" type="ini"
              section="Global Settings" key="AUTOSTART"
              checkonce="true" ignorefailure="true">
    </variable>

</dynamicvariables>

...