Objektbedingungen

Einführung

Diese Seite beschreibt die Attributprüfungen, die Sie für verschiedene Objektattribute durchführen können. Sie können diese Prüfungen an verschiedenen Stellen in Zammad verwenden, wie z.B. Trigger oder bei der Definition von Übersichten. Bitte beachten Sie, dass die verfügbaren Attribute und Operatoren von dem Objekt abhängen und davon, wo Sie diese verwenden wollen.

Mit diesen Objekt-Attribut-Bedingungen sollten Sie in der Lage sein, komplexe Bedingungen zu erstellen. Wenn Sie jedoch zusätzliche UND/ODER-Verknüpfungen für Ihre Bedingungen benötigen, werfen Sie einen Blick in den Abschnitt Experten-Modus, wo Sie eine Beschreibung finden, wie Sie diese verwenden können.

Objekttypen

Je nach Feature und ausgewähltem Attribut kann sich der Objektkontext ändern. Die Standard-Basisobjekte in Zammad sind:

• Ticket

• Benutzer

• Organisation

• Gruppe

Für diese 4 Objekte können Sie sogar Ihre eigenen Attribute erstellen und sie für Bedingungen verwenden. Es gibt jedoch noch weitere Objekttypen und spezielle Funktionen, je nachdem, in welchem Bereich Sie eine Bedingung erstellen möchten:

• Artikel

• Kunde

• Ausführungszeit

• Sitzung

Attribut-Typen

Je nach Art des Attributs können Sie aus verschiedenen Operatoren wählen, um Prüfungen durchzuführen und Ihre Bedingungen zu erstellen.

Unten finden Sie eine Tabelle mit speziellen Funktionen, die Sie quasi als Attribut-Typ sehen können, und eine Auflistung von Attribut-Typen, die Sie in Bedingungen in Zammad verwenden können.

Spezialfelder

Es gibt in Zammad eingebaute Funktionen, die beim Erstellen oder Bearbeiten einer Bedingung ausgewählt werden können. Sie finden sie in der folgenden Tabelle.

Feld	Kontext	Beschreibung	Operatoren	Mögliche Werte
Aktion	Artikel, Ticket	Prüft die durchgeführte Aktion. Nur in Triggern verfügbar.	ist ist nicht	erstellt aktualisiert zusammengefasst zu hierauf zusammengefasst
Kalender	Ausführung Zeit	Prüft, ob das Ereignis in der Arbeitszeit liegt. Nur in Triggern und in Automatisierung verfügbar.	ist innerhalb der Arbeitszeit ist außerhalb der Arbeitszeit	Vordefinierte Kalender
Kunde	Ticket	Prüft Ticket-Kunde.	ist ist nicht wurde verändert	aktueller Benutzer spezifischer Benutzer ist nicht gesetzt
Ermittelt Sprache	Artikel	Prüft die Sprache des Artikels.	ist ist nicht	Alle Sprachen, die unterstützt werden vom Spracherkennungs- Service.
Bestehend Mitglieder	Organisation	Prüft, ob die Organisation Mitglieder hat.	ist ist nicht	ja nein
Bestehend Tickets	Ticket Kunde/ Besitzer	Prüft, ob Tickets zugewiesen sind. Nur in der Automatisierung verfügbar.	ist ist nicht	ja nein
Gruppe	Ticket	Prüft die betroffene Gruppe.	ist ist nicht	Alle konfigurierten und aktiven Gruppen.
Organisation	Ticket, customer	Prüft die betroffene Organisation.	ist ist nicht	Organisation des aktuellen Benutzers spezifische Organisation ist nicht gesetzt
Besitzer	Ticket	Prüft den Besitzer.	ist ist nicht	aktueller Benutzer spezifischer Benutzer nicht gesetzt (nicht definiert)
Absender	Artikel	Prüft den Typ des Absenders.	ist ist nicht	System Agent Kunde
Status	Ticket	Prüft den Status des Tickets.	ist ist nicht	Alle konfigurierten Ticket-Status.
Abonniert	Ticket	Prüft, ob der Benutzer ein Ticket Abonnent	ist ist nicht	aktueller Benutzer spezifischer Benutzer nicht gesetzt (nicht definiert)
Tags	Ticket	Prüft die Tags eines Tickets.	enthält alle enthält eins enthält alle nicht enthält eins nicht	Text-Eingabefeld
Zeit Erfassung	Artikel	Prüft, ob Zeit erfasst ist.	ist gesetzt ist nicht gesetzt	-
Typ	Artikel	Prüft den Typ des Artikels.	ist ist nicht	Alle verfügbaren Artikel-Typen.
Sichtbarkeit	Artikel	Prüft die Sichtbarkeit des Artikels.	ist ist nicht	intern öffentlich

Textfeld

Prüft, ob ein Feld vom Typ Text eine bestimmte Zeichenfolge enthält. Der konfigurierte „Typ“ von Eingabefeldern hat keinen Einfluss auf die verfügbaren Optionen.

Verfügbare Operatoren für die Prüfung:

• enthält: Trifft zu, wenn der Text eine bestimmte Zeichenkette enthält.
• enthält nicht:

  Trifft zu, wenn der Text eine bestimmte Zeichenfolge nicht enthält.
• ist eins von:

  Trifft zu, wenn der Text mit einem der angegebenen Wörter übereinstimmt.
• ist keins von:

  Trifft zu, wenn der Text nicht mit allen angegebenen Wörtern übereinstimmt.
• beginnt mit eins von:

  Trifft zu, wenn der Text mit einem der angegebenen Wörter beginnt.
• endet auf eins von:

  Trifft zu, wenn der Text mit einem der angegebenen Wörter endet.
• passt auf regex:

  Prüft, ob der Text mit dem angegebenen regulären Ausdruck übereinstimmt (siehe auch remarks).
• passt nicht auf regex:

  Prüft, ob der Text nicht mit dem angegebenen regulären Ausdruck übereinstimmt.

Textbereich-Feld

Prüft, ob ein Feld vom Typ Textbereich eine bestimmte Zeichenkette enthält.

Verfügbare Operatoren für die Prüfung:

• enthält

• enthält nicht

• wurde verändert

Boolean-Feld

Prüft, ob ein Feld vom Typ Boolean wahr ist.

Verfügbare Operatoren für die Prüfung:

• ist

• ist nicht

• wurde verändert

Zahlen-Feld

Prüft, ob ein Zahlenfeld einen bestimmten Wert enthält oder nicht.

Verfügbare Operatoren für die Prüfung:

• ist

• ist nicht

• wurde verändert

Datumsfeld

Prüft, ob ein Datum vor oder nach einem bestimmten Zeitpunkt oder Zeitraum liegt (sowohl absolut als auch relativ). Mit relativen Operatoren können Sie eine Zeitspanne in Sekunden, Minuten, Stunden, Tagen, Wochen, Monaten oder Jahren definieren.

Verfügbare Operatoren für die Prüfung:

• vor (absolut):

  Liegt der Wert des Datumsfelds vor dem konfigurierten Datum, wird die Bedingung erfüllt.
• nach (absolut):

  Liegt der Wert des Datumsfelds nach dem konfigurierten Datum, wird die Bedingung erfüllt.
• vor (relativ):

  Liegt der Wert des Datumsfelds auf dem aktuellen Datum minus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• nach (relativ):

  Liegt der Wert des Datumsfelds auf dem aktuellen Datum plus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• innerhalb letzter (relativ):

  Liegt der Wert des Datumsfelds zwischen dem aktuellen Datum und dem aktuellen Datum minus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• innerhalb nächster (relativ):

  Liegt der Wert des Datumsfelds zwischen dem aktuellen Datum und dem aktuellen Datum plus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• bis in (relativ):

  Liegt der Wert des Datumsfelds auf dem aktuellen Datum plus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• von vor (relativ):

  Liegt der Wert des Datumsfelds auf dem aktuellen Datum minus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• wurde verändert:

  Das Feld wurde während einer Ticketaktualisierung geändert.

Damit Sie die zeitlichen Bedingungen von Zammad besser verstehen, könnte Sie sich das folgende Diagramm anschauen.

gantt title Date & Date Time condition timings dateFormat DD.MM.YYYY axisFormat %d.%m. todayMarker off 13.06. (now) :crit, milestone, 13.06.2023,0d section before<br>(absolute) 11.06. :beforeabs, 09.06.2023, 2d section after<br>(absolute) 15.06. :after withinnext, 2d section before<br>(relative) 2 days :09.06.2023, 2d section after<br>(relative) 2 days :after withinnext, 2d section within last<br>(relative) 2 days :withinlast, after beforeabs, 2d section within next<br>(relative) 2 days :withinnext, after withinlast, 2d section til<br>(relative) 2 days :09.06.2023, 6d section from<br>(relative) 2 days :after beforeabs, 6d

Datum & Zeit-Feld

Prüft, ob ein Datum und Uhrzeit vor oder nach einem bestimmten Zeitpunkt oder Zeitraum liegt (sowohl absolut als auch relativ). Mit relativen Operatoren können Sie eine Zeitspanne in Sekunden, Minuten, Stunden, Tagen, Wochen, Monaten oder Jahren definieren.

Verfügbare Operatoren für die Prüfung:

• vor (absolut):

  Liegt der Wert des Datums-/Zeitfelds vor dem konfigurierten Datum und der Zeit, wird die Bedingung erfüllt.
• nach (absolut):

  Liegt der Wert des Datums-/Zeitfelds nach dem konfigurierten Datum und der Zeit, wird die Bedingung erfüllt.
• vor (relativ):

  Liegt der Wert des Datums-/Zeitfelds auf dem aktuellen Datum und Uhrzeit minus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• nach (relativ):

  Liegt der Wert des Datums-/Zeitfelds auf dem aktuellen Datum und Uhrzeit plus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• innerhalb letzter (relativ):

  Liegt der Wert des Datums-/Zeitfelds zwischen dem aktuellen Datum und Uhrzeit und dem aktuellen Datum und Uhrzeit minus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• innerhalb nächster (relativ):

  Liegt der Wert des Datums-/Zeitfelds zwischen dem aktuellen Datum und Uhrzeit und dem aktuellen Datum und Uhrzeit plus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• bis in (relativ):

  Liegt der Wert des Datums-/Zeitfelds auf dem aktuellen Datum und Uhrzeit plus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• von vor (relativ):

  Liegt der Wert des Datums-/Zeitfelds auf dem aktuellen Datum und Uhrzeit minus dem ausgewählten Zeitraum, ist diese Bedingung erfüllt.
• wurde verändert:

  Das Feld wurde während einer Ticketaktualisierung geändert.
• wurde erreicht:

  Prüft, ob die in diesem Feld eingestellte Zeit erreicht wurde.

  Nur verfügbar für Wartezeit und Eskalationszeit in Trigger-Bedingungen.
• Warnung wurde erreicht:

  Trifft zu, wenn die in diesem Feld eingestellte Zeit in weniger als 15 Minuten erreicht wird.

  Diese Option ist nur für die Ticket-Eskalationszeit in Trigger-Bedingungen verfügbar.

Sehen Sie sich das Diagramm oben an. Es gilt auch für Datum und Uhrzeit, aber Sie können zusätzlich Stunden und Minuten verwenden.

Einfachauswahl-Feld

Prüft, ob die ausgewählten Feldwerte mit dem Attributwert übereinstimmen. Sie können einen oder mehrere Werte für das betreffende Attribut auswählen. Die Auswahl von mehr als einem Wert in der Bedingung wirkt wie eine „ODER“-Verknüpfung.

Verfügbare Operatoren für die Prüfung:

• ist

• ist nicht

• wurde verändert

Mehrfachauswahl-Feld

Prüft, ob die Werte des ausgewählten Feldes mit dem/den Attribut(en) übereinstimmen.

Verfügbare Operatoren für die Prüfung:

• enthält alle:

  Trifft zu, wenn alle angegebenen Feldwerte vorhanden sind.
• enthält eins:

  Trifft zu, wenn ein bestimmter Feldwert vorhanden ist.
• enthält alle nicht:

  Trifft zu, wenn alle angegebenen Feldwerte nicht vorhanden sind.
• enthält eins nicht:

  Trifft zu, wenn ein bestimmter Feldwert nicht vorhanden ist.

Einfach-Baumauswahl-Feld

Prüft, ob ein ausgewählter Feldwert mit dem Attributwert übereinstimmt. Die Auswahl von mehr als einem Wert in der Bedingung wirkt wie eine „ODER“-Verknüpfung.

Verfügbare Operatoren für die Prüfung:

• ist

• ist nicht

• wurde verändert

Mehrfach-Baumauswahl-Feld

Prüft, ob der/die ausgewählte(n) Feldwert(e) mit dem/den Attributwert(en) übereinstimmen.

Verfügbare Operatoren für die Prüfung:

• enthält alle

  Trifft zu, wenn alle angegebenen Feldwerte vorhanden sind.
• enthält eins

  Trifft zu, wenn ein bestimmter Feldwert vorhanden ist.
• enthält alle nicht

  Trifft zu, wenn alle angegebenen Feldwerte nicht vorhanden sind.
• enthält eins nicht

  Trifft zu, wenn ein bestimmter Feldwert nicht vorhanden ist.

Zusätzliche Informationen und Bemerkungen

Allgemein

Bedingungen im Ticket-Kontext unterstützen nicht:

• reguläre Ausdrücke

• Groß- und Kleinschreibung bei Zeichenketten

• Die Standard-Bedingungen erlauben es nicht, dass dasselbe Attribut mehrmals ausgewählt werden kann

wurde verändert Bedingungen:

Sind nur für Ticket-Attribute verfügbar und haben keine Auswirkung auf:

• Ticket Artikel-Attribute

• Organisationsattribute

• Benutzerattribute

• Gruppenattribute

Unterschiede in den Eingabefeldern:

Bitte beachten Sie, dass im Eingabefeld für Token das Komma als Trennzeichen nicht unterstützt (wie im Eingabefeld für Tags). Wenn Sie das Komma im Token-Eingabefeld verwenden, ist das Komma in Ihrem Token enthalten.

Beispiel:

A mit Enter/Tab hinzugefügt, B und C mit Komma getrennt (ergibt ein Token/Wort).

Regex

Regex-Unterstützung

passt auf regex und passt nicht auf regex werden nur in Triggern, der Zeiterfassungs-Auswahl, in E-Mail-Filtern, der Auswahl zur automatischen Ticketzuweisung und den Core Workflows unterstützt.

„Alte“ regex:... Bedingungen

Wenn Sie Ihr Zammad von 6.0 oder älter aktualisieren und Sie haben bereits Bedingungen mit enthält oder enthält nicht, die einen Regex-Filter enthalten (z.B. regex:^(foo|bar)$), versucht Zammad, sie beim Update auf die neuen Operatoren passt auf regex und passt nicht auf regex zu migrieren.