Batch ingest simple assets

Batch ingest simple assets

 

MultiExcerpt

Staging options for simple assets

Option 1 - Media file objects only (no MODS XML files)

Place all media files directly into the batch job folder. The DAMS will create one DAMS asset per file, guessing the content model based on the file name extension. The media file will be stored as the asset's OBJ datastream, and the filename of each ingested media file will be used as a preliminary title in the DAMS.

There is currently NO function to batch ingest XML, for attaching it to previously-ingested objects.

After ingesting assets with Method 1 (object-only) ingest, you have the following options to add metadata to the assets:

    • Add metadata via DAMS GUI form, one object at a time

    • Replace MODS XML datastreams, one object at a time

    • Add or edit common metadata via batch edit - currently only a limited set of metadata elements can be edited in batch after ingest

Option 2 - Media file objects and MODS XML files

Place all media files directly into the batch job folder. Add a corresponding MODS XML file per media file. Each MODS XML documents MUST be named with a filename matching the corresponding media file object, followed by the suffix _METADATA (and the file name extension .xml):

  1. <filename>.tif

  2. <filename>_METADATA.xml

The DAMS will create one DAMS asset per media file, guessing the content model based on the file name extension. The media file will be stored as the asset's OBJ datastream, the corresponding MODS XML document will be stored as the asset's MODS datastream.

Option 3 - Media file objects and common metadata MODS XML file

Place all media files directly into the batch job folder. Add one MODS XML document named common_METADATA.xml containing common metadata that will be used for all assets created from this batch.

The DAMS will create one DAMS asset per media file, guessing the content model based on the file name extension. The media file will be stored as the asset's OBJ datastream, and each asset will store a copy of the common metadata MODS XML document in its MODS datastream.

Option 4 - XML only (create placeholder assets)

This option allows to create placeholder DAMS assets which contain only metadata, but no media file object. Use Method 5, described below, to add media file objects to placeholder assets created with Method 4.

Method 4 does NOT allow to add MODS XML metadata to DAMS assets that were previously ingested using Method 1 (object only). There is currently no method available to add MODS XML metadata to DAMS assets that were previously ingested without metadata.

Place MODS XML documents directly into the batch job folder. The filenames of the XML documents MUST contain a suffix that indicates the Content Model the DAMS should use for creating placeholder assets. The Content Model specified when creating placeholder assets with this method CANNOT be changed after ingest.

The general pattern for naming MODS XML documents for this ingest method is <filename>==<CONTENTMODEL>.xml.

  • The <filename> portion CANNOT contain spaces, use underscore (_) instead.

  • It is recommended that the <filename> portion anticipates the filename of the media file object to be added later, but this is not a requirement. Media file objects added later with Method 5 (see below) are matched to their respective placeholder assets using a manifest file and the placeholder asset PIDs.

  • Use 2 (two) equal signs to connect the <filename> portion and the <CONTENTMODEL> portion of the XML document's filename.

  • The <CONTENTMODEL> portion of the filename must be one of the following options:

    • L-IMAGE (Large Image content model, for TIF or JPEG 2000 files; example filename: my_large_image23==L-IMAGE.xml)

    • AUDIO (Audio content model, typically for WAV or MP3 files; example filename: interview_part1==AUDIO.xml)

    • VIDEO (Video content model; example filename: episode012==VIDEO.xml)

    • PDF (PDF content model; example filename: my_pdf_file==PDF.xml)

    • BINARY (Binary content model; example filename: very_important_asset==BINARY.xml)

The DAMS will create one DAMS asset per MODS XML file, using the content model specified in the filename. Each asset will store the metadata contained in the MODS XML file in its MODS datastream. The OBJ datastream of each asset will contain a placeholder media file.

Option 5 - Add media file objects to placeholder assets

This ingest method adds media file objects to their corresponding placeholder assets created with Method 4. This method matches a media file objects to its corresponding placeholder asset in the DAMS using the placeholder asset's PID. To obtain a list of all assets and their PIDs in a given DAMS subcollection, you can use the DAMS asset report script: https://github.austin.utexas.edu/mmh4428/dams_user_tools/tree/main/reports or the Advanced Search function in the DAMS GUI.

Place media file objects directly into the batch job folder. Add a manifest file named info.txt in the same folder, to allow matching between placeholder asset and a media file.

  • Each line of the info.txt manifest MUST contain the following information: <PID without namespace identifier>===<filename.ext>.

  • <PID without namespace identifier> is the part of a PID after the colon (UUID), e.g. 9ebf6ac8-1823-4bf4-8398-654b54090776 for PID utlarch:9ebf6ac8-1823-4bf4-8398-654b54090776.

  • Use 3 (three) equal signs to separate the UUID and the <filename>

  • The <filename> portion CANNOT contain spaces, use underscore (_) instead.

Sample info.txt
Sample info.txt

Step 2: Upload batch job to Jscape

MultiExcerpt

Step 3: Set up collection and submit form in DAMS interface

MultiExcerpt