Versions Compared

Key

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

...

Lifecycle Step

Flat Data

Data

Create

The single record is created. During ingest the preview is stored as file on the record itself.

When uploading a data record in the MediaHaven REST API

  • The original representation is created instantly in addition to the data object itself

  • The access representation is generated during the ingest of the data object

Update

The single record is updated

By using Metadata Inheritancethe updated metadata is inherited from data object to the representations if configured for the metadata field.

Publish

The single record is published

By using Publish Cascade the representations are automatically published when the data object is published.

Delete

The single record is deleted

By using Delete Cascade the representations are automatically deleted when the data object is deleted.

...

Action

Finding the original representation

  • Use the representations API endpoint

  • Or fetch the record specified by the metadata field OriginalRecordId on the data object

  • Or search with +DataRecordId:<data record ID> +IsOriginal:true

Finding the access representation

  • Use the representations API endpoint

  • Or search with +DataRecordId:<data record ID> +IsAccess:true

  • Or fetch the record specified by the metadata field PreviewRecordId on the original representation

  • Note: the metadata field PreviewRecordId on the data object points to the original representation (warning)

Get the technical metadata

  • Fetch Fetching the technical metadata for the data object or returns the technical metadata of the original representation

  • Fetch the technical metadata of the access representation

Omit representations from search results

If you do not want the representations in the search results you can filter them out by searching only with +RecordStructure:(Data Intellectual)

Export

  • Use the regular export API for exporting the file itself

  • Specify the export option combine “ZipTree” to export it as a zip containing all representations

...