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.
Variablen Kategorien¶
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 Erstellung des Objektattributs 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:
Die Datums- oder Zeitstempelvariable, die Sie formatieren möchten.
Die Zeichenkette für das Ausgabeformat.
Die zu verwendende Zeitzone (optional).
#{dt(ticket.updated_at, "%A %Y-%m-%d %H:%M im Büro", "Europa/Berlin")}
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 |
---|---|---|
|
Jahr mit 4 Ziffern |
Verwenden Sie |
|
Monat des Jahres (als Zahl, ggf. mit vorangestellter Null) |
Verwenden Sie |
|
Tag des Monats (als Zahl, ggf. mit vorangestellter Null) |
Verwenden Sie |
|
Stunde des Tages in 24-Stunden-Schreibweise, ggf. mit vorangestellter Null |
Verwenden Sie |
|
Uhrzeit im 12-Stunden-Format, ggf. mit vorangestellter Null |
Verwenden Sie |
|
Minute der Stunde |
|
|
Sekunde der Minute |
|
|
Name des Wochentags |
Verwenden Sie |
|
Name des Monats |
Verwenden Sie |
|
Wochennummer des laufenden Jahres |
Verwenden Sie |
Tipp
Wir unterstützen die bekannten Formatparameter für die in Ruby eingebaute Methode strftime
der Klasse DateTime
. Für weitere Informationen siehe hier.