visualizzazione

Utilizzo

visualization: {
id: "unique-id"
label: "Etichetta di visualizzazione"
url: "visualization_url"
sri_hash: "hash SRI"
dependencies
"

"
"
Gerarchia
visualization
Valore predefinito
Nessuna

Regole speciali
visualization deve avere un parametro url o file, ma non entrambi

Definizione

Il parametro visualization aggiunge una visualizzazione personalizzata al progetto LookML a cui gli utenti possono accedere dalla scheda Visualizzazione nelle esplorazioni del progetto. La visualizzazione personalizzata deve essere definita in un file JavaScript, che può essere incluso nei file di progetto LookML, oppure ospitato altrove.

Il parametro visualization ha i seguenti sottoparametri:

Parametro Descrizione
id Specifica un identificatore univoco per la visualizzazione, che viene visualizzata nella pagina Views (Visualizzazioni) del menu Admin (Amministrazione) di Looker.
label Fornisce l'etichetta per la visualizzazione che viene visualizzata nella scheda Visualizzazione delle esplorazioni del progetto e nella pagina Visualizzazioni del menu Amministratore di Looker.
url Il parametro url fornisce l'URL al file JavaScript della visualizzazione, se il file è archiviato su un server esterno all'istanza di Looker. Invece di utilizzare il parametro url, puoi trascinare il file nell'IDE di Looker, quindi utilizzare il parametro file per indirizzarlo al file.

NOTA: l'applicazione deve avere un parametro url o file, ma non entrambi.
sri_hash L'hash SRI viene utilizzato solo quando il file JavaScript della visualizzazione viene specificato con il parametro url. Se il sito che ospita il codice di visualizzazione personalizzato utilizza un hash dell'integrità delle risorse (SRI) per la verifica, inserisci l'hash SRI nel campo sri_hash.
dependencies Fornisce un elenco separato da virgole di URL di dipendenza necessari per caricare la visualizzazione.
file Specifica il percorso di un file JavaScript (con estensione .js) che definisce la visualizzazione. Il percorso è relativo alla radice del progetto. L'esempio nella colonna successiva rimanda al file calendar-heatmap.js nella directory visualizations del progetto LookML.

NOTA: l'applicazione deve avere un parametro url o un parametro file, ma non entrambi.

Esempio: aggiungere un URL di visualizzazione personalizzato al tuo progetto LookML

Un'opzione per aggiungere una visualizzazione personalizzata al progetto LookML è l'utilizzo dell'URL di un file di visualizzazione personalizzato. Ad esempio, l'aggiunta di questo LookML al file manifest di un progetto aggiunge una visualizzazione personalizzata CDN a più valori al progetto Looker. Questa visualizzazione è definita in un file JavaScript che si trova nel Marketplace di Looker:

visualization: {
  id: "spider-marketplace-dev"
  label: "Spider Viz"
  url: "https://marketplace-api.looker.com/viz-dist/spider.js"
  sri_hash: "oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC"
  dependencies: ["https://code.jquery.com/jquery-2.2.4.min.js","https://cdnjs.cloudflare.com/ajax/libs/underscore.js/1.9.1/underscore-min.js","https://cdnjs.cloudflare.com/ajax/libs/d3/3.5.6/d3.min.js","https://cdnjs.cloudflare.com/ajax/libs/d3-legend/1.13.0/d3-legend.min.js"]
}

Una volta eseguite il commit delle modifiche e il deployment in produzione, la visualizzazione personalizzata verrà visualizzata come opzione nella scheda Visualizzazione delle esplorazioni del progetto:

La visualizzazione verrà elencata anche nella pagina Visualizzazioni della sezione Piattaforma del menu Amministratore di Looker. Per informazioni, consulta la pagina della documentazione Impostazioni amministratore - Visualizzazioni.

Esempio: aggiungere un file di visualizzazione personalizzato al tuo progetto LookML

Un'altra opzione è aggiungere il file JavaScript di visualizzazione personalizzata al progetto LookML utilizzando l'IDE di Looker:

  1. Nell'IDE di Looker, trascina e rilascia il file JavaScript che definisce la visualizzazione personalizzata nel tuo progetto LookML.
  2. Facoltativamente, sposta il file di visualizzazione in una cartella nell'IDE di Looker o crea una nuova cartella per il file di visualizzazione.
  3. Fai clic sul file di visualizzazione nel riquadro del browser per visualizzare i contenuti, quindi fai clic su Salva per salvare il file.
  4. Nel file manifest del progetto, definisci i parametri di visualizzazione. Ad esempio, questo LookML aggiunge una visualizzazione personalizzata con indicatore radiale al progetto Looker. La visualizzazione viene definita in un file JavaScript situato nella directory visualizations del progetto LookML:
  visualization: {
  id: "radial_gauge"
  label: "Radial Gauge"
  file: "visualizations/radialgauge_v2.js"
   }
  1. Esegui il commit delle modifiche ed esegui il deployment in produzione.

    Devi eseguire il deployment degli aggiornamenti della visualizzazione per vedere l'opzione di visualizzazione del cliente in Esplora (non è sufficiente salvare gli aggiornamenti anche in modalità di sviluppo).

Dopo aver implementato gli aggiornamenti, la visualizzazione personalizzata viene visualizzata come opzione nella scheda Visualizzazione delle esplorazioni del progetto:

La visualizzazione è anche indicata nella pagina Visualizzazioni della sezione Piattaforma del menu Amministratore di Looker. Per informazioni, consulta la pagina della documentazione Impostazioni amministratore - Visualizzazioni.