element <fileCitation> (global)
Namespace:
ddi:codebook:2_5
Type:
citationType
Content:
complex, 9 attributes, 10 elements
Defined:
globally in codebook.xsd; see XML source
Used:
at 1 location
XML Representation Summary
<fileCitation
   
ID
 = 
 xs:ID
xml-lang
 = 
 xs:NMTOKEN
xml:lang
 = 
 xs:language
source
 = 
 ("archive" | "producer") : "producer"
elementVersion
 = 
 xs:string
elementVersionDate
 = 
 (xs:dateTime | xs:date | xs:gYearMonth | xs:gYear)
ddiLifecycleUrn
 = 
 xs:anyURI
ddiCodebookUrn
 = 
 xs:anyURI
MARCURI
 = 
 xs:string
    >
   
Content: 
 titlStmt, rspStmt?, prodStmt?, distStmt?, serStmt*, verStmt*, biblCit*, holdings*, notes*, dc:any*
</fileCitation>
Content model elements (10):
biblCit, dc:any, distStmt, holdings, notes, prodStmt, rspStmt, serStmt, titlStmt, verStmt
Included in content model of elements (1):
fileTxt
May contain elements by substitutions (48):
contributor, coverage, creator, date, dc:abstract, dc:accessRights, dc:alternative, dc:audience, dc:available, dc:bibliographicCitation, dc:conformsTo, dc:created, dc:dateAccepted, dc:dateCopyrighted, dc:dateSubmitted, dc:educationLevel, dc:extent, dc:hasFormat, dc:hasPart, dc:hasVersion, dc:isFormatOf, dc:isPartOf, dc:isReferencedBy, dc:isReplacedBy, dc:isRequiredBy, dc:isVersionOf, dc:issued, dc:mediator, dc:medium, dc:modified, dc:references, dc:replaces, dc:requires, dc:spatial, dc:tableOfContents, dc:temporal, dc:valid, description, format, identifier, language, publisher, relation, rights, source, subject, title, type
Known Usage Locations
Annotation

File Citation

Description

The complex element fileCitation provides for a full bibliographic citation option for each data file described in fileDscr. To support accurate citation of a data file the minimum element set includes: titl, IDNo, authEnty, producer, and prodDate. If a DOI is available for the data file enter this in the IDNo (this element is repeatable). If a hash value (digital fingerprint) has been created for the data file enter the information regarding its value and algorithm specification in digitalFingerprint.

Example

<fileCitation> <titlStmt> <titl>ABC News/Washington Post Monthly Poll, December 2010</titl> <IDNo>http://dx.doi.org/10.3886/ICPSR32547.v1</IDNo> </titlStmt> <rspStmt> <AuthEnty>ABC News</AuthEnty> <AuthEnty>The Washington Post</AuthEnty> </rspStmt> <prodStmt> <producer>ABC News</producer> <prodDate>2011</prodDate> </prodStmt> </fileCitation>
XML Source (w/o annotations (1); see within schema source)
<xs:element name="fileCitation" type="citationType"/>
Attribute Detail (all declarations; 9/9)
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:
dateSimpleType
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"/>
MARCURI
Type:
xs:string, predefined
Use:
optional
Defined:
locally within citationType complexType
XML Source (see within schema source)
<xs:attribute name="MARCURI" type="xs:string" use="optional"/>
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>
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; 10/10)
biblCit
Type:
biblCitType, mixed content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="biblCit"/>
any
Type:
SimpleLiteral, mixed content
Abstract:
(may not be used directly in instance XML documents)
Subst.Gr:
may be substituted with 48 elements
Defined:
by reference within dc:elementsAndRefinementsGroup group
XML Source (see within schema source)
<xs:element ref="dc:any"/>
distStmt
Type:
distStmtType, complex content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element minOccurs="0" ref="distStmt"/>
holdings
Type:
holdingsType, mixed content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="holdings"/>
notes
Type:
notesType, mixed content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="notes"/>
prodStmt
Type:
prodStmtType, complex content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element minOccurs="0" ref="prodStmt"/>
rspStmt
Type:
rspStmtType, complex content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element minOccurs="0" ref="rspStmt"/>
serStmt
Type:
serStmtType, complex content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="serStmt"/>
titlStmt
Type:
titlStmtType, complex content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element ref="titlStmt"/>
verStmt
Type:
verStmtType, complex content
Defined:
by reference within citationType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="verStmt"/>
XML schema documentation generated with DocFlex/XML 1.8.7 using DocFlex/XML XSDDoc 2.7.0 template set