Difference between revisions of "METS"

From Archivematica
Jump to navigation Jump to search
 
(30 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
[[Main Page]] > [[Development]] > [[:Category:Development documentation|Development documentation]] > [[Metadata elements]] > METS
 
[[Main Page]] > [[Development]] > [[:Category:Development documentation|Development documentation]] > [[Metadata elements]] > METS
  
=Basic outline=
+
<div style="padding: 10px 10px; border: 1px solid black; background-color: #F79086;">This page is no longer being maintained and may contain inaccurate information. Please see the [https://www.archivematica.org/docs/latest/ Archivematica documentation] for up-to-date information. </div> <p>
*The METS file will have a basic generic structure which will be present for all AIPs derived from different kinds of transfers.
 
  
 +
=METS for Archivematica AIP=
 +
 +
==Basic outline==
 +
*The METS file will have a basic generic structure which will be present for all AIPs derived from different kinds of transfers. Archivematica currently uses METS version 1.11
 
[[File:METS_outline.png|680px|thumb|center|]]
 
[[File:METS_outline.png|680px|thumb|center|]]
 
+
*Sample METS from 1.0: [[Media:METS.752545fa-6869-41d4-95b1-710ac659525d.xml]]
==<dmdSec>==
+
===<dmdSec>===
 
*There may be one dmdSec for the AIP as a whole. Each original file may also have a dmdSec.
 
*There may be one dmdSec for the AIP as a whole. Each original file may also have a dmdSec.
*The dmdSecs are numbered dmdSec_01, dmdSec_02 etc.
+
*The dmdSecs are numbered dmdSec_1, dmdSec_2 etc.
 
*The dmdSec contains Dublin Core metadata. If the user does not enter any DC metadata during transfer/ingest and no DC metadata was included in the transfer (eg as part of a DSpace export), there will be no dmdSec.
 
*The dmdSec contains Dublin Core metadata. If the user does not enter any DC metadata during transfer/ingest and no DC metadata was included in the transfer (eg as part of a DSpace export), there will be no dmdSec.
 
*The dmdSec may contain a reference to metadata in another file, such as a mets.xml file included in a DSpace export.  
 
*The dmdSec may contain a reference to metadata in another file, such as a mets.xml file included in a DSpace export.  
  
==<amdSec>==
+
===<amdSec>===
 
*There is one amdSec for each object.
 
*There is one amdSec for each object.
*The amdSec is identified by the filename and UUID.
+
*The amdSecs are numbered amdSec_1, amdSec_2 etc.
*Each amdSec will include one digiprovMD.
+
*Each amdSec will include one techMD and multiple digiprovMDs
 
*An amdSec for an original object may also contain one or more rightsMDs. The rightsMD may contain a reference to metadata in another file, such as a mets.xml file included in a DSpace export.  
 
*An amdSec for an original object may also contain one or more rightsMDs. The rightsMD may contain a reference to metadata in another file, such as a mets.xml file included in a DSpace export.  
  
==<fileSec>==
+
===<fileSec>===
 
*There is one fileSec listing all files.
 
*There is one fileSec listing all files.
*The fileSec is organized into the following fileGrps, only the first of which is required for all METS files:
+
*The fileSec is organized into the following fileGrps:
 
**original
 
**original
 
**preservation
 
**preservation
 
**service
 
**service
 
**access
 
**access
 +
**submissionDocumentation
 
**license
 
**license
 
**text/ocr
 
**text/ocr
 +
*''Original'' is required for all METS files.
 +
*''SubmissionDocumentation'' is included if the AIP includes submission documentation.
 +
*''Preservation'' is included if the AIP includes normalized files.
 +
*''Service'' and ''access'' may be used if the AIP contains those subfolders - i.e as the output of digitization workflows.
 +
*''License'' and ''text/ocr'' are used if the AIP was created from a DSpace export containing licenses and ocr text files.
 +
 +
===<structMap>===
 +
*As of Archivematica 1.7 there are two structMaps.  The first is labeled "Archivematica Default" and shows the physical layout of the files in the objects directory.
  
==<structMap>==
+
The second is labeled "Normative Directory Structure" which shows the logical structure of the files in the objects directory.  This second structMap is needed to document empty directories before they are deleted at 'store AIP' in the Storage Service.  At AIP re-ingest the new logical structMap will be parsed to re-create the empty directories.
*There is one structMap showing the physical layout of the files in the objects directory.
 
  
=Detailed outline=
+
==Detailed outline==
  
[[File:METS_outline1a.png|680px|thumb|center|]]
+
[[File:METS_outline_1a.png|680px|thumb|center|]]
  
[[File:METS_outline1b.png|680px|thumb|center|]]
+
[[File:METS_outline_1b.png|680px|thumb|center|]]
  
=dmdSec=
+
==dmdSec==
  
==mdWrap==
+
===mdWrap===
  
 
The dmdSec consists of simple Dublin Core, except for <isPartOf>, which is a qualification of <Relation>.
 
The dmdSec consists of simple Dublin Core, except for <isPartOf>, which is a qualification of <Relation>.
  
[[File:dmdSec.png|680px|thumb|center|]]
+
[[File:METS_dmdSec.png|680px|thumb|center|]]
 +
 
 +
===mdRef===
 +
The descriptive metadata for DSpace collections are contained in the METS files that come with the DSpace export, so the Archivematica METS file will point to them using mdRef.
 +
 
 +
[[File:METS_mdRef.png|680px|thumb|center|]]
 +
 
 +
==amdSec==
 +
The amdSec consists of either PREMIS metadata created by Archivematica or (in the case of rights metadata) references to external content. The screenshot below shows the amdSec for a file that has two rightsMD sections, one with rights captured in the PREMIS metadata (rightsMD_1) and one pointing to rightsMD sections in an external METS file (rightsMD_2).
 +
 
 +
[[File:METS_amdSec.png|680px|thumb|center|]]
 +
 
 +
=METS for Archivematica transfer=
 +
Archivematica creates a METS file for each transfer showing a structMap for the transfer.
  
==mdRef==
+
[[File:METS_transfer.png|680px|thumb|center|]]
The descriptive metadata for DSpace collections are contained in the METS files that come with the DSpace export, so the Archivematica METS file will point to them using mdRef. In this example, dmdSec_01 points to the collection-level mets file; dmdSec_02 and dmdSec_03 point to the mets files for the objects:
 
  
[[File:dmdSec1.png|680px|thumb|center|]]
+
=Changes for 0.9=
  
=amdSec=
+
In order to allow users to display digital files in a specified order in the access system, the following changes will be made to the structMap in Archivematica 0.9:
The amdSec consists either of PREMIS metadata created by Archivematica or references to external content.
+
*Files in the structMap will be ordered alphabetically by original name
 +
**Numbers will be respected
 +
**Case will be ignored
 +
**If the objects directory has subdirectories, the structMap will sort alphabetically by directory and within each directory
 +
*Each file will be placed in its own div
 +
*If desired, div labels can be applied to files via a csv file entitled ''file_labels.csv'' included in the metadata directory of the transfer
 +
**The csv file would consist of two columns: filename and label
 +
**The div labels would map to the title field in the access system
 +
**The div labels would be applied only to original versions of the files, not normalized versions
  
==PREMIS in METS==
+
[[File:structMap-09.png|680px|thumb|center|]]

Latest revision as of 15:34, 11 February 2020

Main Page > Development > Development documentation > Metadata elements > METS

This page is no longer being maintained and may contain inaccurate information. Please see the Archivematica documentation for up-to-date information.

METS for Archivematica AIP[edit]

Basic outline[edit]

  • The METS file will have a basic generic structure which will be present for all AIPs derived from different kinds of transfers. Archivematica currently uses METS version 1.11
METS outline.png

<dmdSec>[edit]

  • There may be one dmdSec for the AIP as a whole. Each original file may also have a dmdSec.
  • The dmdSecs are numbered dmdSec_1, dmdSec_2 etc.
  • The dmdSec contains Dublin Core metadata. If the user does not enter any DC metadata during transfer/ingest and no DC metadata was included in the transfer (eg as part of a DSpace export), there will be no dmdSec.
  • The dmdSec may contain a reference to metadata in another file, such as a mets.xml file included in a DSpace export.

<amdSec>[edit]

  • There is one amdSec for each object.
  • The amdSecs are numbered amdSec_1, amdSec_2 etc.
  • Each amdSec will include one techMD and multiple digiprovMDs
  • An amdSec for an original object may also contain one or more rightsMDs. The rightsMD may contain a reference to metadata in another file, such as a mets.xml file included in a DSpace export.

<fileSec>[edit]

  • There is one fileSec listing all files.
  • The fileSec is organized into the following fileGrps:
    • original
    • preservation
    • service
    • access
    • submissionDocumentation
    • license
    • text/ocr
  • Original is required for all METS files.
  • SubmissionDocumentation is included if the AIP includes submission documentation.
  • Preservation is included if the AIP includes normalized files.
  • Service and access may be used if the AIP contains those subfolders - i.e as the output of digitization workflows.
  • License and text/ocr are used if the AIP was created from a DSpace export containing licenses and ocr text files.

<structMap>[edit]

  • As of Archivematica 1.7 there are two structMaps. The first is labeled "Archivematica Default" and shows the physical layout of the files in the objects directory.

The second is labeled "Normative Directory Structure" which shows the logical structure of the files in the objects directory. This second structMap is needed to document empty directories before they are deleted at 'store AIP' in the Storage Service. At AIP re-ingest the new logical structMap will be parsed to re-create the empty directories.

Detailed outline[edit]

METS outline 1a.png
METS outline 1b.png

dmdSec[edit]

mdWrap[edit]

The dmdSec consists of simple Dublin Core, except for <isPartOf>, which is a qualification of <Relation>.

METS dmdSec.png

mdRef[edit]

The descriptive metadata for DSpace collections are contained in the METS files that come with the DSpace export, so the Archivematica METS file will point to them using mdRef.

METS mdRef.png

amdSec[edit]

The amdSec consists of either PREMIS metadata created by Archivematica or (in the case of rights metadata) references to external content. The screenshot below shows the amdSec for a file that has two rightsMD sections, one with rights captured in the PREMIS metadata (rightsMD_1) and one pointing to rightsMD sections in an external METS file (rightsMD_2).

METS amdSec.png

METS for Archivematica transfer[edit]

Archivematica creates a METS file for each transfer showing a structMap for the transfer.

METS transfer.png

Changes for 0.9[edit]

In order to allow users to display digital files in a specified order in the access system, the following changes will be made to the structMap in Archivematica 0.9:

  • Files in the structMap will be ordered alphabetically by original name
    • Numbers will be respected
    • Case will be ignored
    • If the objects directory has subdirectories, the structMap will sort alphabetically by directory and within each directory
  • Each file will be placed in its own div
  • If desired, div labels can be applied to files via a csv file entitled file_labels.csv included in the metadata directory of the transfer
    • The csv file would consist of two columns: filename and label
    • The div labels would map to the title field in the access system
    • The div labels would be applied only to original versions of the files, not normalized versions
StructMap-09.png