Der MASK-Filter erlaubt dir, Datenbankfelder bei der Ausgabe auf Rechnungen in gewissem Umfang zu manipulieren. So erlaubt der Filter eine datenschutzkonforme Ausgabe der IBAN (DSGVO) oder einer E-Mail-Adresse.
Filtern von Platzhalter Inhalten
Mit Filtern kannst du die Werte von Platzhaltern gezielt vor der Ausgabe modifizieren. Dadurch erhältst du die Möglichkeit, Daten dynamisch anzupassen, zu transformieren oder zu maskieren. Du kannst mehrere Filter hintereinander kombinieren, um komplexere Transformationen vorzunehmen. Die Filter werden dabei in der Reihenfolge ihrer Angabe von links nach rechts angewendet.
Die allgemeine Form von Filtern sieht so aus:
{{FELDNAME|filter:param1:param2:...|filter:param1:param2:...}}MASK – Maskieren von Inhalten
Der Maskierungsfilter «MASK» ist der erste unterstützte Anwendungsfall der neuen Filterfunktion. Mit ihm kannst du gezielt steuern, welche Teile eines sensiblen Werts, etwa einer IBAN, sichtbar bleiben und welche durch ein beliebiges Maskierungszeichen ersetzt werden sollen.
So kannst du beispielsweise aus der IBAN DE12345678901234567890 mit dem MASK-Filter folgende, datenschutzkonforme Ausgabe erzeugen:
****************7890Das Feld «IBAN maskiert» ist vorkonfiguriert
Der MASK-Filter ist vorkonfiguriert und du kannst ihn direkt «{}» als «Platzhalter einfügen» auswählen, wenn du ein Datenfeld vom Typ «Text/IBAN» angelegt hast. Das folgende Beispiel zeigt eine einfache Verwendung mit der Standardkonfiguration, welche eingefügt wird:
{{IBAN|MASK:-4:*}}Dabei wird automatisch ein sinnvoller Bereich am Ende sichtbar belassen. In dieser vorkonfigurierten Version werden die letzten vier Stellen angezeigt und davor jede Stelle mit einem «*» maskiert.
Bitte beachte, dass die Leerzeichen auch als Stellen gelten:
Ist die IBAN im Format DE12345678901234567890 erfasst, so resultiert am Schluss …***7890.
Ist die IBAN im Format DE12 3456 7890 1234 5678 90 erfasst, so resultiert am Schluss …***8 90.
Dieses Feld kann nicht verändert werden. Wenn du eine abweichende Darstellung wünschst, so kannst du dies über die «Erweiterte Konfiguration» erreichen.
Erweiterte Konfiguration
Du kannst den MASK-Filter auch auf andere Felder anwenden. Der Filter «MASK» kann auch als «mask» geschrieben werden. Ohne Parameter nach «MASK» wird das gesamte Feld mit «*» ersetzt dargestellt.
Syntax
| Parameter | Beschreibung |
|---|---|
| MASK | Name des Filters (kann auch als «mask» geschrieben werden) |
| 4 | Sichtbare Zeichen am Anfang (optional) |
| -4 | Sichtbare Zeichen am Ende (optional) |
| * | Zeichen zur Maskierung (optional, kann auch ein anderes Zeichen sein) |
Beispiel 1 – E-Mail: hans.mueller@abcd.ch
Du kannst die Stellen zu Beginn und am Schluss des Datenfeldes individuell maskieren und das Zeichen (oder die Zeichenfolge) definieren, mit der die versteckten Stellen maskiert werden.
{{E-Mail|MASK:2:-4:*}} → ha**************d.ch{{E-Mail|MASK:2:-4:-}} → ha--------------d.chBeispiel 2 – Zahl: 12345678901234567890
Auch Zahlenfelder können maskiert werden. Ohne Angabe eines Zeichens für die Maskierung wird automatisch ein Sternchen (*) verwendet.
{{Zahl|mask:-4}} → ****************7890{{Zahl|mask:x}} → xxxxxxxxxxxxxxxxxxxBeispiel 3 – E-Mail: hans.mueller@abcd.ch mit zwei Filtern
Filterkaskade: Das Beispiel zeigt, wie zwei Filter nacheinander auf ein Feld angewendet werden können.
{{E-Mail|MASK:x|MASK:1:-1:y}} → xyyyyyyyyyyyyyyyyyyx