安排交付到 Slack 集成

您可以在 Slack 工作区中安装 Looker 应用,以直接向公共和专用 Slack 频道发送或安排数据传送。如要允许安装 Looker 应用,您的 Slack 工作区所有者可能需要为您的 Slack 工作区调整应用安装设置

Slack 附件(API 令牌)集成仍然可供使用。

在 Looker Action Hub 中启用集成

如果您的 Looker 实例满足必要条件,您的 Looker 管理员必须在 Looker Action Hub 中为每个 Looker 实例启用 Slack 集成,然后用户才能通过 Slack 集成传送数据。

  1. 平台下的管理面板中,前往操作页面。
  2. 点击 Enable 按钮,以在 Looker Action Hub 中启用 Slack 集成。
  3. Slack 操作页面上,点击连接以连接到您的 Slack 工作区。

    Looker 将请求访问页面右上角的下拉菜单中指示的 Slack 工作区。如需将多个 Slack 工作区连接到单个 Looker 实例,请点击 + 连接到 Slack 工作区链接。

  4. 点击允许,然后返回到 Slack 操作页面。

  5. 点击启用开关,然后点击保存

管理 Slack 工作区与 Looker 的连接

您可以从 Slack 操作页面管理实例的 Slack 工作区连接。在管理面板中的操作页面上,点击 Slack 集成旁边的设置按钮。

管理员可以对每个 Slack 工作区连接执行以下操作:连接、断开连接和重置。

  • 如需将其他 Slack 工作区连接到 Looker 实例,请点击 + 连接到 Slack 工作区链接。

  • 如需断开现有的 Slack 工作区连接,请点击断开连接按钮,然后点击弹出警告消息中的确定。您无需点击 Slack 操作页面上的 Save 即可保存这些设置,即使未连接任何 Slack 工作区,操作仍将显示为已启用

  • 如需刷新 Slack 工作区连接,而无需断开连接并重新连接,请点击 Reset 按钮。

在您的 Slack 工作区中进行身份验证

用户必须在 Looker 管理员关联到 Looker 的同一 Slack 工作区中进行身份验证。此外,用户还必须是工作区的现有成员,才能从 Looker 中进行身份验证。

首次在 Slack 工作区中进行身份验证时,您可以执行以下操作:

成功从 Looker 向 Slack 验证身份后,您会收到 Slack 确认消息。

从“帐号”页面向 Slack 工作区进行身份验证

  1. 在 Looker 中,点击屏幕右上角的用户个人资料图标,然后选择帐号
  2. 为您的实例启用的任何集成都显示在集成下。如果您的 Looker 管理员启用了至少一个 Slack 工作区,则系统会显示使用 Slack 登录按钮。如果您的 Looker 管理员已将多个 Slack 工作区关联到您的 Looker 实例,系统会显示工作区列表,其中包含用于分别登录每个工作区的选项。
  3. Looker 将请求访问 Slack 工作区。如果您的 Looker 管理员已将多个 Slack 工作区连接到您的 Looker 实例,则 OAuth 页面的右上角会显示一个下拉菜单。从下拉列表中选择适当的 Slack 工作区。点击允许
  4. 当您返回帐号页面时,集成部分中会显示一个选项,可让您撤消任何您连接到的任何工作区的 Slack 凭据。 注意:请勿撤消您的 Slack 令牌,如果您撤消,您创建的所有时间表都将失败。

现在您已通过身份验证,您可以发送或安排信息中心、Look 和探索。如需了解详情,请参阅本页面上的将数据传送到 Slack 部分。

从“Send”或“Schedule”窗口向 Slack 工作区进行身份验证

  1. 在 Looker 中,转到要传送的内容,点击齿轮菜单,然后点击发送安排时间。对于信息中心,选择安排发送时间
  2. 在探索或 Look 的发送安排窗口中,在这些数据应发送到何处?下方,选择 Slack 操作作为传送目的地。对于信息中心,请在安排和发送时间中选择安排发送时间
  3. 点击 Slack 旁边的 Log in
  4. Looker 将请求访问 Slack 工作区。如果您的 Looker 管理员已将多个 Slack 工作区连接到您的 Looker 实例,则 OAuth 页面的右上角会显示一个下拉菜单。从下拉列表中选择适当的 Slack 工作区。点击允许
  5. 发送安排发送时间窗口(或信息中心的安排发送时间窗口)现在会显示您的 Slack 传送选项,包括 Slack 工作区的公共和专用渠道。

将数据传送到 Slack

您可以将内容分发到多个 Slack 工作区之一。Looker 管理员设置工作区连接后,您可以从用户账号页面登录每个关联。然后,您可以从发送安排弹出式窗口的工作区下拉列表中选择一个目标工作区,也可以信息中心的安排发送时间

以下示例显示了用于传送信息中心的格式选项,包括:

  • PDF
  • 可视化 (PNG)
  • CSV ZIP 文件

发送或安排 Look 或探索时,可使用不同的格式设置选项,包括:

  • CSV
  • XLSX
  • JSON - 简单:在此格式中,Looker 使用维度或测量的字段名称(而不是字段的标签)作为其呈现值。
  • JSON - 标签:在此格式中,Looker 使用字段 labels 作为其 JSON 输出中的呈现值。
  • JSON - 简单,内嵌:在此格式中,Looker 使用维度或测量的字段名称(而不是字段的标签)作为其呈现值。
  • JSON - 详细,内嵌:在此格式中,Looker 使用维度或测量的字段名称(而不是字段的标签)作为其呈现值。
  • 文本
  • HTML

如需提供用户定义的信息中心、LookML 信息中心、Look 或“探索”功能,请转到您的内容并执行以下步骤:

  1. 点击齿轮菜单,然后点击发送安排时间。(您将无法安排安排探索。)对于信息中心,请从信息中心的三点状菜单中选择安排发送
  2. 发送安排窗口中,在这些数据应发送到何处?下方,选择 Slack 集成服务作为传送目的地。对于信息中心,请在目标位置下选择 Slack 集成作为传送目的地。如果这是您第一次使用 Slack 集成,则首先需要在 Slack 工作区中进行身份验证
  3. Looker 会显示特定于 Slack 工作区或连接到此 Looker 实例的工作区的分发选项。
    • 分享位置字段中,输入要将数据发布到的 Slack 频道的名称。您可以向公开或私享频道发送私信或消息。请在前面添加 # 字符,例如 #Sales。
    • 备注字段中,输入您想在提交内容中添加的任何文本。您还可以使用 Slack 的高级格式设置及特殊解析来提及特定的群组、用户或频道,或者进行任何其他特别提及。
    • Filename(文件名)字段中,输入附件文件的名称。
  4. 如果您要安排数据传送,请点击全部保存。您的查询或信息中心将按计划传送到 Slack。如要发送数据,请点击发送。您的数据将传送到您的 Slack 频道。

从 Slack 访问 Looker

您可以通过以下方式在 Slack 中访问 Looker 数据:

您可以在 Slack 中分享指向 SQL Runner 可视化图表用户定义的信息中心LookML 信息中心Looks(但不包括公开嵌入的 Look)或 Explores 的链接。

该链接会在 Slack 中展开,以显示内容的标题及其部分元数据,只有有权访问底层内容的用户才能看到这些内容。链接解除后,您或其他用户将可以:

  • 发布一个返回 Looker 中的内容的链接以及该频道中内容的快照 - 点击发布到此频道。内容发布到频道后,频道中的任何人都可以查看内容概况和标题,即使他们无权访问 Looker 中的基础内容也是如此。
  • 将内容添加到 Looker Favorites 文件夹 - 点击 Add to Favorites(添加到收藏夹)。将内容添加到 Favorites 文件夹后,Slack 中的 Looker 应用会在 Slack 中显示一条消息,其中包含访问 Looker 中的 Favorites 文件夹的链接。

如果您有多个 Looker 实例连接到工作区,则必须设置默认实例,使其与您要从中共享链接的 Looker 实例相匹配。

使用斜杠命令在 Slack 中检索 Looker 信息

如果您还启用了 Lookerbot,则可能需要重命名一些斜杠命令。自定义 Slack 命令不适用于 Slack 集成,但您可以在 Lookerbot 中配置自定义命令。按照在 Slack 中使用 Lookerbot 最佳实践页面中的 Lookebot 使用入门部分中的说明,从 Lookerbot GitHub 代码库进行更新,确保您使用的是 Lookerbot 0.0.16 或更高版本。

使用以下斜杠命令从 Looker 检索信息并将其发布到 Slack:

  • /looker/looker whoami - Slack 中的 Looker 应用会按名称问候您,告知您已连接到的 Looker 实例,并提供您的 Looker Favorites 文件夹、个人文件夹和 Help 的链接。
  • /looker help - Slack 中的 Looker 应用列出了支持的斜杠命令。
  • /looker favorites - Slack 中的 Looker 应用会列出您的 Looker Favorites 文件夹中的内容。点击每项内容旁边的省略号 (...) 访问一个菜单,您可以在其中发布到此频道从收藏夹中移除
  • /looker folder - Slack 中的 Looker 应用列出了您的 Looker 个人文件夹中的内容。点击每项内容旁边的省略号 (...) 访问一个菜单,您可以在其中发布到该频道从收藏夹中移除(如果相应内容也位于收藏夹文件夹中)。
  • /looker select - Slack 中的 Looker 应用列出了连接到该 Slack 工作区的一个或多个实例。如需为您的 Slack 工作区设置默认实例,请从此列表中点击该实例。所有特定于实例的斜杠命令都将应用于默认 Looker 实例。

在 Slack 中查看 Looker 应用的“首页”标签页

如需在 Slack 中查看您喜爱的 Looker 内容和文件夹的列表,请点击 Looker 应用中的首页标签页。

如果您为 Slack 工作区设置了默认的 Looker 实例,则只能通过 Looker 应用的首页标签页查看来自该实例的内容。

为 Slack 工作区设置默认 Looker 实例

如果您的 Looker 管理员仅将一个 Looker 实例连接到您的 Slack 工作区,则该实例是您的默认实例。

如果您的 Looker 管理员已将多个 Looker 实例关联到您的 Slack 工作区,您可以将其中一个实例设为默认 Looker 实例。任何特定于实例的斜杠命令/looker help 之外的大多数命令)和链接展开都将应用于默认实例。

  1. 在 Slack 中,运行斜杠命令 /looker select 以查看连接到 Slack 工作区的 Looker 实例列表。

  2. Looker 应用会询问要将哪个实例设为默认实例?点击与 Looker 实例名称对应的按钮,将此实例设为默认实例。

    Looker 应用会确认您的选择。

如需切换默认的 Looker 实例,请再次运行 /looker select,然后选择其他 Looker 实例。如果您要从非默认实例的 Looker 实例展开链接,则必须切换默认实例。如果您未切换实例并尝试展开非默认 Looker 实例中的链接,系统会提示您登录相应 Looker 实例。