Oxygen XML Editor
Oxygen XML Editor is a cross platform xml editor. Oxygen provides a robust environment for editing ISO 19139 metadata in XML format. The purpose of this page is to share metadata authoring work flow and user tips in this environment. (To learn more or download a trial version go to http://www.oxygenxml.com.)
- Licensing Method: Use a license server
Set Up Oxygen
- Options Tab > Preferences > Content Completion
- Check the following
- Add Element Content to automatically add required content for any element
- Add Optional Content to automatically add optional content for any element. This can be very helpful at the beginning as you become familiar with the standard but as you gain experience you may want to turn it off.
- Show all entities
- Insert the required attributes - there are only a few required attributes in the ISO standards so this one will seem not to make a difference in most cases.
- You can import folders from the desktop or add individual files by creating a Project. Here you can easily organize and edit multiple files.
- Taking advantage of the Outline panel makes it easy to navigate a potentially large file and can help you get to know an unfamiliar standard.
- Click on: Document > Schema > Associate Schema...
- Under the XML Schema tab, enter the URL: http://www.ngdc.noaa.gov/metadata/published/xsd/schema.xsd
- You can associate Schematron schemas as well, by entering the URL: http://www.ngdc.noaa.gov/metadata/published/xsd/schematron/schematronISO.sch under the Schematron Schema tab.
- ISO Namespaces - One of the first things you need to do is make sure that the metadata is properly attributed with ISO namespace declarations and schema location.
- ISO Object Ordering - Ordering of ISO objects
- ISO Boilerplate- ISO Boilerplate
- 19139 Schema URL- supports 19115, 19115-2, 19119 standards
- 19139 Schema ZIP - for download
- Schematron URL - validation support not available in the basic XSD Schema validation
- How to add template text
- How to Import Codelist URLs
- How to Edit Multiple Files
- Stack Overflow Error
- How to create sample XML
Oxygen in a Documentation Workflow
A number of metadata managers at NGDC are using Oxygen as their primary metadata creation and maintenance tool in the context of a larger documentation management architecture. Any full featured XML editor could fit into this architecture in the same slot as Oxygen. The expected workflow is:
- Authors edit and validate ISO Metadata using a desktop XML editor (Oxygen)
- Save metadata files from Oxygen to a version control system (Subversion). These files may contain xlinks to metadata components and are therefore called "unresolved" records.
- These files are automatically checked out from Subversion to a Web Accessible Folder (WAF).
- The xlinks in the unresolved files are automatically resolved and the complete files are checked in to a second version control system.
- The complete records are checked out from Subversion to a resolved/published WAF.
- Metadata are harvested to discovery sites.