Skip to content

Commit e21a3d9

Browse files
ralf401ralf401
authored
Maintenance: Add missing trigger page
1 parent 4c29053 commit e21a3d9

3 files changed

Lines changed: 339 additions & 25 deletions

File tree

‎locale/admin-docs.pot‎

Lines changed: 205 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Zammad Admin Documentation pre-release\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2026-03-11 11:37+0100\n"
11+
"POT-Creation-Date: 2026-03-13 12:59+0100\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -6847,6 +6847,7 @@ msgstr ""
68476847

68486848
#: ../manage/macros/how-do-they-work.rst:0
68496849
#: ../manage/templates.rst:28
6850+
#: ../manage/trigger/how-do-they-work.rst:75
68506851
msgid "Actions"
68516852
msgstr ""
68526853

@@ -7418,6 +7419,7 @@ msgstr ""
74187419
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:1
74197420
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:1
74207421
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:1
7422+
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:1
74217423
msgid "**👋 Looking for more depth explanation on conditions? 🤓**"
74227424
msgstr ""
74237425

@@ -7428,6 +7430,7 @@ msgstr ""
74287430
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:3
74297431
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:3
74307432
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:3
7433+
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:3
74317434
msgid "Many condition settings in Zammad, no matter if in ticket scope or not, re-appear in several places of Zammad. For this reason we created a dedicated documentation section to avoid duplicate content."
74327435
msgstr ""
74337436

@@ -7438,6 +7441,7 @@ msgstr ""
74387441
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:7
74397442
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:7
74407443
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:7
7444+
#: ../misc/object-conditions/conditioning-depth-hint.include.rst:7
74417445
msgid "Have a look at :doc:`/misc/object-conditions/index` to learn even more! 🎉"
74427446
msgstr ""
74437447

@@ -9666,6 +9670,206 @@ msgstr ""
96669670
msgid "Screenshot of “Triggers” page in admin panel"
96679671
msgstr ""
96689672

9673+
#: ../manage/trigger/how-do-they-work.rst:2
9674+
msgid "How Do Trigger Work"
9675+
msgstr ""
9676+
9677+
#: ../manage/trigger/how-do-they-work.rst:4
9678+
msgid "Triggers consist of three parts:"
9679+
msgstr ""
9680+
9681+
#: ../manage/trigger/how-do-they-work.rst:6
9682+
msgid "**Activators:** define \"when the question is asked?\""
9683+
msgstr ""
9684+
9685+
#: ../manage/trigger/how-do-they-work.rst:7
9686+
msgid "**Conditions:** answer the question \"when should this trigger fire?\""
9687+
msgstr ""
9688+
9689+
#: ../manage/trigger/how-do-they-work.rst:8
9690+
msgid "**Actions:** answer the question \"what should happen when it does?\""
9691+
msgstr ""
9692+
9693+
#: ../manage/trigger/how-do-they-work.rst:10
9694+
msgid "Triggers are evaluated in alphabetical order by **name.** In some situations, triggers might be the wrong choice, see :doc:`/manage/trigger/limitations` for more information."
9695+
msgstr ""
9696+
9697+
#: ../manage/trigger/how-do-they-work.rst:14
9698+
msgid "**🤓 Emails can adjust some behavior on their own**"
9699+
msgstr ""
9700+
9701+
#: ../manage/trigger/how-do-they-work.rst:16
9702+
msgid "See :doc:`/channels/email/email-headers` for more information."
9703+
msgstr ""
9704+
9705+
#: ../manage/trigger/how-do-they-work.rst:19
9706+
msgid "Activators"
9707+
msgstr ""
9708+
9709+
#: ../manage/trigger/how-do-they-work.rst:21
9710+
msgid "Triggers support two types of activators:"
9711+
msgstr ""
9712+
9713+
#: ../manage/trigger/how-do-they-work.rst:24
9714+
#: ../manage/webhook/examples/generic-notifications-trigger.rst:32
9715+
#: ../misc/object-conditions/basics.rst:66
9716+
#: ../system/core-workflows/how-do-they-work.rst:60
9717+
#: ../system/core-workflows/learn-by-example.rst:58
9718+
#: ../system/core-workflows/learn-by-example.rst:113
9719+
#: ../system/core-workflows/learn-by-example.rst:157
9720+
#: ../system/core-workflows/learn-by-example.rst:223
9721+
#: ../system/core-workflows/learn-by-example.rst:260
9722+
#: ../system/sessions.rst:51
9723+
msgid "Action"
9724+
msgstr ""
9725+
9726+
#: ../manage/trigger/how-do-they-work.rst:26
9727+
msgid "An action based trigger always requires a ticket update to run. This can be an update by an agent or even internal system updates like updated SLA times. See the explanation below for more details."
9728+
msgstr ""
9729+
9730+
#: ../manage/trigger/how-do-they-work.rst:36
9731+
#: ../manage/webhook/examples/generic-notifications-trigger.rst:28
9732+
msgid "Selective"
9733+
msgstr ""
9734+
9735+
#: ../manage/trigger/how-do-they-work.rst:31
9736+
msgid "Checks if any attribute from the condition was updated. If yes, the trigger runs. If the attributes from the condition weren't touched, the trigger doesn't run."
9737+
msgstr ""
9738+
9739+
#: ../manage/trigger/how-do-they-work.rst:35
9740+
msgid "**Example:** A trigger with a condition for priority **1 low** will run if the ticket was changed to **1 low**."
9741+
msgstr ""
9742+
9743+
#: ../manage/trigger/how-do-they-work.rst:48
9744+
#: ../manage/webhook/examples/generic-notifications-trigger.rst:32
9745+
msgid "Always"
9746+
msgstr ""
9747+
9748+
#: ../manage/trigger/how-do-they-work.rst:39
9749+
msgid "Checks if the current state of the ticket matches the condition. This means: the trigger always runs when the ticket is updated, no matter what was changed. This can lead to executing such a trigger more often."
9750+
msgstr ""
9751+
9752+
#: ../manage/trigger/how-do-they-work.rst:43
9753+
msgid "**Example:** A trigger with a condition for priority **1 low** will run if the ticket was moved to another group while priority was set **1 low**."
9754+
msgstr ""
9755+
9756+
#: ../manage/trigger/how-do-they-work.rst:46
9757+
msgid "If in doubt, use **Selective**. The **Always** action activator can lead to unexpected behavior, e.g. the trigger runs after internal system changes of the ticket, which aren't visible in the ticket history."
9758+
msgstr ""
9759+
9760+
#: ../manage/trigger/how-do-they-work.rst:51
9761+
msgid "Time Event"
9762+
msgstr ""
9763+
9764+
#: ../manage/trigger/how-do-they-work.rst:53
9765+
msgid "The execution is triggered at a specific time when a certain event is reached, e.g. ticket pending time."
9766+
msgstr ""
9767+
9768+
#: ../manage/trigger/how-do-they-work.rst:56
9769+
msgid "This activator simply checks if **conditions** match. This is the same behavior as action-based activator's \"always\" mode."
9770+
msgstr ""
9771+
9772+
#: ../manage/trigger/how-do-they-work.rst:59
9773+
msgid "When creating a trigger, choose activator here:"
9774+
msgstr ""
9775+
9776+
#: ../manage/trigger/how-do-they-work.rst:64
9777+
#: ../system/core-workflows/how-do-they-work.rst:28
9778+
msgid "Conditions"
9779+
msgstr ""
9780+
9781+
#: ../manage/trigger/how-do-they-work.rst:66
9782+
msgid "When creating a trigger, define your conditions here:"
9783+
msgstr ""
9784+
9785+
#: ../manage/trigger/how-do-they-work.rst:70
9786+
msgid "Trigger conditions must match as configured for the trigger to fire."
9787+
msgstr ""
9788+
9789+
#: ../manage/trigger/how-do-they-work.rst:77
9790+
msgid "When creating a trigger, define your changes here:"
9791+
msgstr ""
9792+
9793+
#: ../manage/trigger/how-do-they-work.rst:81
9794+
msgid "Certain actions (such as *email*, *SMS* and *notes*) support :doc:`/misc/variables`, which can be used to build highly-customized message templates."
9795+
msgstr ""
9796+
9797+
#: ../manage/trigger/how-do-they-work.rst:85
9798+
msgid "A trigger can do the following things once its conditions have been met:"
9799+
msgstr ""
9800+
9801+
#: ../manage/trigger/how-do-they-work.rst:96
9802+
msgid "Modify the ticket"
9803+
msgstr ""
9804+
9805+
#: ../manage/trigger/how-do-they-work.rst:88
9806+
msgid "Examples: escalate its priority, close it, reassign it, rename it, add tags, subscribe and unsubscribe specific/all users, etc."
9807+
msgstr ""
9808+
9809+
#: ../manage/trigger/how-do-they-work.rst:91
9810+
msgid "Date & time attributes (like **Pending till**) can be specified in *absolute* or *relative* terms."
9811+
msgstr ""
9812+
9813+
#: ../manage/trigger/how-do-they-work.rst:94
9814+
msgid "You can also combine static text with placeholders for text fields. Remember that the placeholders' values have to be known during trigger runtime. Learn more about :doc:`/misc/variables`."
9815+
msgstr ""
9816+
9817+
#: ../manage/trigger/how-do-they-work.rst:107
9818+
msgid "Send an email or SMS"
9819+
msgstr ""
9820+
9821+
#: ../manage/trigger/how-do-they-work.rst:99
9822+
msgid "Either to the customer, the agent who owns the ticket, or every agent in the system."
9823+
msgstr ""
9824+
9825+
#: ../manage/trigger/how-do-they-work.rst:102
9826+
msgid "Sending emails allows you to include the attachments of the triggering article if required."
9827+
msgstr ""
9828+
9829+
#: ../manage/trigger/how-do-they-work.rst:105
9830+
msgid "In order to send emails with triggers, you need to configure an email address for the group, the trigger is working in. If you don't, Zammad will skip the trigger completely."
9831+
msgstr ""
9832+
9833+
#: ../manage/trigger/how-do-they-work.rst:110
9834+
msgid ":doc:`Fire a webhook </manage/webhook>`"
9835+
msgstr ""
9836+
9837+
#: ../manage/trigger/how-do-they-work.rst:110
9838+
msgid "Connect Zammad to another web service or application to give it live updates about new tickets."
9839+
msgstr ""
9840+
9841+
#: ../manage/trigger/how-do-they-work.rst:114
9842+
msgid "Add internal or public notes to the ticket"
9843+
msgstr ""
9844+
9845+
#: ../manage/trigger/how-do-they-work.rst:113
9846+
msgid "This allows you to help your agents with specific information if needed. (e.g. automated changes a trigger applied to the ticket)"
9847+
msgstr ""
9848+
9849+
#: ../manage/trigger/how-do-they-work.rst:119
9850+
msgid "Localization of Execution Changes"
9851+
msgstr ""
9852+
9853+
#: ../manage/trigger/how-do-they-work.rst:121
9854+
msgid "The system locale and timezone predefines a default format of date and timestamp replacement variables. These settings are customizable for triggers."
9855+
msgstr ""
9856+
9857+
#: ../manage/trigger/how-do-they-work.rst:0
9858+
msgid "Screenshot showing localization section of trigger dialog"
9859+
msgstr ""
9860+
9861+
#: ../manage/trigger/how-do-they-work.rst:128
9862+
msgid "Best practice is to create single separated localized triggers for each language/timezone and execute them based on user or organization attributes."
9863+
msgstr ""
9864+
9865+
#: ../manage/trigger/how-do-they-work.rst:131
9866+
msgid "The format and timezone of date and timestamp replacement variables is customizable by the use of the ``dt()`` method. Further on the ``t()`` method can be used to translated string replacement variables according to the selected locale language."
9867+
msgstr ""
9868+
9869+
#: ../manage/trigger/how-do-they-work.rst:133
9870+
msgid "For usage of the ``t()`` and ``dt()`` method, please follow the instructions in the :ref:`variables section <variable_localization>`."
9871+
msgstr ""
9872+
96699873
#: ../manage/trigger/learn-by-example.rst:2
96709874
msgid "Trigger Examples"
96719875
msgstr ""
@@ -10493,18 +10697,6 @@ msgstr ""
1049310697
msgid "Next, choose a suitable activator type under **Activated by** field:"
1049410698
msgstr ""
1049510699

10496-
#: ../manage/webhook/examples/generic-notifications-trigger.rst:32
10497-
#: ../misc/object-conditions/basics.rst:66
10498-
#: ../system/core-workflows/how-do-they-work.rst:60
10499-
#: ../system/core-workflows/learn-by-example.rst:58
10500-
#: ../system/core-workflows/learn-by-example.rst:113
10501-
#: ../system/core-workflows/learn-by-example.rst:157
10502-
#: ../system/core-workflows/learn-by-example.rst:223
10503-
#: ../system/core-workflows/learn-by-example.rst:260
10504-
#: ../system/sessions.rst:51
10505-
msgid "Action"
10506-
msgstr ""
10507-
1050810700
#: ../manage/webhook/examples/generic-notifications-trigger.rst:18
1050910701
msgid "This will execute the trigger on a specific action, e.g. user creating or updating a ticket, an email coming in."
1051010702
msgstr ""
@@ -10513,18 +10705,10 @@ msgstr ""
1051310705
msgid "If you choose **Action** activator, you can set one of the two options for **Action execution**, in order to influence how it evaluates configured conditions:"
1051410706
msgstr ""
1051510707

10516-
#: ../manage/webhook/examples/generic-notifications-trigger.rst:28
10517-
msgid "Selective"
10518-
msgstr ""
10519-
1052010708
#: ../manage/webhook/examples/generic-notifications-trigger.rst:26
1052110709
msgid "This will check if any property used as a condition attribute was updated by the action. If the action behind the trigger was one other than update, it will simply check if the conditions match."
1052210710
msgstr ""
1052310711

10524-
#: ../manage/webhook/examples/generic-notifications-trigger.rst:32
10525-
msgid "Always"
10526-
msgstr ""
10527-
1052810712
#: ../manage/webhook/examples/generic-notifications-trigger.rst:31
1052910713
msgid "This will check if the current state of the ticket matches configured conditions."
1053010714
msgstr ""
@@ -17884,10 +18068,6 @@ msgstr ""
1788418068
msgid "If selected, your conditions and actions will affect all applicable edit masks."
1788518069
msgstr ""
1788618070

17887-
#: ../system/core-workflows/how-do-they-work.rst:28
17888-
msgid "Conditions"
17889-
msgstr ""
17890-
1789118071
#: ../system/core-workflows/how-do-they-work.rst:30
1789218072
msgid "Zammad differentiates between selected and saved conditions. These can be combined wherever needed. You can find a description of the condition operators for core workflows in :doc:`/system/core-workflows/condition-operators`."
1789318073
msgstr ""

‎manage/trigger.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ settings:
2525
:maxdepth: 1
2626
:caption: Learn more
2727

28+
/manage/trigger/how-do-they-work
2829
/manage/trigger/learn-by-example
2930
/manage/trigger/limitations
3031
/manage/trigger/system-notifications

0 commit comments

Comments
 (0)