Difference between revisions of "Documenting People and Organizations"
| 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 | + | 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 19: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 19115 | Added in ISO 19115-1 |
|
+ resourceProvider |
+ sponsor |
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 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.
