Pianificazione delle consegne nell'integrazione di Slack

Puoi installare l'app Looker nella tua area di lavoro di Slack per inviare o pianificare l'invio 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 regolare le impostazioni di installazione dell'app per l'area di lavoro di Slack.

È ancora possibile utilizzare anche l'integrazione di Slack Attachment (API Token).

Attivazione dell'integrazione in Looker Action Hub

Se la tua istanza di Looker soddisfa le condizioni richieste, prima che gli utenti possano inviare i dati con l'integrazione di Slack, l'amministratore di Looker deve abilitare l'integrazione di Slack nell'hub azioni Looker per ciascuna istanza 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 alla tua area di lavoro Slack.

    Looker richiederà l'accesso allo spazio di lavoro di Slack indicato nel menu a discesa in alto a destra nella pagina. Per collegare 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 dell'azione Slack.

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

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

Puoi gestire le connessioni delle aree di lavoro Slack dell'istanza dalla pagina dell'azione 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 collegamento dello spazio di lavoro di Slack: Connetti, Disconnetti e Reimposta.

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

  • Per scollegare una connessione allo spazio di lavoro di Slack esistente, fai clic sul pulsante Disconnetti e poi su OK nel messaggio di avviso popup. Non è necessario fare clic su Salva nella pagina dell'azione Slack per salvare queste impostazioni e l'azione continuerà a essere visualizzata come Attivata anche se non è collegato alcun spazio di lavoro Slack.

  • Per aggiornare la connessione dell'area di lavoro Slack senza doverla disconnettere e ricollegarla, 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 collegato a Looker. Gli utenti devono anche essere membri esistenti dell'area di lavoro prima di poter eseguire l'autenticazione da Looker.

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

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

Autenticazione in uno spazio di lavoro Slack dalla pagina Account

  1. In Looker, fai clic sull'icona del profilo utente in alto a destra dello schermo e seleziona Account.
  2. Le eventuali integrazioni abilitate per la tua istanza vengono visualizzate in Integrazioni. Se l'amministratore di Looker ha attivato almeno un'area di lavoro Slack, sarà presente un pulsante 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 opzioni per accedere a ciascuna area di lavoro 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 eseguito il collegamento. Attenzione: fai attenzione a non revocare il token di Slack, altrimenti tutte 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 saperne di più, consulta la sezione Caricare i dati in Slack in questa pagina.

Autenticazione in un'area di lavoro 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 Pianifica. Per le dashboard, seleziona Pianifica invio.
  2. Nella finestra Invia o Pianifica di un'esplorazione o di un Look, seleziona l'azione Slack come destinazione di invio 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. La finestra Invia o Pianifica (o la finestra Pianifica invio per le dashboard) ora mostra le opzioni di invio di Slack, inclusi i canali pubblici e privati della tua area di lavoro Slack.

Trasferimento dei dati a Slack

Puoi pubblicare contenuti in uno dei vari spazi di lavoro Slack. Dopo che un amministratore di Looker ha configurato le connessioni all'area di lavoro, puoi accedere a ciascuna di esse dalla 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 Pianificare la finestra di invio per le dashboard.

Le opzioni di formattazione per la pubblicazione di una dashboard sono le seguenti:

  • PDF
  • Visualizzazione (PNG)
  • File ZIP CSV

Per l'invio o la pianificazione di una visualizzazione dati o di 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 misura come valore visualizzato anziché la etichetta del campo.
  • JSON - Etichetta: in questo formato, Looker utilizza il campo etichette come valore visualizzato nell'output JSON.
  • JSON: semplice, in linea: in questo formato, Looker utilizza come valore visualizzato il nome del campo di una dimensione o misura anziché l'etichetta del campo.
  • JSON - Dettagliato, in linea: in questo formato, Looker utilizza il nome del campo di una dimensione o misura come valore visualizzato anziché l'etichetta del campo.
  • Testo
  • HTML

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. Per le dashboard, seleziona Pianifica invio dal menu con tre puntini della dashboard.
  2. Nella finestra Invia o Pianifica, seleziona l'integrazione di Slack come destinazione di invio in 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 dell'area di lavoro di Slack o delle 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 #Vendite.
    • Nel campo Commento, inserisci qualsiasi testo che vuoi includere nel caricamento. Puoi anche utilizzare la formattazione avanzata di Slack con analisi speciale per menzionare gruppi, utenti o canali specifici o per fare altre menzioni speciali.
    • Nel campo Nome file, inserisci un nome per il file allegato.
  4. Se stai pianificando un invio di dati, fai clic su Salva tutto. La query o la dashboard verrà inviata a Slack come pianificato. Se invii i dati, fai clic su Invia. I dati verranno inviati al tuo canale Slack.

Accedere a Looker da Slack

Per accedere ai dati di Looker da Slack:

Puoi condividere link a visualizzazioni di SQL Runner, dashboard definite dall'utente, dashboard di 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 chi ha accesso ai contenuti sottostanti. Una volta lanciato il link, tu o gli altri utenti potrete:

  • Pubblica un link ai contenuti in Looker e un'istantanea dei contenuti sul canale: fai clic su Pubblica su questo canale. Una volta pubblicati sul canale, chiunque ne faccia parte può visualizzare lo snapshot e il titolo dei contenuti, anche se non ha accesso ai contenuti sottostanti in Looker.
  • Aggiungi i contenuti a una cartella Preferiti di Looker: fai clic su 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 di Looker collegate allo spazio di lavoro, devi impostare l'istanza predefinita in modo che corrisponda all'istanza di Looker da cui stai condividendo il link.

Utilizzare i comandi slash per recuperare le informazioni di Looker in Slack

Se hai abilitato anche Lookerbot, potrebbe essere necessario rinominare alcuni comandi slash. I comandi di Slack personalizzati non sono disponibili per l'integrazione di Slack, ma è possibile configurarne uno in Lookerbot. Assicurati di utilizzare Lookerbot versione 0.0.16 o successive aggiornandolo dal repository GitHub di Lookerbot come indicato nella sezione Introduzione a Lookerbot della pagina Best practice per l'utilizzo di Lookerbot per Slack.

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

  • /looker e /looker whoami: l'app Looker in Slack ti saluta per nome, ti indica l'istanza di Looker a cui sei connesso e fornisce i 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 di 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 in cui puoi pubblicare i contenuti su questo canale o rimuoverli dai preferiti.
  • /looker folder: l'app di Looker in Slack elenca i contenuti della tua cartella personale di Looker. Fai clic sui puntini di sospensione (...) accanto a ciascun contenuto per accedere a un menu da cui è possibile 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 l'istanza o le istanze connesse a quella determinata area di lavoro di Slack. Per impostare un'istanza predefinita per la tua area di lavoro Slack, fai clic su questa istanza nell'elenco. Tutti i comandi slash specifici dell'istanza vengono applicati all'istanza di Looker predefinita.

Visualizzazione della scheda Home dell'app di Looker in Slack

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

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

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

Se l'amministratore di Looker ha collegato più istanze di Looker alla tua area di lavoro di Slack, puoi impostare una delle istanze come predefinita. Tutti i comandi slash specifici dell'istanza, ovvero la maggior parte dei comandi oltre a /looker help, e l'espansione dei link verranno 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 selezione.

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