Pianificazione delle consegne nell'integrazione di Slack

Puoi installare l'app Looker nella tua area di lavoro Slack per inviare o pianificare la distribuzione dei dati direttamente su 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.

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

Abilitazione 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 all'area di lavoro di Slack indicata nel menu a discesa in alto a destra nella pagina. Per connettere più aree di lavoro Slack a una singola istanza di Looker, fai clic sul link + Connetti a spazio di lavoro Slack.

  4. Fai clic su Consenti e torna alla pagina dell'azione Slack.

  5. Fai clic sul pulsante di attivazione/disattivazione 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 di 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 disconnettere una connessione Slack Workspace esistente, fai clic sul pulsante Disconnetti e quindi 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 autenticarsi nella stessa area di lavoro di Slack collegata a Looker dall'amministratore di Looker. Gli utenti devono inoltre essere membri esistenti dello spazio di lavoro prima di poter eseguire l'autenticazione da Looker.

Puoi eseguire l'autenticazione in uno spazio 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 verrà visualizzata un'opzione che ti consentirà di revocare le credenziali Slack per qualsiasi area di lavoro a cui sei connesso. Attenzione: fai attenzione a non revocare il token Slack, altrimenti le pianificazioni create avranno esito negativo.

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 Slack dalla finestra Invia o Pianifica

  1. In Looker, vai ai contenuti da caricare, fai clic sul menu a forma di ingranaggio e fai clic 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 di Slack.

Trasferimento dei dati a Slack

Puoi distribuire contenuti in una delle varie aree di lavoro di 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 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 misura come valore visualizzato anziché l'etichetta del campo.
  • JSON - Etichetta: in questo formato, Looker utilizza le etichette dei campi come valore visualizzato nel suo 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, accedi ai tuoi contenuti ed esegui questi passaggi:

  1. Fai clic sul menu a forma di ingranaggio e poi su Invia o Pianifica. 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 consegna in Dove devono essere inviati questi dati? Per le dashboard, seleziona l'integrazione di Slack come destinazione di invio 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 importazione specifiche per lo spazio di lavoro o gli spazi di lavoro di Slack collegati 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 messaggi a canali pubblici o privati. Includi il carattere # iniziale, ad esempio #Vendite.
    • Nel campo Commento, inserisci il testo che vuoi includere con l'invio. 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 verranno consegnate a Slack come programmato. Se invii i dati, fai clic su Invia. I tuoi dati verranno inviati al tuo canale Slack.

Accedere a Looker da Slack

Per accedere ai dati di Looker da Slack, puoi:

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 sviluppa 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 i contenuti sul canale, tutti gli utenti del canale possono visualizzare l'istantanea e il titolo dei contenuti, anche se non hanno accesso ai contenuti sottostanti in Looker.
  • Aggiungere il contenuto 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 con un link per accedere alla cartella Preferiti in Looker.

Se all'area di lavoro sono collegate più istanze di Looker, 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 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 successiva eseguendo l'aggiornamento dal repository GitHub di Lookerbot come indicato nella sezione Introduzione a Lookebot della pagina delle best practice per utilizzare Lookerbot per Slack.

Utilizza i seguenti comandi con barra 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 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 su questo canale o Rimuovere 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 ogni contenuto per accedere a un menu in cui puoi pubblicare i contenuti su questo canale o rimuoverli 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 barra specifici dell'istanza verranno applicati all'istanza 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 connesso una sola istanza di Looker alla tua area di lavoro Slack, questa è l'istanza predefinita.

Se l'amministratore di Looker ha connesso più istanze di Looker all'area di lavoro di Slack, puoi impostarne una come istanza di Looker predefinita. All'istanza predefinita verranno applicati tutti i comandi slash specifici dell'istanza, la maggior parte oltre a /looker help, e lo sviluppo dei link.

  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 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 cambiare istanza predefinita se esegui l'unfurling dei link da un'istanza di Looker che non è 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 di Looker.