Variablen

Verwenden Sie Variablen in Textbausteinen, Triggern und vielen anderen Stellen in Zammad, um Informationen aus Objektattributen dynamisch auszugeben.

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.

Grundlagen

Variablen können durch Eingabe von :: aufgerufen werden (genau wie Textbausteine im Editor), solange Sie sich in einem unterstützten Textfeld in den Einstellungen befinden. Zammad zeigt alle Variablen an, die in diesem Kontext verfügbar sind, und fügt die Variable zu Ihrem Text hinzu, sobald Sie einen Eintrag ausgewählt haben. Sie können sogar nach Variablen für benutzerdefinierte Objektattribute suchen und diese verwenden.

Nach der Auswahl einer Variablen wird diese in einer Struktur wie dieser angezeigt: #{Objekt.Attribut}

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

• Konfiguration
• Aktueller Benutzer
• Artikel
• Ticket

Struktur

Der erste Teil des Variablennamens besteht aus dem Objekttyp, z.B. ticket, config, user.

Der zweite Teil ist der Name des Attributs. Bei benutzerdefinierten Objektattributen ist dies der Name, den Sie für das Attribut definiert haben und der jederzeit im Menü Objektattribut zu finden ist. Der erste und zweite Teil einer Variablen wird durch einen Punkt geteilt, z.B.: ticket.number, was am Ende in #{ticket.number} resultiert.

Bei Attributen mit Schlüssel/Anzeige-Kombinationen wie Auswahlfeldern ersetzt Zammad die Variable durch den Schlüsselnamen. Wenn Sie möchten, dass Zammad eine Variable durch den Anzeigenamen anstelle des Schlüssels ersetzt, müssen Sie einen dritten Teil hinzufügen: #{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 (CTRL Shift v) ein, sonst 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.