Variablen

Bemerkung

Bitte beachten Sie, dass dies nur eine Übersicht der verfügbaren Variablen ist. Manche Variablen können in bestimmten Funktionen inkompatibel oder nicht verfügbar sein. Wenn Sie Variablen vermissen oder sich nicht sicher sind, ob diese wie erwartet funktionieren, fragen Sie sehr gern in unserer Community nach.

Variablen können durch Eingabe von :: aufgerufen werden (genau wie Textbausteine im Frontend), solange man sich in einem unterstützten Textfeld im Backend befindet. Zammad zeigt alle Variablen an, die in diesem Kontext verfügbar sind und ersetzt sie durch die Variable, sobald Sie einen Eintrag ausgewählt haben.

Hinweis

Haben Sie ein leeres Feld, auf das Sie verweisen, und es erscheint als -? Das funktioniert derzeit wie vorgesehen - Sie sollten sicherstellen, dass diese Felder immer einen Wert beinhalten.

Moment, was ist mit benutzerdefinierten Objekten?

Das ist ein guter Punkt! Natürlich können wir nicht vorhersagen, welche Objekte Sie erstellen werden, aber wir können Ihnen einen Hinweis geben, wie Sie Ihre eigenen Werte verwenden können.

Hier geht es um den inneren Teil der Variable (also alles innerhalb von #{}). Bitte fügen Sie den äußeren Teil hinzu, um eine gültige Variable zu erhalten. Der erste Teil des Variablennamens besteht aus dem Objekttyp. Derzeit sind dies:

  • Ticket (ticket)

  • Benutzer (user)

  • Organisation (organization)

  • Gruppe (group)

Der zweite Teil ist der Name des Objektattributs. Diesen Namen legen Sie bei der Objektattributerstellung fest und Sie können ihn jederzeit im Objektmenü in den Einstellungen wiederfinden. Der erste und zweite Teil einer Variablen wird durch einen Punkt getrennt, z.B.: ticket.number, was im Ergebnis #{ticket.number} ergibt.

In manchen Situationen ist es möglich, dass Sie einen dritten Teil verwenden müssen. Das beste Beispiel für eine solche Situation wäre ein Auswahl- oder Baumauswahl-Feld, das standardmäßig den Schlüsselwert und nicht den Anzeigenamen zurückgibt. Erweitern Sie dazu einfach Ihre Variable mit .value. Das Ergebnis ist dann #{ticket.select.value}.

Verwendung übersetzter Variablen

Wenn Sie eine übersetzte Variable in Triggern oder Automatisierungen verwenden möchten, können Sie den Platzhalter wie folgt erweitern: #{t(ticket.status.name)}. Das t sagt Zammad, dass es nach passenden übersetzten Zeichenketten suchen soll. Die verwendete Ausgabesprache basiert auf der Systemsprache von Zammad, die Sie im Admin-Panel unter Branding einstellen können oder basierend auf der ausgewählten Sprache im Trigger-/Automatisierungs-Dialog.

Ein möglicher Anwendungsfall: Sie möchten Ihren Kunden per Trigger oder Scheduler Updates zu Tickets schicken, die den Status des Tickets enthalten sollen. Die Verwendung des Standardwertes #{ticket.state.name} (ohne das Übersetzungsflag t()) würde zur Ausgabe des ursprünglichen (englischen) Namens des Status führen.

Formatierung von Datum und Uhrzeit

Die Sprache und Zeitzone des Systems (oder in Trigger/Automatisierung ausgewählt) gibt ein Standardformat für Datum und Zeitstempel vor. Dieses Format kann mit Hilfe der Methode dt() angepasst werden.

Die Argumente der Methode lauten wie folgt:

  1. Die Datums- oder Zeitstempelvariable, die Sie formatieren möchten.

  2. Die Zeichenkette für das Ausgabeformat.

  3. Die zu verwendende Zeitzone (optional).

Beispiel:
#{dt(ticket.updated_at, "%A %Y-%m-%d %H:%M im Büro", "Europa/Berlin")}
Montag, 2024-03-18 15:31 im Büro

Hinweis

Wenn Sie unser Beispiel verwenden wollen, fügen Sie die obige Zeichenkette ohne Formatierung ein (STRG+Umschalt+v), andernfalls funktioniert es nicht.

In der folgenden Tabelle sind die verfügbaren Formatparameter aufgeführt:

Parameter

Beschreibung

Notiz

%Y

Jahr mit 4 Ziffern

Verwenden Sie %y für Jahreszahlen mit 2 Ziffern

%m

Monat des Jahres (als Zahl, ggf. mit vorangestellter Null)

Verwenden Sie %-m für den Monat ohne vorangestellte Null

%d

Tag des Monats (als Zahl, ggf. mit vorangestellter Null)

Verwenden Sie %e für Tage ohne vorangestellte Null

%H

Stunde des Tages in 24-Stunden-Schreibweise, ggf. mit vorangestellter Null

Verwenden Sie %k für Stunden ohne führende Null

%I

Uhrzeit im 12-Stunden-Format, ggf. mit vorangestellter Null

Verwenden Sie %l für die Stunde ohne vorangestellte Null und %p / %P für den Tageszeit-Indikator

%M

Minute der Stunde

%S

Sekunde der Minute

%A

Name des Wochentags

Verwenden Sie %a für abgekürzte Namen oder %^A für den Name in Großbuchstaben

%B

Name des Monats

Verwenden Sie %b für den abgekürzte Namen

%U

Wochennummer des laufenden Jahres

Verwenden Sie %W für eine andere Berechnungsmethode

Tipp

Wir unterstützen die bekannten Formatparameter für die in Ruby eingebaute Methode strftime der Klasse DateTime. Für weitere Informationen siehe hier.