2019.06 2020.06

Batch-Betrieb über das Commandline-Tool

Der Abschnitt beschreibt Vorgehensweisen bei der Nutzung des CLI im Batch-Betrieb.

Allgemeines

Neben der interaktiven Arbeit über die WEB-Oberfläche kann es bei Produktivanwendungen immer wieder zu dem Erfordernis kommen, via Script Änderungen an den Daten vornehmen zu müssen. Hierfür können die MyCoRe-Kommandos in Shell-Scripts eingebunden werden. Neben Kommandos für eine feste Gruppe von Daten oder die Auswahl aller Daten bietet die MyCoRe Kommandozeile auch die Möglichkeit Daten zu selektieren und dann auf diese Auswahl zuzugreifen.

Grundsätzlich wird hierbei zunächst eine Menge von Werten (typischerweise Objekt-IDs) selektiert und anschließend entweder

eines der unten genannten Kommandos ausgeführt, dass mit dieser Auswahl arbeitet, oder
ein anderes Kommando für alle selektierten Werte ausgeführt.

Erstellen einer Auswahl

Eine Auswahl kann explizit als mit Leerzeichen separierte Liste angegeben werden:

mycore.sh select values {0}

Eine Auswahl von Object IDs kann per XPath erfolgen, wobei alle (normalisierten) Objekte geprüft werden:

mycore.sh select objects with xpath {0}

Eine Auswahl von Object IDs kann per XPath erfolgen, wobei alle (expandierten) Objekte geprüft werden:

mycore.sh select expanded objects with xpath {0}

Eine Auswahl von Object IDs kann per XPath erfolgen, wobei alle Derivate geprüft werden:

mycore.sh select derivates with xpath {0}

Eine Auswahl von Object IDs kann per Solr Query erfolgen:

mycore.sh select objects with solr query {0} in core {1}

Reduzieren einer Auswahl

Eine Auswahl von Object IDs kann per XPath reduziert werden, wobei für alle bereits ausgewählten Objekt-IDs das zugehörige (normalisierten) Objekte geprüft werden:

mycore.sh filter object selection with xpath {0}

Eine Auswahl von Object IDs kann per XPath reduziert werden, wobei für alle bereits ausgewählten Objekt-IDs das zugehörige (expandierte) Objekte geprüft werden:

mycore.sh filter expanded object selection with xpath {0}

Eine Auswahl von Object IDs kann per XPath reduziert werden, wobei für alle bereits ausgewählten Objekt-IDs das zugehörige Derivat geprüft werden:

mycore.sh filter dereivate selection with xpath {0}

Kommandos für ausgewählte Daten

Nach erfolgreicher Auswahl können dann u. a. die folgenden Kommandos für die selektierten Werte aufgerufen werden.

Allgemeine Kommandos

mycore.sh list selected: Listet alle ausgewählten Werte auf
mycore.sh execute for selected {0}: Führt für alle ausgewählten Werte ein anderes Kommando aus

Kommandos für SOLR

Achtung, Kommandos für die SOLR-Indizierung sollten nicht im Batch, sondern nur direkt im CLI-Tool ausgeführt werden. Es ist auch darauf zu achten, dass mit dem quit-Befehl gewartet wird, bis alle Responses von SOLR im CLI eingetroffen sind. Andernfalls kann es zu Datenverlusten im SOLR-Server kommen!

mycore.sh rebuild solr metadata index for selected in core {0}: rebuilds solr's metadata index for selected objects
mycore.sh rebuild solr content index for selected in core {0}: rebuilds solr's content index for selected objects and or derivates

Kommandos für Permissions

mycore.sh update permission {0} for selected with rulefile {1} described by {2}: The command updates access rule for a given permission and all ids of a given MCRObject-Type with a given special rule
mycore.sh update permission {0} for selected with rulefile {1}: The command updates access rule for a given permission and all ids of a given MCRObject-Type with a given special rule
mycore.sh delete permission {0} for selected: The command delete access rule for a query selected set of object ids of a given permission
mycore.sh delete all permissions for selected: The command delete all access rules for a query selected set of object ids

Kommandos für METS-Daten

mycore.sh validate selected mets: validates all mets.xml of selected derivates