Zum Hauptinhalt springen

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​

FormatKodierenDekodieren
Base64Text als Base64Base64 zurück in Text. Leerzeichen und Zeilenumbrüche werden ignoriert.
Base64URLBase64 mit - und _ statt + und /, ohne = am Ende – wie in Web-Tokens und URLsDasselbe 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 &amp;, &lt;, …Entities wie &amp; oder &#228; zurück in Zeichen
HTML-EscapeWie XML-EscapeZusätzlich benannte HTML-Entities wie &nbsp;, &auml; oder &euro;
JSON-Escape", \, Zeilenumbrüche und Tabs als \", \\, \n, \tZurück in Text, auch ä
Quoted-PrintableSonderzeichen als =XX, lange Zeilen umbrochen – die Kodierung vieler E-Mail-TexteZurück in Text
RFC 2047 (MIME-Header)Text mit Umlauten als =?utf-8?B?…?=, reiner Text bleibt unverändertJedes =?…?=-Wort im Text zurück in Text, z. B. Dateinamen von E-Mail-Anlagen
RegEx-EscapeZeichen 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​

AusgabeInhalt
resultDer 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:

  1. HTTP-Request auf /messages/{id}/attachments, danach ein Parser (JsonPath) auf $.value und ein For Each über die Anlagen. Ein Entscheidungs-Schritt prüft, ob die Anlage smime.p7m heißt.

  2. Kodieren / Dekodieren – Richtung Dekodieren, Format Base64, Eingabe {{Attachment_contentBytes}}. Slug Mime. {{Mime_result}} enthält jetzt die E-Mail als Text.

  3. Parser – Typ RegEx, Eingabe {{Mime_result}}, eine Zeile part mit 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], …

  4. For Each über part, darin ein Parser (RegEx) auf den aktuellen Teil mit diesen Zeilen:

    ZeileSelektor
    fileNamefilename\*?="?([^"\r\n;]+)
    contentTypeContent-Type:\s*([^;\r\n]+)
    encodingContent-Transfer-Encoding:\s*(\S+)
    body(?s)\r?\n\r?\n(.*)
  5. Kodieren / Dekodieren – Richtung Dekodieren, Format RFC 2047 (MIME-Header) auf fileName. So wird aus einem Namen wie =?utf-8?B?UmVjaG51bmcgTcO8bGxlci5wZGY=?= wieder Rechnung Müller.pdf.

  6. Den Teil smime.p7s überspringst du – das ist die Signatur. Bei einer PDF ist body bereits die Datei als Base64 und kann direkt weitergegeben werden, z. B. als Base64-Zeile von ZIP-Archiv erstellen. Ist encoding gleich quoted-printable, dekodierst du body vorher 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 .eml angehä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.