Impostazioni amministratore - Visualizzazioni

Looker include un elenco completo di tipi di visualizzazione integrati, che ti consentono di rappresentare i dati in vari modi. Se hai bisogno di un tipo di grafico non incluso nei tipi di visualizzazione integrati di Looker, Looker offre diversi modi per aggiungere visualizzazioni JavaScript personalizzate all'istanza di Looker:

  1. Aggiungi un parametro visualization al file manifest del progetto LookML per aggiungere visualizzazioni personalizzate direttamente al progetto LookML. Per saperne di più, consulta la pagina della documentazione del parametro visualization.
  2. Installa una visualizzazione da Looker Marketplace. Con la funzionalità Marketplace abilitata, puoi installare i pacchetti di visualizzazione di Looker Marketplace.
  3. Utilizza la pagina Visualizzazioni nella sezione Piattaforma del menu Amministrazione di Looker per installare e amministrare le visualizzazioni JavaScript personalizzate dal repository delle visualizzazioni personalizzate di Looker.

Questa pagina descrive come aggiungere visualizzazioni JavaScript personalizzate utilizzando la pagina Visualizzazioni nel pannello Amministrazione di Looker.

Visualizzare un elenco di visualizzazioni personalizzate

Per ottenere la funzionalità completa delle visualizzazioni scaricate, gli amministratori dei deployment ospitati dal cliente devono assicurarsi di installare la versione appropriata del renderer Chromium.

La pagina Visualizzazioni nella sezione Piattaforma del menu Amministrazione di Looker elenca tutte le visualizzazioni personalizzate che sono state aggiunte all'istanza di Looker.

L'elenco include le seguenti colonne:

Recuperare una visualizzazione personalizzata

Puoi ottenere visualizzazioni da personalizzare e aggiungere alla tua istanza di Looker da varie fonti, tra cui:

  • Looker gestisce una libreria di visualizzazioni personalizzate per uso pubblico in questa pagina GitHub di Looker. Puoi trovare le istruzioni per utilizzare l'API Visualization di Looker per creare i tuoi tipi di visualizzazione in questa pagina GitHub di Looker.
  • Il Looker Marketplace autonomo, in cui puoi cercare visualizzazioni, chiamate "plug-in", e accedere al relativo codice sorgente.
  • Looker Marketplace accessibile dalla tua istanza Looker. In questo Marketplace puoi sfogliare e installare le visualizzazioni direttamente nella tua istanza di Looker. Per ulteriori informazioni sull'installazione delle visualizzazioni da Looker Marketplace, consulta la pagina della documentazione Utilizzo di Looker Marketplace.

Aggiunta di una nuova visualizzazione personalizzata

Una volta individuata la visualizzazione da aggiungere all'istanza, puoi utilizzare la pagina Visualizzazioni nella sezione Piattaforma del menu Amministrazione di Looker per aggiungere una visualizzazione personalizzata selezionando il pulsante Aggiungi visualizzazione.

Looker visualizza la pagina Nuova visualizzazione. Per aggiungere una nuova visualizzazione, segui questi passaggi:

  1. Nel campo ID, inserisci l'ID univoco della visualizzazione definito nel codice JavaScript della visualizzazione.

  2. Nel campo Etichetta, inserisci il nome della visualizzazione. Looker visualizza questo nome nel menu di visualizzazione di Looker in un'esplorazione.

  3. Nel campo Principale, inserisci l'URI del file JavaScript principale della visualizzazione per indirizzare Looker al repository del codice JavaScript.

  4. Se il sito che ospita il codice di visualizzazione personalizzato utilizza un hash di integrità delle risorse secondarie (SRI) a scopo di verifica, inserisci l'hash SRI nel campo Hash SRI. Questo campo si trova in Opzioni avanzate. Gli host di visualizzazione personalizzata di Looker non utilizzano un hash SRI.

  5. Nel campo Dependencies (Dipendenze), inserisci gli URI di tutti gli altri file da cui dipende il JavaScript della visualizzazione e fai clic su Add (Aggiungi). Puoi inserire più URI separati da virgole oppure aggiungerli uno alla volta. Il campo Dipendenze si trova in Opzioni avanzate.

  6. Seleziona Salva.

Una volta aggiunta la visualizzazione, la vedrai con l'etichetta che le hai assegnato nel menu delle visualizzazioni di un'esplorazione. Puoi utilizzare il nuovo tipo di visualizzazione come qualsiasi altro tipo di visualizzazione esistente di Looker.

Per visualizzare le visualizzazioni personalizzate dal menu delle visualizzazioni:

  1. Seleziona l'icona con tre puntini ... dalla barra dei menu della visualizzazione per accedere alla visualizzazione personalizzata.

  2. Una volta selezionata la visualizzazione, il relativo nome viene visualizzato nella barra dei menu.

Modificare una visualizzazione personalizzata

Per modificare una visualizzazione esistente, seleziona il pulsante Modifica a destra della visualizzazione. Looker mostra la stessa pagina che utilizzi per aggiungere una visualizzazione (descritta in Aggiunta di una nuova visualizzazione personalizzata), ma con le informazioni pertinenti già compilate. Apporta le modifiche che preferisci, quindi fai clic su Salva.

Eliminare una visualizzazione personalizzata

Per eliminare una visualizzazione, seleziona il pulsante Elimina a destra della visualizzazione nella pagina Visualizzazioni della sezione Piattaforma del menu Amministrazione di Looker, quindi fai clic su Ok nella casella di conferma.

L'eliminazione di una visualizzazione la rimuove da Looker, ma non influisce su nulla nel repository di codice esterno della visualizzazione.

L'eliminazione di una visualizzazione disattiva tutti i Look o le dashboard che utilizzano quel tipo di visualizzazione. Puoi correggere questo problema aggiungendo nuovamente la visualizzazione eliminata con lo stesso ID visualizzazione.

Risoluzione dei problemi

Le visualizzazioni personalizzate sono un impegno supportato dalla community. Il team di assistenza di Looker non risolve i problemi relativi alle visualizzazioni personalizzate o al codice delle visualizzazioni personalizzate. Per il monitoraggio e la chiusura dei bug, utilizza i problemi di GitHub nel repository della visualizzazione personalizzata oppure visita la community di Looker per trovare post con istruzioni, conversazioni e suggerimenti sulle visualizzazioni personalizzate.

Visualizzazioni personalizzate vuote nelle esportazioni in formato PDF o PNG

Le visualizzazioni personalizzate nei download in formato PDF o PNG vengono visualizzate come vuote nelle istanze di connessioni private di Looker (Google Cloud core) che non dispongono dell'accesso a internet in uscita. Questo problema si verifica perché il renderer Chromium non può recuperare le dipendenze JavaScript esterne (come D3 o jQuery) ospitate su reti di distribuzione dei contenuti (CDN) pubbliche quando l'accesso in uscita è limitato.

Per risolvere il problema, utilizza una delle seguenti soluzioni alternative:

  • Raggruppa le dipendenze nel tuo progetto LookML:
    1. Scarica il file .js della dipendenza esterna richiesta.
    2. Copia e incolla il codice della dipendenza non elaborato nella parte superiore del file .js della visualizzazione personalizzata.
    3. Salva il file .js in bundle nel progetto LookML.
    4. Aggiorna il file manifest.lkml in modo che rimandi al file locale utilizzando il parametro file anziché gli URL esterni in dependencies o url.
    5. Esegui il deployment delle modifiche nell'ambiente di produzione in modo che Looker gestisca le dipendenze localmente.
  • Configura le connessioni in uscita per Private Service Connect: Per le istanze che utilizzano Private Service Connect, configura le connessioni in uscita (in direzione sud) per consentire all'istanza di raggiungere servizi esterni e CDN pubbliche.

Per saperne di più sulla risoluzione dei problemi relativi al renderer, consulta Risoluzione dei problemi relativi al renderer Chromium.