ICSM ISO19115-1 Metadata Best Practice Guide

Resource Citation ★★★★★

Some of the most basic needs of users of a resource is citation information. This basic information includes title, edition, identifier, dates, responsible parties, etc. In ISO 19115-1 we capture this information in MD_identification.citation.

   
Element Name citation
Parent MD_Metadata.identificationInfo>MD_Identification
Class/Type CI_Citation
Governance Common ICSM, Agency, Domain
Purpose Discovery, Identification
Audience machine resource - ⭑ ⭑ ⭑
  general - ⭑ ⭑ ⭑ ⭑ ⭑
  resource manager - ⭑ ⭑ ⭑ ⭑
  specialist - ⭑ ⭑ ⭑
Metadata type descriptive
ICSM Level of Agreement ⭑ ⭑ ⭑ ⭑

Definition

Citation information for the spatial resource.

ISO Obligation

There must be one and only one [1..1] MD_Metadata.identificationInfo>MD_Identification.citation package for the cited resource in a metadata record. This must be of class CI_Citation. The resource may be of type data MD_DataIdentification or of type service SV_ServiceIdentification.

Discussion

The citation package contains multiple elements from CI_Citation. Only child elements contain content. Follow the links on the child elements recommendations for further instruction. Aspects of the contents of this package may be governed at different levels.

ICSM Best Practice Recommendations

Therefore - for potential users to find and identify spatial resources, these must be well-cited with information that includes a minimum of title, identifier, date (of type creation, plus revision and issued when appropriate) and citedResponsibleParty (for author or creator, plus publisher and contributor when appropriate).

Because many of the elements of MD_Identification.citation are mandatory and are important for identification and harvesting of metadata, it is recommended that the guidance provided in each of these six sub-elements (title, date, edition, identifier, citedResponsibleParty, and series) be followed. Other available CI_Citation elements should be used if needed to properly document your resource. Consult your metadata governance team on such use.

This element should be populated in all service metadata records.

Follow the general guidance for CI_Citation with emphasis on the following elements:

Other Sub-Elements

Also Consider

Outstanding Issues

CORE ISSUE:
Core to any metadata record is access to the described resource. There are several options where this may be expressed in an ISO19115-1 metadata record. The MDWG has not agreed to a consistent approach. Inside the resource citation package, the identifier and onlineResource may provide this functionality. The package DistributionInfo is, of course, a common way to capture such information - particularly for data resources. For service resources ContainsOperations is another common location for resource access information. Further discussion and guidance are needed to resolve this issue to support machine readability and reduce confusion.

Examples

\pagebreak

XML

Data Resource example

<mdb:MD_Metadata>
....
 <mdb:identificationInfo>
  <mri:MD_DataIdentification>
  ....
    <mri:citation>
     <cit:CI_Citation>
       <cit:title>
        <gco:CharacterString>OpenWork geographical data
        </gco:CharacterString>
       </cit:title>
       <cit:date>
        <cit:CI_Date>
          <cit:date>
           <gco:Date>2019-07-18</gco:Date>
          </cit:date>
          <cit:dateType>
           <cit:CI_DateTypeCode 
           codeList="https://schemas.isotc211.org/19115/resources
           /Codelist/cat/codelists.xml#CI_DateTypeCode" 
           codeListValue="creation"/>
          </cit:dateType>
        </cit:CI_Date>
       </cit:date>
       <cit:date>
        <cit:CI_Date>
          <cit:date>
           <gco:Date>2019-07-18</gco:Date>
          </cit:date>
          <cit:dateType>
           <cit:CI_DateTypeCode 
           codeList="https://schemas.isotc211.org/19115/resources
           /Codelist/cat/codelists.xml#CI_DateTypeCode" 
           codeListValue="publication"/>
          </cit:dateType>
        </cit:CI_Date>
       </cit:date>
       <cit:edition>
        <gco:CharacterString>Version 0.1</gco:CharacterString>
       </cit:edition>
       <cit:editionDate>
        <gco:Date>2019-07-18</gco:Date>
       </cit:editionDate>
       <cit:identifier>
        <mcc:MD_Identifier>
          <mcc:code>
           <gco:CharacterString>
           9547e07e-6a15-403b-8b19-488778fe0cf0
           </gco:CharacterString>
          </mcc:code>
          <mcc:codeSpace>
           <gco:CharacterString>
           http://202.49.243.69:8080/geonetwork/srv/eng/metadata/
           </gco:CharacterString>
          </mcc:codeSpace>
        </mcc:MD_Identifier>
       </cit:identifier>
       <cit:citedResponsibleParty>
        <cit:CI_Responsibility>
          <cit:role>
           <cit:CI_RoleCode 
           codeList="https://schemas.isotc211.org/19115/resources
           /Codelist/cat/codelists.xml#CI_RoleCode" 
           codeListValue="author"/>
          </cit:role>
          <cit:party>
           <cit:CI_Organisation>
             <cit:name>
              <gco:CharacterString>OpenWork Ltd
              </gco:CharacterString>
             </cit:name>
             <cit:contactInfo>
              <cit:CI_Contact>
                <cit:address>
                 <cit:CI_Address>
                   <cit:electronicMailAddress>
                    <gco:CharacterString>info@openwork.nz
                    </gco:CharacterString>
                   </cit:electronicMailAddress>
                 </cit:CI_Address>
                </cit:address>
              </cit:CI_Contact>
             </cit:contactInfo>
           </cit:CI_Organisation>
          </cit:party>
        </cit:CI_Responsibility>
       </cit:citedResponsibleParty>
       <cit:citedResponsibleParty>
        <cit:CI_Responsibility>
          <cit:role>
           <cit:CI_RoleCode 
           codeList="https://schemas.isotc211.org/19115/resources
           /Codelist/cat/codelists.xml#CI_RoleCode" 
           codeListValue="publisher"/>
          </cit:role>
          <cit:party>
           <cit:CI_Individual>
             <cit:name>
              <gco:CharacterString>Byron Cochrane
              </gco:CharacterString>
             </cit:name>
             <cit:contactInfo>
              <cit:CI_Contact>
                <cit:address>
                 <cit:CI_Address>
                   <cit:electronicMailAddress>
                    <gco:CharacterString>byron@openwork.nz
                    </gco:CharacterString>
                   </cit:electronicMailAddress>
                 </cit:CI_Address>
                </cit:address>
              </cit:CI_Contact>
             </cit:contactInfo>
           </cit:CI_Individual>
          </cit:party>
        </cit:CI_Responsibility>
       </cit:citedResponsibleParty>
     </cit:CI_Citation>
    </mri:citation>
   ....
  </mri:MD_DataIdentification>
 </mdb:identificationInfo>
....
</mdb:MD_Metadata>

Service Resource example

<mdb:MD_Metadata>
....
 <mdb:identificationInfo>
   <srv:SV_ServiceIdentification>
     <mri:citation>
      <cit:CI_Citation>
        <cit:title>
         <gco:CharacterString>Sample service metadata 2020-05-28</gco:CharacterString>
        </cit:title>
        <cit:date>
         <cit:CI_Date>
           <cit:date>
            <gco:DateTime>2019-09-01T00:00:00</gco:DateTime>
           </cit:date>
           <cit:dateType>
            <cit:CI_DateTypeCode codeList="http://standards.iso.org/iso/19115/resources/Codelists/cat/codelists.xml#CI_DateTypeCode"
                       codeListValue="creation"/>
           </cit:dateType>
         </cit:CI_Date>
        </cit:date>
        <cit:date>
         <cit:CI_Date>
           <cit:date>
            <gco:DateTime>2019-12-01T00:00:00</gco:DateTime>
           </cit:date>
           <cit:dateType>
            <cit:CI_DateTypeCode codeList="http://standards.iso.org/iso/19115/resources/Codelists/cat/codelists.xml#CI_DateTypeCode"
                       codeListValue="revision"/>
           </cit:dateType>
         </cit:CI_Date>
        </cit:date>
        <cit:edition>
         <gco:CharacterString>2nd Revision</gco:CharacterString>
        </cit:edition>
        <cit:editionDate>
         <gco:DateTime>2019-12-01T00:00:00</gco:DateTime>
        </cit:editionDate>
        <cit:identifier>
         <mcc:MD_Identifier>
           <mcc:code>
            <gcx:Anchor xlink:href="https://my.webite.io/cgi-bin/wfs-map-site" xlink:type="simple">https://my.webite.io/cgi-bin/wfs-map-site</gcx:Anchor>
           </mcc:code>
         </mcc:MD_Identifier>
        </cit:identifier>
        <cit:citedResponsibleParty>
         <cit:CI_Responsibility>
           <cit:role>
            <cit:CI_RoleCode codeList="http://standards.iso.org/iso/19115/resources/Codelists/cat/codelists.xml#CI_RoleCode"
                     codeListValue="contributor"/>
           </cit:role>
           <cit:party>
            <cit:CI_Organisation>
              <cit:name>
               <gco:CharacterString>OpenWork Ltd</gco:CharacterString>
              </cit:name>
              <cit:contactInfo>
               <cit:CI_Contact>
                 <cit:address>
                  <cit:CI_Address>
                    <cit:electronicMailAddress>
                     <gco:CharacterString>info@openwork.nz</gco:CharacterString>
                    </cit:electronicMailAddress>
                  </cit:CI_Address>
                 </cit:address>
               </cit:CI_Contact>
              </cit:contactInfo>
            </cit:CI_Organisation>
           </cit:party>
         </cit:CI_Responsibility>
        </cit:citedResponsibleParty>
        <cit:citedResponsibleParty>
         <cit:CI_Responsibility>
           <cit:role>
            <cit:CI_RoleCode codeList="http://standards.iso.org/iso/19115/resources/Codelists/cat/codelists.xml#CI_RoleCode"
                     codeListValue="publisher"/>
           </cit:role>
           <cit:party>
            <cit:CI_Organisation>
              <cit:name>
               <gco:CharacterString>ICSM MDWG</gco:CharacterString>
              </cit:name>
              <cit:contactInfo>
               <cit:CI_Contact>
                 <cit:address>
                  <cit:CI_Address>
                    <cit:electronicMailAddress>
                     <gco:CharacterString>mdwg@icsm-au.org</gco:CharacterString>
                    </cit:electronicMailAddress>
                  </cit:CI_Address>
                 </cit:address>
               </cit:CI_Contact>
              </cit:contactInfo>
            </cit:CI_Organisation>
           </cit:party>
         </cit:CI_Responsibility>
        </cit:citedResponsibleParty>
        <cit:onlineResource>
         <cit:CI_OnlineResource>
           <cit:linkage>
            <gco:CharacterString>https://my.webite.io/</gco:CharacterString>
           </cit:linkage>
           <cit:protocol gco:nilReason="missing">
            <gco:CharacterString/>
           </cit:protocol>
           <cit:name>
            <gco:CharacterString>OWL WFS Sample site</gco:CharacterString>
           </cit:name>
           <cit:description>
            <gco:CharacterString>Landing page for Spatial Service</gco:CharacterString>
           </cit:description>
           <cit:function>
            <cit:CI_OnLineFunctionCode codeList="http://standards.iso.org/iso/19115/resources/Codelists/cat/codelists.xml#CI_OnLineFunctionCode"
                          codeListValue=""/>
           </cit:function>
         </cit:CI_OnlineResource>
        </cit:onlineResource>
      </cit:CI_Citation>
     </mri:citation>
     ....
  </mri:SV_ServiceIdentification>
 </mdb:identificationInfo>
....
</mdb:MD_Metadata>

\pagebreak

UML diagrams

Recommended elements highlighted in yellow

ResourceCitation

\pagebreak