Feldwert umsetzen DB

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:

exchangefieldvaluedb_sqlserver

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

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