Purpose

This guidance shows how the "metadata" requirements found in the SWIM Information Definition Specification can be satisfied using the structures found in the XML Schema Definition language and based on common metadata standards.

The guidance applies to:

1 Purpose
2 Different approaches
- 2.1 DCAT 2 vocabulary
- 2.2 Use ISO 19115:2003 metadata fields
3 Examples

Different approaches

Two ways to record the information required by the specification are detailed.

Using DCAT 2 vocabulary
Using ISO 190115:2003 metadata fields

Both have their advantages and disadvantages. However, both options need to be supported at the present time.

DCAT 2 is focused on catalogue entries and so is a good fit for the needs of the specification. However, it has not been widely adopted in ATM at the time of writing.
ISO 19115:2003 is used in many information exchange models within ATM such as AIXM 5.1.1. It is also mentioned in various ICAO SARPS such as Annex 15. For this reason, it is the metadata standard imported into the AIRM. However, it is focused on resources of a geographical nature and can be seen as too comprehensive for the limited needs of the specification.

DCAT 2 vocabulary

The diagram below shows the metadata fields supported by the W3C Data Catalog Vocabulary (V2).

If we treat an information definition as a "cataloged resource" we get the following mapping.

Requirement number	Field requested by the specification	DCAT field	DCAT definition	Notes

Requirement number	Field requested by the specification	DCAT field	DCAT definition	Notes
SWIM-INFO-002 Information definition language	language	dct:language	A language of the item. This refers to the natural language used for textual metadata (i.e. titles, descriptions, etc) of a cataloged resource (i.e. dataset or service) or the textual values of a dataset distribution
SWIM-INFO-003 Information definition identification	a title by which it is known	dct:title	A name given to the item.
	an edition	dct:identifier	A unique identifier of the item	The edition (or version) should be expressed as to form a unique identifier in the context of the item
	a reference date for use in citing the information definition	dct:issued	Date of formal issuance (e.g., publication) of the item.
SWIM-INFO-004 Information definition responsible party	the name of the responsible organisation or person	dcat:contactPoint vcard:organization-name or vcard:hasOrganizationName vcard:fn or vcard:hasFN (for Person)	Relevant contact information for the cataloged resource. Use of vCard is recommended To specify the organizational name associated with the object	Use the vCard properties directly
	the contact information of the responsible party	vcard:hasAddress vcard:hasEmail vcard:hasTelephone	To specify the telephone, physical,and electronic mail address for communication with the object
	the role played by the responsible party	vcard:hasRole	To specify the function or part played in a particular situation by the object
SWIM-INFO-005 Information definition scope	a textual description of the scope of the information it covers	dct:description	A free-text account of the item.

Use ISO 19115:2003 metadata fields

The diagram below shows some relevant metadata fields as found is ISO 19115:2003. A mapping of the fields to the language of the specification is then included.

ISO 19115 - MD_Identification

Requirement number	Field requested by the specification	ISO 19115 field Note: the full path to the field is given as the same name is often used in different places.	ISO 19115 definition	Notes

Requirement number	Field requested by the specification	ISO 19115 field Note: the full path to the field is given as the same name is often used in different places.	ISO 19115 definition	Notes
SWIM-INFO-002 Information definition language	language	MD_Metadata.identificationInfo.MD_DataIdentification.language	language(s) used within the dataset	This does not appear in the latest version of ISO 19115.
SWIM-INFO-003 Information definition identification	a title by which it is known	MD_Metadata.identificationInfo.MD_DataIdentification.citation.CI_Citation.title	name by which the cited resource is known
	an edition	MD_Metadata.identificationInfo.MD_DataIdentification.citation.CI_Citation.edition	version of the cited resource
	a reference date for use in citing the information definition	MD_Metadata.identificationInfo.MD_DataIdentification.citation.CI_Citation.date	reference date for the cited resource
SWIM-INFO-004 Information definition responsible party	the name of the responsible organisation or person	MD_Metadata.identificationInfo.MD_DataIdentification.pointOfContact.CI_ResponsibleParty.individualName MD_Metadata.identificationInfo.MD_DataIdentification.pointOfContact.CI_ResponsibleParty.organisationName	name of the responsible person surname, given name, title separated by a delimiter name of the responsible organization	Slightly differently modelled in the latest version of ISO 19115.
	the contact information of the responsible party	MD_Metadata.identificationInfo.MD_DataIdentification.pointOfContact.CI_ResponsibleParty.contactInfo	address of the responsible party	How much detail is required here as ISO has lots of sub-fields
	the role played by the responsible party	MD_Metadata.identificationInfo.MD_DataIdentification.pointOfContact.CI_ResponsibleParty.role	function performed by the responsible party	ISO has a codelist
SWIM-INFO-005 Information definition scope	a textual description of the scope of the information it covers	MD_Metadata.identificationInfo.MD_DataIdentification.citation.CI_Citation.abstract	brief narrative summary of the content of the resource(s)

Examples

The following table gives examples on how to fulfill the requirements using DCAT v2 and ISO 19115.

Requirement	DCAT 2 example	ISO 19115 example
SWIM-INFO-002 Information definition language	^{<xs:annotation> <xs:documentation>} ^{<dct:language>en-GB</dct:language>} ^{</xs:documentation> </xs:annotation>}	^{<xs:annotation> <xs:documentation>} ^{<language>en-GB</language>} ^{</xs:documentation> </xs:annotation>}
SWIM-INFO-003 Information definition identification	^{<xs:annotation> <xs:documentation> <identification> <dct:title>Donlon TOBT Setting Service Information Definition</dct:title> <dct:identifier>0.93</dct:identifier> <dct:issued>2018-10-17</dct:issued> </identification> </xs:documentation> </xs:annotation>}	^{<xs:annotation> <xs:documentation> <identification> <title>Donlon TOBT Setting Service Information Definition</title> <edition>0.93</edition> <date>2018-10-17</date> </identification> </xs:documentation> </xs:annotation>}
SWIM-INFO-004 Information definition responsible party	^{<xs:annotation>} ^{<xs:documentation>} ^{<responsibleParty>} ^{<vcard:hasOrganizationName>Donlon Airport Operator</vcard:hasOrganizationName>} ^{<vcard:hasEmail>service@donlon/vcard:hasEmail>} ^{<vcard:hasRole>author</vcard:hasRole>} ^{</responsibleParty>} ^{</xs:documentation>} ^{</xs:annotation>}	^{<xs:annotation>} ^{<xs:documentation>} ^{<responsibleParty>} ^{<organisationName>Donlon Airport Operator</organisationName>} ^{<contactInfo>service@donlon</contactInfo>} ^{<role>author</role>} ^{</responsibleParty>} ^{</xs:documentation>} ^{</xs:annotation>}
SWIM-INFO-005 Information definition scope	^{<xs:annotation>} ^{<xs:documentation>} ^{<dct:description>Information in support of the Donlon TOBT Setting Service.</dct:description>} ^{</xs:documentation>} ^{</xs:annotation>}	^{<xs:annotation>} ^{<xs:documentation>} ^{<abstract>Information in support of the Donlon TOBT Setting Service.</abstract>} ^{</xs:documentation>} ^{</xs:annotation>}

SWIM Supporting Material

Recording metadata required by the specification

Purpose

Different approaches

DCAT 2 vocabulary

Use ISO 19115:2003 metadata fields

Examples

Related content