Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Fixed broken formatting

...

This format is designed to be a straightforward and precise representation of the DSpace data model's Item metadata. It represents the new metadata model described in MetadataSupport, which includes a "metadata schema" field.

Namespace

...

See XmlNamespaces for details. All elements are in the "dim" namespace, identified by the URI

...

http://www.dspace.org/xmlns/dspace/

...

dimImage Added

There will eventually be a schema for this namespace, as soon as

...

dspace.org

...

establishes a place to put schemas. The purpose of the schema is to document the

Code Block
dim

{dim}} element and allow validation.

...

Code Block
 <dim:dim xmlns:dim="<nowiki>httphttp://www.dspace.org/xmlns/dspace/dim</nowiki>dim" dspaceType="ITEM">
   <dim:field mdschema="dc" element="title" lang="en_US">
     The Endochronic Properties of Resublimated Thiotimonline
   </dim:field>
   <dim:field mdschema="dc" element="contributor" qualifier="author">
     Isaac Asimov
   </dim:field>
   <dim:field mdschema="dc" element="language" qualifier="iso">
     eng
   </dim:field>
   <dim:field mdschema="dc" element="subject" qualifier="other" lang="en_US">
     time-travel scifi hoax
   </dim:field>
   <dim:field element="publisher">
     Boston University Department of Biochemistry
   </dim:field>
 </dim:dim>

The root element is named

...

"dim"

...

(for DSpace Intermediate Metadata, also because it is an unappealing name in English to discourage exposing it!). This element may contain one attribute (along with namespace declarations):

  • The Code Block'''dspaceType''' attribute is the type of dspace object being described. The possible values of this attribute are: " Code BlockITEM", " Code BlockCOLLECTION", or " Code BlockCOMMUNITY".
  • The Code Block'''dim''' element contains a list of 0 or more Code Block"field" elements, each of which describes a single value. In each Code Blockfield element:
  • The Code Block'''mdschema''' attribute is the metadata schema, aka "namespace", described in MetadataSupport. In this example all fields are "dc", meaning the original DSpace LAP qualified DC. This could be the default when that attribute is omitted.
  • The Code Block'''element''' attribute is the Dublin Core element name, or its equivalent in another schema. It is required.
  • The Code Block'''qualifier''' attribute is the DC qualifier or equivalent. Omitting it means the qualifier is null.
  • Finally, the Code Block'''lang''' attribute is the language code associated with the entry. I deliberately did not use the XML standard Code Blockxml:lang name for this attribute because it implies semantics that we cannot guarantee to support, since the value of this attribute is whatever someone put into DSpace.
  • The text value of the Code Block'''field''' element is the value of the metadata field.
  • Any number of Code Block'''field''' elements are allowed, even with all attributes matching.

...

For ItemBatchUpdate (importing existing bibliographic data and uploading of corresponding files), DIM is "extended" the following ways:

  1. Code Block<dim:list>...</dim:list> now can enclose multiple items: Code Block<dim:dim>...</dim:dim>code
  2. <dim:field ... type="field-type">...</dim:field> is used to specify either type="unique" (to remove prior field content before inserting new one) either type="key" (to specify that the current record replaces the record which may (or not) exist with the same value: useful for external identifiers)
  3. Code Block<dim:remove mdschema="schema-name" element="element-name" qualifier="qualifier-name" lang="language_country"/> remove field occurrence(s) corresponding to the specified element-name, qualifier-name and (optional) language_country.
  4. Code Block<dim:original>file-path</dim:original> specifies the path of the document file to upload (not a "symbolic link")code
  5. <dim:licence>file-path</dim:licence> specifies the path to the licence file to uploadcode
  6. <dim:collection> collection complete handle or internal number Code Block </dim:collection> : Additional collection to link with the document

Modifications are in XSLTIngestionCrosswalk and are therefore common to ItemImport and XSLTingest (described in ItemBatchUpdate).

...