The New Document Dialog

Oxygen XML Developer supports many document types. This dialog presents the default associations between a file extension and the type of editor which opens the file for editing. You can override these default associations in the File Types user preferences panel.

  1. Select File > New (Ctrl+N) or press the New toolbar button. The New dialog is displayed. The supported document types are grouped into several categories:
    • Recently used - contains the list of most recently used files;
    • New Document - contains the list of supported document types (including, among others, XML, XSL, XML Schema, Document Type Definition, Relax NG Schema, XQuery, Web Services Definition Language, Schematron Schema, CSS File, Text File, PHP File, JavaScript File , Java File, C File, C++ File, Batch File, Shell File, Properties File, SQL File, XML Catalog, and PERL File).
    • Global templates - contains the list of predefined templates as well as templates defined in the Document Templates preferences page.
    • Framework templates - contains the list of templates defined in the Document Type Association preferences page, Templates tab.
  2. Select a document type.
  3. Click one of the following:
    • Customize - Action available only for XML, XML Schema, Schematron, and XSL file types. Depending on the document type, different properties can be set before creating the file.
    • Create - Uses default settings to create a file.

    If Create was clicked, the new file is created and opened in the editor view.

  4. If Customize was clicked, the following dialog is opened. Depending on the selected document type, different properties can be set:
    • New XML Document Dialog

      • Schema URL - Path to the schema file. When a file is selected, Oxygen XML Developer analyzes its content and tries to fill-in the rest of the dialog;
      • Schema type - The following options are available: XML Schema, DTD, RelaxNG XML syntax, RelaxNG compact syntax, and NVDL;
      • Public ID - Specifies the PUBLIC identifier declared in the document prolog;
      • Namespace - The document namespace;
      • Prefix - The prefix for the namespace of the document root;
      • Root Element - Populated with elements defined in the specified schema, enables selection of the element to be used as document root;
      • Description - Shows a small description of the selected document root;
      • Add optional content - When selected, the elements and attributes that are defined in the XML Schema as optional, are generated in the skeleton XML document;
      • Add first Choice particle - When selected, the first element of an xs:choice schema element is generated in the skeleton XML document created in a new editor panel when the OK button is pressed.
    • New XSL Document Dialog

      • Stylesheet version - Stylesheet version number. Possible options: 1.0 and 2.0;
      • Add documentation annotations - Generates the stylesheet documentation.
    • New XML Schema Document Dialog

      • Target namespace - Specifies the schema target namespace;
      • Namespace prefix declaration table - Contains namespace prefix declarations. Table information can be managed using the (New) and (Delete) buttons.
    • New Schematron Document Dialog

      • Schematron version - Specifies the Schematron version. Possible options: 1.5 and ISO.
  5. Press Create to create the file.