Customizing Default Options

Oxygen XML Developer has an extensive set of options that you can configure. When Oxygen XML Developer in installed, these options are set to default values. You can provide a different set of default values for an installation using an XML options file.

Creating an XML Options File

To create an options file, follow these steps:

  1. It is recommended that you use a fresh install for this procedure, to make sure that you do not copy personal or local preferences.
  2. Open Oxygen XML Developer and open the Preferences dialog box (OptionsPreferences).
  3. Go through the options and set them to the desired defaults. Make sure that Global Options is selected in each page.
  4. Click OK and close the Preferences dialog box.
  5. Go to OptionsExport Global Options to create an XML options file.

Using Customized Default Options

There are two methods that you can use to configure an Oxygen XML Developer installation to use the customized default options from the created XML options file:

  • Copy the XML Options File to the Installation Directory

    In the [OXYGEN_INSTALL_DIR], create a folder called preferences and copy the created XML options file into it (for example, [OXYGEN_INSTALL_DIR]/preferences/default.xml).

  • Specify a Path to the XML Options File in a Startup Parameter

    Set the path to the XML options file as the value of the com.oxygenxml.default.options system property in the startup parameters. The path can be specified with any of the following:

    • A URL or file path relative to the application installation folder. For example:
      -Dcom.oxygenxml.default.options=options/default.xml
    • A system variable that specifies the file path. For example:
      com.oxygenxml.default.options=${system(CONFIG)}/default.xml
    • An environmental variable that specifies the file path. For example:
      com.oxygenxml.default.options=${env(CONFIG)}/default.xml

    Note

    If you are using the Java Webstart distribution, use the optionsDir property to specify the path of the options file (in this case, the file must be named default.xml), or you can edit the .jnlp file that launches the application and set the com.oxygenxml.default.options parameter using a property element, as in the following example:
     <property name="oxy:com.oxygenxml.default.options" 
               value="http://host/path/to/default.xml"/>

Was this helpful?