Versions Compared

Key

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

...

Each Item should sit in a flat hierarchy inside of a folder suitable for ingest. As Items can contain more than one media object, each object should exist in the same folder. The folder should also contain a Manifest for use in Avalon.

 


Code Block
FolderContainingContent

...


├── assets

...


   ├── file2.mp4

...


   ├── file3.mp4

...


   └── file.mp4

...


└── manifest.csv


File naming conventions

To arrange materials downstream, when Archivematica and Avalon connect to each other, the Transfer Name in Archivematica should be the same as the desired Collection to be output. A unique identifier will be minted by Archivematica.

...

Files are then stored in the transfer source, which can be thought of as a staging location for all files waiting to be processed through Archivematica and have been prepared for long term storage and access copy deposit into Avalon. This transfer source will be connected to Archivematica, and files can be discovered via the Archivematica dashboard.

Validation service call

Avalon Media System users who want to validate their Manifest files prior to moving through the Archivematica preservation process can test their Manifest CSVs by sending the CSV to an endpoint in the Archivematica API. 

Usage example: (assuming that path/to/Manifest.csv exists)

curl http://127.0.0.1:62080/api/v2beta/validate/avalon \

  --data-binary "@path/to/Manifest.csv" \

  --header "Authorization: ApiKey test:test" \

  --header "Content-Type: text/csv; charset=utf-8"

Note on above example: do not use --data, use --data-binary instead.

Response examples:

200 OK

(Response was valid)

{

  "valid": true

}

400 Bad Request

(Expect reason to include different validation errors, or that the file could not be found)

{

  "valid": false,

  "reason": "Administrative data must include reference name and author."

}

404 Not Found

(Validator was not found.)

{

  "error": true,

  "message": "Unknown validator. Accepted values: avalon"

}

This request can be performed manually, per manifest, or set to run regularly on all files in a folder using the cron service or another script scheduler.

Archivematica transfer and ingest initiation 

...