Creating and Working with Documents / Creating New Documents
Parent topic: Creating New Documents Previous topic: Creating New Documents Next topic: Creating New Documents Based on Templates

Oxygen XML Developer plugin New Document Wizard

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 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 > Oxygen XML Developer plugin or click the New button on the toolbar.
    The New file wizard is displayed.
  2. Select a document type. You can also select New from Templates to create a document based upon predefined templates or custom templates.
  3. 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.

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

    Figure: New XML Document Dialog Box

    • 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 - 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 Finish.

    Figure: 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 - Specifies whether or not you want to open the newly created file in the editor.

    Figure: New XML Schema Document (XSD) Dialog Box

    • Default XML Schema version - Uses the XML Schema version defined in the XML Schema preferences page.
    • XML Schema 1.0 - Sets the minVersion attribute to 1.0 and the maxVersion attribute to 1.1.
    • XML Schema 1.1 - Sets the minVersion attribute to 1.1.
    • 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.
      Tip: For further details on how you can set the version of an XML Schema, go to Setting the XML Schema Version.

    Figure: New Schematron Document Dialog Box

    • Schematron version - Specifies the Schematron version. Possible options: 1.5 and ISO.
    • Open file for editing when done - Specifies whether or not you want to open the file for editing purposes.
Parent topic: Creating New Documents Previous topic: Creating New Documents Next topic: Creating New Documents Based on Templates
WebHelp output generated by XML Author