Slack

通过 ArcGIS Velocity 中的 Slack 输出,您可以向 Slack 频道发送消息。 这些消息可以包括文本、图形和按钮,从而提供一种吸引人的交互式信息交流方式。  使用 Velocity 时,可以使发布到 Slack 频道的消息包含要素数据。 这是一种跨不同系统与用户交流信息的机制。 

要使用此输出类型,必须首先在 Slack 中生成 webhook URL。 此 webhook URL 后续将用于配置 Velocity 中的 Slack 输出。

示例

此处是 Slack 输出的使用示例:

一位分析师配置了计划大数据分析,以处理定期更新的车辆事故数据集。 分析师将 Slack 输出添加到了可向 Slack 频道发送消息的分析中。 此消息提供汇总统计数据,其中包括车辆事故总数和按时间划分的事故分类。

用法说明

使用 Slack 输出时,请谨记以下信息:

Slack 消息 JSON 示例

以下示例可创建一条显示轮船信息的基础 Slack 消息。

示例 1:基础 Slack 消息

 
// Output is wrapped in Text() 
Text({ 
    "blocks": [ 
      { 
        "type": "header", 
        "text": { 
          "type": "plain_text", 
          "text": "Vessel Information", 
          "emoji": true 
        } 
      }, 
      { 
        "type": "section", 
        "fields": [ 
          {   
												"type": "plain_text", 
            "text": "Vessel Name: " + $feature.name, 
            "emoji": true 
          }, 
          { 
            "type": "plain_text", 
            "text": "Vessel ID: " + $feature.num, 
            "emoji": true 
          } 
        ] 
      } 
    ] 
})

上方示例创建了以下轮船信息消息,其中包括轮船名称和 ID。

包含轮船详细信息的 Velocity 警告

下方示例可生成一条包含链接和 markdown 文本的 Slack 消息。

示例 2:包含链接和 markdown 文本的 Slack 消息

 

// Output is wrapped in Text() 
Text({ 
    "blocks": [ 
        { 
            "type": "header", 
            "text": { 
                "type": "plain_text", 
                "text": "New vessel detected at " + $feature.currTime, 
                "emoji": true 
            } 
        }, 
        { 
            "type": "section", 
            "text": { 
                "type": "plain_text", 
                "text": "Vessel Name " + $feature.name + ", traveling at " + $feature.speed + " miles per hour, was detected entering the service territory.", 
                "emoji": true 
            } 
        }, 
        { 
            "type": "section", 
            "text": { 
                "type": "mrkdwn", 
                "text": "Click the <https://www.esri.com/en-us/arcgis/products/arcgis-velocity/overview|link> for additional information about this vessel. :boat: " 
            } 
        } 
    ] 
})

上方示例创建了以下新检测到的轮船消息,其中包括轮船名称、日期和时间以及用于获取更多信息的链接。

包含新检测到的轮船详细信息的 Velocity 警告

参数

以下是 Slack 输出的参数:

参数描述数据类型

Slack Webhook URL

(必填)

Slack 中创建的传入 webhook URL。

字符串

POST 正文

(必填)

JSON Arcade 表达式。 JSON 必须包含在 Text() Arcade 表达式中。

Arcade 表达式

其他日志记录

(可选)

可以为 Velocity 生成的原始 HTTP 请求和响应启用日志记录。

注:

仅当进行故障排除时,才应启用此参数,并且应在完成故障排除时禁用。 如果在启用参数后启动分析,调试级别日志即会出现在分析日志页面上。 如果需要故障排除方面的帮助,请联系 Esri 技术 支持

布尔

注意事项和限制

下面是使用此输出时的注意事项和限制:

  • 了解数据的速度至关重要。 发送到此输出的每个记录都将生成单独的请求。 如果在一秒钟内发出了多个请求,则可以限制客户端连接。 最佳做法是将此输出用于不经常发生的事件。

    了解有关传入 webhook 速率限制的详细信息

  • 理解所发送的消息十分重要。 Slack 将截断包含超过 40,000 个字符的消息,并且简单 text 值不应超过 4,000 个字符。

    了解有关截断内容的详细信息