Erweiterte Suche¶
Mit Zammad kannst Du Deine Suche auf bestimmte Informationen einschränken. Das ermöglicht es, Tickets mit bestimmten Schlagworten oder Stati zu suchen. Das verbessert Deine Suchergebnisse signifikant.
Zum Beispiel kannst Du mit folgendem Befehl nach einem bestimmten Kunden suchen:
customer: some name
Wenn Deine Suche etwas komplexer werden soll, kannst Du Konditionen mit () und AND/OR Operatoren verknüpfen:
state: open and (from:me OR from:somebody)
Verfügbare Attribute¶
Hinweis
Für eine detaillierte Liste von verfügbaren Attributen, schau bitte in unsere Admin-Dokumentation
| 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 | new open closed |
state: new state: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
Du kannst Such-Ausdrücke mit den Operatoren AND, OR und TO , abhängig von der Situation und dem Ausdruck, der eingesetzt werden, nutzen. Falls benötigt, können Such-Ausdrücke mit () geteilt werden, um komplexere Suchen durchführen zu können. Das erlaubt es mehrere Suchphrasen mit verschiedenen Abhängigkeiten (AND/OR) zu kombinieren. Wenn Begriffe von der Suche ausgeschlossen werden sollen, können Negierung mit ! verwendet werden. Unten findest Du ein paar Beispiele, die Du damit anwenden kannst:
| Suchphrase | Beschreibung |
|---|---|
| state:(closed OR open) AND (priority:“2 normal“ OR tags:feedback) | Zeige jedes Ticket mit den Stati geschlossen oder offen und einer normalen Priorität oder dem Schlagwort feedback. |
| state:(closed OR open) AND (priority:“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:(open OR new) | Zeige Tickets von bob@example.net die entweder offen oder neu sind. |
| state: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: String
- priority: String
- state: string
- organization: String
- 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 (filename of attachment)
- article.attachment.content: string (content of attachment)
- article.attachment.content_type: string (File type e.g. PDF)