Imeji ingest

From MPDLMediaWiki
Revision as of 15:27, 1 August 2013 by Jroeder (talk | contribs) (improvement, wording)
Jump to navigation Jump to search
Imeji logo.png

Internal
Meetings
Cooperation

Specification
Architecture
Installer
Ingest
Functional Specification
Technical Specification

Metadata
RDF mapping
Metadata terms

edit

The ingest feature is used to ingest metadata into imeji (which is done to avoid entering these metadata manually via the GUI interface). It is considered an expert feature. It is necessary to have a XML file of the metadata that shall be ingested (the so-called source XML file). In order to create a source XML file first a container XML file is downloaded from imeji which is then edited by the user (you write your metadata in the file) and uploaded afterwards. A detailed workflow is given below. This feature is especially beneficial if you use automatic means (e.g. scripts) to populate the source XML file with your metadata. The ingest feature is only accessible by the imeji system administrator.

Description[edit]

There are two different ingest modes:

  1. Metadata profile ingest: Ingesting of a metadata profile to a collection
  2. Image metadata ingest: Ingesting of metadata to one (or more) image(s)

Metadata profile ingest[edit]

  1. Be sure to be logged in as an admin.
  2. Create a collection (if not already existent), an empty metadata profile is created with the collection at once
  3. Download the metadata profile of this collection by navigating to Collections -> YourCollection -> Collection Metadata -> Show as XML, then download the XML file (this is the raw container XML file which includes only the information for the imeji system)
  4. Edit the metadata profile XML file and enter your metadata
    • WARNING: This must be done according to the imeji format. For more information on how to do this please contact the support list
  5. Ingest the edited profile XML file (this is the source XML file which includes the information for the imeji system AND your metadata) by navigating to Collections -> YourCollection -> Ingest -> Profile Upload, then Add file
    • WARNING: An already existing profile of the collection will be overridden without prompt.

Image metadata ingest[edit]

  1. Be sure to be logged in as an admin.
  2. Create a collection (if not already existent)
  3. Upload files (images, videos or audios), for each file an item is created in this collection at once
  4. Download the item list by navigating to Collections -> YourCollection -> View Images -> Download -> Metadata in imeji format, then download the XML file (this is the raw container XML file which includes only the information for the imeji system)
  5. Edit the item list XML file and enter your metadata
    • WARNING: This must be done according to the imeji format. For more information on how to do this please contact the support list at support list
    • Each metadata field must be defined by the according statement id. The id of each statement can be found on the Collections -> YourCollection -> Collection Metadata page.
  6. Ingest the edited item list XML file (this is the source XML file which includes the information for the imeji system AND your metadata) by navigating to Collections -> YourCollection -> Ingest -> Metadata Upload, then Add file
    • WARNING: Already existing item metadata will be overridden without prompt.

Architecture[edit]

Sequence Diagrams[edit]

Ingest Profile[edit]

IngestProfile sequence diagram.png

Ingest Item[edit]

IngestItem sequence diagram.png