Erweiterte Suche

Mit Zammad können Sie die Suchergebnisse auf bestimmte Informationen einschränken. Das erlaubt Ihnen z.B. Tickets mit bestimmten Schlagworten oder Status zu finden. Die Informationen unten helfen Ihnen dabei Ihre Suchergebnisse zu verbessern.

Zum Beispiel können Sie customer.attribute nutzen, um nach einem bestimmten Kunden zu suchen:

customer.firstname: John

or:

customer.lastname: Doe

Wenn Sie komplexere Suchen nutzen möchten, können Sie Konditionen mit () und AND/OR nutzen:

state.name: open AND (article.from:me OR article.from:somebody)

Bemerkung

🤓 Suchbegriffe haben sich mit Zammad 4.0 geändert

Mit Zammad <=3.6 haben die folgenden Attribute nur Strings enthalten:

• group

• priority

• state

• organization

Mit Zammad >=4.0 enthalten diese Attribute ganze Objekte. Das bedeutet, dass Sie .name (z.B. group.name oder priority.name) hinzufügen müssen, um Suchergebnisse zu erhalten.

Verfügbare Attribute

Hinweis

Eine detailliertere Liste der verfügbaren Attribute finden Sie in der Zammad Admin-Dokumentation

Attribute und ihre Nutzung

Attribute	mögliche Werte	Beispiel	Beschreibung
number	1118566	number:1118566 number:11185*	Nach einer Ticketnummer suchen
title	irgendein Titel	title:“irgendein Titel“ title:Drucker title: „irgendein Ti*“	Wenn Sie Leerstellen nutzen möchten, benutzen Sie bitte Anführungsstriche. Zammad führt eine UND-Suche über die definierten Suchworte aus. Bei einzelnen Suchbegriffen können die Anführungsstriche weggelassen werden.
created_at	2018-11-18	created_at:2018-11-18 created_at:[2018-11-15 TO 2018-11-18] created_at:>now-1h	Sie können entweder ein einfaches Datum, einen Datumszeitraum oder >now-xh nutzen. Bitte beachten Sie dabei, dass das Format YYYY-MM-DD lauten muss
state.name	new open closed	state.name: new state.name:new OR open	Sie können nach bestimmten Ticket-Status suchen (und diese mit einem OR kombinieren). Bitte beachten Sie dabei, dass für eine Suche die englischen Begriffe genutzt werden müssen, es sei denn, es wurden eigene Ticket-Status z.B. in deutsch definiert.
article_count	5 [5 TO 10] [5 TO *] [* TO 5]	article_count:5 article_count: [5 TO 10] article_count:[5 TO *] article_count:[* TO 5]	Sie können nach Tickets mit einer bestimmten Anzahl von Artikeln suchen (oder sogar nach allem mit 5 oder mehr Artikel; oder bis zu 5 Artikel, wenn nötig).
article.from	*bob*	article.from:*bob*	Zeigt alle Tickets an, in denen Artikel von „Bob“ enthalten sind
article.body	Hitze Hitze~ /joh?n(ath[oa]n)/	article.body:heat article.body:heat~ articlebody:/joh?n(ath[oa]n)/	Das erste Beispiel zeigt jedes Ticket, welches das Wort „heat“ enthält - Sie können auch mit dem Operator „~“ eine fehlertolerante Suche durchführen, um nach ähnlichen Worten wie z.B. „head“ suchen zu können. Zammad erlaubt zudem eine Suche mit regulären Ausdrücken, wo immer ein Attribut dies zulässt.

Hinweis

Suchbegriffe kombinieren

Mit dem Nutzen von AND, OR und TO können Sie Suchphrasen abhängig von der Situation miteinander kombinieren. Sofern nötig können Sie bei sehr komplexen Suchanfragen auch Phrasen mit () kombinieren und in Abhängigkeit bringen (AND/OR). Sollten Sie Suchergebnisse erhalten, die Sie ausschließen möchten, können Sie Suchbegriffe mit ! negieren. Hier finden Sie noch ein paar Beispiele, wie so etwas aussehen kann:

Beispiele für Suchphrasen-Kombinationen

Suchphrase	Beschreibung
state.name:(closed OR open) AND (priority.name:“2 normal“ OR tags:feedback)	Zeige jedes Ticket mit den Status geschlossen oder offen und einer normalen Priorität oder dem Schlagwort feedback.
state.name:(closed OR open) AND (priority.name:“2 normal“ OR tags:feedback) AND !(Zammad)	Diese Suche ergibt das gleiche Ergebnis wie das darüber, mit dem Unterschied, dass das Ergebnis nichts mit „Zammad“ enthält
owner.email:bob@example.net AND state.name:(open OR new)	Zeige Tickets von bob@example.net die entweder offen oder neu sind
state.name:pending* AND article_count:[1 TO 5]	Zeige alles mit einem warten auf Status und einer Artikelanzahl von 1 bis 5.

Eine kurze Auswahl von Ticket Attributen

Anbei finden Sie eine Auflistung der wichtigsten Attribute, aufgeteilt in Ticket und Artikel.

Ticket Attribute

• number: String

• title: String

• group: Object (group.name, …)

• priority: Object (priority.name, …)

• state: Object (state.name, …)

• organization: Object (organization.name, …)

• owner: Objekt (owner.firstname, owner.lastname, owner.email, …)

• customer: Objekt (customer.firstname, customer.lastname, customer.email, …)

• first_response_at: Zeitstempel

• first_response_in_min: ganze Zahl (Geschäfts-Minuten bis zur ersten Reaktion)

• close_at: Zeitstempel

• close_in_min: ganze Zahl (Geschäfts-Minuten bis Schließung des Tickets)

• last_contact_at: Zeitstempel (Letzter Kontakt durch Kunden oder Agenten)

• last_contact_agent_at: Zeitstempel (Letzter Kontakt durch Agenten)

• last_contact_customer_at: Zeitstempel (Letzter Kontakt durch Kunden)

• create_article_type: String (email|phone|web|…)

• create_article_sender: String (Customer|Agent|System)

• article_count: ganze Zahl

• escalation_at: Zeitstempel

• pending_time: Zeitstempel

Artikel Attribute

• article.from: String

• article.to: String

• article.cc: String

• article.subject: String

• article.body: String

• article.attachment.title: string (Dateiname von Anhang)

• article.attachment.content: string (Inhalt des Anhangs)

• article.attachment.content_type: string (Dateityp z.B. PDF)