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 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¶
If you want to use a translated variable in triggers or
schedulers, you can extend the placeholder like this:
#{t(ticket.state.name)}
. The t
tells Zammad to search for fitting
translated strings. The used output language is based on the system language of
Zammad which you can set in the admin panel under Branding or
based on the selected locale in the trigger/scheduler edit 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¶
The system (trigger/scheduler selected) locale and timezone predefines a default format of date and timestamp. This format is customizable by using the dt()
method.
The method arguments are as follows:
The date or timestamp variable you want to format.
The output format string.
The timezone to apply (optional).
#{dt(ticket.updated_at, "%A %Y-%m-%d %H:%M in the office", "Europe/Berlin")}
Hinweis
Wenn Sie unser Beispiel verwenden wollen, fügen Sie die obige Zeichenkette ohne Formatierung ein (STRG+Umschalt+v
), andernfalls funktioniert es nicht.
The following table lists available format directives:
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
We support the known format directives for
the Ruby built-in method strftime
of the DateTime
class.
For more information, see here.