replace value(a, csv/xls(x) b, column c, default d, [encoding e, key column f, delimiter g, sheet h])
Gruppe |
Sucht den Wert a in der Schlüsselspalte einer CSV-Datei oder Excel-Datei b. Wird der Wert gefunden, gibt die Funktion den Wert aus der angegebenen Ersetzungsspalte c zurück, wird der Wert nicht gefunden, wird der Parameter d zurückgegeben. Ist nicht die erste Spalte die Schlüsselspalte, kann die zu verwendende Spalte über f festgelegt werden. Ein vom System Encoding abweichender Zeichensatz wird über Parameter e festgelegt. Das CSV-Trennzeichen kann mit Parameter g vorgegeben werden. Wenn Parameter b eine Excel-Datei bezeichnet, kann mit Parameter h der Name oder die Nummer des Excel-Sheets (bei 0 beginnend) angegeben werden.
Zeilen in der CSV-Datei, die mit # beginnen, sind Kommentarzeilen. Die formale Struktur der CSV-Datei muss fehlerfrei sein, d. h. wenn der Wert in Spalte n gesucht ist oder Spalte n als Schlüssel verwendet wird, müssen alle Datenzeilen auch n Spalten haben, also mindestens n-1 Kommata (CSV-Trennzeichen) enthalten. Andernfalls tritt eine IndexOutOfBoundsException auf.
Das Default-Spalten-Trennzeichen ist Komma. Mit Parameter g kann ein anderes Spalten-Trennzeichen angegeben werden. Der Wert in Parameter g wird getrimmt und danach das erste Zeichen verwendet. Um TAB oder SPACE als Trennzeichen zu definieren, verwenden Sie bitte \TAB bzw. \SPACE in Parameter g.
Wichtiger Hinweis
Diese Funktion erbt das Basis-Verhalten von Funktion replace value(a, csv b, column c, default d, [encoding e, key column f, delimiter g]), kann aber als Umsetz-Datei zusätzlich zum CSV-Format auch eine Excel-Datei verwenden. Zur Vorgabe des Excel Sheets dient der zusätzliche Parameter h. In der Excel-Datei definierte Berechnungen werden ausgeführt.
Parameterbeschreibung
Parameter |
Beschreibung |
a |
Suchwert. |
b |
Pfad und Name der CSV-Datei oder Excel-Datei. |
c |
Ersetzungsspalte. |
d |
Default-Rückgabewert. |
e |
(optional) Encoding. Default: System-Encoding, bzw. 8859_1, wenn keines vorhanden ist. |
f |
(optional) Alternative Schlüsselspalte. Default: 1. |
g |
(optional) Spalten-Trennzeichen. Default: Komma. |
h |
(optional) Excel-Sheet. Default: 0. |
Umsetzdatei aus ZIP-Datei lesen
Die Umsetzdatei (CSV oder Excel) kann auch aus einer Zip-Datei gelesen werden. Dazu wird folgende Syntax für Parameter b erwartet.
Datei-Pfad der ZIP-Datei |
Darin enthaltener Eintrag |
Parameter b |
./conf/xyz/Umsetzung.zip |
Auftragsnummern.xlsx |
./conf/xyz/Umsetzung.zip!Auftragsnummern.xlsx |
./conf/xyz/Umsetzung.zip |
DE/Auftragsnummern.csv |
./conf/xyz/Umsetzung.zip!DE/Auftragsnummern.csv |
Bitte vermeiden Sie Datei-Pfade mit Leerzeichen.
Ziel dieser Funktionalität ist es, dass mehrere Umsetzdateien, die in einem Zusammenhang stehen, innerhalb einer einzigen Zip-Datei bereitgestellt werden und dass dadurch ein Austausch dieser Dateien zum gleichen Zeitpunkt durch Ersetzen der Zip-Datei möglich ist.