Kodieren / Dekodieren
Der Schritt Kodieren / Dekodieren wandelt einen Wert von einer Kodierung in eine andere um: Base64, URL, XML-, HTML- und JSON-Escaping, Quoted-Printable, MIME-Header-Wörter (RFC 2047) und Escaping für reguläre Ausdrücke. Ein Wert geht hinein, der umgewandelte Wert kommt als result heraus.
Typische Einsatzszenarien:
- Base64-Inhalte aus einem HTTP-Request in lesbaren Text umwandeln.
- URL-Parameter mit Leerzeichen,
&oder Umlauten bilden. - Einen Wert sicher in selbst gebauten XML-, HTML- oder JSON-Text einsetzen.
- Zusammen mit dem Schritt Parser die Anlagen signierter E-Mails aus Microsoft Graph auslesen (siehe Beispiel unten).
Richtung
Kodieren wandelt Klartext in das gewählte Format um, Dekodieren wandelt das Format zurück in Klartext.
Format
| Format | Kodieren | Dekodieren |
|---|---|---|
| Base64 | Text als Base64 | Base64 zurück in Text. Leerzeichen und Zeilenumbrüche werden ignoriert. |
| Base64URL | Base64 mit - und _ statt + und /, ohne = am Ende – wie in Web-Tokens und URLs | Dasselbe zurück in Text |
| URL (Formular) | Sonderzeichen als %XX, ein Leerzeichen als + – für Formulardaten und Query-Parameter | %XX und + zurück in Text |
| URL (Pfad) | Sonderzeichen als %XX, ein Leerzeichen als %20 – für Teile eines URL-Pfads | %XX zurück in Text, + bleibt |
| XML-Escape | &, <, >, " und ' als &, <, … | Entities wie & oder ä zurück in Zeichen |
| HTML-Escape | Wie XML-Escape | Zusätzlich benannte HTML-Entities wie , ä oder € |
| JSON-Escape | ", \, Zeilenumbrüche und Tabs als \", \\, \n, \t | Zurück in Text, auch ä |
| Quoted-Printable | Sonderzeichen als =XX, lange Zeilen umbrochen – die Kodierung vieler E-Mail-Texte | Zurück in Text |
| RFC 2047 (MIME-Header) | Text mit Umlauten als =?utf-8?B?…?=, reiner Text bleibt unverändert | Jedes =?…?=-Wort im Text zurück in Text, z. B. Dateinamen von E-Mail-Anlagen |
| RegEx-Escape | Zeichen mit Sonderbedeutung in regulären Ausdrücken (., +, ?, …) bekommen ein \ | – (nur Kodieren) |
Text wird immer als UTF-8 gelesen und geschrieben. RFC-2047-Wörter nennen ihren Zeichensatz selbst; unterstützt werden UTF-8, ISO-8859-1, Windows-1252 und US-ASCII.
Eingabe
Der umzuwandelnde Wert, meist die Ausgabe eines vorherigen Schritts, z. B. {{GetAttachments_contentBytes}}. Ein leerer Wert ergibt ein leeres Ergebnis.
Lässt sich die Eingabe nicht dekodieren – weil sie zum Beispiel kein gültiges Base64 ist –, bricht der Schritt den Flow mit einem Fehler ab.
Ausgaben
| Ausgabe | Inhalt |
|---|---|
result | Der umgewandelte Wert. Auch große Werte von mehreren hundert Kilobyte sind kein Problem. |
Bei eingeschaltetem Debug-Logging zeigt das Ausführungsprotokoll Eingabe und Ergebnis des Schritts.
Beispiel: Anlagen signierter E-Mails auslesen (Microsoft Graph)
Ist eine E-Mail digital signiert (S/MIME), listet Microsoft Graph ihre Anlagen nicht einzeln auf. Die Abfrage /messages/{id}/attachments liefert stattdessen eine einzige Anlage smime.p7m mit dem Inhaltstyp multipart/signed. Ihre contentBytes enthalten die ganze E-Mail – Text, Anlagen und Signatur – als Base64. Mit Kodieren / Dekodieren und dem Parser holst du die Anlagen heraus:
-
HTTP-Request auf
/messages/{id}/attachments, danach ein Parser (JsonPath) auf$.valueund ein For Each über die Anlagen. Ein Entscheidungs-Schritt prüft, ob die Anlagesmime.p7mheißt. -
Kodieren / Dekodieren – Richtung Dekodieren, Format Base64, Eingabe
{{Attachment_contentBytes}}. SlugMime.{{Mime_result}}enthält jetzt die E-Mail als Text. -
Parser – Typ RegEx, Eingabe
{{Mime_result}}, eine Zeilepartmit dem Selektor(?s)(Content-Type:(?:(?!\r\n\r\n).)*?Content-Disposition:\s*attachment.*?)(?=\r?\n--)Er liefert einen Wert pro Anlage:part[0],part[1], … -
For Each über
part, darin ein Parser (RegEx) auf den aktuellen Teil mit diesen Zeilen:Zeile Selektor fileNamefilename\*?="?([^"\r\n;]+)contentTypeContent-Type:\s*([^;\r\n]+)encodingContent-Transfer-Encoding:\s*(\S+)body(?s)\r?\n\r?\n(.*) -
Kodieren / Dekodieren – Richtung Dekodieren, Format RFC 2047 (MIME-Header) auf
fileName. So wird aus einem Namen wie=?utf-8?B?UmVjaG51bmcgTcO8bGxlci5wZGY=?=wiederRechnung Müller.pdf. -
Den Teil
smime.p7süberspringst du – das ist die Signatur. Bei einer PDF istbodybereits die Datei als Base64 und kann direkt weitergegeben werden, z. B. als Base64-Zeile von ZIP-Archiv erstellen. Istencodinggleichquoted-printable, dekodierst dubodyvorher mit dem Format Quoted-Printable.
Brauchst du die Boundary der E-Mail in einem regulären Ausdruck, wandle sie vorher mit Richtung Kodieren und Format RegEx-Escape um – Boundaries enthalten oft Zeichen wie ., + oder =.
Gut zu wissen
- Base64 → Text ist für Text gedacht. Wer eine PDF oder ein Bild zu Text dekodiert, beschädigt den Inhalt. Dateien bleiben am besten Base64 und werden als Base64 weitergegeben.
- Quoted-Printable wird immer als UTF-8 gelesen. E-Mail-Texte in ISO-8859-1 zeigen nach dem Dekodieren falsche Umlaute.
- Das E-Mail-Beispiel deckt den üblichen Fall ab. E-Mails mit ungewöhnlichen Kopfzeilen, als
.emlangehängte weitergeleitete E-Mails und verschlüsselte E-Mails (application/pkcs7-mime) erfassen die Selektoren nicht oder nur teilweise. - JSON-Escape maskiert nur den Inhalt. Die Anführungszeichen setzt du beim Bauen von JSON-Text selbst.