Skip to content
Markus Weigelt edited this page Oct 11, 2023 · 5 revisions

Verwendung von Platzhaltern

An einigen Stellen erlaubt Production die Verwendung von Platzhaltern. Sie können in den Pfaden der Projekteinstellungen und im Skriptpfad in den Workflow-Editoren verwendet werden.

Platzhalter für Werte aus der Anwendung

Für einige innere Werte der Software gibt es Platzhalter, die bei der Nutzung ersetzt werden. Diese sind:

Variablenname Beschreibung Verwendung
prefs Absoluter Pfad vom Regelsatz des Vorgangs (prefs)
processid ID des Vorgangs (processid)
processtitle Titel des Vorgangs (processtitle)
projectid ID des Projekt (projectid)
stepid ID der Aufgabe (stepid)
stepname Name der Aufgabe (stepname)
generatorsource Relativer Pfad vom Unterverzeichnis des Vorgangs, welches als Quelle zum Generieren von Inhalten verwendet wird (generatorsource)
generatorsourcepath Absoluter Pfad vom Unterverzeichnis des Vorgangs, welches als Quelle zum Generieren von Inhalten verwendet wird (generatorsourcepath)
ocrdworkflowid Relativer Pfad der Datei aus dem OCR-D Workflow-Ordner, welcher dem Vorgang der Aufgabe direkt oder indirekt (über die Produktionsvorlage) zugeordnet ist (⏳ Aktuell noch Bestandteil des PR #5697) (ocrdworkflowid)
filename Dateiname einer Mediendatei
ℹ️ Nur in der Konfiguration von Mets-Pfaden verfügbar
(filename)
basename Dateiname einer Mediendatei ohne Suffix
ℹ️ Nur in der Konfiguration von Mets-Pfaden verfügbar
(basename)
relativepath Relativer Pfad einer Mediendatei
ℹ️ Nur in der Konfiguration von Mets-Pfaden verfügbar
(relativepath)

❗ Platzhalter für Werte aus der Anwendung haben kein vorangestelltes $-Zeichen!

ℹ️ Weitere Platzhalter können in der Datei kitodo_config.properties konfiguriert werden. Sie dienen einer reibungslosen Migration von Version 2, wo zusätzliche (hartcodierte) Platzhalter erlaubt waren.

Platzhalter für Werte aus den Metadaten

Für Werte aus den Metadaten des Vorgangs gibt es ebenfalls Platzhalter.

ℹ️ Platzhalter für Werte aus den Metadaten benötigen ein vorangestelltes $-Zeichen!

Diese werden nach folgendem Schema gebildet:

Variablenname Beschreibung Verwendung (Beispiel)
meta.‹key› Wert eines Metadatums des ersten Kindstrukturelements mit dem Schlüssel ‹key›, falls dort vorhanden; sonst Wert des obersten Strukturelements mit dem Schlüssel ‹key› $(meta.TitleDocMain)
meta.topstruct.‹key› Wert eines Metadatums des obersten Strukturelements mit dem Schlüssel ‹key› $(meta.topstruct.TitleDocMain)
meta.firstchild.‹key› Wert eines Metadatums des ersten Kindstrukturelements mit dem Schlüssel ‹key› $(meta.firstchild.TitleDocMain)

Perspektive

Die Nutzung eines ReadMetadataSelectors (wie hier spezifiziert) würde einen Zugriff auf beliebige Metadaten erlauben.
Beispiel: $(^/@TitleDocMain)(Zugriff auf den Titel im übergeordneten Vorgang)
❗ Diese sind noch nicht Bestandteil der Software.

Clone this wiki locally