Relution Signet Customer Hub

Erweiterte Platzhalter

Platzhalter wie ${user.email} oder ${device.model} werden an mehreren Stellen in Relution genutzt, u. a. bei Gerätenamen, Zertifikaten, Exchange-Konten oder App-Konfigurationen. Über die zugrunde liegende Template-Engine Freemarker stehen dabei zusätzliche Funktionen zur Verfügung, mit denen Platzhalter weiter angepasst werden können.

Teilzeichenfolgen (Substring)

Mit der Notation [start..ende] wird nur ein Ausschnitt eines Werts verwendet. Die Zählung beginnt bei 0.

  • ${user.givenName[0..0]} → erster Buchstabe des Vornamens
  • ${device.model[0..1]} → erste zwei Zeichen des Gerätemodells

Beispiel: ${user.givenName[0..0]}${user.surname[0..0]}-${device.model[0..1]}-${(device.custom1)!"00000"} ergibt bei einem Benutzerkonto „Max Mustermann“ mit einem custom1-Wert von 00042 auf einem iPad12,1 beispielsweise MM-iP-00042.

Standardwert bei leerem Feld

Ist ein Feld leer oder nicht gesetzt, kann mit dem !-Operator ein Standardwert hinterlegt werden: ${(device.custom1)!"00000"}. Ist das benutzerdefinierte Feld custom1 nicht befüllt, wird stattdessen 00000 verwendet, anstatt dass der Platzhalter leer bleibt oder einen Fehler verursacht.

Groß-/Kleinschreibung und Zeichen ersetzen

Über ?lower_case bzw. ?upper_case wird ein Wert vollständig in Klein- oder Großbuchstaben umgewandelt. Mit ?replace("alt", "neu") lassen sich einzelne Zeichen oder Zeichenfolgen ersetzen, beispielsweise um Umlaute für Systeme aufzulösen, die keine Sonderzeichen im Benutzernamen zulassen:

${user.surname?lower_case?replace("ä","ae")?replace("ö","oe")?replace("ü","ue")?replace("ß","ss")}

Lokalen Teil einer E-Mail-Adresse verwenden

Um aus ${user.username} (bzw. ${user.email}) nur den Teil vor dem @-Zeichen zu verwenden, stehen mehrere gleichwertige Varianten zur Verfügung:

  • ${user.username?keep_before("@")}
  • ${user.username?split("@")[0]}
  • ${user.username[0..user.username?index_of("@")-1]}

Hinweise

Welche Basis-Platzhalter (z. B. ${user.email}, ${device.serialnumber}) in einer bestimmten Konfiguration zur Verfügung stehen, wird jeweils unterhalb des entsprechenden Eingabefelds im Relution-Portal angezeigt.