Encoder

Verwendung

Mit dem Encoder-Utility können Sie Eingangsnachrichten dekodieren, kodieren und dabei z.B. mit einer Prüfsumme versehen oder den Zeichensatz ändern:

Das Kodieren von Daten ist z.B. nötig, wenn die Daten für E-Mail-Übertragungen oder XML-Darstellungen in einer ASCII-basierten Darstellung vorliegen müssen.
Beim Dekodieren werden die Daten wieder in ihr ursprüngliches Format zurückgeführt.

Dialog Encoder Eigenschaften

In diesem Dialog legen Sie die Funktionsweise des Encoder-Utilitys fest.

Konfiguration Eingangsdaten

Eingangsdaten aus XML

Wenn die Eingangsdaten XML-formatiert sind, dann können Sie auch einzelne Elemente kodieren oder dekodieren lassen: Geben Sie den XPath zu dem XML-Element ein, dessen Inhalt kodiert/dekodiert werden soll. Wenn Sie eine Beispiel-Eingangsdatei haben, klicken Sie auf den Button, um die Datei zu laden und zu dem XML-Element zu navigieren. Der XPath wird dabei automatisch erstellt.
Zeichensatzkodierung

Nur aktiv, wenn als Algorithmus Zeichensatzkonvertierung oder URL gewählt ist. Wählen Sie eine Zeichensatzkodierung aus der Liste aus.

Operation

Aktion wählen

Wählen Sie aus, ob die Eingangsdaten kodiert oder dekodiert werden sollen.
Algorithmus wählen

Die folgenden Verfahren stehen zur Auswahl:
- Zeichensatzkonvertierung: Wenn diese Option ausgewählt, dann können Sie eine Zeichensatzkodierung für die Ausgangsdaten auswählen.
- base64: Die base64-Kodierung wird benutzt, um Binärdaten über Technologien zu übertragen, die 8-Bit nicht sauber übertragen können, wie z.B. E-Mail.
  
  Die binären Zeichenketten werden in Text-Zeichenketten umgewandelt, die problemlos per E-Mail versendet oder als Teil eines HTTP POST Requests verwendet werden können. base64 verwendet eine Untermenge des ASCII-Zeichensatzes, die kodierten Zeilen müssen exakt 64 druckbare Zeichen lang sein. Durch die Kodierung steigt der Platzbedarf der Daten um 25 %.
- MIME-base64: Dieses Verfahren basiert auf der base64-Kodierung, legt aber keine feste Länge für base64-kodierte Zeilen fest. Lediglich die Maximallänge ist mit 76 Zeichen fest definiert.
- hex: Dieser Algorithmus wandelt Binärdaten in eine Folge von Hexadezimal-Zahlen um.
- URL: URL-Encoding ist notwendig, wenn Eingangsnachrichten als HTTP Request oder HTTP Response gesendet werden soll. Da bei der HTTP Kommunikation nur eine Untermenge des US-ASCII Zeichensatz verwendet werden darf, müssen alle Zeichen, die nicht in dieser Untermenge enthalten sind, durch sog. Escape-Sequenzen ersetzt werden. So wird z.B. das Leerzeichen durch die Sequenz %20 ersetzt.
  
  Mit den folgenden Algorithmen können Sie Prüfsummen erstellen lassen, mit denen die Integrität von Nachrichten geprüft werden kann. Um festzustellen, ob eine Nachricht verändert oder beschädigt wurde, wird die aktuelle Prüfsumme der Nachricht mit einer bekannten, früher erstellten Summe verglichen. Die Prüfsumme wird am Ende der Nachricht übertragen. Zur Auswahl stehen die folgenden Algorithmen:
- MD5: Eine weit verbreitete kryptografische Funktion, die aus beliebigen Daten eine 128-Bit-Prüfsumme erzeugt. MD5-Summen werden unter anderem von PGP verwendet. Um die Eingangsnachricht an das nächste Modul im Workflow zu senden, kann die Option Eingangsnachricht zusätzlich auch als Ausgangsnachricht setzen aktiviert werden.
- SHA1: Kryptografische Funktion, die aus beliebigen Daten eine 160-Bit-Prüfsumme erzeugt.
- SHA-224, SHA-256, SHA-384, SHA-512 und SHA3-512: Kryptografische Funktionen, die zur SHA-2-Familie der Hash-Algorithmen gehören und durch bessere Algorithmen das Kollisionsrisiko reduzieren.
- CRC-32: Diese Option erzeugt eine 32-Bit-Prüfsumme für die Eingangsnachricht. Um die Eingangsnachricht an das nächste Modul im Workflow zu senden, kann die Option Eingangsnachricht zusätzlich auch als Ausgangsnachricht setzen aktiviert werden.

Konfiguration Ausgangsdaten

Zeichensatzkodierung

Nur aktiv, wenn als Aktion Kodieren und als Algorithmus Zeichensatzkonvertierung gewählt ist. Wählen Sie eine Zeichensatzkodierung aus der Liste aus, um anzugeben, mit welchem Zeichensatz die Ausgangsdaten ausgegeben werden sollen.
Eingangsnachricht zusätzlich auch als Ausgangsnachricht setzen

Nur aktiv, wenn als Aktion Kodieren und als Algorithmus MD5, SHA1, SHA-224, SHA-256, SHA-384, SHA-512, SHA3-512 oder CRC-32 gewählt ist.

Diese Option ermöglicht die Ausgabe des Eingabestroms anstelle der Prüfsumme für die oben genannten Algorithmen. Die Checksumme wird dann nur in der Variablen Encoder.xxx gespeichert, und die Ausgabe enthält den Eingabestrom.