Pianificazione delle consegne all'integrazione di Slack

Puoi installare l'app Looker nell'area di lavoro di Slack per inviare o pianificare le consegne di 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.

Anche l'integrazione di Slack Attachment (API Token) è ancora disponibile per l'uso.

Abilitazione dell'integrazione nell'hub azioni di Looker.

Se la tua istanza di Looker soddisfa le condizioni richieste, prima che gli utenti possano distribuire i dati con l'integrazione di Slack, l'amministratore Looker deve attivare l'integrazione di Slack nell'hub azioni di Looker.

  1. Dal 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 a un'area di lavoro di Slack.

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

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

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

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

Gli amministratori possono eseguire le seguenti operazioni per ogni connessione dell'area di lavoro di Slack: Connect, Disconnetti e Reset.

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

  • Per disconnettere una connessione Slack dell'area di lavoro esistente, fai clic sul pulsante Disconnetti e fai clic su OK nel messaggio di avviso popup. Non è necessario 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 all'area di lavoro di Slack senza doverla disconnettere e ricollegare, 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. Gli utenti devono anche essere membri esistenti dell'area di lavoro prima di poter eseguire l'autenticazione da Looker.

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

Ricevi un messaggio Slack di conferma dopo aver eseguito 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 viene visualizzata in Integrazioni. Se l'amministratore Looker ha abilitato almeno un'area di lavoro di Slack, verrà visualizzato un pulsante Accedi 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. Quando torni alla pagina Account, nella sezione Integrazioni verrà visualizzata un'opzione che ti consentirà di revocare le credenziali di Slack per tutte le aree di lavoro a cui sei connesso. Attenzione: fai attenzione a non revocare il tuo token Slack, altrimenti potresti non riuscire a creare le pianificazioni che hai creato.

Ora che hai eseguito l'autenticazione, puoi inviare o pianificare dashboard, Look ed esplorazioni. Per ulteriori informazioni, consulta la sezione Invio di dati in 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. Per le dashboard, seleziona Pianifica consegna.
  2. Nella finestra Invia o Pianifica di un'esplorazione o di un look, seleziona l'azione Slack come destinazione di consegna in Dove devono essere inviati questi dati?. Per le dashboard, seleziona Pianifica consegna nella finestra Programma 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. La finestra Invia o Pianifica (o la finestra Pianifica consegna per le dashboard) ora mostra le opzioni di consegna di Slack, inclusi i canali pubblici e privati dell'area di lavoro di Slack.

Invio dei dati a Slack

Puoi pubblicare contenuti in una di più aree di lavoro di Slack. Dopo che un amministratore di Looker ha configurato le connessioni dell'area di lavoro, puoi accedere a ognuna dalla pagina Account dell'utente. Quindi, puoi selezionare un'area di lavoro di destinazione tra quelle elencate nel menu a discesa Aree di lavoro del popup Invia o Pianifica o Programma la finestra di consegna 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 come valore visualizzato anziché l'etichetta del campo.
  • JSON (etichetta): in questo formato Looker utilizza il campo labels 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 e non l'etichetta del campo.
  • JSON (dettagliato), 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.
  • Testo
  • HTML

Per offrire una dashboard definita dall'utente, una dashboard LookML, una visualizzazione dati o un'esplorazione, accedi 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. Per le dashboard, seleziona Pianifica consegna dal menu con tre puntini della dashboard.
  2. Nella finestra Invia o Pianifica, seleziona l'integrazione di Slack come destinazione di consegna nella sezione Dove devono essere inviati questi dati? Per le dashboard, seleziona l'integrazione Slack come destinazione di distribuzione in Destinazione. Se è la prima volta che utilizzi l'integrazione di Slack, devi prima autenticarti nell'area di lavoro di Slack.
  3. Looker visualizza le 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 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 con la pubblicazione. Puoi anche utilizzare la formattazione avanzata di Slack con analisi speciali per menzionare gruppi, utenti o canali specifici o per inserire altre menzioni speciali.
    • 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 inviate a Slack come programmato. Se invii 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:

Condivisione di link ai contenuti di Looker in Slack

Puoi condividere link a visualizzazioni SQL Runner, dashboard definite dall'utente, dashboard LookML, Looks (ma non look incorporati pubblicamente) o Esplorazioni in Slack.

Il link si apre in Slack per mostrare il titolo dei contenuti e alcuni dei relativi metadati, che sono visibili soltanto a chi ha accesso ai contenuti sottostanti. Dopo l'espansione del link, tu o gli altri utenti potete:

  • Per pubblicare un link ai contenuti in Looker e un'istantanea dei contenuti del canale, fai clic su Post to this Channel (Pubblica su questo canale). Dopo aver pubblicato i contenuti sul canale, chiunque si trovi 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 Favorites (Preferiti) di Looker: fai clic su Add to Favorites (Aggiungi ai preferiti). Dopo aver aggiunto i contenuti alla tua cartella Favorites (Preferiti), viene visualizzato un messaggio in Slack con un link per accedere alla cartella Favorites in Looker.

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

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

Se hai attivato 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 dal repository GitHub di Lookerbot come indicato nella sezione Getting started with Lookebot della pagina sulle best practice per l'utilizzo 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, indica l'istanza di Looker a cui sei connesso e fornisce link alla 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 dal quale puoi Pubblicare su questo 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 dal quale puoi Pubblicare su questo canale o Rimuovere dai Preferiti (se i contenuti si trovano anche nella tua cartella Preferiti).
  • /looker select: nell'app Looker in Slack sono elencate le istanze connesse 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 Looker predefinita per l'area di lavoro di Slack, vedrai solo i contenuti dell'istanza dalla 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 di Looker all'area di lavoro di Slack, questa è l'istanza predefinita.

Se l'amministratore di Looker ha collegato più istanze Looker all'area di lavoro di Slack, puoi impostare una delle istanze come istanza Looker predefinita. Tutti i comandi slash specifici dell'istanza, la maggior parte dei comandi oltre a /looker help, e la disabilitazione dei 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 spostare le istanze predefinite se stai distribuendo i link da un'istanza di Looker che non è quella predefinita. Se non cambi istanza e provi a annullare il collegamento di un'istanza Looker non predefinita, ti verrà chiesto di accedere a quell'istanza.