Difference between revisions of "Documenting People and Organizations"

From Earth Science Information Partners (ESIP)
Line 1: Line 1:
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 element`s. For example, the [[Attribute Convention for Data Discovery (ACDD)|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.
+
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 element's. For example, the [[Attribute Convention for Data Discovery (ACDD)|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|NetCDF, HDF, and ISO Metadata]] for more details on this approach.
 
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|NetCDF, HDF, and ISO Metadata]] for more details on this approach.

Revision as of 20:23, May 29, 2013

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 element's. 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 resources is an important role of metadata. In addition, it is critical to describe people's role with respect to the resource. In ISO, most objects that include associated people or organizations can have multiple associations and the roles are described in a codeList. This means that, for example, a citation can have people identified in any or all of the roles listed in the CI_RoleCode object. These roles are:

CI_RoleCode

ISO 19115Added in ISO 19115-1

+ resourceProvider
+ custodian
+ owner
+ user
+ distributor
+ originator
+ pointOfContact
+ principalInvestigator
+ processor
+ publisher
+ author

+ sponsor
+ coAuthor
+ collaborator
+ editor
+ mediator
+ rightsHolder
+ contributor
+ funder
+ stakeholder

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 /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo: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 /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo: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 /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo: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 /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo: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.