From version 1.1 >
edited by superadmin
on 2024/12/13, 16:23
To version < 2.1
edited by superadmin
on 2024/12/13, 16:45
Change comment: There is no comment for this version

Summary

Details

Icon Page properties
Content
... ... @@ -1,7 +1,9 @@
1 1  = 通知 =
2 2  
3 +
3 3  iTop 集成了与生命周期相关的通知系统 的对象。这允许管理员定义电子邮件 给定类的对象进入或离开时的通知规则 指定状态、创建新对象时、更新 从门户发生,或者当达到特定阈值时发生。
4 4  
6 +
5 5  通知机制分为两部分:
6 6  
7 7  * (((
... ... @@ -11,6 +11,7 @@
11 11  操作**定义将**要执行的操作。 在当前版本的 iTop 中,唯一可用的 action 类型 包括发送电子邮件。
12 12  )))
13 13  
16 +
14 14  对于给定的触发器,您可以定义多个操作 执行了 (Executed) 及其顺序。此外,还可以执行给定的操作 通过几个触发器。
15 15  
16 16  使用“管理工具”菜单中的“通知”链接进行管理 触发器和操作:
... ... @@ -24,8 +24,15 @@
24 24  “Actions” 选项卡显示所有操作
25 25  )))
26 26  
30 +(% class="wikigeneratedid" %)
31 +== ==
32 +
33 +(% class="wikigeneratedid" %)
34 +== ==
35 +
27 27  == 创建一个 行动 ==
28 28  
38 +
29 29  在创建有用的触发器之前,必须至少有一个操作是 定义。电子邮件操作是用于将邮件格式化为的模板 被发送,则定义消息的内容以及 主题、发件人和收件人。
30 30  
31 31  要创建新操作,请转到“操作”选项卡并单击 “新...”。此时将显示以下向导:
... ... @@ -32,6 +32,7 @@
32 32  
33 33  [[[[image:https://www.itophub.io/wiki/media?w=400&tok=aabd40&media=3_0_0:admin:new-action.png||alt="新建操作"]]>>url:https://www.itophub.io/wiki/media?media=3_0_0:admin:new-action.png]]
34 34  
45 +
35 35  电子邮件操作的必填字段包括:
36 36  
37 37  * (((
... ... @@ -52,8 +52,10 @@
52 52  **From (label):**静态 label 或占位符(如 .$this->agent_id->friendlyname$
53 53  )))
54 54  
66 +
55 55  当然,您必须指定**至少一个** 3 个字段,用于邮件收件人,**收件人、 抄送**或**密件抄送**。
56 56  
69 +
57 57  其他字段:
58 58  
59 59  * (((
... ... @@ -62,17 +62,9 @@
62 62  * (((
63 63  **状态**:
64 64  
65 -*
66 -
67 -在生产中:将电子邮件发送给检索到的人员 按 To、Cc 和 Bcc 查询
68 -
69 -*
70 -
71 -正在接受测试:电子邮件将发送到电子邮件地址Test recipient
72 -
73 -*
74 -
75 -Inactive:不发送电子邮件
78 +* 在生产中:将电子邮件发送给检索到的人员 按 To、Cc 和 Bcc 查询
79 +* 正在接受测试:电子邮件将发送到电子邮件地址Test recipient
80 +* Inactive:不发送电子邮件
76 76  )))
77 77  * (((
78 78  **Language**:要使用的语言 生成的电子邮件中插入的占位符。这会影响 主要是枚举的标签(如工单的状态)和 日期和时间格式。
... ... @@ -94,6 +94,12 @@
94 94  **忽略通知标志**:在确定要通知的联系人列表时(在每个 收件人:CC: 和 Bcc: 字段中),是否考虑联系人上的**通知**标志。当此字段设置为“Yes”时,要通知的联系人列表正是 OQL 表达式指定的内容。如果设置为“否”,则会自动向 OQL 表达式添加一个条件以排除联系人,其中“通知标志”设置为“否”。
95 95  )))
96 96  
102 +(% class="wikigeneratedid" %)
103 +=== ===
104 +
105 +(% class="wikigeneratedid" %)
106 +=== ===
107 +
97 97  === Defining recipients 定义收件人 ===
98 98  
99 99  The contacts to be notified in the “To”, “Cc”, and “Bcc” are defined by an OQL query. This allows to specify multiple recipients for the notification, like “all the contacts attached to a ticket” or “all the contacts on the impacted site”.
... ... @@ -105,6 +105,12 @@
105 105  If the field “Ignore Notify flag” of this action is set to “No”, the condition is automatically appended to the OQL.notify = 'yes'
106 106  如果此操作的“忽略通知标志”字段设置为“否”,则该条件将自动附加到 OQL。notify = 'yes'
107 107  
119 +(% class="wikigeneratedid" %)
120 +=== ===
121 +
122 +(% class="wikigeneratedid" %)
123 +=== ===
124 +
108 108  === Using predefined queries 使用预定义查询 ===
109 109  
110 110  The easiest mean to define who will receive those notifications is to retrieve the query using the magnifier icon and select the appropriate query
... ... @@ -112,12 +112,14 @@
112 112  
113 113  [[image:https://www.itophub.io/wiki/media?w=600&tok=d5166d&media=3_0_0:admin:predefined-queries-search.png]][[[[image:https://www.itophub.io/wiki/media?w=400&tok=ae4cfe&media=3_0_0:admin:predefined-queries.png]]>>url:https://www.itophub.io/wiki/media?media=3_0_0:admin:predefined-queries.png]]
114 114  
132 +
115 115  它会在字段中复制相应的 OQL。你可以选择一个 每个字段的不同预定义查询:
116 116  
117 117  |[[[[image:https://www.itophub.io/wiki/media?w=500&tok=369e0d&media=3_0_0:admin:predefined-queries-results.png]]>>url:https://www.itophub.io/wiki/media?media=3_0_0:admin:predefined-queries-results.png]]|To: 中的调用方:
118 118  
119 -{{{SELECT Person WHERE id= :this->caller_id}}}(((
137 +{{{SELECT Person WHERE id= :this->caller_id}}}
120 120  
139 +(((
121 121  在 抄送 中,链接到工单的联系人:
122 122  
123 123  {{{SELECT Contact
... ... @@ -134,6 +134,12 @@
134 134  
135 135  如果查询不是 100% 的需要,您可以修改查询。
136 136  
156 +(% class="wikigeneratedid" %)
157 +=== ===
158 +
159 +(% class="wikigeneratedid" %)
160 +=== ===
161 +
137 137  === 编写 自己的查询 ===
138 138  
139 139  您可以从头开始编写自己的查询并对其进行测试:请参阅 [[Object Query 有关>>url:https://www.itophub.io/wiki/page?id=3_0_0:oql:start]]编写 OQL 的更多信息,请参阅语言 查询
... ... @@ -140,6 +140,7 @@
140 140  
141 141  [[[[image:https://www.itophub.io/wiki/media?w=600&tok=7a33de&media=3_0_0:admin:predefined-queries-test.png||alt="Icon to test a query"]]>>url:https://www.itophub.io/wiki/media?media=3_0_0:admin:predefined-queries-test.png]][[[[image:https://www.itophub.io/wiki/media?w=600&tok=a21b24&media=3_0_0:admin:run-query.png||alt="Run Query screen"]]>>url:https://www.itophub.io/wiki/media?media=3_0_0:admin:run-query.png]]
142 142  
168 +
143 143  此 OQL 查询必须返回包含**单个** email 属性的对象列表,即:
144 144  
145 145  * (((
... ... @@ -152,6 +152,7 @@
152 152  团队
153 153  )))
154 154  
181 +
155 155  例如,要通知所有名字以 John 开头的人, **To** 字段可以包含:
156 156  
157 157  {{{SELECT Person WHERE name LIKE 'John%'}}}
... ... @@ -164,12 +164,20 @@
164 164   JOIN lnkFunctionalCIToTicket AS L2 ON L2.functionalci_id = CI.id
165 165   WHERE L2.ticket_id = :this->id}}}
166 166  
194 +
167 167  如果您不想通知 标志设置为 、 的人员 将此条件添加到 WHERENotificationNo
168 168  
169 169  {{{ Person.notify = 'yes'}}}
170 170  
199 +
171 171  **从 iTop 3.1.0 开始**,您可以实现相同的功能 结果,只需设置字段 **Ignore Notify flag** 设置为 “No” 以执行此操作。
172 172  
202 +(% class="wikigeneratedid" %)
203 +=== ===
204 +
205 +(% class="wikigeneratedid" %)
206 +=== ===
207 +
173 173  === 用 占位符 ===
174 174  
175 175  查询可以包含引用
... ... @@ -188,11 +188,14 @@
188 188  //此语法也有效: :current_contact_id 等效于 :current_contact->id
189 189  此语法也有效: :current_contact_id 相当于 :current_contact->id//
190 190  
191 -== 消息内容和占位符
192 -消息内容和占位符 ==
226 +==
227 + ==
193 193  
229 +(% class="wikigeneratedid" %)
230 +== 消息内容和占位符 ==
231 +
232 +
194 194  邮件正文使用 [[WYSIWYG HTML 编辑器>>url:https://www.itophub.io/wiki/page?id=3_0_0:admin:rich_text_limitations]]进行编辑。
195 -邮件正文使用 [[WYSIWYG HTML 编辑器>>url:https://www.itophub.io/wiki/page?id=3_0_0:admin:rich_text_limitations]]进行编辑。
196 196  
197 197  **从 iTop 3.1.0 开始**,您还可以上传自己的 HTML 模板 电子邮件。**HTML 模板**和 **Body** 字段都可以通过插入 placeholder **$content$** 在 HTML 模板中。这 content 将替换占位符。$content$
198 198  **从 iTop 3.1.0 开始**,您还可以为电子邮件上传自己的 HTML 模板。通过在 HTML 模板中插入占位符 **$content$**,可以组合 **HTML 模板**和 **Body** 字段。**Body** 字段的内容将替换占位符。$content$
... ... @@ -212,8 +212,8 @@
212 212  消息部分(主题、正文)|在 **HTML** 文本中, 占位符 开头和结尾为**$**
213 213  在 **HTML** 文本中,占位符以 $ 开头和结尾|例如。**$current_contact->friendlyname$**
214 214  
253 +
215 215  有几种类型的占位符:
216 -有几种类型的占位符:
217 217  
218 218  * (((
219 219  $CONSTANT$指固定值 命名为 //constant//。
... ... @@ -240,17 +240,26 @@
240 240  特定占位符**只能在 HTML 模板内**使用,以指示生成电子邮件时必须插入 **Body** 的位置。$content 美元
241 241  )))
242 242  
243 -在此处查看这些[[不同类型占位符>>url:https://www.itophub.io/wiki/page?id=3_0_0:admin:placeholders]]
244 -在此处查看这些[[不同类型占位符>>url:https://www.itophub.io/wiki/page?id=3_0_0:admin:placeholders]]的详细信息的详细信息
245 245  
246 -== 测试 通知 测试通知 ==
282 +在此处查看这些[[不同类型占位符>>url:https://www.itophub.io/wiki/page?id=3_0_0:admin:placeholders]]的详细信息
247 247  
284 +== 测试 通知 ==
285 +
286 +
248 248  要测试新操作,您可以使用状态 “正在测试” 和 在“测试收件人”中填写测试地址。在这种情况下, 通知将发送到后一个地址。一旦 通知已经过测试,请将其状态更改为 “In Production” 以将通知流向其实际收件人。
288 +
289 +
249 249  要测试新操作,您可以使用状态“正在测试”,并在“测试收件人”中填写测试地址。在这种情况下,通知将发送到后一个地址。测试通知后,将其状态更改为“In Production”,以使通知流向其实际收件人。
250 250  
251 251  如果要停用操作,只需将其状态设置为 “非活动”。
252 252  如果要停用某个操作,只需将其状态设置为“非活动”即可。
253 253  
295 +(% class="wikigeneratedid" %)
296 +== ==
297 +
298 +(% class="wikigeneratedid" %)
299 +== ==
300 +
254 254  == 创建 触发 创建触发器 ==
255 255  
256 256  要创建新触发器,请单击“新建”下拉列表 对于 “Trigger” 选项卡中的给定类别。以下向导 出现:
... ... @@ -352,7 +352,7 @@
352 352  示例:调用者请求的用户请求,他自己是负责在该服务子类别上交付 Tickets 的团队的一员(//请注意,这是一个非标准数据模型,也是一个有意义的数据模型!//
353 353  
354 354  ; [[不工作 例>>url:https://www.itophub.io/wiki/page?do=export_code&id=3_0_0:admin:notifications&codeblock=6]]
355 -:
402 +:
356 356  
357 357  {{{SELECT UserRequest AS u
358 358   JOIN ServiceSubcategory AS s ON u.servicesubcategory_id = s.id
... ... @@ -364,7 +364,7 @@
364 364  无需在当前对象上添加任何条件。
365 365  
366 366  ; [[更好>>url:https://www.itophub.io/wiki/page?do=export_code&id=3_0_0:admin:notifications&codeblock=7]]
367 -:
414 +:
368 368  
369 369  {{{SELECT UserRequest AS u
370 370   JOIN ServiceSubcategory AS s ON u.servicesubcategory_id = s.id
... ... @@ -378,6 +378,9 @@
378 378  如果要触发 通知仅限于通过电子邮件创建的工单,请使用 origin='mail' 在 Trigger Filter 中。
379 379  如果要触发仅限于通过电子邮件创建的工单的通知,请在触发器过滤器中使用 origin='mail'。
380 380  
428 +(% class="wikigeneratedid" %)
429 +==== ====
430 +
381 381  ==== 上下文 上下文 ====
382 382  
383 383  //上下文//允许您指定在哪些[[上下文中>>url:https://www.itophub.io/wiki/page?id=3_0_0:customization:context]],触发器应为 激活。
... ... @@ -497,7 +497,7 @@
497 497  此触发器有一个特殊的 Configuration,它会自动出现:
498 498  
499 499  ; [[配置 文件>>url:https://www.itophub.io/wiki/page?do=export_code&id=3_0_0:admin:notifications&codeblock=8]]
500 -:
550 +:
501 501  
502 502  {{{ // mentions.allowed_classes: Classes which can be mentioned through the autocomplete in the logs.
503 503   // Key of the array must be a single character that will trigger the autocomplete,
... ... @@ -535,6 +535,7 @@
535 535  //To// 应该是被提及的 Person,你可以这样得到:
536 536  
537 537  {{{SELECT Contact WHERE id = :mentioned->id}}}
588 +
538 538  * (((
539 539  //主题//是“您已被提及 XXXX“,XXXX 是您所在的日志的对象的名称 提到
540 540  //主题//是“您在 XXXX 中被提及”,XXXX 是您在日志中被提及的对象的名称
... ... @@ -544,7 +544,7 @@
544 544  )))
545 545  
546 546  ; [[身体>>url:https://www.itophub.io/wiki/page?do=export_code&id=3_0_0:admin:notifications&codeblock=11]]
547 -:
598 +:
548 548  
549 549  {{{ Hello $mentioned->first_name$,
550 550  
... ... @@ -699,7 +699,10 @@
699 699  它是 iTop 配置中的一个变量 (email_css),它允许 以重载用于电子邮件通知的默认 CSS。 查看以下[[教程>>url:https://www.itophub.io/wiki/page?id=3_0_0:customization:customize-notification-css]] 了解如何个性化您自己的 CSS。
700 700  这是 iTop 配置中的一个变量 (email_css),它允许重载用于电子邮件通知的默认 CSS。查看以下[[教程>>url:https://www.itophub.io/wiki/page?id=3_0_0:customization:customize-notification-css]],了解如何个性化您自己的 css。
701 701  
702 -== A 步骤 步骤示例
753 +(% class="wikigeneratedid" %)
754 +== ==
755 +
756 +== A 步骤 步骤示例 
703 703  Step by Step 示例 ==
704 704  
705 705  **[[教程 创建您的第一个通知
深圳市艾拓先锋企业管理咨询有限公司