Pianificazione delle pubblicazioni nell'integrazione di Slack

Puoi installare l'app Looker nella tua area di lavoro Slack per inviare o pianificare l'invio dei dati direttamente ai canali Slack pubblici e privati. Per abilitare l'installazione dell'app Looker, il proprietario dell'area di lavoro di Slack potrebbe dover modificare le impostazioni di installazione dell'app per l'area di lavoro di Slack.

Anche l'integrazione dell'allegato Slack (token API) è ancora disponibile per l'uso.

Abilitazione dell'integrazione nell'hub azioni di Looker

Se l'istanza di Looker soddisfa le condizioni richieste, l'amministratore di Looker deve abilitare l'integrazione di Slack nell'hub azioni di Looker per ogni istanza di Looker prima che gli utenti possano fornire i dati con l'integrazione di Slack.

  1. Nel riquadro Amministrazione, in Piattaforma, vai alla pagina Azioni.
  2. Fai clic sul pulsante Abilita per abilitare l'integrazione di Slack nell'hub azioni di Looker.
  3. Nella pagina delle azioni di Slack, fai clic su Connetti per connetterti all'area di lavoro di Slack.

    Looker richiederà l'accesso all'area di lavoro di Slack indicata nel menu a discesa in alto a destra nella pagina. Per connettere più aree di lavoro di Slack a una singola istanza di Looker, fai clic sul link + Connetti all'area di lavoro di Slack.

  4. Fai clic su Consenti e torna alla pagina delle azioni di Slack.

  5. Fai clic sull'opzione Abilita e fai clic su Salva.

Gestione delle connessioni all'area di lavoro di Slack con Looker

Puoi gestire le connessioni all'area di lavoro Slack dell'istanza dalla pagina delle azioni Slack. Fai clic sul pulsante Impostazioni accanto all'integrazione di Slack nella pagina Azioni del riquadro Amministrazione.

Gli amministratori possono eseguire le seguenti operazioni con ogni connessione all'area di lavoro Slack: Connetti, Disconnetti e Reimposta.

  • Per connettere altre aree di lavoro di Slack all'istanza di Looker, fai clic sul link + Connettiti all'area di lavoro Slack.

  • Per disconnettere una connessione all'area di lavoro Slack esistente, fai clic sul pulsante Disconnetti e poi su OK nel messaggio di avviso popup. Non è necessario fare clic su Salva nella pagina delle azioni di Slack per salvare queste impostazioni e l'azione continuerà a essere visualizzata come Abilitata anche se non è collegata alcuna area di lavoro Slack.

  • Per aggiornare la connessione all'area di lavoro di Slack senza doverla disconnettere e riconnetterla, fai clic sul pulsante Reimposta.

Autenticazione nell'area di lavoro Slack

Gli utenti devono eseguire l'autenticazione nella stessa area di lavoro di Slack che l'amministratore di Looker ha connesso a Looker. Per poter eseguire l'autenticazione da Looker, gli utenti devono anche essere membri esistenti dell'area di lavoro.

Puoi eseguire l'autenticazione in un'area di lavoro Slack per la prima volta da:

Dopo aver eseguito l'autenticazione in Slack da Looker, riceverai un messaggio di conferma su Slack.

Autenticazione in un'area di lavoro Slack dalla pagina Account

  1. In Looker, fai clic sull'icona del profilo utente nell'angolo in alto a destra dello schermo e seleziona Account.
  2. Tutte le integrazioni abilitate per l'istanza vengono visualizzate in Integrazioni. Se l'amministratore di Looker ha abilitato almeno un'area di lavoro di Slack, sarà presente un pulsante per Accedi con Slack. Se l'amministratore di Looker ha collegato più di un'area di lavoro di Slack alla tua istanza di Looker, viene visualizzato un elenco di aree di lavoro con le opzioni per accedere a ciascuna singolarmente.
  3. Looker richiederà l'accesso all'area di lavoro di Slack. Se l'amministratore di Looker ha collegato più aree di lavoro di Slack all'istanza di Looker, viene visualizzato un menu a discesa in alto a destra nella pagina OAuth. Seleziona l'area di lavoro di Slack appropriata nel menu a discesa. Fai clic su Consenti.
  4. Quando torni alla pagina Account, nella sezione Integrazioni viene visualizzata un'opzione che ti consente di revocare le credenziali di Slack per tutte le aree di lavoro a cui hai effettuato la connessione. Attenzione: fai attenzione a non revocare il token Slack perché, in questo caso, le pianificazioni che hai creato non andranno a buon fine.

Ora che hai eseguito l'autenticazione, puoi inviare o pianificare dashboard, Look ed esplorazioni. Per ulteriori informazioni, consulta la sezione Invio di dati a Slack in questa pagina.

Autenticazione in un'area di lavoro di Slack dalla finestra Invia o Pianificazione

  1. In Looker, vai ai contenuti da caricare, fai clic sul menu a forma di ingranaggio e poi su Invia o Pianifica. Per le dashboard, seleziona Pianifica invio.
  2. Nella finestra Invia o Pianifica di un'esplorazione o un Look, seleziona l'azione Slack come destinazione della consegna in Dove devono essere inviati questi dati?. Per le dashboard, seleziona Pianifica invio nella finestra Pianifica e invia.
  3. Accanto a Slack, fai clic su Accedi.
  4. Looker richiederà l'accesso all'area di lavoro di Slack. Se l'amministratore di Looker ha collegato più aree di lavoro di Slack all'istanza di Looker, viene visualizzato un menu a discesa in alto a destra nella pagina OAuth. Seleziona l'area di lavoro di Slack appropriata nel menu a discesa. Fai clic su Consenti.
  5. Nella finestra Invia o Pianifica (o Pianifica invio per le dashboard) ora vengono visualizzate le opzioni di consegna Slack, inclusi i canali pubblici e privati dell'area di lavoro di Slack.

Invio dei dati a Slack

Puoi caricare contenuti in una delle diverse aree di lavoro di Slack. Dopo che un amministratore di Looker ha configurato le connessioni dell'area di lavoro, puoi accedere a ciascuna di esse dalla tua pagina Account utente. Successivamente, puoi selezionare un'area di lavoro di destinazione tra quelle elencate nel menu a discesa Aree di lavoro del popup Invia o Pianifica oppure nella finestra Pianifica invio per le dashboard.

L'esempio seguente mostra le opzioni di formattazione per la pubblicazione di una dashboard, tra cui:

  • PDF
  • Visualizzazione (PNG)
  • File ZIP CSV

Per inviare o pianificare un Look o un'esplorazione sono disponibili diverse opzioni di formattazione, tra cui:

  • CSV
  • XLSX
  • JSON - Semplice: in questo formato, Looker utilizza il nome del campo di una dimensione o di una misura anziché l'etichetta del campo.
  • JSON - Etichetta: in questo formato, Looker utilizza le etichette dei campi come valore visualizzato nell'output JSON.
  • JSON - Semplice, incorporato: in questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo.
  • JSON - Dettagliato, In linea: in questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo.
  • Testo
  • HTML

Per fornire una dashboard definita dall'utente, una dashboard LookML, un Look o un'esplorazione, vai ai tuoi contenuti ed esegui questi passaggi:

  1. Fai clic sul menu a forma di ingranaggio e seleziona Invia o Programma. Non avrai la possibilità di pianificare un'esplorazione. Per le dashboard, seleziona Pianifica invio dal menu con tre puntini della dashboard.
  2. Nella finestra Send (Invia) o Schedule (Pianifica), seleziona l'integrazione di Slack come destinazione di consegna in Where should this data go? (Dove devono essere inviati questi dati?). Per le dashboard, seleziona l'integrazione di Slack come destinazione di distribuzione in Destinazione. Se è la prima volta che utilizzi l'integrazione di Slack, devi prima eseguire l'autenticazione nell'area di lavoro di Slack.
  3. Looker mostra le opzioni di distribuzione specifiche per l'area di lavoro di Slack o le aree di lavoro connesse a questa istanza di Looker.
    • Nel campo Condividi in, inserisci il nome del canale Slack in cui pubblicare i dati. Puoi inviare messaggi diretti o messaggi a canali pubblici o privati. Includi il carattere # iniziale, ad esempio #Sales.
    • Nel campo Commento, inserisci il testo da includere nel caricamento. Puoi anche utilizzare la formattazione avanzata di Slack con analisi speciale per menzionare gruppi, utenti o canali specifici o per menzionare altre menzioni speciali.
    • Nel campo Nome file, inserisci un nome per il file allegato.
  4. Se stai pianificando un invio dei dati, fai clic su Salva tutto. La query o la dashboard verranno inviate a Slack come pianificato. Se intendi inviare i dati, fai clic su Invia. I dati verranno inviati al tuo canale Slack.

Accesso a Looker da Slack

Puoi accedere ai dati di Looker da Slack nei seguenti modi:

In Slack puoi condividere link a visualizzazioni SQL Runner, dashboard definite dall'utente, dashboard LookML, Look (ma non Look incorporati pubblicamente) o esplorazioni in Slack.

Il link si espande in Slack per mostrare il titolo dei contenuti e alcuni dei relativi metadati, che sono visibili solo a coloro che hanno accesso ai contenuti sottostanti. Una volta che il link si è aperto, tu o altri utenti potete:

  • Pubblica un link che rimanda ai contenuti in Looker e un'istantanea dei contenuti nel canale: fai clic su Pubblica su questo canale. Dopo che i contenuti sono stati pubblicati sul canale, chiunque può visualizzare l'istantanea e il titolo dei contenuti, anche se non ha accesso ai contenuti sottostanti in Looker.
  • Aggiungi i contenuti a una cartella di Looker Preferiti: fai clic su Aggiungi ai preferiti. Dopo che hai aggiunto contenuti alla cartella Favorites, l'app Looker in Slack mostra un messaggio in Slack con un link per accedere alla cartella Favorites in Looker.

Se più istanze di Looker sono connesse all'area di lavoro, devi impostare l'istanza predefinita in modo che corrisponda all'istanza di Looker da cui stai condividendo il collegamento.

Utilizzo dei comandi slash per recuperare le informazioni di Looker in Slack

Se hai abilitato Lookerbot, potrebbe essere necessario rinominare alcuni comandi slash. I comandi di Slack personalizzati non sono disponibili per l'integrazione di Slack, ma puoi configurarli in Lookerbot. Assicurati di utilizzare Lookerbot versione 0.0.16 o successiva eseguendo l'aggiornamento dal repository GitHub di Lookerbot come indicato nella sezione Introduzione a Lookebot della pagina delle best practice sull'utilizzo di Lookerbot per Slack.

Utilizza i seguenti comandi slash per recuperare informazioni da Looker e pubblicarle su Slack:

  • /looker e /looker whoami: l'app Looker in Slack ti saluta per nome, indica l'istanza di Looker a cui sei connesso e fornisce i link alla tua cartella Preferiti di Looker, alla cartella personale e alla Guida.
  • /looker help: l'app Looker in Slack elenca i comandi slash supportati.
  • /looker favorites: l'app Looker in Slack elenca i contenuti della cartella Preferiti di Looker. Fai clic sui puntini di sospensione (...) accanto a ciascun contenuto per accedere a un menu da cui puoi Pubblicare su questo canale o Rimuovi dai preferiti.
  • /looker folder: l'app Looker in Slack elenca i contenuti della cartella personale di Looker. Fai clic sui puntini di sospensione (...) accanto a ogni contenuto per accedere a un menu da cui puoi Pubblicare su questo canale o Rimuovi dai preferiti (se i contenuti si trovano anche nella cartella Preferiti).
  • /looker select: l'app Looker in Slack elenca le istanze collegate all'area di lavoro di Slack. Per impostare un'istanza predefinita per l'area di lavoro di Slack, selezionala dall'elenco. Tutti i comandi slash specifici dell'istanza vengono applicati all'istanza di Looker predefinita.

Visualizzazione della scheda Home dell'app Looker in Slack

Per visualizzare un elenco delle cartelle e dei contenuti di Looker preferiti in Slack, fai clic sulla scheda Home nell'app Looker.

Se imposti un'istanza di Looker predefinita per la tua area di lavoro Slack, vedrai solo i contenuti di quell'istanza nella scheda Home dell'app Looker.

Impostazione di un'istanza di Looker predefinita per l'area di lavoro di Slack

Se l'amministratore di Looker ha connesso una sola istanza di Looker all'area di lavoro di Slack, questa è l'istanza predefinita.

Se l'amministratore di Looker ha collegato più istanze di Looker all'area di lavoro di Slack, puoi impostarne una come istanza di Looker predefinita. Tutti i comandi slash specifici dell'istanza, la maggior parte dei comandi oltre a /looker help, e l'espansione dei link vengono applicati all'istanza predefinita.

  1. In Slack, esegui il comando slash /looker select per visualizzare un elenco delle istanze di Looker collegate alla tua area di lavoro Slack.

  2. L'app Looker chiede Quale istanza vuoi impostare come predefinita?. Fai clic sul pulsante corrispondente al nome dell'istanza di Looker per impostarla come predefinita.

    L'app Looker confermerà la tua selezione.

Per cambiare l'istanza di Looker predefinita, esegui di nuovo /looker select e seleziona un'istanza di Looker diversa. Devi cambiare istanze predefinite se stai espandendo i link da un'istanza di Looker diversa da quella predefinita. Se non cambi istanza e provi a sbloccare un link da un'istanza di Looker non predefinita, ti verrà chiesto di accedere a quell'istanza.