Beschreibung
Dieser Rob übersetzt einen Wert in einen anderen und verwendet dabei eine Tabelle mit Wert-Paaren. D.h. es wird nach einem Ursprungswert in einer Spalte einer Tabelle gesucht und der dazugehörige Wert der gleichen Tabellenzeile in einer anderen Spalte ausgelesen. Dieser ausgelesene Wert wird dann in ein anzugebendes Metadatenfeld eingesetzt.
Damit arbeitet dieser Rob analog dem Rob „Feldwert umsetzen“, nur bezieht er seine Umsetzungstabelle nicht aus einer Textdatei sondern wird an eine Microsoft SQL-Server-Tabelle angebunden.
Beispiel:
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 DB“ bietet die Möglichkeit, in einer Datenbank-Tabelle einer SQL-Server-Datenbank 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 Datenbanktabelle mit mindestens zwei Spalten – Schlüsselwert und Umsetzungswert:
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 eine Verbindung zur Angegebenen Datenbank hergestellt werden kann.
Im nächsten Schritt werden die Einträge der ersten Spalte der Datenbanktabelle Zeile für Zeile durchsucht, bis ein entsprechender Wert gefunden wird, welcher dem Quell-Metadatenfeld entspricht. Wurde der Wert gefunden, so wird der entsprechende Spaltenwert aus der Parametrisierung 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 Schlüsselspalte kontextsensitiv ausgeführt werden soll |
| Allgemein |
Muss enthalten sein |
Ja/Nein |
Gibt an, ob es bei der Suche in der Umsetzungstabelle ausreicht, wenn ein Teil der gesuchten Zeichenfolge enthalten ist |
| Datenbank |
Datenbankserver |
Text |
Name der SQL-Server-Instanz, welche die Umsetzungsdatenbank und -tabelle enthält |
| Datenbank |
Datenbankname |
Text |
Name der SQL-Server-Datenbank, welche die Umsetzungstabelle enthält |
| Datenbank |
Tabellenname |
Text |
Name der Tabelle innerhalb der angegebenen Datenbank, welche die Umsetzungswerte enthält |
| Datenbank |
Benutzername |
Text |
Name des Datenbankbenutzers für die Anmeldung an der SQL-Server-Datenbank |
| Datenbank |
Passwort |
Text |
Passwort für die Anmeldung an der SQL-Server-Datenbank |
| Datenbank |
Quell-Spalte |
Text |
Name der Spalte in der Datenbank, welche die Schlüsselwerte enthält |
| Datenbank |
Wert-Spalte |
Text |
Name der Spalte in der Datenbank, welche die Umsetzungswerte enthält |
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 |
