17.3 The info.xml file

This file contains general information about a metadata. It must have an info root element with a mandatory version attribute. This attribute must be in the X.Y form, where X represents the major version and Y the minor one. The purpose of this attribute is to allow future changes of this format maintaining compatibility with older readers. The policy behind the version is this:

  1. A change to Y means a minor change. All existing elements in the previous version must be left unchanged: only new elements or attributes may be added. A reader capable of reading version X.Y is also capable of reading version X.Y’ with Y’>Y.

  2. A change to X means a major change. Usually, a reader of version X.Y is not able to read version X’.Y with X’>X.

The root element must have the following children:

  1. general : a container for general information. It must have the following children:

    1. uuid : this is the universally unique identifier assigned to the metadata and must be a valid uuid. This element is optional and, when omitted, the reader should generate one. A metadata without a uuid can be imported several times into the same system without breaking uniqueness constraints. When missing, the reader should also generate the siteId value.

    2. createDate : This date indicates when the metadata was created.

    3. changeDate : This date keeps track of the most recent change to the metadata.

    4. siteId : This is an uuid that identifies the actor that created the metadata and must be a valid uuid. When the uuid element is missing, this element should be missing too. If present, it will be ignored.

    5. siteName : This is a human readable name for the actor that created the metadata. It must be present only if the siteId is present.

    6. schema : Indicates the metadata’s schema. The value can be assigned as will but if the schema is one of those describe below, that value must be used:

      1. dublin-core : A metadata in the dublin core format as described in http://dublincore.org

      2. fgdc-std : A metadata in the Federal Geographic Data Committee.

      3. iso19115 : A metadata in the ISO 19115 format

      4. iso19139 : A metadata in the ISO 19115/2003 format for which the ISO19139 is the XML encoding.

    7. format : Indicates the MEF export format. The element’s value must belong to the following set: { simple, partial, full }.

    8. localId : This is an optional element. If present, indicates the id used locally by the sourceId actor to store the metadata. Its purpose is just to allow the reuse of the same local id when reimporting a metadata.

    9. isTemplate : A boolean field that indicates if this metadata is a template used to create new ones. There is no real distinction between a real metadata and a template but some actors use it to allow fast metadata creation. The value must be: { true, false }.

    10. rating : This is an optional element. If present, indicates the users’ rating of the metadata ranging from 1 (a bad rating) to 5 (an excellent rating). The special value 0 means that the metadata has not been rated yet. Can be used to sort search results.

    11. popularity : Another optional value. If present, indicates the popularity of the metadata. The value must be positive and high values mean high popularity. The criteria used to set the popularity is left to the writer. Its main purpose is to provide a metadata ordering during a search.

  2. categories : a container for categories associated to this metadata. A category is just a name, like ’audio-video’ that classifies the metadata to allow an easy search. Each category is specified by a category element which must have a name attribute. This attribute is used to store the category’s name. If there are no categories, the categories element will be empty.

  3. privileges : a container for privileges associated to this metadata. Privileges are operations that a group (which represents a set of users) can do on a metadata and are specified by a set of group elements. Each one of these, has a mandatory name attribute to store the group’s name and a set of operation elements used to store the operations allowed on the metadata. Each operation element must have a name attribute which value must belong to the following set: { view, download, notify, dynamic, featured }. If there are no groups or the actor does not have the concept of group, the privileges element will be empty. A group element without any operation element must be ignored by readers.

  4. public : All metadata thumbnails (and any other public file) must be listed here. This container contains a file element for each file. Mandatory attributes of this element are name, which represents the file’s name and changeDate, which contains the date of the latest change to the file. The public element is optional but, if present, must contain all the files present in the metadata’s public directory and any reader that imports these files must set the latest change date on these using the provided ones. The purpose of this element is to provide more information in the case the MEF format is used for metadata harvesting.

  5. private : This element has the same purpose and structure of the public element but is related to maps and all other private files.

Any other element or attribute should be ignored by readers that don’t understand them. This allows actors to add custom attributes or subtrees to the XML.

Figure 17.1, “Example of info file” shows an example of info file.

Date format

Unless differently specified, all dates in this file must be in the ISO/8601 format. The pattern must be YYYY-MM-DDTHH:mm:SS and the timezone should be the local one.

Figure 17.1. Example of info file

<info version="1.0"> 
        <siteName>FAO main site</siteName> 
        <category name="maps"/> 
        <category name="datasets"/> 
        <group name="editors"> 
            <operation name="view"/> 
            <operation name="download"/> 
        <file name="small.png" changeDate="2006-10-07T13:44:32"/> 
        <file name="large.png" changeDate="2006-11-11T09:33:21"/> 
        <file name="map.zip" changeDate="2006-11-12T13:23:01"/> 

Other documents: The complete manual in pdf format | License | Readme | Changes