Slack 統合への配信のスケジューリング

LookerアプリをSlackワークスペースにインストールして、データ配信を直接Slackのパブリックチャンネルやプライベートチャンネルに送信またはスケジュールできます。Looker アプリをインストールできるようにするため、Slack ワークスペースのオーナーが Slack ワークスペースのアプリのインストール設定を調整する必要があるかもしれません。

Slack のアタッチメント(API トークン)の統合も使用できます。

Lookerアクションハブでの統合の有効化

Looker インスタンスが必要な条件を満たしている場合、Looker 管理者が Looker インスタンスごとに Looker Action Hub で Slack の統合を有効にする必要があります。これにより、ユーザーが Slack の統合にデータを送信できるようになります。

  1. [管理者] パネルの [プラットフォーム] から [アクション] ページに移動します。
  2. [Enable] ボタンをクリックして、Looker アクションハブで Slack 統合を有効にします。
  3. [Slack] アクションページで [Connect] をクリックし、Slack ワークスペースに接続します。

    Lookerは、ページの右上のプルダウンメニューに表示されているSlackワークスペースへのアクセスを要求します。複数の Slack ワークスペースを単一の Looker インスタンスに接続するには、[+ Slack ワークスペースに接続] リンクをクリックします。

  4. [許可] をクリックし、Slack アクションページに戻ります。

  5. [有効にする] スイッチをクリックし、[保存] をクリックします。

LookerへのSlackワークスペースの接続の管理

インスタンスの Slack ワークスペース接続は、[Slack] アクションページから管理できます。[Admin] パネルの [Actions] ページで、Slack 統合の横にある [Settings] ボタンをクリックします。

管理者は、Slack ワークスペース接続ごとに、接続、接続解除、リセットの各操作を実行できます。

  • 追加の Slack ワークスペースを Looker インスタンスに接続するには、[+ Connect to Slack workspace] リンクをクリックします。

  • 既存の Slack ワークスペース接続を切断するには、[切断] ボタンをクリックし、ポップアップ警告メッセージで [OK] をクリックします。これらの設定を保存するために、[Slack] アクション ページで [Save] をクリックする必要はありません。このアクションは引き続き [Enabled{] と表示されます。

  • 接続を切断して再接続せずに Slack ワークスペース接続を更新するには、[Reset] ボタンをクリックします。

Slackワークスペースへの認証

ユーザーは、Looker管理者によってすでにLookerに接続されたSlackワークスペースに認証する必要があります。また、該当するワークスペースのメンバーとなっていなければ、Lookerからワークスペースに認証できません。

Slackワークスペースへの初めての認証は、次の場所から行えます。

LookerからSlackへの認証に成功すると、Slackの確認メッセージが表示されます。

Slackワークスペースへの認証(アカウントページから)

  1. Looker で、画面の右上隅にあるユーザー プロフィール アイコンをクリックし、[アカウント] を選択します。
  2. インスタンスで有効になっている統合は、[統合] の下に表示されます。Looker 管理者が少なくとも 1 つの Slack ワークスペースを有効にしている場合、[Slack でログイン] ボタンが表示されます。Looker 管理者が複数の Slack ワークスペースを Looker インスタンスに接続している場合は、ワークスペースのリストが表示され、各ワークスペースに個別にログインできます。
  3. LookerはSlackワークスペースへのアクセスを要求します。Looker管理者がすでに複数のSlackワークスペースをLookerインスタンスに接続している場合、OAuthページの右上にプルダウンメニューが表示されます。プルダウンから適切なSlackワークスペースを選択します。[許可] をクリックします。
  4. [アカウント] ページに戻ると、[統合] セクションにオプションが表示され、接続しているワークスペースの Slack 認証情報を取り消すことが可能です。注意: Slack トークンを取り消さないように注意してください。取り消すと、作成済みのスケジュールがすべて失敗します。

これで認証が完了し、ダッシュボード、Look、Exploreを送信またはスケジュールできるようになりました。詳細については、このページの Slack へのデータの配信をご覧ください。

Slackワークスペースへの認証([送信]または[スケジュール]ウィンドウから)

  1. Looker で、配信するコンテンツに移動して、歯車メニューをクリックし、[送信] または [スケジュール] をクリックします。ダッシュボードの場合は、[配信をスケジュール]を選択します。
  2. Explore か Look の送信またはスケジュールウィンドウの [このデータをどこに配信しますか?] で、配信先として[Slack] アクションを選択します。ダッシュボードの場合は、[スケジュールと送信ウィンドウ] で [配信をスケジュール] を選択します。
  3. [Slack] の横にある [ログイン] をクリックします。
  4. LookerはSlackワークスペースへのアクセスを要求します。Looker管理者がすでに複数のSlackワークスペースをLookerインスタンスに接続している場合、OAuthページの右上にプルダウンメニューが表示されます。プルダウンから適切なSlackワークスペースを選択します。[許可] をクリックします。
  5. [送信] または [スケジュール] ウィンドウ(ダッシュボードの場合は [配信をスケジュール] ウィンドウ)に、Slack ワークスペースの一般公開チャネルとプライベート チャネルなどの Slack 配信オプションが表示されるようになりました。

Slackにデータを配信する

複数のSlackワークスペースの1つにコンテンツを配信できます。Looker 管理者がワークスペースの接続を設定したら、ユーザーの [アカウント] ページから各ワークスペースにログインできます。次に、[Send] か [Schedule] ポップアップの [Workspaces] プルダウン、またはダッシュボードの場合は [配信をスケジュール] ウィンドウにあるリストから、配信先のワークスペースを選択できます。

以下は、ダッシュボードを配信する書式設定オプションの例です。

  • PDF
  • ビジュアリゼーション(PNG)
  • CSV ZIPファイル

LookやExploreを送信またはスケジュールする場合は、次のようなさまざまな書式設定オプションを使用できます。

  • CSV
  • XLSX
  • JSON - シンプル: この形式では、Looker はフィールドのラベルではなく、レンダリングされた値としてディメンションまたはメジャーのフィールド名を使用します。
  • JSON - ラベル: この形式で、Looker は JSON 出力でレンダリングされた値としてフィールドラベルを使用します。
  • JSON - シンプル、インライン: この形式では、Looker はフィールドのラベルではなく、レンダリングされた値としてディメンションまたはメジャーのフィールド名を使用します。
  • JSON - 詳細、インライン: この形式では、Looker がフィールドのラベルではなく、レンダリングされた値としてディメンションまたはメジャーのフィールド名を使用します。
  • テキスト
  • HTML

ユーザー定義ダッシュボード、LookMLダッシュボード、Look、Exploreを配信するには、コンテンツに移動して、次の手順を実行します。

  1. 歯車メニューをクリックし、[送信] または [スケジュール] をクリックします。(Exploreをスケジューリングするオプションはありません。) ダッシュボードの場合は、ダッシュボードのその他メニューから [配信をスケジュール] を選択します。
  2. [送信] または [スケジュール] ウィンドウの [このデータをどこに配信しますか?] で、配信先として Slack の統合を選択します。ダッシュボードの場合は、[宛先] で配信先として Slack 統合を選択します。Slack の統合を初めて使用する場合は、まず Slack ワークスペースへの認証を行う必要があります。
  3. Lookerに、このLookerインスタンスに接続しているSlackワークスペース固有の配信オプションが表示されます。
    • [Share In] フィールドに、データを送信する Slack チャンネルの名前を入力します。ダイレクトメッセージやメッセージを、パブリックチャンネルやプライベートチャンネルに送信できます。先頭の # 文字を入力します(例: #Sales)。
    • [コメント] フィールドに、配信に含めるテキストを入力します。Slack の高度な書式設定と特別な解析を使用して、特定のグループ、ユーザー、チャンネルにメンションしたり、その他の特別なメンションを作成したりすることもできます。
    • [ファイル名] フィールドで、添付ファイルの名前を入力します。
  4. データ配信をスケジュールする場合は、[すべて保存] をクリックします。スケジュールに従ってクエリやダッシュボードがSlackに配信されます。データを送信する場合は、[Send] をクリックします。Slackチャンネルにデータが配信されます。

SlackからLookerにアクセスする

次の方法で、Slack内からLookerデータにアクセスできます。

SQL Runner ビジュアリゼーションユーザー定義のダッシュボードLookML ダッシュボードLook (ただし、パブリックで埋め込まれた Look は対象外)、または Slack のExplore へのリンクを共有できます。

リンクはSlackで展開され、コンテンツのタイトルとメタデータの一部が表示されます(元のコンテンツにアクセスできるユーザーにのみ表示されます)。リンクが展開されたら、あなたや他のユーザーは次の操作を行うことができます。

  • Looker のコンテンツへのリンクとチャンネル内のコンテンツのスナップショットを投稿するには、[この投稿に投稿] をクリックします。コンテンツがチャンネルに投稿されると、Looker で基になるコンテンツへのアクセス権がない場合でも、チャンネルの全員がコンテンツのスナップショットとタイトルを表示できます。
  • Looker の [お気に入り] フォルダにコンテンツを追加し、[お気に入りに追加] をクリックします。コンテンツを [お気に入り] フォルダに追加すると、Slack の Looker アプリに、Looker の [お気に入り] フォルダにアクセスするためのリンクが含まれるメッセージが Slack に表示されます。

複数の Looker インスタンスがワークスペースに接続されている場合は、リンクを共有する Looker インスタンスに合わせてデフォルト インスタンスを設定する必要があります。

スラッシュコマンドを使用してSlackでLooker情報を取得する

Lookerbot も有効にしている場合は、一部のスラッシュ コマンドの名前を変更する必要があります。SlackのカスタムコマンドはSlack統合では利用できませんが、Lookerbotでカスタムコマンドを設定することができます。Looker 向け Lookerbot の使用ヘルプセンターの記事で Lookerbot を使ってみるセクションの説明に従って Lookerbot GitHub リポジトリから更新し、Lookerbot バージョン 0.0.16 以降を使用していることを確認します。

次のスラッシュコマンドを使用してLookerから情報を取得し、それをSlackに投稿します。

  • /looker/looker whoami - Slack の Looker アプリはユーザーに name します。は、接続先の Looker インスタンスを示します。には、Looker の [お気に入り] フォルダ、個人用フォルダ、ヘルプへのリンクが用意されています。
  • /looker help - Slack の Looker アプリには、サポートされているスラッシュ コマンドが一覧表示されます。
  • /looker favorites - Slack の Looker アプリでは、Looker の お気に入り フォルダの内容が一覧表示されます。各コンテンツの横にある省略記号(...)をクリックすると、メニューにアクセスできます。このメニューから [このチャンネルに投稿] または [お気に入りから削除] を選択できます。
  • /looker folder - Slack の Looker アプリでは、Looker 個人用フォルダの内容が一覧表示されます。各コンテンツの横にある省略記号(...)をクリックすると、メニューにアクセスできます。このメニューには [この投稿に投稿] または [お気に入りから削除] が表示されます(コンテンツ(お気に入りフォルダにあります)。
  • /looker select - Slack の Looker アプリには、その Slack ワークスペースに接続されているインスタンスが一覧表示されます。Slackワークスペースのデフォルトインスタンスを設定するには、このリストの中からインスタンスをクリックします。インスタンス固有のすべてのスラッシュコマンドが、デフォルトのLookerインスタンスに適用されます。

SlackでLookerアプリのホームタブを表示する

Looker で [Home] タブをクリックすると、Slack でお気に入りの Looker コンテンツとフォルダのリストが表示されます。

Slack ワークスペースにデフォルトの Looker インスタンスを設定すると、Looker アプリの [Home] タブにそのインスタンスのコンテンツのみが表示されます。

SlackワークスペースのデフォルトLookerインスタンスを設定する

Looker管理者が1つのLookerインスタンスのみをSlackワークスペースに接続している場合、そのインスタンスがデフォルトです。

Looker管理者が複数のLookerインスタンスをSlackワークスペースにすでに接続している場合、それらのインスタンスの1つをデフォルトのLookerインスタンスに設定できます。インスタンス固有のスラッシュ コマンド/looker help 以外のほとんどのコマンド)とリンク unurling は、デフォルトのインスタンスに適用されます。

  1. Slack でスラッシュ コマンド /looker select を実行し、Slack のワークスペースに接続されている Looker インスタンスのリストを表示します。

  2. Looker アプリから「どのインスタンスをデフォルトに設定しますか?」と質問されます。Lookerインスタンスの名前のボタンをクリックして、そのインスタンスをデフォルトに設定します。

    Lookerアプリが選択を確認します。

デフォルトの Looker インスタンスを切り替えるには、/looker select を再度実行して、別の Looker インスタンスを選択します。デフォルトではないLookerインスタンスからリンクを展開する場合、デフォルトのインスタンスを切り替えなければなりません。インスタンスを切り替えず、非デフォルトのLookerインスタンスからリンクを展開しようとする場合、そのLookerインスタンスにログインするよう促されます。