Difference between revisions of "Imeji ingest"

	Internal; Meetings; Cooperation;
	Specification ; Architecture; Installer; Ingest; Functional Specification ; Technical Specification ;
	Metadata ; RDF mapping; Metadata terms;
	edit

Revision as of 09:38, 8 August 2013

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:

Metadata profile ingest: Ingesting of a metadata profile to a collection
Item metadata ingest: Ingesting of metadata to one (or more) item(s)

Metadata profile ingest[edit]

Be sure to be logged in as an admin.
Create a collection (if not already existent), an empty metadata profile is created with the collection at once
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)
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
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]

Be sure to be logged in as an admin.
Create a collection (if not already existent)
Upload files (items, videos or audio), for each file an item is created in this collection at once
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)
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.
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]

Ingest Item[edit]

@@ Line 5: / Line 5: @@
 There are two different ingest modes:
 # ''Metadata profile ingest'': Ingesting of a metadata profile to a collection
-# ''Image metadata ingest'': Ingesting of metadata to one (or more) image(s)
+# ''Item metadata ingest'': Ingesting of metadata to one (or more) item(s)
 ===Metadata profile ingest===
 # Be sure to be logged in as an admin.
 # Create a collection (if not already existent), an empty metadata profile is created with the collection at once
-# 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)
+# 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)
 # Edit the metadata profile XML file and enter your metadata
 #* WARNING: This must be done according to the [http://colab.mpdl.mpg.de/mediawiki/Category:Imeji_terms imeji format]. For more information on how to do this please contact the [mailto:imeji-support@gwdg.de support list]
-# 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
+# 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.
-===Image metadata ingest===
+===Item metadata ingest===
 # Be sure to be logged in as an admin.
 # Create a collection (if not already existent)
-# Upload files (images, videos or audios), for each file an item is created in this collection at once
+# Upload files (items, videos or audio), for each file an item is created in this collection at once
-# 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)
+# 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)
 # Edit the item list XML file and enter your metadata
 #* WARNING: This must be done according to the [http://colab.mpdl.mpg.de/mediawiki/Category:Imeji_terms imeji format]. For more information on how to do this please contact the support list at [mailto:imeji-support@gwdg.de 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.
+#* 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.
-# 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
+# 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.