安排到 Slack 集成的递送

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

Slack 附件（API 令牌）集成也仍然可用。

在 Looker Action Hub 中启用集成

如果您的 Looker 实例符合必要条件，则您的 Looker 管理员必须先在 Looker Action Hub 中为每个 Looker 实例启用 Slack 集成，然后用户才能通过 Slack 集成提交数据。

  1. 在平台下的管理面板中，转到操作页面。
  2. 点击 Looker Action Hub 中的 Enable 按钮，即可启用 Slack 集成。

  3. 在 Slack 操作页面上，点击 Connect 以连接到您的 Slack 工作区。

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

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

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

管理 Slack 工作区与 Looker 的连接

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

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

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

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

  • 如需刷新 Slack 工作区连接，而不必断开连接并重新连接，请点击重置按钮。

在 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. 在探索或数据洞见的发送或安排窗口中，选择 Slack 操作作为这些数据应发送到哪里？下的传送目标。对于信息中心，请在“安排和发送”时间范围中选择安排发送时间。
  3. 点击 Slack 旁边的登录。
  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 会显示与此 Looker 实例关联的 Slack 工作区或工作区专用的提交选项。
    • 在 Share In（分享到）字段中，输入要将数据发布到的 Slack 渠道的名称。您可以向公开或私密频道发送私信或消息。请包含前导 # 字符，例如 #Sales。
    • 在备注字段中，输入您要随传送内容一起发送的任何文本。您还可以使用 Slack 的高级格式设置和特殊解析功能，提及特定群组、用户或渠道，或进行任何其他特殊提及。
    • 在文件名字段中，输入附件文件的名称。
  4. 如果您要安排数据传送，请点击全部保存。您的查询或信息中心将按计划发送到 Slack。如果您要发送数据，请点击发送。您的数据将传送到您的 Slack 频道。

通过 Slack 访问 Looker

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

在 Slack 中分享指向 Looker 内容的链接

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

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

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

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

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

如果您还启用了 Lookerbot，则可能需要重命名某些斜线命令。自定义 Slack 命令不适用于 Slack 集成，但您可以在 Lookerbot 中配置自定义命令。按照使用 Lookerbot for Slack 最佳实践页面中使用 Lookerbot 入门部分中的说明，从 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 实例。