|
DDI_XPath
|
Required
|
UI Label
|
Type
|
Repeatable
|
Usage note
|
| /codeBook/@xml:lang | Recommended | Study description available in.. (in the search result
list) | Attribute | | ISO 639-1 codes are strongly encouraged to be used |
| /codeBook/@xsi:schemaLocation | Recommended | | Attribute | | System-required information - nearly always "ddi:codebook:2_6
codebook.xsd" |
| /codeBook/docDscr/citation/titlStmt/titl | Optional | | Content element | No | Title of the CDC XML document - note that the Study Title goes in
/codeBook/stdyDscr/citation/titlStmt/titl |
| /codeBook/stdyDscr/citation/titlStmt/titl | Mandatory | Study title | Content element | No | Title of the Study. If additional titles are required in other
languages, use the parTitl element |
| /codeBook/stdyDscr/citation/titlStmt/parTitl | Optional | Study title | Content element | Yes | Title of the Study in additional languages other than the 'titl'
element. It is preferable to include this element to hold an English version of the
title if the 'titl' element is not in English. |
| /codeBook/stdyDscr/citation/titlStmt/IDNo | Mandatory | Study number / PID | Content element | Yes | The content of this element serves two purposes. It is used both for
the PID and for the study/archival number given by the SP. These two cases have
different specifications. IDNo in the sense of study number is optional. PID is
mandatory |
| /codeBook/stdyDscr/citation/titlStmt/IDNo/@agency | Mandatory | Study number / PID | Attribute | | Agency responsible for the identifier of the study. If you are using
IDNo for a Persistent Identifer, value should be one of
https://vocabularies.cessda.eu/vocabulary/CessdaPersistentIdentifierTypes i.e. ARK
or DOI or Handle or URN |
| /codeBook/stdyDscr/citation/holdings/@URI | Mandatory | in the search result list with label "Access data" | Attribute | | This is the document the metadata refers to, i.e. the URL of the study
description page at the SP website. |
| /codeBook/stdyDscr/citation/rspStmt/AuthEnty | Recommended | Creator | Content element | Yes | Principal investigator Person OR Institution |
| /codeBook/stdyDscr/citation/rspStmt/AuthEnty/@affiliation | Optional | | Attribute | | If AuthEnty is a person, the organisational affiliation of that
person |
| /codeBook/stdyDscr/citation/prodStmt/grantNo | Optional | | Content element | Yes | The identification code of the grant or other monetary award which
provided funding for the Study. If you know that the funder
is included in the OpenAire list of Funders, see the instructions for grantNo syntax
here:
https://guidelines.openaire.eu/en/latest/data/field_contributor.html#nameidentifier-ma-o
. Indicate the appropriate agency using the "@agency" attribute. If different
funding agencies sponsored different stages of the production process, use the
"@role" attribute to distinguish the grant numbers. |
| /codeBook/stdyDscr/citation/prodStmt/grantNo/@agency | Optional | | Attribute | | Agency which provided the funding. |
| /codeBook/stdyDscr/citation/prodStmt/grantNo/@role | Optional | | Attribute | | If different funding agencies sponsored different stages of the
production process, use the "@role" attribute to distinguish the grant
numbers. |
| /codeBook/stdyDscr/citation/distStmt/distrbtr | Mandatory | Publisher | Content element | Yes | The element should contain the name of the organisation who has
published the metadata for the harvested study description. This is usually the
SP. |
| /codeBook/stdyDscr/citation/distStmt/distrbtr/@abbr | Optional | | Attribute | | Abbreviated form of the Publisher name e.g. 'UKDA' for 'UK Data
Archive' |
| /codeBook/stdyDscr/citation/distStmt/distDate | Optional | Publication year | Content element | Yes | The freetext date when the study description was published. This
element may be left empty. |
| /codeBook/stdyDscr/citation/distStmt/distDate/@date | Mandatory if 'distDate' element is present | Publication year | Attribute | | Ideally 'YYYY-MM-DDThh:mm:ssZ' format, but can accept 'YYYY-MM-DD',
'YYYY-MM' or 'YYYY' as date format. It is strongly recommended to provide the full
date to allow sorting by publication date in CDC. |
| /codeBook/stdyDscr/stdyInfo/subject/keyword | Recommended | Keywords | Content element | Yes | Keyword for the study in the local language. |
| /codeBook/stdyDscr/stdyInfo/subject/keyword/@vocab | Recommended if 'keyword' element is present | | Attribute | | Source of keywords - ELSST is recommended but other vocabularies can
be referenced. |
| /codeBook/stdyDscr/stdyInfo/subject/keyword/@vocabURI | Optional | | Attribute | | |
| /codeBook/stdyDscr/stdyInfo/subject/topcClas | Recommended | Topics | Content element | Yes | Subject classifcation term for the study in the local language. Use
descriptive terms from https://vocabularies.cessda.eu/vocabulary/TopicClassification
if possible but other vocabularies are permitted. |
| /codeBook/stdyDscr/stdyInfo/subject/topcClas/@vocab | Recommended | | Attribute | | name of the vocabulary. If possible, use "CESSDA Topic Classification"
(regardless of language) but other vocabularies are permitted. |
| /codeBook/stdyDscr/stdyInfo/subject/topcClas/@vocabURI | Recommended | | Attribute | | Use the URI of the CV version that is being used based on the pattern
"https://vocabularies.cessda.eu/urn/urn:ddi:int.cessda.cv:TopicClassification:[version number]"
For example, for version 4.2.2 of CESSDA Topic Classification, use
"https://vocabularies.cessda.eu/urn/urn:ddi:int.cessda.cv:TopicClassification:4.2.2" |
| /codeBook/stdyDscr/stdyInfo/abstract | Mandatory | Abstract | Content element | Yes | The abstract for the study |
| /codeBook/stdyDscr/stdyInfo/sumDscr/collDate | Optional | Data collection period | Content element | Yes | This is the free text expression of the collection period. This
element may be empty. |
| /codeBook/stdyDscr/stdyInfo/sumDscr/collDate/@event | Mandatory if parent is present | Data collection period | Attribute | | Either 'start', 'end' or 'single' to indicate the type of @date
Attribute |
| /codeBook/stdyDscr/stdyInfo/sumDscr/collDate/@date | Recommended strongly if 'collDate' element is present. | | Attribute | | Ideally YYYY-MM-DDThh:mm:ssZ format, but can accept YYYY-MM-DD,
YYYY-MM or YYYY as date attribute. If there are multiple end dates, use the
last. |
| /codeBook/stdyDscr/stdyInfo/sumDscr/nation | Recommended | Country | Content element | Yes | Countries relevant to the study area |
| /codeBook/stdyDscr/stdyInfo/sumDscr/nation/@abbr | Recommended | | Attribute | | Use this attribute only if the country in the 'nation' element has an
ISO 3166-1 2-letter code. |
| /codeBook/stdyDscr/stdyInfo/sumDscr/anlyUnit | Recommended | Analysis unit | Content element | Yes | Contains the Analysis Unit CV item in the local language. |
| /codeBook/stdyDscr/stdyInfo/sumDscr/anlyUnit/concept | Recommended | | Content element | No | |
| /codeBook/stdyDscr/stdyInfo/sumDscr/anlyUnit/concept/@vocab | Recommended | | Attribute | | Use the string "DDI Analysis Unit" regardless of language. |
| /codeBook/stdyDscr/stdyInfo/sumDscr/anlyUnit/concept/@vocabURI | Optional | | Attribute | | The Canonical URL of the CV version that is being used e.g.
https://vocabularies.cessda.eu/v2/vocabularies/AnalysisUnit/1.0.0?languageVersion=en-1.0.0 |
| /codeBook/stdyDscr/stdyInfo/sumDscr/universe | Recommended | None | Content element | Yes | Description of population or other elements studied or measured (freetext). |
| /codeBook/stdyDscr/stdyInfo/sumDscr/universe/@clusion | Optional | None | Attribute | | The default value is "true" in DDI-L. The description statement of a
universe is generally stated in inclusive terms such as "All persons residing in Europe".
Occasionally a universe is defined by what it excludes, i.e., "All persons residing
in Europe except for those residing on U.S. Military bases".
In this case the value would be changed to "false".
In DDI-C, attribute clusion states the inclusion/exclusion with values "I" and "E" respectively. |
| /codeBook/stdyDscr/method/dataColl/timeMeth | Recommended | Time dimension | Content element | Yes | Contains the Time Method CV item in the local language |
| /codeBook/stdyDscr/method/dataColl/timeMeth/concept | | | Content element | No | Time Method Controlled Vocabulary "Code value" that is the same across
languages. e.g if the 'timeMeth' element is 'Pitkittäisaineisto' for Finnish, the
'concept' element is 'Longitudinal'. See example at
https://vocabularies.cessda.eu/urn/urn:ddi:int.ddi.cv:TimeMethod |
| /codeBook/stdyDscr/method/dataColl/timeMeth/concept/@vocab | Recommended | | Attribute | | Use the string "DDI Time Method" regardless of language. |
| /codeBook/stdyDscr/method/dataColl/timeMeth/concept/@vocabURI | Optional | | Attribute | | The Canonical URL of the CV version that is being used e.g.
https://vocabularies.cessda.eu/v2/vocabularies/TimeMethod/1.2.0?languageVersion=en-1.2.0 |
| /codeBook/stdyDscr/method/dataColl/sampProc | Optional | Sampling procedure | Content element | Yes | Contains the Sampling Procedure CV item in the local language and/or a
freetext description in the local language |
| /codeBook/stdyDscr/method/dataColl/sampProc/concept | | | Content element | No | Sampling Procedure Controlled Vocabulary "Code value" that is the same
across languages. e.g if the 'sampProc' element is 'Todennäköisyysotanta' for
Finnish, the 'concept' element is 'Probability'. See example at
https://vocabularies.cessda.eu/urn/urn:ddi:int.ddi.cv:SamplingProcedure |
| /codeBook/stdyDscr/method/dataColl/sampProc/concept/@vocab | Recommended | | Attribute | | Use the string "DDI Sampling Procedure" regardless of
language. |
| /codeBook/stdyDscr/method/dataColl/sampProc/concept/@vocabURI | Optional | | Attribute | | The Canonical URL of the CV version that is being used e.g.
https://vocabularies.cessda.eu/v2/vocabularies/SamplingProcedure/1.1.0?languageVersion=en-1.1.0 |
| /codeBook/stdyDscr/method/dataColl/collMode | Recommended | Data collection mode | Content element | Yes | Contains the Mode of Collection CV item in the local
language. |
| /codeBook/stdyDscr/method/dataColl/collMode/concept | | | Content element | No | Mode of Collection Controlled Vocabulary "Code value" that is the same
across languages. e.g if the 'collMode' element is 'Haastattelu' for Finnish, the
'concept' element is 'Interview'. See example at
https://vocabularies.cessda.eu/urn/urn:ddi:int.ddi.cv:ModeOfCollection |
| /codeBook/stdyDscr/method/dataColl/collMode/concept/@vocab | Recommended | | Attribute | | Use the string "DDI Mode of Collection" regardless of
language. |
| /codeBook/stdyDscr/method/dataColl/collMode/concept/@vocabURI | Optional | | Attribute | | The Canonical URL of the CV version that is being used e.g.
https://vocabularies.cessda.eu/v2/vocabularies/ModeOfCollection/3.0.0?languageVersion=en-3.0.0 |
| /codeBook/stdyDscr/dataAccs/typeOfAccess | Mandatory | Open/Closed | Content element | Yes | Controlled description of the data access (open access vs. restricted access).
CDC will use the same Access Rights vocabulary as OpenAIRE.
The name of the vocabulary is “info:eu-repo-Access-Terms vocabulary” - see
http://purl.org/eu-repo/semantics/#info-eu-repo-AccessRights
Only the codes “restrictedAccess” and “openAccess” will be used. |
| /codeBook/stdyDscr/dataAccs/typeOfAccess/@vocabURI | Mandatory if '../typeofAccess' element is present | | Attribute | | Always 'info:eu-repo-Access-Terms vocabulary'. |
| /codeBook/stdyDscr/dataAccs/useStmt/restrctn | Recommended | Terms of data access | Content element | Yes | Refers to any information relating to the access and use conditions of
data that the SP wants to send. SPs need to concatenate the information for
'restrctn' the way they want it to appear in the CDC, if they use data from
different elements e.g.specPerm, restrctn, avlStatus etc. |
| /codeBook/fileDscr/fileTxt/fileName | Recommended | | Content element | Yes | Language-specific name of file |
| /codeBook/stdyDscr/othrStdyMat/relPubl/citation/titlStmt/IDNo | Recommended | | Content element | Yes | PID of the publication. Required by OpenAire to to relate the
publication to a dataset. |
| /codeBook/stdyDscr/othrStdyMat/relPubl/citation/titlStmt/IDNo/@agency | Mandatory if '..../IDNo' element is present. | | Attribute | | Agency responsible for the identifier of the publication. Required by
OpenAire and the value has to come from their controlled list of
relatedIdentifierTypes:
https://guidelines.openaire.eu/en/latest/data/field_relatedidentifier.html#d-relatedidentifier.. |
| /codeBook/stdyDscr/othrStdyMat/relPubl/citation/holdings/@URI | Recommended. | | Attribute | | URL of website on which the publication can be found (or at least information concerning
the literature). |