Documenting People and Organizations

From Earth Science Information Partners (ESIP)

Many documentation dialects include mechanisms for connecting people and organizations to metadata records. There are two general approaches to these connections. The first involves including the roles of the people in the names of the metadata elements. For example, the netCDF Attribute Convention for Data Discovery includes fields titled creator_name, creator_email, and creator_url. This approach makes it difficult to standardize because new standard elements must be added in order to add a new role, i.e. processor_name, processor_email, processor_URL.

The second approach centers around a generic description of a person or an organization that includes an attribute that gives the role they play with respect to the resource being documented. This approach allows additions by extending the list of roles. See [[NetCDF,_HDF,_and_ISO_Metadata] for more details on this approach.

People

Connecting people to datasets is an important role of metadata

Crosswalks

Concept Description Paths
Role function performed by the responsible party DIF /dif:DIF/dif:Personnel/dif:Role
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:Role
ISO //gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode
Position Name Name of the job or position in an organization ECHO /Collection/Contacts/Contact/ContactPersons/ContactPerson/JobPosition
ISO //gmd:CI_ResponsibleParty/gmd:positionName/gco:CharacterString
First Name First name of the individual DIF /dif:DIF/dif:Personnel/dif:First_Name
ECHO /Collection/Contacts/Contact/ContactPersons/ContactPerson/FirstName
ISO //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName
Middle Name Middle name of the individual DIF /dif:DIF/dif:Personnel/dif:Middle_Name
ECHO /Collection/Contacts/Contact/ContactPersons/ContactPerson/MiddleName
ISO //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName
Last Name Last name of the individual DIF /dif:DIF/dif:Personnel/dif:Last_Name
ECHO /Collection/Contacts/Contact/ContactPersons/ContactPerson/LastName
ISO //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName
Email Email address of the individual or organization DIF /dif:DIF/dif:Personnel/dif:Email
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationEmails/echo:Email
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:electronicMailAddress/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:ElectronicMailAddress
Hours of Service Time period (including time zone) when individuals can contact the organisation or

individual

ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:HoursOfService
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:hoursOfService/gco:CharacterString
Contact Instructions Supplemental instructions on how or when to contact the individual or organisation ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:Instructions
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:contactInstructions/gco:CharacterString
Phone Telephone numbers at which the organisation or individual may be contacted DIF /dif:DIF/dif:Personnel/dif:Phone
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationPhones/echo:Phone[echo:type='voice]'/echo:Number
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:phone/gmd:CI_Telephone/gmd:voice/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Phone/ows:Voice
Fax Telephone numbers at which the organisation or individual may be contacted via facsimile

(fax)

DIF /dif:DIF/dif:Personnel/dif:Fax
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationPhones/echo:Phone[echo:type='fax]'/echo:Number
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:phone/gmd:CI_Telephone/gmd:facsimile/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Phone/ows:Facsimile
Address Address line for the location DIF /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Address
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:StreetAddress
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:deliveryPoint/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:DeliveryPoint
City City of the location DIF /dif:DIF/dif:Personnel/dif:Contact_Address/dif:City
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:City
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:city/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:City
Province or State Province, state, or other administrative area of the location DIF /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Province_or_State
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:StateProvince
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:administrativeArea/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:AdministrativeArea
Postal_Code Zip code or other postal code for the location DIF /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Postal_Code
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:PostalCode
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:postalCode/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:PostalCode
Country Country of the location DIF /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Country
ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:Country
ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:coountry/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:Country
Web Page On-line information that can be used to contact the individual or organisation ISO //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ProviderSite/@xlink:href
Organization Name Name of the organization ECHO /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationName
ISO //gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceProvider/ows:ProviderName

xPath Note: The xPaths included in this table use several wildcards. // means any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere in an XML file. /*/ indicates a single level with several possible elements. This usually indicates one of several concrete realizations of an abstract object. For example /*/gmd:identificationInfo could be gmd:MD_Metadata/gmd:identificationInfo or gmi:MI_Metadata/gmd:identificationInfo and gmd:identificationInfo//*/gmd:descriptiveKeywords could be gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords or gmd:identificationInfo/srv:SV_ServiceIdentification/gmd:descriptiveKeywords.