系统管理-扩展模块-Slack集成
本帖最后由 adminlily 于 2020-12-11 11:01 编辑Slack集成名称：Slack集成
版本:17.4.0
发布:2017-12-20
描述：发送通知到Slack
itop-version-min：2.0.0
关键词：slack, notification, action, trigger
依赖项：itop-config-mgmt
作者：ITOMIG GmbH
买它
此扩展添加了能力以基于操作活动发送通知并触发协作工具松弛。本页介绍如何配置和使用扩展，以便向Slack发送通知。
特征
默认情况下，唯一可用的功能类型是发送发送邮件。此扩展定义了一种新的功能类型：Slack通知。你能：
[*]发送通知给Slack
[*]配置通知的目标（松弛的工作空间，通道，人员）
[*]在Slack中配置传入通知的显示机器人名称
[*]通过添加标题，链接，编辑颜色等来格式化消息。
[*]注意并快速响应iTop中的更改
修订记录
版本发布日期注释
17.4.02017-12-20初始发布。
局限性
[*]虽然iTop与HTML一起使用来格式化消息，但是Slack使用自己的降价语言（例如语言）。此扩展将HTML转换为markdown。但是由于松弛标记的限制，当前图像不会发送到松弛，并且标题只会显示为粗体。
[*]到目前为止，不可能以异步方式发送松弛通知。因此，请注意配置参数“超时”。
要求
[*]现有松弛的工作空间
[*]已配置网络挂钩
[*]Webhook的URL（看起来像：https ::: hooks.slack.commservicessT000000000B000000000XXXXXXXXXXXXXXXXXXXXXXXXXXX）
安装
[*]使用标准安装流程 对于此扩展。
[*]在交互式向导的末尾，检查扩展列表中的Slack集成。
配置
以下设置可用于配置模块：
参数类型描述默认价值
certificate_check布尔值是否检查服务器的ssl证书。真正
certificate_file串自定义证书文件的路径。
timeout整数确定iTop等待回复松弛的秒数5
用法
松弛通知是功能的特殊类型。它基于动作触发。用法与发送邮件通知非常相似。
要查看您的Slack通知，请使用“管理工具”菜单中的“通知”链接，然后单击选项卡“操作活动”。
https://www.itophub.io/wiki/media?w=400&tok=f26bfa&media=extensions%3Aslack_integration.png
请参见示例Slack通知“将工单信息发送到Slack”
此扩展的安装提供了一个示例Slack通知“将工单信息发送到Slack”。看看这个，以了解如何构建您自己的通知。
创建一个松弛通知功能
要创建新的功能，请转到“操作活动”选项卡，然后单击“新建…”。出现以下向导：
https://www.itophub.io/wiki/media?w=600&tok=23ff1e&media=extensions%3Aslack_create.png
松弛通知的必填字段为：
[*]名称：Slack通知的iTop名称
[*]Slack URL：Slack Webhook的URL。 （看到：hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack)
[*]状况：仅处于生产状态的通知将发送到松弛状态（默认值：正在测试）
[*]调试跟踪：如果启用，扩展将在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]这个网站.
添加松弛附件
为了改善格式，您可以使用松弛邮件附件。附件将显示在简单文本下方，并在左侧缩进并用颜色标记。
https://www.itophub.io/wiki/media?w=300&tok=d5ba9d&media=extensions%3Aslack_attachment.png
要启用附件，请设置属性“使用附件？”。为“是”并编辑以下属性：
[*]附件标题：附件文本上方的标题。
[*]附件链接：将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]https://www.itophub.io/wiki/media?w=600&tok=3d1910&media=extensions%3Aadd_trigger_slack.png
页:
[1]