Skip to content

Maintenance: Improve wording in Advanced Search chapter #550

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ralf401 merged 3 commits into from
Jun 1, 2026
+23 −23
Merged

Maintenance: Improve wording in Advanced Search chapter #550

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b4f22d9
Maintenance: Improve wording in Advanced Search chapter
urbalazs May 28, 2026
f2f42ba
Update translation catalog
urbalazs May 29, 2026
d44ed3d
i18n
ralf401 Jun 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 11 additions & 11 deletions advanced/search.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,16 +31,16 @@ Available Attributes
<br />

.. csv-table:: Attributes and their usage
:header: "Attribute", "possible Values", "Example", "Description"
:header: "Attribute", "Possible Values", "Example", "Description"
:widths: 10, 10, 10, 20

"number", "1118566", "number:1118566 |br|\ number:11185*", "Search for a Ticketnumber"
"title", "some title", "title:""some title"" |br|\ title:Printer |br|\ title: ""some ti*""", "If you need to use spacings in the search phrase, use quotes. Zammad will do a AND-Search over the given words. You can also use a single keyword without quotation."
"number", "1118566", "number:1118566 |br|\ number:11185*", "Search for a ticket number."
"title", "some title", "title:""some title"" |br|\ title:Printer |br|\ title: ""some ti*""", "If you need to use spacings in the search phrase, use quotes. Zammad will do an AND-search over the given words. You can also use a single keyword without quotation."
"created_at", "2018-11-18", "created_at:2018-11-18 |br|\ created_at:[2018-11-15 TO 2018-11-18] |br|\ created_at:>now-1h", "You can either use a simple date, a date-range or >now-xh. Please note that the date format needs to be YYYY-MM-DD"
"state.name", "new |br|\ open |br|\ closed", "state.name: new |br|\ state.name:new OR open", "You can filter for specific ticket states (and even combine them with an OR). Please note that you need to use the english namings for states, unless you have custom ticket states defined in your instance."
"article_count", "5 |br|\ [5 TO 10] |br|\ [5 TO \*] |br|\ [\* TO 5]", "article_count:5 |br|\ article_count: [5 TO 10] |br|\ article_count:[5 TO \*] |br|\ article_count:[\* TO 5]", "You can search for Tickets with a specific number of articles (you can even search for everything with 5 or more articles or even up to 5 articles, if needed)."
"article.from", "\*bob\*", "article.from:\*bob\*", "Show all tickets that contain articles from ""Bob"""
"article.body", "heat |br|\ heat~ |br|\ /joh?n(ath[oa]n)/", "article.body:heat |br|\ article.body:heat~ |br|\ articlebody:/joh?n(ath[oa]n)/", "First example shows every ticket containing the word ""heat"" - you can also use the fuzzy operator ""~"" to search for similar words like e.g. like ""head"". Zammad will also allow you to use regular expressions, where ever the attributes allows it."
"state.name", "new |br|\ open |br|\ closed", "state.name: new |br|\ state.name:new OR open", "You can filter for specific ticket states (and even combine them with an OR). Please note that you need to use the English naming for states, unless you have custom ticket states defined in your instance."
"article_count", "5 |br|\ [5 TO 10] |br|\ [5 TO \*] |br|\ [\* TO 5]", "article_count:5 |br|\ article_count: [5 TO 10] |br|\ article_count:[5 TO \*] |br|\ article_count:[\* TO 5]", "You can search for tickets with a specific number of articles (you can even search for everything with 5 or more articles or even up to 5 articles, if needed)."
"article.from", "\*bob\*", "article.from:\*bob\*", "Show all tickets that contain articles from ""Bob""."
"article.body", "heat |br|\ heat~ |br|\ /joh?n(ath[oa]n)/", "article.body:heat |br|\ article.body:heat~ |br|\ articlebody:/joh?n(ath[oa]n)/", "First example shows every ticket containing the word ""heat"" - you can also use the fuzzy operator ""~"" to search for similar words like e.g. ""head"". Zammad will also allow you to use regular expressions, where ever the attributes allows it."

Combining Search Phrases
------------------------
Expand All @@ -57,8 +57,8 @@ Below are some examples that you could use with this:
:widths: 10, 20

"state.name:(closed OR open) AND (priority.name:""2 normal"" OR tags:feedback)", "Show every ticket that state is either closed or open and has priority normal or the tag feedback."
"state.name:(closed OR open) AND (priority.name:""2 normal"" OR tags:feedback) AND !(*Zammad*)", "This gets the same result as above, expect that we don't want the ticket to contain anything matching to ""Zammad"""
"owner.email:bob@example.net AND state.name:(open OR new)", "Show Tickets from bob@example.net that are either open or new"
"state.name:(closed OR open) AND (priority.name:""2 normal"" OR tags:feedback) AND !(*Zammad*)", "This gets the same result as above, expect that we don't want the ticket to contain anything matching to ""Zammad""."
"owner.email:bob@example.net AND state.name:(open OR new)", "Show tickets from bob@example.net that are either open or new."
"state.name:pending* AND article_count:[1 TO 5]", "Show everything with any pending state and an article count of 1 to 5."

Some Ticket Attributes and Their Type
Expand Down Expand Up @@ -111,9 +111,9 @@ Article Attributes
- Make sure to escape the ``/`` with a prefixed ``\``.
- Examples:

- Libreoffice spreadsheets:
- LibreOffice spreadsheets:
``application\/vnd.oasis.opendocument.spreadsheet``
- Libreoffice text documents: ``application\/vnd.oasis.opendocument.text``
- LibreOffice text documents: ``application\/vnd.oasis.opendocument.text``
- MS Excel spreadsheets:
``application\/vnd.openxmlformats-officedocument.wordprocessingml.document``
- MS Word text documents:
Expand Down
24 changes: 12 additions & 12 deletions locale/user-docs.pot
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Zammad User Documentation pre-release\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-05-21 11:06+0200\n"
"POT-Creation-Date: 2026-06-01 08:01+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
Expand Down Expand Up @@ -658,7 +658,7 @@ msgid "Attribute"
msgstr ""

#: ../advanced/search.rst:1
msgid "possible Values"
msgid "Possible Values"
msgstr ""

#: ../advanced/search.rst:1
Expand All @@ -683,7 +683,7 @@ msgid "number:1118566 |br|\\ number:11185*"
msgstr ""

#: ../advanced/search.rst:1
msgid "Search for a Ticketnumber"
msgid "Search for a ticket number."
msgstr ""

#: ../advanced/search.rst:1
Expand All @@ -699,7 +699,7 @@ msgid "title:\"some title\" |br|\\ title:Printer |br|\\ title: \"some ti*\""
msgstr ""

#: ../advanced/search.rst:1
msgid "If you need to use spacings in the search phrase, use quotes. Zammad will do a AND-Search over the given words. You can also use a single keyword without quotation."
msgid "If you need to use spacings in the search phrase, use quotes. Zammad will do an AND-search over the given words. You can also use a single keyword without quotation."
msgstr ""

#: ../advanced/search.rst:1
Expand Down Expand Up @@ -731,7 +731,7 @@ msgid "state.name: new |br|\\ state.name:new OR open"
msgstr ""

#: ../advanced/search.rst:1
msgid "You can filter for specific ticket states (and even combine them with an OR). Please note that you need to use the english namings for states, unless you have custom ticket states defined in your instance."
msgid "You can filter for specific ticket states (and even combine them with an OR). Please note that you need to use the English naming for states, unless you have custom ticket states defined in your instance."
msgstr ""

#: ../advanced/search.rst:1
Expand All @@ -747,7 +747,7 @@ msgid "article_count:5 |br|\\ article_count: [5 TO 10] |br|\\ article_count:[5 T
msgstr ""

#: ../advanced/search.rst:1
msgid "You can search for Tickets with a specific number of articles (you can even search for everything with 5 or more articles or even up to 5 articles, if needed)."
msgid "You can search for tickets with a specific number of articles (you can even search for everything with 5 or more articles or even up to 5 articles, if needed)."
msgstr ""

#: ../advanced/search.rst:1
Expand All @@ -763,7 +763,7 @@ msgid "article.from:\\*bob\\*"
msgstr ""

#: ../advanced/search.rst:1
msgid "Show all tickets that contain articles from \"Bob\""
msgid "Show all tickets that contain articles from \"Bob\"."
msgstr ""

#: ../advanced/search.rst:1
Expand All @@ -779,7 +779,7 @@ msgid "article.body:heat |br|\\ article.body:heat~ |br|\\ articlebody:/joh?n(ath
msgstr ""

#: ../advanced/search.rst:1
msgid "First example shows every ticket containing the word \"heat\" - you can also use the fuzzy operator \"~\" to search for similar words like e.g. like \"head\". Zammad will also allow you to use regular expressions, where ever the attributes allows it."
msgid "First example shows every ticket containing the word \"heat\" - you can also use the fuzzy operator \"~\" to search for similar words like e.g. \"head\". Zammad will also allow you to use regular expressions, where ever the attributes allows it."
msgstr ""

#: ../advanced/search.rst:46
Expand Down Expand Up @@ -811,15 +811,15 @@ msgid "state.name:(closed OR open) AND (priority.name:\"2 normal\" OR tags:feedb
msgstr ""

#: ../advanced/search.rst:1
msgid "This gets the same result as above, expect that we don't want the ticket to contain anything matching to \"Zammad\""
msgid "This gets the same result as above, expect that we don't want the ticket to contain anything matching to \"Zammad\"."
msgstr ""

#: ../advanced/search.rst:1
msgid "owner.email:bob@example.net AND state.name:(open OR new)"
msgstr ""

#: ../advanced/search.rst:1
msgid "Show Tickets from bob@example.net that are either open or new"
msgid "Show tickets from bob@example.net that are either open or new."
msgstr ""

#: ../advanced/search.rst:1
Expand Down Expand Up @@ -973,11 +973,11 @@ msgid "Examples:"
msgstr ""

#: ../advanced/search.rst:114
msgid "Libreoffice spreadsheets: ``application\\/vnd.oasis.opendocument.spreadsheet``"
msgid "LibreOffice spreadsheets: ``application\\/vnd.oasis.opendocument.spreadsheet``"
msgstr ""

#: ../advanced/search.rst:116
msgid "Libreoffice text documents: ``application\\/vnd.oasis.opendocument.text``"
msgid "LibreOffice text documents: ``application\\/vnd.oasis.opendocument.text``"
msgstr ""

#: ../advanced/search.rst:117
Expand Down