element <fileDscr> (global)
Namespace:
Type:
Content:
complex, 13 attributes, 3 elements
Defined:
globally in codebook.xsd; see XML source
Used:
XML Representation Summary
<fileDscr
   
 = 
xs:ID
 = 
xs:NMTOKEN
 = 
xs:language
 = 
("archive" | "producer") : "producer"
 = 
xs:string
 = 
(xs:dateTime | xs:date | xs:gYearMonth | xs:gYear)
 = 
xs:anyURI
 = 
xs:anyURI
 = 
xs:string
 = 
xs:IDREFS
 = 
xs:IDREFS
 = 
xs:IDREFS
 = 
xs:IDREFS
    >
   
Content: 
fileTxt*, locMap?, notes*
</fileDscr>
Content model elements (3):
fileTxt, locMap, notes
Included in content model of elements (1):
codeBook
Known Usage Locations
Annotation

Data Files Description

Description

Information about the data file(s) that comprises a collection. This section can be repeated for collections with multiple files.

The "URI" attribute may be a URN or a URL that can be used to retrieve the file. The "sdatrefs" are summary data description references that record the ID values of all elements within the summary data description section of the Study Description that might apply to the file. These elements include: time period covered, date of collection, nation or country, geographic coverage, geographic unit, unit of analysis, universe, and kind of data. The "methrefs" are methodology and processing references that record the ID values of all elements within the study methodology and processing section of the Study Description that might apply to the file. These elements include information on data collection and data appraisal (e.g., sampling, sources, weighting, data cleaning, response rates, and sampling error estimates). The "pubrefs" attribute provides a link to publication/citation references and records the ID values of all citations elements within Other Study Description Materials or Other Study-Related Materials that pertain to this file. "Access" records the ID values of all elements in the Data Access section that describe access conditions for this file.

Remarks: When a codebook documents two different physical instantiations of a data file, e.g., logical record length (or OSIRIS) and card-image version, the Data File Description should be repeated to describe the two separate files. An ID should be assigned to each file so that in the Variable section the location of each variable on the two files can be distinguished using the unique file IDs.

Example

<fileDscr ID="CARD-IMAGE" URI="www.icpsr.umich.edu/cgi-bin/archive.prl?path=ICPSR&amp;num=7728"/> <fileDscr ID="LRECL" URI="www.icpsr.umich.edu/cgi-bin/archive.prl?path=ICPSR&amp;num=7728"/>
XML Source (w/o annotations (1); see within schema source)
<xs:element name="fileDscr" type="fileDscrType"/>
Attribute Detail (all declarations; 13/13)
access
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within fileDscrType complexType
XML Source (see within schema source)
<xs:attribute name="access" type="xs:IDREFS"/>

ddiCodebookUrn
Type:
xs:anyURI, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Used to capture the DDI-Codebook type URN for the element. This is used to assign a DDI-Codebook specific URN to the element, according the format prescribed by the DDI-Codebook standard.
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="ddiCodebookUrn" type="xs:anyURI" use="optional"/>

ddiLifecycleUrn
Type:
xs:anyURI, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Used to capture the DDI-Lifecycle type URN for the element. This may be captured during translation from DDI-Lifecycle to DDI-Codebook structure or in preparation for transferring to a DDI-Lifecycle structure.
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="ddiLifecycleUrn" type="xs:anyURI" use="optional"/>

elementVersion
Type:
xs:string, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Captures version of the element
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="elementVersion" type="xs:string" use="optional"/>

elementVersionDate
Type:
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Indicates version date for the element. Use YYYY-MM-DD, YYYY-MM, or YYYY formats.
Attribute Value
xs:dateTime | xs:date | xs:gYearMonth | xs:gYear
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="elementVersionDate" type="dateSimpleType" use="optional"/>

ID
Type:
xs:ID, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
XML Source (see within schema source)
<xs:attribute name="ID" type="xs:ID" use="optional"/>

methrefs
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within fileDscrType complexType
XML Source (see within schema source)
<xs:attribute name="methrefs" type="xs:IDREFS"/>

pubrefs
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within fileDscrType complexType
XML Source (see within schema source)
<xs:attribute name="pubrefs" type="xs:IDREFS"/>

sdatrefs
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within fileDscrType complexType
XML Source (see within schema source)
<xs:attribute name="sdatrefs" type="xs:IDREFS"/>

source
Type:
anonymous simpleType (restriction of xs:NMTOKEN)
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"archive", "producer"
Default:
"producer"
Anonymous simpleType
Type Derivation Tree
xs:NMTOKEN (restriction)
  simpleType
Derivation:
restriction of xs:NMTOKEN
Facets:
enumeration:
"archive", "producer"
XML Source (see within schema source)
<xs:attribute default="producer" name="source">
<xs:simpleType>
<xs:restriction base="xs:NMTOKEN">
<xs:enumeration value="archive"/>
<xs:enumeration value="producer"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>

URI
Type:
xs:string, predefined
Use:
optional
Defined:
locally within fileDscrType complexType
XML Source (see within schema source)
<xs:attribute name="URI" type="xs:string"/>

xml-lang
Type:
xs:NMTOKEN, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
DO NOT USE THIS ATTRIBUTE. Its inclusion is an error that was persisted to retain backward compatibility. If this attribute has been used, transfer the content to xml:lang.
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="xml-lang" type="xs:NMTOKEN" use="optional"/>

xml:lang
Type:
xs:language, predefined
Use:
optional
Defined:
by reference within GLOBALS attributeGroup
XML Source (see within schema source)
<xs:attribute ref="xml:lang" use="optional"/>
Content Element Detail (all declarations; 3/3)
fileTxt
Type:
fileTxtType, complex content
Defined:
by reference within fileDscrType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="fileTxt"/>

locMap
Type:
locMapType, complex content
Defined:
by reference within fileDscrType complexType
XML Source (see within schema source)
<xs:element minOccurs="0" ref="locMap"/>

notes
Type:
notesType, mixed content
Defined:
by reference within fileDscrType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="notes"/>

XML schema documentation generated with DocFlex/XML 1.8.7 using DocFlex/XML XSDDoc 2.7.0 template set