Description:
Main entry point for a PBCore record. Single assets start here. The pbcoreDescriptionDocument assembles together all of PBCore knowledge items into a single data record organized in a hierarchical structure. For PBCore these knowledge items are metadata descriptions of media, including all the knowledge items and metadata terms and values associated with its content and containers.
XPATH LOCATION:
/ pbcoreDescriptionDocument
USAGE RULES:
Occurs:
1 time only
Must Contain:
3 attributes, specific:
- xmlns (text, specific value: “http://pbcore.org/PBCore/PBCoreNamespace.html”)
- xsi (text, specific value: “http://www.w3.org/2001/XMLSchema-instance”)
- schemaLocation (text, specific value: “http://pbcore.org/PBCore/PBCoreNamespace.html”)
3 elements, specific:
May Contain:
5 or less optional attributes, specific:
- collectionTitle (text, may be empty)
- collectionDescription (text, may be empty)
- collectionSource (text, may be empty)
- collectionRef (text, may be empty)
- collectionDate (text, may be empty)
16 or less optional elements, specific:
Contained by:
Contained with:
NOTHING
EXAMPLES:
<pbcoreDescriptionDocument xmlns="http://pbcore.org/PBCore/PBCoreNamespace.html"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://pbcore.org/PBCore/PBCoreNamespace.html >
<pbcoreIdentifier source="NOLA Code">AMEX000102</pbcoreIdentifier>
<pbcoreTitle titleType="Full">American Experience: Radio Bikini</pbcoreTitle>
<pbcoreDescription>In July 1946, the U.S. Navy staged "Operation Crossroads"--two highly publicized atomic bomb tests at a Pacific Island called Bikini. This film is the story of those tests and their effect not only on the thousands of Naval personnel and spectators who watched, but also on the Bikinians whose homes was rendered uninhabitable by contamination, even now, 40 years later.</pbcoreDescription>
</pbcoreDescriptionDocument>
When I attempt to code this element as explained above, the document won’t validate. Specifically, I’d like to use the attributes @collectionTitle, @collectionDescription, @collectionSource, and @collectionRef in the element.
Maybe with PBCore version 2.0, these attributes are now only available in . If so, please consider a change for a future version to allow a set of attributes for both and . That would facilitate two applications:
1) Thinking of an RSS feed, or some another scenario where multiple description documents were bundled into one : if the assets came from different logical collections, each could use these attributes to carry its own information.
2) Thinking of one asset owned by one institution: in I’d use the attributes to supply information about the INSTITUTION. Then in , I’d use the attributes to provide information about the logical COLLECTION, such as a link to the finding aid.
Thank you
I didn’t realize element names in carets would need to be stripped from comments, and without the element names my comment isn’t clear. If there’s a human moderator, please delete the comment above and post only the content below:
————-
When I attempt to code descriptionDocument as explained above, the document won’t validate. Specifically, I’d like to use the attributes @collectionTitle, @collectionDescription, @collectionSource, and @collectionRef in descriptionDocument.
Maybe with PBCore version 2.0, these attributes are now only available in pbcoreCollection. If so, please consider a change for a future version to allow this set of attributes for both pbcoreCollection and descriptionDocument. That would facilitate two applications:
1) Thinking of an RSS feed, or some another scenario where multiple description documents were bundled into one pbcoreCollection: if the assets in the different descriptions came from different logical collections, each descriptionDocument could use these attributes to carry its own information.
2) Thinking of one asset owned by one institution: in collectionDocument I’d use the attributes to supply information about the INSTITUTION. Then in descriptionDocument, I’d use the attributes to provide information about the logical COLLECTION, such as a link to the finding aid.
Thank you