ESciDoc Application Profiles

From MPDLMediaWiki
Jump to navigation Jump to search
  • work in progress

Open issues[edit]

I moved the open issues to the discussion page -- Andreas Gros 08:19, 20 March 2008 (CET)


Application Profile[edit]

The eSciDoc Application Profiles (AP) documents the descriptive elements used by eSciDoc to describe its content entities, e.g. publications, organizations, etc. Additional information about objects (properties for items and its components) and structural relations between objects are also existing, but currently not considered in this AP. The AP is nowhere near to being complete yet.

In the first step, the AP is meant for documenting the existing xml schemas only. The document should be the basis for all future communication about the pubman metadata profile in use. Anyway, we also expect that this approach will help us clarifying how to implement the requirements, thus the work will have certain impacts on the xml schemas.

The format of the table below follows the CEN Workshop Agreement 14855 for Dublin Core Application Profile Guidelines[1]

Namespaces[edit]

Term URI http://purl.org/dc/terms/
Name dcterms:
Label Dublin Core terms


Term URI http://www.w3.org/2006/vcard/ns#
Name vCard:
Label An Ontology for vCards


Term URI http://purl.org/agmes/1.1/
Name ags:
Label Agricultural Metadata Element Set



Term URI http://purl.org/rslp/terms/
Name rslp:
Label Research Support Libraries Programme


Term URI http://purl.org/escidoc/metadata/terms
Name escidoc:
Label eSciDoc terms





Syntax Encoding Scheme[edit]

String data type definition
Name <string>
Label Character string
Definition A string of ASCII characters. No formatting tags may be included. The following characters must be encoded for XML: '&' - '&'; '<' - '<'; '>' - '>'. A limited list of non-ASCII characters may be included encoded as character entities.


Date data type definition
Name <date>
Label Date
Defined By http://www.w3.org/TR/NOTE-datetime
Definition

Character string representing a date to the complete date level of the W3CDTF profile of ISO 8601


URI data type definition
Name <URI>
Label URI
Defined By http://www.ietf.org/rfc/rfc2396.txt
Definition Character string for a URI



Describing a publication[edit]

Elements and element refinements[edit]

Term URI http://purl.org/dc/terms/title
Name title
Label Title
Defined by: -
DC Definition A name given to the resource.
DC Comment -
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines -
Refined by http://purl.org/dc/terms/alternative
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: 1
Best practice -
Open Questions -


Term URI http://purl.org/dc/terms/alternative
Name alternative
Label Alternative Title
Defined by: -
DC Definition An alternative name for the resource.
DC Comment The distinction between titles and alternative titles is application-specific.
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/title
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min:0; Max: Unbounded
Best practice -
Open Questions -


Term URI http://purl.org/dc/terms/type
Name type
Label Genre
Defined by: -
DC Definition The nature or genre of the resource.
DC Comment Recommended best practice is to use a controlled vocabulary such as the DCMI Type Vocabulary[2]. To describe the file format, physical medium, or dimensions of the resource, use the Format element.
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://escidoc.mpg.de/metadataprofile/schema/0.1/terms/genre ESciDoc PublicationType Encoding Scheme
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: 1;
Best practice -
Open Questions Maximum occurrence might be changed in the future


Term URI http://purl.org/dc/terms/language
Name language
Label Language
Defined by: -
DC Definition A language of the resource.
DC Comment Recommended best practice is to use a controlled vocabulary such as RFC 4646 [RFC4646].
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme RFC 4646
Obligation Optional
Condition -
Datatype string
Occurrence Min:0; Max: Unbounded
Best practice -
Open Questions -



Term URI http://purl.org/dc/terms/identifier
Name identifier
Label Identifier
Defined by: -
DC Definition An unambiguous reference to the resource within a given context.
DC Comment Recommended best practice is to identify the resource by means of a string conforming to a formal identification system.
eSciDoc Definition An external identifier for the resource.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme List a number of Schemes (URI), ISBN, ISSN, DOI, ...
Obligation Optional
Condition -
Datatype URI
Occurrence Min: 0; Max: Unbounded
Best practice -
Open Questions Data type "URI" not agreed upon, Traugott sends more information, compare with SWAP AP



Term URI http://purl.org/dc/terms/creator
Name creator
Label Creator
Defined by: -
DC Definition An entity primarily responsible for making the resource.
DC Comment Examples of a Creator include a person, an organization, or a service. Typically, the name of a Creator should be used to indicate the entity.
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: Unbounded;
Best practice -
Open Questions -


Example: http://schemas.library.nhs.uk/Term/DC/contributor.html

Term URI http://purl.org/dc/terms/creator
Name creator
Label Creator
Defined by: -
DC Definition An entity primarily responsible for making the resource.
DC Comment Examples of a Creator include a person, an organization, or a service. Typically, the name of a Creator should be used to indicate the entity.
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines -
Refined by [marcrel:AUT] Author

http://www.loc.gov/loc.terms/relators/AUT

Refined by [marcrel:EDT] Editor

http://www.loc.gov/loc.terms/relators/EDT

Refined by [marcrel:ILL] Illustrator

http://www.loc.gov/loc.terms/relators/ILL

Refined by [marcrel:TRL] Translator

http://www.loc.gov/loc.terms/relators/TRL

Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: Unbounded;
Best practice -
Open Questions -



Term URI http://escidoc.mpg.de/metadataprofile/schema/0.1/terms/publishinginfo
Name publishinginfo
Label Publishing Info
Defined by: -
DC Definition An entity responsible for making the resource available.
DC Comment Examples of a Publisher include a person, an organization, or a service.
eSciDoc Definition The institution which published the item and additional information, e.g. the publisher name and place of a book, or the university where a theses has been created.
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/publisher
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -



Term URI http://purl.org/dc/terms/created
Name created
Label Date Created
Defined by: -
DC Definition Date of creation of the resource.
DC Comment -
eSciDoc Definition The date when the publication was created.
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/date
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://www.w3.org/TR/NOTE-datetime
Obligation Optional
Condition -
Datatype date
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -



Term URI http://purl.org/dc/terms/dateSubmitted
Name dateSubmitted
Label Date Submitted
Defined by: -
DC Definition Date of submission of the resource.
DC Comment Examples of resources to which a Date Submitted may be relevant are a thesis (submitted to a university department) or an article (submitted to a journal).
eSciDoc Definition
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/date
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://www.w3.org/TR/NOTE-datetime
Obligation Optional
Condition -
Datatype date
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -


Term URI http://purl.org/dc/terms/dateAccepted
Name dateAccepted
Label Date Accepted
Defined by: -
DC Definition Date of acceptance of the resource.
DC Comment Examples of resources to which a Date Accepted may be relevant are a thesis (accepted by a university department) or an article (accepted by a journal).
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/date
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://www.w3.org/TR/NOTE-datetime
Obligation Optional
Condition -
Datatype date
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -



Term URI http://purl.org/dc/terms/modified
Name modified
Label Date Modified
Defined by: -
DC Definition Date on which the resource was changed.
DC Comment -
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/date
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://www.w3.org/TR/NOTE-datetime
Obligation Optional
Condition -
Datatype date
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -



Term URI http://purl.org/dc/terms/issued
Name issued
Label Date Issued
Defined by: -
DC Definition Date of formal issuance (e.g., publication) of the resource.
DC Comment -
eSciDoc Definition
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/date
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://www.w3.org/TR/NOTE-datetime
Obligation Optional
Condition -
Datatype date
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -



Term URI http://purl.org/eprints/status
Name status
Label Review Method
Defined by: -
DC Definition -
DC Comment -
eSciDoc Definition The type of the scientific review process for the described item.
eSciDoc Comment List contains: internal, peer, no review
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://escidoc.mpg.de/metadataprofile/schema/0.1/terms/reviewMethod ReviewMethod Encoding Scheme
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions In encoding scheme include eprints "peerReviewed"



Term URI http://purl.org/dc/terms/isPartOf
Name isPartOf
Label is Part Of
Defined by: -
DC Definition A related resource in which the described resource is physically or logically included.
DC Comment -
eSciDoc Definition The bundle in which the item has been published, e.g. a journal, a book, a series or a database.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: Unbounded
Best practice -
Open Questions -




Term URI http://purl.org/dc/terms/extent
Name extent
Label Total number of pages
Defined by: -
DC Definition The size or duration of the resource.
DC Comment -
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/format
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -


Term URI http://purl.org/dc/terms/bibliographicCitation
Name bibliographicCitation
Label -
Defined by: -
DC Definition A bibliographic reference for the resource.
DC Comment Recommended practice is to include sufficient bibliographic detail to identify the resource as unambiguously as possible.
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines http://purl.org/dc/terms/identifier
Refined by -
Encoding Scheme For -
Has Encoding Scheme OpenURL, Text
Obligation MA
Condition -
Datatype string
Occurrence Min: 0; Max: Unbounded
Best practice -
Open Questions -



Term URI http://escidoc.mpg.de/metadataprofile/schema/0.1/terms/event
Name event
Label Event
Defined by: -
DC Definition -
DC Comment -
eSciDoc Definition Some items are related to an event, e.g. a conference or a lecture series.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype -
Occurrence Min: 0; Max: Unbounded;
Best practice -
Open Questions C-DOC CRM standard event element?



Term URI http://escidoc.mpg.de/metadataprofile/schema/0.1/terms/degree
Name degree
Label Degree
Defined by: -
DC Definition -
DC Comment -
eSciDoc Definition The type of degree which is received with this type of publication.
eSciDoc Comment List contains: master, diploma, magister, staatsexamen, phd, habilitation
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme Degree Encoding Scheme
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions Clarify definition so that degree appears as a characteristic of the publication



Term URI http://purl.org/dc/terms/abstract
Name abstract
Label Abstract
Defined by: http://purl.org/dc/terms/
DC Definition A summary of the resource.
DC Comment -
eSciDoc Definition Abstract or short description of the item.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: Unbounded
Best practice -
Open Questions -



Term URI http://purl.org/dc/terms/subject
Name subject
Label Subject
Defined by: http://purl.org/dc/terms/
DC Definition The topic of the resource.
DC Comment Typically, the subject will be represented using keywords, key phrases, or classification codes. Recommended best practice is to use a controlled vocabulary. To describe the spatial or temporal topic of the resource, use the Coverage element.
eSciDoc Definition Free keywords.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: Unbounded
Best practice -
Open Questions -



Term URI http://purl.org/dc/terms/tableOfContents
Name tableofcontents
Label Table of Contents
Defined by: -
DC Definition A list of subunits of the resource.
DC Comment -
eSciDoc Definition Table of contents of the described item.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -



Term URI http://www.loc.gov/mods/location
Name location
Label Location
Defined by:
DC Definition -
DC Comment -
eSciDoc Definition The name of the library where the item is currently located.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions Location is a class with further properties in MODS, so possibly not a good choice. An alternative would be to use the "address" property of the Z39.50 Application Profile for Geospatial Metadata.

Application Profile for Entity Person[edit]

Term URI http://xmlns.com/foaf/0.1/name
Name name
Label Complete Name
Defined by: -
FOAF Definition A name for some thing.
FOAF Comment
eSciDoc Definition The complete name of a person, usually a concatenation of given names and family name.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: 1;
Best practice -
Open Questions -


Term URI http://xmlns.com/foaf/0.1/family_name
Name family_name
Label Family Name
Defined by: -
FOAF Definition The family_name of some person.
FOAF Comment
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: 1;
Best practice -
Open Questions -


Term URI http://xmlns.com/foaf/0.1/givenname
Name givenname
Label Given Name
Defined by: -
FOAF Definition The given name of some person.
FOAF Comment
eSciDoc Definition -
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1;
Best practice -
Open Questions -


Term URI http://xmlns.com/foaf/0.1/nick
Name nick
Label Pseudonym
Defined by: -
FOAF Definition A short informal nickname characterising an agent (includes login identifiers, IRC and other chat nicknames).
FOAF Comment
eSciDoc Definition The pen or stage name of a person.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: Unbounded;
Best practice -
Open Questions For "Pseudonym" we should probably use an eSciDoc term


Term URI http://escidoc.mpg.de/metadataprofile/schema/0.1/terms/alternative_name
Name alternative_name
Label Alternative Name
Defined by: -
FOAF Definition -
FOAF Comment -
eSciDoc Definition Any alternative name used for the person.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: Unbounded;
Best practice -
Open Questions -


Term URI http://xmlns.com/foaf/0.1/title
Name title
Label Title
Defined by: -
FOAF Definition Title (Mr, Mrs, Ms, Dr. etc)
FOAF Comment -
eSciDoc Definition The title or peerage of a person in one string.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: Unbounded;
Best practice -
Open Questions -





Term URI http://www.w3.org/2006/vcard/ns/org
Name org
Label Organization
Defined by: -
vCard Definition An organization associated with a person
vCard Comment
eSciDoc Definition The organizational unit the person was affiliated to when creating the item.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -The domain of the vCard:org property is the vCard:VCard class.
-The range of the v:org property is the v:Organization class.
Datatype string
Occurrence Min: 0; Max: 1;
Best practice -
Open Questions To prevent ambiguities shouldn't the label be "Affiliation" instead of "Organization"?


Term URI http://purl.org/dc/terms/identifier
Name identifier
Label Identifier
Defined by: -
DC Definition An unambiguous reference to the resource within a given context.
DC Comment Recommended best practice is to identify the resource by means of a string conforming to a formal identification system.
eSciDoc Definition Identifier in the Personennamendatei, provided by the Deutsche Nationalbibliothek.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme Only IdType “PND” is allowed.
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1;
Best practice -
Open Questions -


Application Profile of an Organization[edit]

Term URI http://xmlns.com/foaf/0.1/name
Name name
Label Name
Defined by: -
FOAF Definition A name for some thing.
FOAF Comment -
eSciDoc Definition The name of the organization as used in the item.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: 1
Best practice -
Open Questions -


Term URI http://purl.org/rslp/terms#address
Name address
Label Address
Defined by: -
RSLP Definition Postal address
RSLP Comment -
eSciDoc Definition The address of the organization as used in the item.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions


Term URI http://purl.org/dc/terms/identifier
Name identifier
Label Identifier
Defined by: -
DC Definition An unambiguous reference to the resource within a given context.
DC Comment Recommended best practice is to identify the resource by means of a string conforming to a formal identification system.
eSciDoc Definition The id of the corresponding organizational unit in the system.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions Is this a systems metadata entry, or a truly descriptive element? Should it be linked to an Authority File?


Application Profile of an Event[edit]

Term URI http://purl.org/dc/terms/title
Name title
Label Title
Defined by: -
DC Definition A name given to the resource.
DC Comment -
eSciDoc Definition The title of the event.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: 1
Best practice -
Open Questions -


Term URI http://purl.org/dc/terms/alternative
Name alternative
Label Alternative Title
Defined by: -
DC Definition An alternative name for the resource.
DC Comment -
eSciDoc Definition -
eSciDoc Comment The event may have one or several alternative forms of the title (e.g. an abbreviated title).
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: Unbounded
Best practice -
Open Questions -


Term URI http://purl.org/agmes/1.1/dateStart
Name dateStart
Label Start Date
Defined by: -
AG-event Definition Date on which the event will start.
AG-event Comment -
eSciDoc Definition Start date of an event.
eSciDoc Comment
Type of term Property
Refines http://purl.org/dc/terms/date
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://www.w3.org/TR/NOTE-datetime
Obligation Optional
Condition -
Datatype date
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -


Term URI http://purl.org/agmes/1.1/dateEnd
Name dateEnd
Label End Date
Defined by: -
AG-event Definition Date on which the event will end.
AG-event Comment -
eSciDoc Definition End date of an event.
eSciDoc Comment
Type of term Property
Refines http://purl.org/dc/terms/date
Refined by -
Encoding Scheme For -
Has Encoding Scheme http://www.w3.org/TR/NOTE-datetime
Obligation Optional
Condition -
Datatype date
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -


Term URI http://purl.org/dc/terms/spatial
Name spatial
Label Place
Defined by: -
DC Definition Spatial characteristics of the resource.
DC Comment -
eSciDoc Definition Place of an event.
eSciDoc Comment
Type of term Property
Refines http://purl.org/dc/terms/coverage
Refined by -
Encoding Scheme For -
Has Encoding Scheme
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions As "spatial" refines "coverage" its usage for a location can be debated


Term URI http://purl.org/escidoc/metadata/terms/invitationstatus/
Name invitation_status
Label Invitation Status
Defined by: -
DC Definition
DC Comment -
eSciDoc Definition The information whether or not the creator was explicitly invited.
eSciDoc Comment
Type of term Property
Refines
Refined by -
Encoding Scheme For -
Has Encoding Scheme yes or no
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1
Best practice -
Open Questions -

References[edit]

  1. CWA14855: Dublin Core Application Profile guidelines, see http://www.cen.eu/cenorm/businessdomains/businessdomains/isss/cwa/cwa14855.asp
  2. DCMI Type Vocabulary [DCMITYPE], see http://dublincore.org/documents/dcmi-type-vocabulary/"