XML format for dataset descriptions

See also How to manage different input metadata formats?

For each dataset we will need two XML files:

In addition to an XML file containing the metadata (in one of several possible formats), we will need an XML file that describes identification etc. for the dataset.

Such XML files will be given an “.xmd” extention, and have a format like this:

<dataset xmlns="" ...>                       // Ref. to XML namespace etc.
   <info status="..."                        // Value: active/deleted 
         ownertag="..."
         creationDate="..."                  // YYYY-MM-DDZHH:TT
         metadataFormat="..."                // Example: DIF, MM2
         name="..." />                       // Unique identification
   <quadtree>
      ...
   </quadtree> 
</dataset>

• exampledataset.xmd
• Schema
• Stylesheet

The XML files containing metadata are of varying formats. They will all be given an “.xml” extention.

One of these formats are defined by METAMOD2, and is only used as an internal format within the METAMOD2 system. This format (MM2) is for metadata produced by the UPLOAD module or the QUEST module:

   <MM2 xmlns="" ...>                              // Ref. to XML namespace etc. (if needed)
         <metadata name="...">value</metadata>     // To be repeated. One element
                                                   // for each name,value pair.
   </MM2>

• examplemm2.xml
• Schema
• Stylesheet

Both metadata files should always be written as an atomic operation. To support this, flock should be used for reading and writing to the file-system. flock should first lock the .xmd file, then the .xml file. Then, both files should be written. Afterwards, unlock first the .xml file, then the .xmd file. Not using this order might lead to a deadlock.