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.

Recommended Sub-Elements

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

title - (type - charStr)[1..1] mandatory - name by which the cited resource is known
date - (class - CI_Date) [0..*] reference date for the cited resource. Should include at a minimum, the creation date for the resource.
edition - (type - charStr) [0..1] version of the cited resource if appropriate
identifier - (class - MD_Identifier) [0..*] value uniquely identifying an object within a namespace. Recommend provision of a resolvable URI following the MD_Identifier guidance.
citedResponsibleParty - (class - CI_Responsibility)[0..*] roles, name, contact, and position information for an individual or organisation that is responsible for the resource. It is recommended that a party with the role “Point of Contact” be provided as well as an entry for “author” or “publisher”.
series - (class - CI_Series) [0..1] If needed, information about the series, or aggregate resource, of which the resource is a part should be included.
onlineResource - class - CI_OnlineResource [0..*] Highly Recommended for Service Resources. Should contain the URL Link for the landing page of the service. May also be recorded in DistributionInfo or ResourceIdentifier

Other Sub-Elements

alternateTitle - (type - charStr) [0..*] short name or other language name by which the cited service is known, e.g. DCW as an alternative title for Digital Chart of the World. Recommended whenever there are alternate names commonly in use
series - (class - CI_Series) [0..1] If needed, information about the series, or aggregate resource, of which the resource is a part should be included

Also Consider

DistributionInfo - can contain information about how the resource is distributed. like onlineResource should contain landing page linkages to the resource but can also store additional information
metadataLinkage - for links that provide a download of the metadata
browseGraphic - associates to a large number of packages to provide linkage to associated image files, such as business or product icons and logos
ContainsOperations - for service resources, this element can provide online access instructions
CI_Citation - the class guidance for more options.

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