Differences between revisions 8 and 9
Revision 8 as of 2010-01-04 12:54:11
Size: 2026
Editor: eab
Comment:
Revision 9 as of 2010-01-04 13:43:09
Size: 4674
Editor: eab
Comment:
Deletions are marked like this. Additions are marked like this.
Line 32: Line 32:
Consider using a drawing to illustrate relations or for instance include code/XML snippets Consider using a drawing to illustrate relations or for instance include (psudo)code/XML snippets.

{{{#!xml
<!-- the pbcore identifier - this element may occur as many times as
desired, however if it does occur, then a indentifier tag must appear
internally (once). optionally, a identifierSource tag may appear -->
  <xsd:element maxOccurs="unbounded" minOccurs="1" name="pbcoreIdentifier">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element maxOccurs="1" minOccurs="1" name="identifier" type="xsd:string">
          <xsd:annotation>
           <xsd:documentation xml:lang="eng">"The descriptor identifier is used to
                                                        reference or identify the entire record of metadata descriptions for a
                                                        media item and exists at the top level for a PBCore description and
                                                        its associated description document (XML). Best practice is to
                                                        identify the media item (whether analog or digital) by means of an
                                                        unambiguous string or number corresponding to an established or formal
                                                        identification system if one exists. Otherwise, use an identification
                                                        method that is in use within your agency, station, production company,
                                                        office, or institution."</xsd:documentation>
           </xsd:annotation>
          </xsd:element>
          <xsd:element maxOccurs="1" minOccurs="1" name="identifierSource"
                                                         type="pbcore.string.type.base">
            <xsd:annotation>
              <xsd:documentation xml:lang="eng">"The descriptor identifierSource is
                                                        used in combination with the unambiguous reference or identifier for a
                                                        media item found in the descriptor identifier. Thus PBCore provides
                                                        not only a locator number, but also an agency or institution who
                                                        assigned it. Both exist at the top level for a PBCore description and
                                                        its associated description document (XML)."</xsd:documentation>
              </xsd:annotation>
             </xsd:element>
            </xsd:sequence>
           </xsd:complexType>
          </xsd:element>
}}}

A collection description is the formalization combined with the Pattern Expression, that documents the used patterns and the rationalizations upon which the collection is based.

Main elements are inclusive but not limited to:

  • Title -- something descriptive, not to long. MUST match the page name.

  • Pattern expression -- The general, and yet formalized, description of the process and thoughts that forms the basis of the collection architecture. With references to a series of connected patterns.

  • Collection description -- A short, more technical, description of the elements that form the collection.

  • Workflow -- a how to for the collection, implementation / usage.

  • Technical/Collection formalization -- The actual DOMS collection described. This should be represented in the best possible way, it can be a diagram, it can also be represented by a XML file, or parts thereof. Other descriptive measures should also be considered.

Pattern expression

The foundation of the choices for the collection

Write your pattern expression here, it's the rationale behind the collections structure.

Be sure to include the patterns that you use and describe the way relationships affect the pattens.

Collection description

The What

Sum up the elements in the collection here, focus on core descriptive and technical metadata fields.

Workflow

The how

Describe the intended usage of and content addition to this collection, use all available measures that help clarify on the subject. Consider images in addition to text. This will be the section that is most useful for the personnel working with the digitization process and/or the conversion of old collections.

Technical

Be concrete and go into detail of things that require it, especially parts of the collection that is complex or of a special nature.

Consider using a drawing to illustrate relations or for instance include (psudo)code/XML snippets.

<!-- the pbcore identifier - this element may occur as many times as
desired, however if it does occur, then a indentifier tag must appear
internally (once).  optionally, a identifierSource tag may appear -->
  <xsd:element maxOccurs="unbounded" minOccurs="1" name="pbcoreIdentifier">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element maxOccurs="1" minOccurs="1" name="identifier" type="xsd:string">
          <xsd:annotation>
           <xsd:documentation xml:lang="eng">"The descriptor identifier is used to
                                                        reference or identify the entire record of metadata descriptions for a
                                                        media item and exists at the top level for a PBCore description and
                                                        its associated description document (XML). Best practice is to
                                                        identify the media item (whether analog or digital) by means of an
                                                        unambiguous string or number corresponding to an established or formal
                                                        identification system if one exists. Otherwise, use an identification
                                                        method that is in use within your agency, station, production company,
                                                        office, or institution."</xsd:documentation>
           </xsd:annotation>
          </xsd:element>
          <xsd:element maxOccurs="1" minOccurs="1" name="identifierSource"
                                                         type="pbcore.string.type.base">
            <xsd:annotation>
              <xsd:documentation xml:lang="eng">"The descriptor identifierSource is
                                                        used in combination with the unambiguous reference or identifier for a
                                                        media item found in the descriptor identifier. Thus PBCore provides
                                                        not only a locator number, but also an agency or institution who
                                                        assigned it. Both exist at the top level for a PBCore description and
                                                        its associated description document (XML)."</xsd:documentation>
              </xsd:annotation>
             </xsd:element>
            </xsd:sequence>
           </xsd:complexType>
          </xsd:element>

GuidelinesForNewDatamodel/Collections (last edited 2010-03-17 13:13:45 by localhost)