Rob-Dokumentation

Beschreibung

Häufig ist es notwendig, erfasste oder erhaltene Werte in ein besser lesbares Format zu übertragen. Nehmen wir einmal an, wir erhalten Einwohnerzahlen aller erdenklichen Länder dieser Welt als Datenstrom, welcher für eine Statistik über CODING4-Workflows entsprechend aufbereitet werden soll. Dabei erhalten wir einen ISO-3166-1 Ländercode für die Angabe des Landes.
Die wenigsten Menschen kennen alle Ländercodes der Welt und können dementsprechend eine Zuordnung treffen.

Der Rob “Feld umsetzen” bietet die Möglichkeit, in einer Tabelle nach einem Wert zu suchen und einen entsprechenden Umsetzungswert in ein anderes Metadatenfeld des Dokumentes zu schreiben. So kann z.B. das Eingabe Metadatenfeld “Ländercode” in das Metadatenfeld “Ländername” umgesetzt werden.

Der Rob benötigt dazu eine durch TAB-getrennte zweispaltige Textdatei der Form:

AF Afghanistan
EG Ägypten
AX Åland
AL Albanien
DZ Algerien
AS Amerikanisch-Samoa
VI Amerikanische Jungferninseln
AD Andorra
AO Angola
AI Anguilla
AQ Antarktika
AG Antigua und Barbuda
GQ Äquatorialguinea
AR Argentinien
AM Armenien
AW Aruba
AZ Aserbaidschan
ET Äthiopien
.
.
.

Es wird dann der Quellwert in der ersten Spalte gesucht und bei Treffer der Wert der zweiten Spalte in das Ziel-Metadatenfeld eingesetzt.

Für die ISO-3166-1 Länderkodierung können Sie hier eine Beispieldatei herunterladen (Quelle: Wikipedia, mehr zu ISO-3166-1 unter https://de.wikipedia.org/wiki/ISO-3166-1-Kodierliste).

Funktionsweise

Trifft der Workflow auf den Rob “Feldwert umsetzen”, so wird geprüft, ob die angegebene Datei mit der Umsetzung existiert und ein gültiges Format besitzt.

Im nächsten Schritt werden die Einträge der ersten Spalte der Datei Zeile für Zeile durchsucht, bis ein entsprechender Wert gefunden wird, welcher dem Quell-Metadatenfeld entspricht. Wurde der Wert gefunden, so wird der entsprechend zweite Spaltenwert der gefundenen Zeile in das Ziel-Metadatenfeld einkopiert.

Für die Suche können unterschiedliche Konfigurationen mitgegeben werden, wie z.B. die Angabe, ob Groß- und Kleinschreibung bei der Suche nach dem Ursprungswert in der Tabelle eine Rolle spielen soll, oder auch ob es bereits ausreicht, dass der Ursprungswert im Schlüsselwert einfach nur enthalten ist. Das Ignorieren von Sonderzeichen kann interessant sein, wenn die Zeichenkodierungen zwischen Ursprungsdatei und Referenztabelle unterschiedlich sind.

Der Rob wählt bei einer erfolgreichen Umsetzung den “Ja”-Ausgang, um die erfolgreiche Konvertierung zu signalisieren. Andernfalls wird der “Nein”-Ausgang gewählt, so dass z.B. mittels des “Feldwert setzen”-Robs dann manuell ein Umsetzungswert festgelegt werden kann.

Parameter

Kategorie	Name	Typ	Beschreibung
Allgemein	Quellfeld	Feldauswahl	Name des Metadatenfeldes, in welchem sich der zu suchende Wert befindet
Allgemein	Zielfeld	Feldauswahl	Name des Metadatenfeldes, in welches der gefundene Wert aus der Tabelle eingetragen werden soll
Allgemein	Groß-/Kleinschreibung beachten	Ja/Nein	Gibt an, ob die Suche nach dem Schlüsselbegriff der ersten Tabellenspalte kontextsensitiv ausgeführt werden soll
Allgemein	Muss enthalten sein	Ja/Nein	Gibt an, ob es bei der Suche in der Umsetzungsdatei ausreicht, wenn ein Teil der gesuchten Zeichenfolge enthalten ist

Anschlüsse

	Wird gewählt, wenn der Schlüsselwert gefunden und eine erfolgreiche Umsetzung durchgeführt werden konnte.
	Wird gewählt, wenn der Schlüsselwert nicht in der Tabelle gefunden und somit keine Umsetzung durchgeführt werden konnte.
	Im Falle eines Fehlers wird dieser Ausgang gewählt