Erweiterte Suche¶
Mit Zammad kannst du die Suchergebnisse auf bestimmte Informationen einschränken. Das erlaubt Dir z.B. Tickets mit bestimmten Schlagworten oder Status zu finden. Die Informationen unten helfen Dir dabei deine Suchergebnisse zu verbessern.
Zum Beispiel kannst Du customer.attribute nutzen, um nach einem bestimmten Kunden zu suchen:
customer.firstname: John
or:
customer.lastname: Doe
Wenn Du komplexere Suchen nutzen möchtest, kannst du 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 Du .name (z.B. group.name oder priority.name) hinzufügen musst, um Suchergebnisse zu erhalten.
Verfügbare Attribute¶
Hinweis
For a more detailed list of available attributes please take a look into our Zammad Admin-Documentation
| Attribut | mögliche Werte | Beispiel | Beschreibung |
|---|---|---|---|
| number | 1118566 | number:1118566 number:11185* |
Suche nach einer Ticketnummer |
| title | irgendein Titel | title:“irgendein Titel“ title:Drucker title: „irgendein Ti*“ |
Wenn Du Leerstellen nutzen möchtest, benutze 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 |
Du kannst entweder ein einfaches Datum, einen Datumszeitraum oder >now-xh nutzen. Bitte beachte dabei, dass das Format YYYY-MM-DD lauten muss. |
| state.name | new open closed |
state.name: new state.name:new OR open |
Du kannst nach bestimmten Ticket-Stati suchen (und diese mit einem OR kombinieren). Bitte beachte dabei, dass für eine Suche die englischen Begriffe genutzt werden müssen, es sei denn, es wurden eigene Ticket-Stati 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] |
Du kannst 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 - Du kannst 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
Kombiniere Suchbegriffe
Mit dem Nutzen von AND, OR und TO kannst du Suchphrasen abhängig von der Situation miteinander kombinieren. Sofern nötig kannst Du bei sehr komplexen Suchanfragen auch Phrasen mit () kombinieren und in Abhängigkeit bringen (AND/OR). Solltest du Suchergebnisse erhalten, die Du ausschließen möchtest, kannst du Suchbegriffe mit ! negieren. Hier findest du noch ein paar Beispiele, wie so etwas aussehen kann:
| Suchphrase | Beschreibung |
|---|---|
| state.name:(closed OR open) AND (priority.name:“2 normal“ OR tags:feedback) | Zeige jedes Ticket mit den Stati 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 findest Du 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.firtname, 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
Article 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)