Slack集成

名称：Slack集成

版本:17.4.0

发布:2017-12-20

描述：发送通知到Slack

itop-version-min：2.0.0

关键词：slack, notification, action, trigger

依赖项：itop-config-mgmt

作者：ITOMIG GmbH

[  /fr_FR/shop/product/itop-slack-integration-203?search=slack]买它[/url]

此扩展添加了能力以基于操作活动发送通知并触发协作工具松弛。本页介绍如何配置和使用扩展，以便向Slack发送通知。

特征

默认情况下，唯一可用的功能类型是发送发送邮件。此扩展定义了一种新的功能类型：Slack通知。你能：

• 发送通知给Slack
• 配置通知的目标（松弛的工作空间，通道，人员）
• 在Slack中配置传入通知的显示机器人名称
• 通过添加标题，链接，编辑颜色等来格式化消息。
• 注意并快速响应iTop中的更改
  

修订记录

版本	发布日期	注释
17.4.0	2017-12-20	初始发布。

局限性

• 虽然iTop与HTML一起使用来格式化消息，但是Slack使用自己的降价语言（例如语言）。此扩展将HTML转换为markdown。但是由于松弛标记的限制，当前图像不会发送到松弛，并且标题只会显示为粗体。
• 到目前为止，不可能以异步方式发送松弛通知。因此，请注意配置参数“超时”。
  

要求

• 现有[  /create]松弛的工作空间[/url]
• 已配置[  /hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack]网络挂钩[/url]
• Webhook的URL（看起来像：https ::: hooks.slack.commservicessT000000000B000000000XXXXXXXXXXXXXXXXXXXXXXXXXXX）
  

安装

• 使用标准安装流程 对于此扩展。
• 在交互式向导的末尾，检查扩展列表中的Slack集成。
  

配置

以下设置可用于配置模块：

参数	类型	描述	默认价值
certificate_check	布尔值	是否检查服务器的ssl证书。	真正
certificate_file	串	自定义证书文件的路径。
timeout	整数	确定iTop等待回复松弛的秒数	5

用法

松弛通知是功能的特殊类型。它基于动作触发。用法与发送邮件通知非常相似。

要查看您的Slack通知，请使用“管理工具”菜单中的“通知”链接，然后单击选项卡“操作活动”。

请参见示例Slack通知“将工单信息发送到Slack”

此扩展的安装提供了一个示例Slack通知“将工单信息发送到Slack”。看看这个，以了解如何构建您自己的通知。

创建一个松弛通知功能

要创建新的功能，请转到“操作活动”选项卡，然后单击“新建…”。出现以下向导：

松弛通知的必填字段为：

• 名称：Slack通知的iTop名称
• Slack URL：Slack Webhook的URL。 （看到：[  /hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack]hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack[/url])
• 状况：仅处于生产状态的通知将发送到松弛状态（默认值：正在测试）
• 调试跟踪：如果启用，扩展将在log/slackintegration.log中写入调试日志（默认：否）
  

没有任何其他信息，iTop将向Slack发送一个空的通知。

编辑松弛连接信息

在Slack URL旁边，您可以指定以下属性：

• 频道或个人：如果您输入频道名称（i.e. #general）或个人名称（i.e. @personname），则消息将发送给该​​频道或个人。如果留为空白，则消息将发送到Slack Webhook中配置的默认通道。
• 应用名称：输入一个机器人名称，该名称将以通知的发送者名称显示为松弛形式。如果保留为空，则将显示在松弛Webhook中配置的默认名称。
  

消息文本和占位符

您可以通过编辑属性“简单文本”将内容添加到通知中。可以通过HTML格式化消息并添加占位符。占位符的工作方式与发送邮件通知中的工作方式相同。有关更多信息，请参见[  :8082/bin/view/2/2.6/2.6%C2%B736/#message_contents_and_placeholders]这个网站[/url].

添加松弛附件

为了改善格式，您可以使用[  /docs/message-attachments]松弛邮件附件[/url]。附件将显示在简单文本下方，并在左侧缩进并用颜色标记。

要启用附件，请设置属性“使用附件？”。为“是”并编辑以下属性：

• 附件标题：附件文本上方的标题。
• 附件链接：将OQL查询输入到对象。 Slack通知将向指向OQL中定义的对象的附件标题添加链接。如果OQL与多个对象匹配，那么当前只有第一个对象将被链接。允许您在OQL中使用占位符。例如：
  

SELECT Ticket WHERE id= :this->id

• 附件颜色：使用十六进制颜色价值指定附件消息的颜色。
• 附件文本：附件的文本。您可以使用HTML和占位符。
• 附件回退：如果Slack无法显示附件（即在通知预览中），则可以回退。您可以使用HTML和占位符。
  

将触发器添加到Slack通知

要定义何时必须发送通知，必须定义触发器并将通知链接到触发器。切换到“相关触发器”选项卡，然后单击“添加触发器…”，以将现有触发器添加到通知。

窗体底端

iTop Hub是一个信息聚合器和市场。作为iTop编辑器，我们为社区创建了一个独特的地方。它的内容将定期得到充实，因此请随时关注我们，不要错过任何更新！

[ ttps://www.itophub.io/wiki/media-detail?id=extensions%3Aitomig-slack-integration&media=extensions%3Aadd_trigger_slack.png][/url]

Slack集成

名称：Slack集成

版本:17.4.0

发布:2017-12-20

描述：发送通知到Slack

itop-version-min：2.0.0

关键词：slack, notification, action, trigger

依赖项：itop-config-mgmt

作者：ITOMIG GmbH

[  /fr_FR/shop/product/itop-slack-integration-203?search=slack]买它[/url]

此扩展添加了能力以基于操作活动发送通知并触发协作工具松弛。本页介绍如何配置和使用扩展，以便向Slack发送通知。

特征

默认情况下，唯一可用的功能类型是发送发送邮件。此扩展定义了一种新的功能类型：Slack通知。你能：

• 发送通知给Slack
• 配置通知的目标（松弛的工作空间，通道，人员）
• 在Slack中配置传入通知的显示机器人名称
• 通过添加标题，链接，编辑颜色等来格式化消息。
• 注意并快速响应iTop中的更改
  

修订记录

版本	发布日期	注释
17.4.0	2017-12-20	初始发布。

局限性

• 虽然iTop与HTML一起使用来格式化消息，但是Slack使用自己的降价语言（例如语言）。此扩展将HTML转换为markdown。但是由于松弛标记的限制，当前图像不会发送到松弛，并且标题只会显示为粗体。
• 到目前为止，不可能以异步方式发送松弛通知。因此，请注意配置参数“超时”。
  

要求

• 现有[  /create]松弛的工作空间[/url]
• 已配置[  /hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack]网络挂钩[/url]
• Webhook的URL（看起来像：https ::: hooks.slack.commservicessT000000000B000000000XXXXXXXXXXXXXXXXXXXXXXXXXXX）
  

安装

• 使用标准安装流程 对于此扩展。
• 在交互式向导的末尾，检查扩展列表中的Slack集成。
  

配置

以下设置可用于配置模块：

参数	类型	描述	默认价值
certificate_check	布尔值	是否检查服务器的ssl证书。	真正
certificate_file	串	自定义证书文件的路径。
timeout	整数	确定iTop等待回复松弛的秒数	5

用法

松弛通知是功能的特殊类型。它基于动作触发。用法与发送邮件通知非常相似。

要查看您的Slack通知，请使用“管理工具”菜单中的“通知”链接，然后单击选项卡“操作活动”。

请参见示例Slack通知“将工单信息发送到Slack”

此扩展的安装提供了一个示例Slack通知“将工单信息发送到Slack”。看看这个，以了解如何构建您自己的通知。

创建一个松弛通知功能

要创建新的功能，请转到“操作活动”选项卡，然后单击“新建…”。出现以下向导：

松弛通知的必填字段为：

• 名称：Slack通知的iTop名称
• Slack URL：Slack Webhook的URL。 （看到：[  /hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack]hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack[/url])
• 状况：仅处于生产状态的通知将发送到松弛状态（默认值：正在测试）
• 调试跟踪：如果启用，扩展将在log/slackintegration.log中写入调试日志（默认：否）
  

没有任何其他信息，iTop将向Slack发送一个空的通知。

编辑松弛连接信息

在Slack URL旁边，您可以指定以下属性：

• 频道或个人：如果您输入频道名称（i.e. #general）或个人名称（i.e. @personname），则消息将发送给该​​频道或个人。如果留为空白，则消息将发送到Slack Webhook中配置的默认通道。
• 应用名称：输入一个机器人名称，该名称将以通知的发送者名称显示为松弛形式。如果保留为空，则将显示在松弛Webhook中配置的默认名称。
  

消息文本和占位符

您可以通过编辑属性“简单文本”将内容添加到通知中。可以通过HTML格式化消息并添加占位符。占位符的工作方式与发送邮件通知中的工作方式相同。有关更多信息，请参见[  :8082/bin/view/2/2.6/2.6%C2%B736/#message_contents_and_placeholders]这个网站[/url].

添加松弛附件

为了改善格式，您可以使用[  /docs/message-attachments]松弛邮件附件[/url]。附件将显示在简单文本下方，并在左侧缩进并用颜色标记。

要启用附件，请设置属性“使用附件？”。为“是”并编辑以下属性：

• 附件标题：附件文本上方的标题。
• 附件链接：将OQL查询输入到对象。 Slack通知将向指向OQL中定义的对象的附件标题添加链接。如果OQL与多个对象匹配，那么当前只有第一个对象将被链接。允许您在OQL中使用占位符。例如：
  

SELECT Ticket WHERE id= :this->id

• 附件颜色：使用十六进制颜色价值指定附件消息的颜色。
• 附件文本：附件的文本。您可以使用HTML和占位符。
• 附件回退：如果Slack无法显示附件（即在通知预览中），则可以回退。您可以使用HTML和占位符。
  

将触发器添加到Slack通知

要定义何时必须发送通知，必须定义触发器并将通知链接到触发器。切换到“相关触发器”选项卡，然后单击“添加触发器…”，以将现有触发器添加到通知。

窗体底端

iTop Hub是一个信息聚合器和市场。作为iTop编辑器，我们为社区创建了一个独特的地方。它的内容将定期得到充实，因此请随时关注我们，不要错过任何更新！

[ ttps://www.itophub.io/wiki/media-detail?id=extensions%3Aitomig-slack-integration&media=extensions%3Aadd_trigger_slack.png][/url]