Oxygen XML Developer plugin Plugin Wizard for New Document

The New Document wizard only creates a skeleton document. It contains the document prolog, a root element, and possibly other child elements depending on the options specific for each schema type. To generate full and valid XML instance documents based on an XML Schema, use the XML instance generation tool.

The Oxygen XML Developer plugin plugin installs a series of Eclipse wizards for easy creation of documents. If you use these wizards, Oxygen XML Developer plugin automatically completes the following details:
  • the system ID, or schema location of a new XML document;
  • the minimal markup of a DocBook article, or the namespace declarations of a Relax NG schema.
  1. To create a document, either select File > New > -> Other (Ctrl+N) > oXygen, or click the New button on the toolbar.
    The New wizard is displayed.
  2. Select a document type.

  1. Click the Next button.

    For example if XML was selected the Create an XML Document wizard is started.

    The Create an XML Document dialog box enables definition of an XML Document Prolog using the system identifier of an XML Schema, DTD, Relax NG (full or compact syntax) schema, or NVDL (Namespace-based Validation Dispatching Language) schema. As not all XML documents are required to have a Prolog, you can choose to skip this step by clicking OK. If the prolog is required, complete the fields as described in the next step.

  2. Type a name for the new document and press the Next button.
  3. If you select Customize, Oxygen XML Developer plugin opens the following dialog box. You can customize different options depending on the document type you select.

    New XML Document Dialog Box

    • Schema URL - specifies the path to the schema file. When you select a file, Oxygen XML Developer plugin analyzes its content and tries to fill the rest of the dialog box;
    • Schema type - allows you to select the 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 - specifies the document namespace;
    • Prefix - specifies the prefix for the namespace of the document root;
    • Root Element - populated with elements defined in the specified schema, enables selection of the element used as document root;
    • Description - shows a small description of the selected document root;
    • Add optional content - if you select this option, the elements, and attributes defined in the XML Schema as optional, are generated in the skeleton XML document;
    • Add first Choice particle - if you select this option, Oxygen XML Developer plugin generates the first element of an xs:choice schema element in the skeleton XML document. Oxygen XML Developer plugin creates this document in a new editor panel when you click OK.

    New XSL Document Dialog Box

    • Stylesheet version - allows you to select the Stylesheet version number. You can select from: 1.0, 2.0, and 3.0;
    • Add documentation annotations - adds annotation for XSL components;
    • Open file for editing when done - when you press Finish, Oxygen XML Developer plugin opens the newly created file.

    New XML Schema Document Dialog Box

    • Target namespace - specifies the schema target namespace;
    • Namespace prefix declaration table - contains namespace prefix declarations. To manage table information, use the New and Delete buttons.

    New Schematron Document Dialog Box

    • Schematron version - specifies the Schematron version. Possible options: 1.5 and ISO.