Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Batch manifests must be in comma-separated values (.csv) format; the batch ingest will not accept Excel spreadsheets (.xlsx, etc.), so please remember to export your files as .csv if you are editing them with Excel, Google Sheets, LibreOffice Calc, or other spreadsheet software.

Manifest format

The following is a sample of a batch manifest:

Collection name

The collection must already exist in AMP. The name of the collection is used to determine:

  • which collection Dropbox holds the media files to be uploaded
  • to which collection in AMP the information in that line refers.

External Source (Source is the old column name)

This field may be left blank. It can be used to tell AMP the source system of the item. This information is added by AMP in the bag it provides with AMP-generated metadata for target systems to consume. Within AMP this currently serves no purpose.

External Item ID (Source ID is the old column name)

This field may be left blank. When provided, it is used as the unique identifier of the item during the batch ingest process (if not, Item Title is the unique identifier). This allows items within the same collection to have the same Title.

Item Title

The bibliographic title of the item. If the External Item ID is not provided, this title is used to uniquely identify an item within a collection; in this case, one cannot have multiple items with the same title within a collection.

Item Description

This field may be left blank. When provided, it will be displayed as the item description in AMP.

Primary File

This is the filename of the media file that has been placed in the Dropbox for ingestion. The uniqueness of a primary file is the combination of Collection, Item/External ID, and Primary File Label. File names are unique within an item, but not across items (that is, two distinct items can have the same primary filename).

Warning: if a batch manifest includes 2 lines with the same value in the Primary file column for different items in the same collection, the validation step will let it pass, but the ingestion process will have a runtime error because in the dropbox there can only be one copy of a file with that name.

Primary File Label

Users must provide a label (or title) for the file. That label will be used to uniquely identify the file within this item. In other words, one cannot have multiple primary files with the same label if they are associated with the same item within the same collection. 

Primary File Description

This field may be left blank. When provided, it will be displayed as the file description in AMP.

Supplemental File fields:

Multiple supplemental files can be specified per line. For each supplemental file, you need 4 fields:

...