Zum Inhalt

Converter-Referenz

Append

Hängt ein festes Suffix an einen Eingabestring an.

Warum: Wenn ein konstanter Nachsatz ergänzt werden soll, ohne den ursprünglichen Wertkörper zu verändern.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="Append(append_char='_ARCHIVED')"/>

Parameter

  • append_char: str; Standardwert erforderlich — Konstanter Text, der an den Eingabewert angehängt wird.

CutLength

Behält höchstens die angegebene Anzahl führender Zeichen eines Strings.

Warum: Um eine maximale Textlänge einzuhalten und den Anfang des Werts zu bewahren.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="CutLength(length_to_cut=8)"/>

Parameter

  • length_to_cut: int; Standardwert erforderlich — Maximale Anzahl der zu behaltenden Anfangszeichen.

Date2Timestamp

Wandelt Zeitwerte in einen Unix-Timestamp um.

Warum: Wenn ein Integrationsvertrag Unix-Epoch-Sekunden statt eines Zeitwerts erwartet; für Textformate DateFormat verwenden.

Kategorie: core.

Ergebnis: int.

1
<key name="value" constant="sample" converter="Date2Timestamp()"/>

DateFormat

Formatiert Zeitwerte als Zeichenfolge.

Warum: Wenn ein Zeitwert in genau einem nachgelagerten Textformat ausgegeben werden muss.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="DateFormat(format_str='%Y-%m-%d')"/>

Parameter

  • format_str: str; Standardwert erforderlich — Python-strftime-Muster für die Textausgabe.

Hash

Pseudonymisiert einen String zu einem stabilen Hash, gebunden an <setup rngSeed>.

Warum: Für stabile Pseudonymisierung verwenden, wenn Gleichheit vergleichbar bleiben soll, ohne den Quellwert offenzulegen.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="Hash(hash_type='sha256', output_format='hex')"/>

Parameter

  • hash_type: str; Standardwert erforderlich — Unterstützter Digest-Algorithmus für die Pseudonymisierung.
  • output_format: str; Standardwert erforderlich — Kodierung des Hash-Digests als Hex oder Base64.

JavaHash

Bildet die Java-Funktion String.hashCode nach.

Warum: Nur für Kompatibilitätstests mit Java-HashCode-Semantik verwenden; für kryptografische Pseudonymisierung Hash einsetzen.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="JavaHash()"/>

LowerCase

Wandelt Text in Kleinschreibung um.

Warum: Für kanonische, groß-/kleinschreibungsunabhängige Schlüssel und E-Mails verwenden; nicht, wenn die Originalschreibung fachlich relevant ist.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="LowerCase()"/>

Mask

Ersetzt jedes Eingabezeichen durch ein konfiguriertes Maskierungszeichen.

Warum: Wenn der ganze Quellwert verborgen werden muss, seine Länge aber sichtbar bleiben darf; für sichtbare Ränder MiddleMask nutzen.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="Mask(mask_char='*')"/>

Parameter

  • mask_char: str; Standardwert * — Ein einzelnes Zeichen, das jeden verborgenen Wertteil ersetzt.

MiddleMask

Maskiert Zeichen in der Mitte eines Strings und erhält konfigurierte Ränder.

Warum: Um sensible Mittelteile zu verbergen und dennoch Anfang oder Ende erkennbar zu lassen.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="MiddleMask(start_mask_index=2, end_mask_offset=3)"/>

Parameter

  • start_mask_index: int; Standardwert erforderlich — Nullbasierter Index, ab dem maskiert wird.
  • end_mask_offset: int; Standardwert erforderlich — Anzahl der am Ende sichtbar bleibenden Zeichen.
  • mask_char: str; Standardwert * — Ein einzelnes Zeichen, das jeden verborgenen Wertteil ersetzt.

NumericBand

Maskiert eine Zahl durch einen gleichverteilten Wert aus ihrem festen Band.

Warum: Zur De-Identifizierung numerischer Werte bei Erhalt des konfigurierten analytischen Bands.

Kategorie: core.

Ergebnis: int.

1
<key name="value" constant="sample" converter="NumericBand(width=10)"/>

Parameter

  • width: int; Standardwert erforderlich — Positive Größe eines numerischen Maskierungsbands.

ProjectFields

Projiziert ein Mapping auf die angegebenen Felder in deklarierter Reihenfolge.

Warum: Für eine explizite schmale Ausgabeform verwenden, wenn fremde Source-Felder nicht durchgereicht werden dürfen.

Kategorie: core.

Ergebnis: dict[str, object].

1
<key name="value" constant="sample" converter="ProjectFields('id', 'status')"/>

RemoveNoneOrEmptyElement

Entfernt None und leere Elemente rekursiv aus verschachtelten Daten.

Warum: Vor JSON-ähnlichem Export verwenden, wenn fehlende verschachtelte Werte ausgelassen statt serialisiert werden sollen.

Kategorie: core.

Ergebnis: T (input type preserved; empty nested collection members removed).

1
<key name="value" constant="sample" converter="RemoveNoneOrEmptyElement()"/>

Substring

Extrahiert einen Teilstring mit Python-Slice-Semantik.

Warum: Für einen deterministischen Ausschnitt wie das sichtbare Ende einer Kennung verwenden.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="Substring(start=-4)"/>

Parameter

  • start: int; Standardwert erforderlich — Startwert oder inklusiver Startindex des Wertebereichs.
  • end: int | null; Standardwert None — Endgrenze oder exklusiver Endindex des Wertebereichs.

Timestamp2Date

Wandelt einen Unix-Timestamp in einen Zeitwert um.

Warum: Wenn ein numerischer Epoch-Wert vor weiterer Formatierung oder Export wieder ein Zeitwert werden muss.

Kategorie: core.

Ergebnis: datetime.

1
<key name="value" constant="sample" converter="Timestamp2Date()"/>

UpperCase

Wandelt Text in Großschreibung um.

Warum: Für kanonische Codes und Zielverträge mit Großschreibung verwenden; nicht, wenn Originalschreibung fachlich relevant ist.

Kategorie: core.

Ergebnis: str.

1
<key name="value" constant="sample" converter="UpperCase()"/>