Import metadata¶
To import metadata with your transfer, you must structure your transfer to
include a directory called metadata
. The folder can contain any type of
metadata that you wish to preserve alongside your digital objects. If you
include a metadata.csv
file structured as described on this page,
Archivematica is able to parse the metadata into the dmdSec (descriptive
metadata section) of the METS file. This metadata also becomes searchable
in the Archival Storage tab.
Workflow¶
- Create a transfer folder that contains a folder called
metadata
. For simple objects, the user places files in the objects directory, with or without intervening subdirectories.
- For compound objects, create one or more subdirectories in the objects directory, each containing the files that form a compound object.
Important
The subdirectory names must not contain spaces or other forbidden characters.
- Add a csv file to the metadata folder for the transfer called
metadata.csv
.
The first row of the csv file consists of field names. Field names must not include spaces.
Dublin Core field names must contain the “dc” element in the name, eg “dc.title”. Note that the Dublin Core is not validated, this is up to the user.
Each subsequent row contains the complete set of field values for a single directory or file.
As of version 1.4, mixed directory and object level metadata is allowed in the metadata.csv.
For multi-value fields (such as dc.subject), the entire column is repeated and each column contains a single value.
If the metadata are for simple objects, the csv file must contain a “filename” column listing the filepath and filename of each objects: eg “objects/BrocktonOval.jp2”
If the metadata are for compound objects, the “filename” column contains the names of the directories containing the items that form the compound object: eg “objects/Jan021964”
Note that filenames can be duplicates of filenames in other subdirectories if desired. For example, the name “page01.jp2” can occur in multiple subdirectories.
- At the generate METS micro-service, Archivematica parses the metadata in metadata.csv to the METS file, as follows:
- All Dublin Core elements are used to generate a dmdSec for each directory or file with MDTYPE=”DC”
- All non-Dublin Core elements are used to generate a dmdSec for each directory or file with MDTYPE=”OTHER” OTHERMDTYPE=”CUSTOM”
- The dmdSecs are linked to their directories or files in the structMap.
Simple objects¶
This section provides csv file and METS file examples for simple objects - i.e. individual files that are not pages in a compound object such as a book or a newspaper issue.
CSV file
Sample headings and values
filename | dc.title | dcterms.issued | dc.publisher | dc.contributor | dc.subject | dc.subject | dc.date | dc.description | notes | dcterms.isPartOf | repository | dc.rights | project_website | dc.format |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
objects/BrocktonOval.jp2 | Stanley Park in December | 1996-01-17 | Riley Studios, Vancouver BC | Don Langfield, photographer | Vancouver (B.C.)–Parks | Landscapes | 1992/12/04 | Image shows Brockton Oval after light snowfall | Originally part of series entitled “Winter in Vancouver” | Riley Studios collection | New Caledonia Public Library | Copyright held by Riley Studios | http://www.ncpl/donlangfieldphotographs.ca | image/jp2 |
objects/QEParksunset.jp2 | Sunset in Queen Elizabeth Park | Riley Studios, Vancouver BC | Don Langfield, photographer | Vancouver (B.C.)–Parks | 1994/07/13 | Riley Studios collection | New Caledonia Public Library | Copyright held by Riley Studios | http://www.ncpl/donlangfieldphotographs.ca | image/jp2 |
METS file
<mets xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.loc.gov/METS/" xsi:schemaLocation="http://www.loc.gov/METS/ http://www.loc.gov/standards/mets/version18/mets.xsd">
<dmdSec ID="dmdSec_1">
<mdWrap MDTYPE="DC">
<xmlData>
<dublincore xsi:schemaLocation="http://purl.org/dc/elements/1.1 http://dublincore.org/schemas/xmls/qdc/dc.xsd http://purl.org/dc/terms/ http://dublincore.org/schemas/xmls/qdc/2008/2/11/dcterms.xsd">
<title>Stanley Park in December</title>
<issued>1996-01-17</issued>
<subject>Vancouver (B.C.)--Parks</subject>
<subject>Landscapes</subject>
<description>Image shows Brockton Oval after light snowfall</description>
<publisher>Riley Studios, Vancouver B.C.</publisher>
<contributor>Don Langfield, photographer</contributor>
<date>1992-12-04</date>
<isPartOf>Riley Studios collection</isPartOf>
<rights>Copyright held by Riley Studios</rights>
<format>image/jp2</format>
</dublincore>
</xmlData>
</mdWrap>
</dmdSec>
<dmdSec ID="dmdSec_2">
<mdWrap MDTYPE="OTHER" OTHERMDTYPE="CUSTOM">
<xmlData>
<notes>
Originally part of series entitled "Winter in Vancouver"
</notes>
<repository>
New Caledonia Public Library
</repository>
<project_website>http://www.ncpl/donlangfieldphotographs.ca</project_website>
</xmlData>
</mdWrap>
</dmdSec>
<dmdSec ID="dmdSec_3">
<mdWrap MDTYPE="DC">
<xmlData>
<dublincore xsi:schemaLocation="http://purl.org/dc/elements/1.1 http://dublincore.org/schemas/xmls/qdc/dc.xsd http://purl.org/dc/terms/ http://dublincore.org/schemas/xmls/qdc/2008/2/11/dcterms.xsd">
<title>Sunset in Queen Elizabeth Park</title>
<subject>Vancouver (B.C.)--Parks</subject>
<publisher>Riley Studios, Vancouver BC</publisher>
<contributor>Don Langfield, photographer</contributor>
<date>1994-07-13</date>
<rights>Copyright held by Riley Studios</rights>
</dublincore>
</xmlData>
</mdWrap>
</dmdSec>
<dmdSec ID="dmdSec_4">
<mdWrap MDTYPE="OTHER" OTHERMDTYPE="CUSTOM">
<xmlData>
<forms_part_of>Riley Studios collection </forms_part_of>
<repository>New Caledonia Public Library</repository>
<project_website>http://www.ncpl/donlangfieldphotographs.ca</project_website>
<digital_image_format>image/jp2</digital_image_format>
</xmlData>
</mdWrap>
</dmdSec>
<fileSec>
<fileGrp USE="original">
<file ID="BrocktonOval.jp2-aeebe429-9b5f-453c-8f73-57ed53f12b6f" GROUPID="Group-aeebe429-9b5f-453c-8f73-57ed53f12b6f" ADMID="amdSec_1">
<FLocat xlink:href="objects/BrocktonOval.jp2" LOCTYPE="OTHER" OTHERLOCATYPE="SYSTEM"/>
</file>
<file ID="QE_Park_sunset.jp2-47faa4c2-fa23-4484-aa08-8d50945b1c5d" GROUPID="Group-47faa4c2-fa23-4484-aa08-8d50945b1c5d" ADMID="amdSec_2">
<FLocat xlink:href="objects/QE_Park_sunset.jp2" LOCTYPE="OTHER" OTHERLOCATYPE="SYSTEM"/>
</file>
</fileGrp>
</fileSec>
<structMap TYPE="physical" LABEL="Archivematica default">
<div TYPE="directory" LABEL="Simple-0c754dae-6a7f-4837-9ecd-8a0ff36e694b">
<div TYPE="directory" LABEL="objects">
<div TYPE="Item" DMDID="dmdSec_1 dmdSec_2">
<fptr FILEID="BrocktonOval.jp2-aeebe429-9b5f-453c-8f73-57ed53f12b6f"/>
</div>
<div TYPE="Item" DMDID="dmdSec_3 dmdSec_4">
<fptr FILEID="QE_Park_sunset.jp2-47faa4c2-fa23-4484-aa08-8d50945b1c5d"/>
</div>
<div TYPE="directory" LABEL="submissionDocumentation">
<div TYPE="directory" LABEL="transfer-Simple-525a57bb-cec8-4279-ae77-b95171f84c59"/>
</div>
</div>
</div>
</structMap>
</mets>
Compound objects¶
This section provides csv file and METS file examples for compound objects - i.e. multi-page digital objects such as newspapers and books.
CSV file
Sample headings and values
parts | dc.title | alternative_title | dc.publisher | dates_of_publication | dc.subject | dc.date | dc.description | frequency | dc.language | forms_part_of | repository | project_website | digital_file_format |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
objects/Jan021964 | Coast News, January 02, 1964 | Sunshine Coast News | Fred Cruice | 1945-1995 | Gibsons (B.C.)–Newspapers | 1964/01/02 | Serving the Growing Sunshine Coast | Weekly | English | British Columbia Historical Newspapers collection | Sunshine Coast Museum and Archives | http://historicalnewspapers.library.ubc.ca | image/jp2 |
objects/Jan091964 | Coast News, January 09, 1964 | Sunshine Coast News | Fred Cruice | 1945-1995 | Gibsons (B.C.)–Newspapers | 1964/01/09 | Serving the Growing Sunshine Coast | Weekly | English | British Columbia Historical Newspapers collection | Sunshine Coast Museum and Archives | http://historicalnewspapers.library.ubc.ca | image/jp2 |
METS file
<mets xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.loc.gov/METS/" xsi:schemaLocation="http://www.loc.gov/METS/ http://www.loc.gov/standards/mets/version18/mets.xsd">
<dmdSec ID="dmdSec_1">
<mdWrap MDTYPE="DC">
<xmlData>
<dublincore xsi:schemaLocation="http://purl.org/dc/elements/1.1 http://dublincore.org/schemas/xmls/qdc/dc.xsd http://purl.org/dc/terms/ http://dublincore.org/schemas/xmls/qdc/2008/2/11/dcterms.xsd">
<title>Coast News, January 02, 1964</title>
<subject>Gibsons (B.C.)--Newspapers</subject>
<description>Serving the Growing Sunshine Coast</description>
<publisher>Fred Cruice</publisher>
<date>1964/01/02</date>
<language>English</language>
</dublincore>
</xmlData>
</mdWrap>
</dmdSec>
<dmdSec ID="dmdSec_2">
<mdWrap MDTYPE="OTHER" OTHERMDTYPE="CUSTOM">
<xmlData>
<alternative_title>Sunshine Coast News</alternative_title>
<dates_of_publication>1945-1995</dates_of_publication>
<frequency>Weekly</frequency>
<forms_part_of>British Columbia Historical Newspapers Collection</forms_part_of>
<repository>
Sunshine Coast Museum and Archives
</repository>
<project_website>http://historicalnewspapers.library.ubc.ca</project_website>
<digital_image_format>image/jp2</digital_image_format>
</xmlData>
</mdWrap>
</dmdSec>
<dmdSec ID="dmdSec_3">
<mdWrap MDTYPE="DC">
<xmlData>
<dublincore xsi:schemaLocation="http://purl.org/dc/elements/1.1 http://dublincore.org/schemas/xmls/qdc/dc.xsd http://purl.org/dc/terms/ http://dublincore.org/schemas/xmls/qdc/2008/2/11/dcterms.xsd">
<title>Coast News, January 09, 1964</title>
<subject>Gibsons (B.C.)--Newspapers</subject>
<description>Serving the Growing Sunshine Coast</description>
<publisher>Fred Cruice</publisher>
<date>1964/01/09</date>
<language>English</language>
</dublincore>
</xmlData>
</mdWrap>
</dmdSec>
<dmdSec ID="dmdSec_4">
<mdWrap MDTYPE="OTHER" OTHERMDTYPE="CUSTOM">
<xmlData>
<alternative_title>Sunshine Coast News</alternative_title>
<dates_of_publication>1945-1995</dates_of_publication>
<frequency>Weekly</frequency>
<forms_part_of>British Columbia Historical Newspapers Collection</forms_part_of>
<repository>Sunshine Coast Museum and Archives</repository>
<project_website>http://historicalnewspapers.library.ubc.ca</project_website>
<digital_image_format>image/jp2</digital_image_format>
</xmlData>
</mdWrap>
</dmdSec>
<fileSec>
<fileGrp USE="original">
<file ID="page01.jp2-31e3ee5c-ff7a-4fb9-818d-e325345a5766" GROUPID="Group-31e3ee5c-ff7a-4fb9-818d-e325345a5766" ADMID="amdSec_1">
<FLocat xlink:href="objects/Jan021964/page01.jp2" LOCTYPE="OTHER" OTHERLOCTYPE="SYSTEM"/>
</file>
<file ID="page02.jp2-626bc937-5a6e-4a32-adf4-7db7ab5a3e66" GROUPID="Group-626bc937-5a6e-4a32-adf4-7db7ab5a3e66" ADMID="amdSec_2">
<FLocat xlink:href="objects/Jan021964/page02.jp2" LOCTYPE="OTHER" OTHERLOCTYPE="SYSTEM"/>
</file>
<file ID="page01.jp2-38e939e0-74fe-4ace-81ff-da4b89fa3481" GROUPID="Group-38e939e0-74fe-4ace-81ff-da4b89fa3481" ADMID="amdSec_3">
<FLocat xlink:href="objects/Jan091964/page01.jp2" LOCTYPE="OTHER" OTHERLOCTYPE="SYSTEM"/>
</file>
<file ID="page02.jp2-f42aaa1b-3816-45ed-9419-193474462481" GROUPID="Group-f42aaa1b-3816-45ed-9419-193474462481" ADMID="amdSec_4">
<FLocat xlink:href="objects/Jan091964/page02.jp2" LOCTYPE="OTHER" OTHERLOCTYPE="SYSTEM"/>
</file>
</fileGrp>
</fileSec>
<structMap TYPE="physical" LABEL="Archivematica default">
<div TYPE="directory" LABEL="Compound-6ef65864-d8ce-46df-b6e7-cd7d75498110">
<div TYPE="directory" LABEL="objects">
<div TYPE="directory" LABEL="Jan021964" DMDID="dmdSec_1 dmdSec_2">
<div TYPE="item">
<fptr FILEID="page01.jp2-31e3ee5c-ff7a-4fb9-818d-e325345a5766"/>
</div>
<div TYPE="item">
<fptr FILEID="page02.jp2-626bc937-5a6e-4a32-adf4-7db7ab5a3e66"/>
</div>
</div>
<div TYPE="directory" LABEL="Jan091964" DMDID="dmdSec_3 dmdSec_4">
<div TYPE="item">
<fptr FILEID="page01.jp2-38e939e0-74fe-4ace-81ff-da4b89fa3481"/>
</div>
<div TYPE="item">
<fptr FILEID="page02.jp2-f42aaa1b-3816-45ed-9419-193474462481"/>
</div>
</div>
<div TYPE="directory" LABEL="submissionDocumentation">
<div TYPE="directory" LABEL="transfer-Compound-03e22333-4ce3-415f-adbf-9d392931bfb6"/>
</div>
</div>
</div>
</structMap>
</mets>
Archivematica 1.5
Search
Open the general index or type your search in the search box.
Available projects
Archivematica
- Version 1.16.0 (stable-current)
- Version 1.15.1 (stable-previous)
- Version 1.14.1 (legacy)
- Version 1.13.2 (legacy)
- Version 1.12.2 (legacy)
- Version 1.11.2 (legacy)
- Version 1.10.2 (legacy)
- Version 1.9.3 (legacy)
- Version 1.8.1 (legacy)
- Version 1.7.2 (legacy)
- Version 1.6.1 (legacy)
- Version 1.5 (legacy)
- Version 1.4 (legacy)
Archivematica Storage Service
- Version 0.22.0 (stable-current)
- Version 0.21.1 (stable-previous)
- Version 0.20.1 (legacy)
- Version 0.19.0 (legacy)
- Version 0.18.1 (legacy)
- Version 0.17.1 (legacy)
- Version 0.16.1 (legacy)
- Version 0.15.1 (legacy)
- Version 0.14.1 (legacy)
- Version 0.13.0 (legacy)
- Version 0.12.0 (legacy)
- Version 0.11.1 (legacy)
- Version 0.10 (legacy)
- Version 0.9 (legacy)
- Version 0.8 (legacy)
License
Archivematica documentation by Artefactual Systems Inc. is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.