Personal tools

Skip to content. | Skip to navigation

 
You are here:
We are in the process of updating this content to reflect changes to the latest release of AKOMA NTOSO!!!
Document Actions

Metadata Conventions

Note: Return to reference manual view.

1. Naming Convention

to identify metadata unambiguously without name clashes

A mechanism is needed to ensure that metadata belonging to the core set can be identified unambiguously and that proprietary metadata can be added to the various AKOMA NTOSO document models without name clashes.

Metadata names are constructed using a prefix pointing to the country codes of the relevant emanating body (such as the Parliament). It is assumed that name clashes in metadata items within a single country are resolved before being committed to actual AKOMA NTOSO documents.

AKOMA NTOSO assumes the following conventions regarding metadata items:

  • Items without prefixes belong to the core set of metadata elements and are available to all emanating bodies in their explicitly stated meaning.
  • Items with a given country prefix are local to a specific country and are not to be used outside of documents coming from that country.Applications receiving documents that contain metadata elements with unknown prefix CAN take no further actions on them, but MUST preserve them when delivering the documents to other applications down the line. 
  • Items within the AKOMA-NTOSO namespace are to be considered as local but are scoped to the whole AKOMA NTOSO framework, rather that to an individual country. A central repository and registry of metadata names belonging to the AKOMA-NTOSO prefix will be kept to which any individual emanating body can contribute. The registry will make sure that no name clashes exist in AKOMA NTOSO scoped local extensions.

For more information see Naming Conventions

2. Eurovoc-Africa metadata

the provider of values for a number of metadata items

The Eurovoc thesaurus (or, better yet, an African-scoped version of Eurovoc) is explicitly supported as the provider of values for a number of metadata items, most notably the subject descriptor (metadata name: keyword).

<meta>
    ...
    <keywords dictionary=”Eurovoc”>
        <keyword value=”Community programme”/>
        <keyword value=”Internet”/>
        <keyword value=”information technology”/>
        <keyword value=”new technology”/>
        <keyword value=”data protection”/>
    </keywords>
    ...
</meta>

The value “Afrivoc”, as value for the vocabulary attribute, is reserved for possible use with a pan-African variant on Eurovoc-Africa, the details of which are still under discussion. It may not be necessary to use this extra name if the African customisations of Eurovoc-Africa can be achieved within the existing Eurovoc-Africa extension mechanisms.

 

3. Other Metadata Initiatives

identification of semantic equivalences

AKOMA NTOSO strongly encourages the identification of semantic equivalences between AKOMA NTOSO metadata and well-known  international metadata initiatives. Among them a strong importance is in providing equivalences between AKOMA NTOSO and IFLA FRBR, Dublin Core (http://dublincore.org/) and FOAF (http://xmlns.com/foaf/0.1/).

The central repository of the AKOMA NTOSO metadata initiative provides a direct conversion mapping between all relevant AKOMA NTOSO metadata and other metadata initiatives (whenever appropriate). In particular, all AKOMA NTOSO required and optional items are mapped, whenever appropriate, to specific Dublin Core and FOAF properties. The central repository will also require that all local extensions (either belonging to the AKOMA-NTOSO prefix or not) are explicitly associated to a Dublin Core or FOAF property whenever appropriate.