Das TextReplace Add-In kann verwendet werden um in einer Textdatei bestimmte Zeichenfolgen zu ersetzen. Dabei wird die Datei zeilenweise eingelesen und die zu ersetzenden Zeichenfolgen können über Reguläre Ausdrücke definiert werden. Ausserdem kann der Zeichensatz einer Textdatei konvertiert werden.
| Merkmale | |
| Add-In Type | Logic |
| Schnittstellen | In/Out: Datei (“file” Parameter) |
| Transaktionen | 1 wenn erfolgreich |
| Ereignisse | n/a |
| Parameter | |
| expression | Liste mit Regulären Ausdrücken (einer pro Zeile) die in der Eingabedatei gesucht werden |
| replacement | Liste von Werten mit denen die gefundenen Zeichenketten ersetzt werden (einer pro Zeile) |
| inputEncoding | Zeichencodierung der Eingabedatei (z.B. ‘UTF-8’, ‘ISO-8859-1’) (Optional, Default = “UTF-8”) |
| outputEncoding | Zeichencodierung der Ausgabedatei (z.B. ‘UTF-8’, ‘ISO-8859-1’) (Optional, Default = “UTF-8”) |
| writeBom | Gibt an ob eine ‘byte order mark’ (BOM) geschrieben wird wenn ‘outputEncoding’ auf ‘UTF-8’ gesetzt ist (Optional, Default = true) |
| endpoint | Name des Endpunktes der in der Transaktion verwendet wird (Optional, Default = “”). Wenn “endpoint” mit *** beginnt wird der Wert der aufrufenden Instanz verwendet. |
Die Parameter “expression” und “replacement” können mehrzeiligen Text enthalten. Pro Zeile muss in “expression” ein Regulärer Ausdruck und in “replacement” ein Ersatztext angegeben werden. Beide Parameter müssen dieselbe Anzahl Zeilen beinhalten.
| expression | replacement | |
| encoding=”ISO-8859-1” | encoding=”UTF-8” | Ersetzt den Ausdruck encoding=”ISO-8859-1” durch encoding=”UTF-8”. |
| ([^=])(“) | $1" | Ersetzt alle vorkommen von “ (Gruppe 2) die nicht nach einem = (Gruppe 1) stehen durch " |
Das TextReplace Add-In erhält den Namen der zu bearbeitenden Datei im abonnierten Ereignis im “file” Parameter. Dieser Parameter wird von folgenden Add-Ins bereitgestellt:
Wenn der Parameter “inputEncoding” auf “UTF-8” festgelegt wurde, und die zu verarbeitende Datei in einem anderen Format vorliegt, dann wird automatisch versucht die Datei im Standard-Zeichensatz des Systems (normalerweise ISO-8859-1) einzulesen.