Pianificazione delle distribuzioni all'integrazione di Slack

Puoi installare l'app Looker nella tua area di lavoro di Slack per inviare o pianificare la distribuzione dei dati direttamente ai canali Slack pubblici e privati. Per attivare 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.

L'integrazione di Slack non è supportata per le istanze ospitate dal cliente.
L'integrazione di Slack è disponibile per i deployment ospitati da Looker che soddisfano queste condizioni:

  • L'istanza di Looker è su 6.24 o versioni successive.
  • La funzionalità IP Allowlist (Lista consentita IP) non è attivata sull'istanza di Looker.

Anche l'integrazione di Slack Attachment (API Token) può essere utilizzata.

Abilitare l'integrazione nell'hub azioni di Looker

Se la tua istanza di Looker soddisfa le condizioni richieste, prima di poter fornire i dati con l'integrazione di Slack, l'amministratore di Looker deve attivare l'integrazione di Slack nell'hub azioni di Looker per ciascuna istanza di Looker.

  1. Nel riquadro Amministratore 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 dell'azione Slack, fai clic su Connect (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. Per collegare più aree di lavoro di Slack a una singola istanza di Looker, fai clic sul link + Connect to Slack workspace (Connetti ad area di lavoro di Slack).

  4. Fai clic su Allow (Consenti) e torna alla pagina delle azioni Slack.

  5. Fai clic sull'opzione Attiva e poi su Salva.

Gestione delle connessioni dell'area di lavoro di Slack a Looker

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

Gli amministratori possono eseguire le operazioni seguenti con ogni connessione dell'area di lavoro di Slack: connessione, disconnessione e reimpostazione.

  • Per collegare altre aree di lavoro di Slack all'istanza di Looker, fai clic sul link + Connect to Slack workspace (Connetti ad area di lavoro di Slack).

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

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

Autenticazione nell'area di lavoro di Slack

Gli utenti devono eseguire l'autenticazione nella stessa area di lavoro di Slack a cui l'amministratore di Looker ha collegato Looker. Inoltre, gli utenti devono essere membri esistenti dell'area di lavoro prima di autenticarsi da Looker.

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

Ricevi un messaggio di conferma di Slack dopo aver eseguito correttamente l'autenticazione in Slack da Looker.

Autenticazione in un'area di lavoro di Slack dalla pagina Account

  1. In Looker, fai clic sull'icona del tuo profilo utente in alto a destra dello schermo e seleziona Account.
  2. Qualsiasi integrazione abilitata per la tua istanza è visualizzata in Integrazioni. Se l'amministratore di Looker ha attivato almeno un'area di lavoro di Slack, vedrai un pulsante per accedere con Slack. Se l'amministratore di Looker ha collegato più di un'area di lavoro di Slack all'istanza di Looker, viene visualizzato un elenco di aree di lavoro con le opzioni per accedere a ognuna di loro 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. Tornando alla pagina Account, viene visualizzata un'opzione per revocare le credenziali di Slack per le aree di lavoro a cui sei collegato.

Fai attenzione a non revocare il token di Slack: in questo caso, le eventuali pianificazioni create 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 Inviare dati a Slack in questa pagina.

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

  1. In Looker, vai ai contenuti da pubblicare, fai clic sul menu a forma di ingranaggio e poi su Invia o Programma.
  2. Nella finestra Invia o Programma, seleziona l'azione Slack come destinazione della distribuzione nella sezione Where should this data go? (Dove devono essere inviati questi dati?).
  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 Programma ora vengono visualizzate le opzioni di pubblicazione di Slack, inclusi i canali pubblici e privati della tua area di lavoro di Slack. 

Invio dei dati a Slack

Per fornire dati all'integrazione di Slack, un amministratore di Looker deve prima concedere agli utenti l'autorizzazione send_to_integration e abilitare l'integrazione di Slack nell'hub azioni di Looker. Gli utenti devono inoltre autenticarsi nella stessa area di lavoro o in aree di lavoro di Slack a cui l'amministratore ha collegato Looker.

Puoi pubblicare contenuti in una di più aree di lavoro di Slack. Dopo che un amministratore di Looker ha configurato le connessioni a Workspace, puoi accedere a ognuna di esse dalla pagina Account dell'utente. Quindi, puoi selezionare un'area di lavoro di destinazione da quelli elencati nel menu a discesa Aree di lavoro del popup Invia o Pianifica.

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

  • PDF
  • Visualizzazione (PNG)
  • File ZIP CSV

L'invio o la pianificazione di un look o di un'esplorazione offre diverse opzioni di formattazione, tra cui:

  • CSV
  • XLSX
  • JSON - Semplice: in questo formato, Looker utilizza il nome di un campo di dimensione o misurazione come valore visualizzato anziché l'etichetta del campo.
  • JSON (etichetta): in questo formato, Looker utilizza i campi labels come valore visualizzato nell'output JSON.
  • JSON — Simple, Inline: in questo formato, Looker utilizza il nome di un campo di dimensione o misura come valore visualizzato anziché l'etichetta del campo.
  • JSON - Dettagliato, in linea: in questo formato, Looker utilizza il nome di un campo di dimensione o misura come valore visualizzato anziché l'etichetta del campo.
  • Testo
  • HTML

Per inviare un'esplorazione in formato PDF o PNG, salva l'aspetto di una dashboard e pianifica la dashboard nel formato desiderato. Per pianificare un'esplorazione devi prima salvarlo come look.

Per inviare o pianificare un look in formato PDF o PNG, salva l'aspetto in una dashboard e pianifica la dashboard nel formato desiderato.

Per pubblicare 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 poi su Invia o Programma. Non avrai la possibilità di pianificare un'esplorazione.
  2. Nella finestra Invia o Programma, seleziona l'integrazione di Slack come destinazione di distribuzione nella sezione Where should this data go? (Dove devono essere inviati questi dati?). Se è la prima volta che utilizzi l'integrazione di Slack, devi prima autenticarsi nell'area di lavoro di Slack.
  3. Looker visualizza opzioni di distribuzione specifiche per l'area di lavoro di Slack o per le aree di lavoro collegate a questa istanza di Looker.
    • Nel campo Share In (Condividi in), inserisci il nome del canale Slack in cui pubblicare i dati. Puoi inviare messaggi diretti o a canali pubblici o privati. Includi il carattere iniziale #, ad esempio #Vendite.
    • Nel campo Commento, inserisci il testo da includere nella pubblicazione.
      • Per menzionare un utente, includi <@user_ID>, che puoi copiare facendo clic sul pulsante ... nel relativo profilo utente Slack.
      • Per menzionare un gruppo, includi <@group_ID>, che puoi copiare dall'URL del browser quando sei nel profilo del gruppo.
      • Per menzionare un canale specifico, includi <#channel_ID>, che puoi copiare dall'URL del browser quando sei nel canale.
      • Per altre menzioni speciali, utilizza <!here>, <!channel> o <!everyone>.
    • Nel campo Nome file, inserisci un nome per il file allegato.
  4. Se stai pianificando una distribuzione di dati, fai clic su Salva tutto. La query o la dashboard verranno pubblicate in Slack come programmato. Se invii i tuoi dati, fai clic su Invia. I tuoi dati verranno inviati al tuo canale Slack.

Accesso a Looker da Slack

Puoi accedere ai dati di Looker dall'interno di Slack:

Condivisione di link ai contenuti di Looker in Slack

In Slack puoi condividere link a visualizzazioni SQL Runner, dashboard definite dall'utente (incluse le dashboard legacy), dashboard LookML, Looks (ma non Look incorporati pubblicamente) o Esplorazioni.

Il link si presenta in Slack per mostrare il titolo dei contenuti e alcuni dei relativi metadati, che sono visibili solo a chi ha accesso ai contenuti sottostanti. Dopo che il link si è sviluppato, tu o gli altri utenti potete:

  • Pubblica un link ai contenuti in Looker e un'istantanea dei contenuti nel canale. Fai clic su Pubblica su questo canale. Dopo aver pubblicato i contenuti sul canale, chiunque nel canale può visualizzare l'istantanea e il titolo dei contenuti, anche se non hanno accesso ai contenuti sottostanti in Looker.
  • Aggiungi i contenuti alla cartella Preferiti di Looker facendo clic su Add to Favorites (Aggiungi ai preferiti). Dopo aver aggiunto contenuti alla cartella Preferiti, l'app Looker in Slack mostra un messaggio in Slack con un link per accedere alla cartella Preferiti in Looker.

Se hai più istanze Looker connesse all'area di lavoro, devi impostare l'istanza predefinita in modo che corrisponda all'istanza di Looker da cui condividi il link.

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

Se hai attivato anche Lookerbot, potrebbe essere necessario rinominare alcuni comandi slash. I comandi Slack personalizzati non sono disponibili per l'integrazione di Slack, ma puoi configurarli in Lookerbot. Assicurati di utilizzare Lookerbot 0.0.16 o versioni successive eseguendo l'aggiornamento del repository GitHub di Lookerbot come indicato nella sezione Aggiornamento dell'app Lookerbot dell'articolo del Centro uso di Lookerbot per Slack.

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

  • /looker e /looker whoami: l'app Looker in Slack ti saluta per nome, ti dice l'istanza di Looker a cui sei connesso e fornisce link alla tua cartella Preferiti di Looker, alla tua 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 ogni contenuto per accedere a un menu da cui puoi pubblicare sul canale o rimuovere 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 Rimuovere 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, fai clic sull'elenco. Tutti i comandi slash specifici dell'istanza si applicano all'istanza di Looker predefinita.

Visualizzazione della scheda Home dell'app Looker in Slack

Per visualizzare un elenco delle cartelle e dei contenuti 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 di Slack, vedrai solo i contenuti di quell'istanza nella scheda Home dell'app Looker.

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

Se l'amministratore di Looker ha collegato una sola istanza Looker alla tua area di lavoro di Slack, l'istanza è quella predefinita.

Se l'amministratore di Looker ha collegato più istanze Looker alla tua area di lavoro di Slack, puoi impostare una delle istanze come istanza predefinita di Looker. Tutti i comandi a barra specifici dell'istanza (la maggior parte dei comandi oltre a /looker help) e l'espansione del link si applicano all'istanza predefinita.

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

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

    L'app Looker confermerà la selezione.

Per cambiare l'istanza di Looker predefinita, esegui di nuovo /looker select e seleziona un'istanza di Looker diversa. Devi passare a un'istanza predefinita se stai configurando i link da un'istanza di Looker che non è quella predefinita. Se non cambi istanza e tenti di annullare il collegamento di un'istanza Looker predefinita, ti verrà chiesto di accedere all'istanza Looker.