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

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:

  1. The date or timestamp variable you want to format.

  2. The output format string.

  3. The timezone to apply (optional).

Beispiel:
#{dt(ticket.updated_at, "%A %Y-%m-%d %H:%M in the office", "Europe/Berlin")}
Monday, 2024-03-18 15:31 in the office

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

%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

We support the known format directives for the Ruby built-in method strftime of the DateTime class. For more information, see here.