Imeji ingest

From MPDLMediaWiki
Revision as of 10:01, 21 August 2013 by Jroeder (talk | contribs)
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. Item metadata ingest: Ingesting of metadata to one (or more) item(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 -> Your Collection -> 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 -> Your Collection -> Ingest -> Profile Upload, then Add file
    • WARNING: An already existing profile of the collection will be overridden without prompt.

Item 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, PDFs, videos or audio), for each file an item is created in this collection at once
  4. Download the item list by navigating to Collections -> Your Collection -> View Items -> 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 -> Your Collection -> 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 -> Your Collection -> 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