Dopo aver creato un incorporamento, che può essere fatto pubblicamente e privatamente, con l'incorporamento firmato o tramite l'API, puoi interagire con questi iframe utilizzando JavaScript. Puoi rendere la tua pagina più dinamica in base allo stato dell'elemento incorporato e puoi persino apportare modifiche all'elemento incorporato dalla tua pagina web.
Tieni presente che Looker non controlla l'ordine in cui i browser inviano gli eventi alle applicazioni web. Ciò significa che l'ordine degli eventi non è garantito per tutti i browser o le piattaforme. Assicurati di scrivere il codice JavaScript in modo appropriato per tenere conto della gestione degli eventi di diversi browser.
Puoi utilizzare JavaScript in uno dei seguenti modi per i contenuti incorporati di Looker:
- Utilizzo del Software Development Kit (SDK) incorporato di Looker, descritto nella pagina della documentazione Embed SDK (Incorpora SDK)
- Utilizzare gli eventi JavaScript, descritti nella sezione Accesso agli eventi in JavaScript in questa pagina.
preparazione
Prima di poter interagire con l'iframe incorporato, segui questi passaggi:
- Aggiungi un ID all'iframe.
- Aggiungi il dominio incorporato all'attributo
src
dell'iframe. - Aggiungi il dominio incorporato alla lista consentita.
Aggiunta di un ID all'iframe
In seguito, quando recuperi i dati dall'iframe, dovrai verificare che le informazioni con cui stai lavorando provengano effettivamente dall'iframe di Looker. Per facilitare questa operazione, assicurati di aggiungere un ID all'iframe, se non l'hai già fatto. Nel seguente esempio, imposti l'ID su looker
aggiungendo id="looker"
all'iframe:
<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>
Aggiunta del dominio incorporato all'attributo iframe src
Nell'attributo src
dell'iframe, includi il dominio in cui viene utilizzato l'iframe. Nell'esempio seguente, puoi specificare myownpersonaldomain.com
come dominio aggiungendo ?embed_domain=https://myownpersonaldomain.com"
alla fine dell'URL nell'attributo src
:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com">
</iframe>
Se stai utilizzando l'incorporamento firmato, assicurati di aggiungere embed_domain
all'URL incorporato.
Se utilizzi l'SDK per l'incorporamento, aggiungi sdk=2
alla fine dell'URL incorporato. Il parametro sdk=2
indica che l'SDK è presente e che Looker può sfruttare le funzionalità aggiuntive fornite dall'SDK, come il passaggio di eventi JavaScript tra l'iframe di Looker e il tuo dominio. L'SDK non può aggiungere questo parametro autonomamente perché fa parte dell'URL firmato. Ad esempio:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com&sdk=2">
</iframe>
Aggiunta del dominio incorporato alla lista consentita
Infine, dovrai aggiungere il dominio in cui viene utilizzato l'iframe alla lista consentita della pagina Incorpora del pannello di amministrazione di Looker seguendo questi passaggi:
Nel campo Embedded Domain List (Lista consentita di domini incorporati) inserisci il dominio in cui viene utilizzato l'iframe, quindi premi il tasto Tab in modo che il dominio venga visualizzato in una casella all'interno del campo.
Fai clic su Update (Aggiorna).
Puoi utilizzare il carattere jolly *
nella lista consentita per creare un pattern di dominio. Ad esempio, https://*.myownpersonaldomain.com
consentirebbe sia https://analytics.myownpersonaldomain.com
sia https://data.myownpersonaldomain.com
.
Se utilizzi l'incorporamento senza cookie con Looker 23.8 o versioni successive, il dominio di incorporamento può essere specificato al momento dell'acquisizione della sessione senza cookie. Si tratta di un'alternativa all'aggiunta del dominio incorporato alla lista consentita utilizzando il riquadro Amministratore > Incorpora. Leggi le best practice per la sicurezza se decidi di usufruire di questa funzionalità.
Recupero dei dati dall'iframe
Dopo aver completato i passaggi di preparazione, puoi accedere agli eventi trasmessi tra l'iframe di Looker e il tuo dominio ascoltando gli eventi postMessage
.
L'iframe incorporato può creare alcuni tipi di eventi, come descritto nella sezione Informazioni sui tipi di evento di questa pagina.
Accesso agli eventi in JavaScript
Ecco un esempio di ascolto di questi eventi in JavaScript nativo e di logging nella console:
window.addEventListener("message", function(event) {
if (event.source === document.getElementById("looker").contentWindow) {
if (event.origin === "https://instance_name.looker.com") {
console.log(JSON.parse(event.data));
}
}
});
Ecco un esempio di come ascoltare questi eventi in jQuery e di registrarli nella console:
$(window).on("message", function(event) {
if (event.originalEvent.source === $("#looker")[0].contentWindow) {
if (event.origin === "https://instance_name.looker.com") {
console.log(JSON.parse(event.data));
}
}
});
Tabella di riepilogo dei tipi di evento
La tabella seguente riassume i tipi di eventi. Seleziona un tipo di evento per visualizzarne i dettagli.
Tipo di evento | Causa dell'evento |
---|---|
dashboard:loaded |
Sulle dashboard in cui i riquadri non sono impostati per l'esecuzione automatica, una dashboard e i relativi elementi sono stati caricati, ma le query non sono ancora in esecuzione. |
dashboard:run:start |
È iniziato il caricamento di una dashboard e i relativi riquadri hanno iniziato a caricare ed eseguire query sui dati. |
dashboard:run:complete |
L'esecuzione di una dashboard è terminata e tutti i riquadri hanno terminato il caricamento e l'esecuzione di query. |
dashboard:download |
È iniziato il download di un PDF di una dashboard. |
dashboard:edit:start |
AGGIUNTO il 22/02/2020
Una dashboard è passata alla modalità di modifica. L'evento dashboard:save:complete verrà attivato dopo il salvataggio della dashboard. |
dashboard:edit:cancel |
AGGIUNTO il 22/20/2020 Una dashboard in modalità di modifica è stata chiusa dalla modalità di modifica senza salvare. |
dashboard:save:complete |
Una dashboard è stata modificata e salvata. |
dashboard:delete:complete |
È stata eliminata una dashboard. |
dashboard:tile:start |
Un riquadro ha iniziato a caricare o eseguire query sui dati. |
dashboard:tile:complete |
Un riquadro ha terminato l'esecuzione della query. |
dashboard:tile:download |
È iniziato il download dei dati di un riquadro. |
dashboard:tile:explore |
Un utente ha fatto clic sull'opzione Esplora da qui in un riquadro della dashboard. |
dashboard:tile:view |
Un utente ha fatto clic sull'opzione Visualizza Look originale in un riquadro della dashboard. |
dashboard:filters:changed |
I filtri di una dashboard sono stati applicati o modificati. |
look:ready |
Un Look ha iniziato a caricare i dati delle query, indipendentemente dal fatto che la query venga eseguita o meno. |
look:run:start |
Un Look ha iniziato a caricare i dati della query e la query è stata eseguita. |
look:run:complete |
Un Look ha terminato l'esecuzione della query. |
look:save:complete |
È stato modificato e salvato un Look. |
look:delete:complete |
Un Look è stato spostato nella cartella Cestino. |
drillmenu:click |
Un utente ha fatto clic su un menu drill in una dashboard creata con il parametro LookML link . |
drillmodal:download |
Un utente ha aperto una finestra di dialogo di analisi dettagliata da un riquadro della dashboard e ha fatto clic sull'opzione Scarica. |
drillmodal:explore |
Un utente ha fatto clic sull'opzione Esplora da qui in una finestra di dialogo in dettaglio. |
explore:ready |
Un'esplorazione ha iniziato a caricare i dati delle query, indipendentemente dal fatto che la query venga eseguita o meno. |
explore:run:start |
Un'esplorazione ha iniziato a caricare i dati delle query, che a sua volta è stata eseguita. |
explore:run:complete |
L'esecuzione della query è terminata per un'esplorazione. |
explore:state:changed |
L'URL di una pagina Esplora è cambiato a seguito delle azioni dell'utente. |
page:changed |
Un utente è arrivato a una nuova pagina all'interno dell'iframe. |
page:properties:changed |
L'altezza di un iframe della dashboard è cambiata. |
session:tokens |
Il client Looker richiede i token per continuare. |
session:status |
Invia informazioni sullo stato di una sessione. |
env:client:dialog |
È stata aperta una finestra di dialogo che potrebbe essere parzialmente fuori dall'area visibile, come una finestra di dialogo in dettaglio. Questo evento consente all'applicazione di hosting di far scorrere la finestra di dialogo per visualizzarla. |
Riferimento al tipo di evento
L'iframe incorporato può creare molti tipi diversi di eventi:
dashboard:loaded
Nelle dashboard in cui i riquadri non sono impostati per l'esecuzione automatica, questo evento viene creato dopo il caricamento di una dashboard e dei relativi elementi, ma prima dell'esecuzione delle query.
type: "dashboard:loaded",
status: "complete",
dashboard: {
id: 1,
title: "Business Pulse",
canEdit: true,
dashboard_filters: {
"date": "Last 6 Years",
"state": ""
},
absoluteUrl: "https://self-signed.looker.com:9999/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
url: "/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attributo | Formato | Descrizione |
---|---|---|
status |
Stringa | Indica se la dashboard e i suoi elementi sono stati caricati correttamente. |
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.options |
Oggetto | Le proprietà e i valori del layout della dashboard, del componente del layout della dashboard e degli elementi della dashboard. È possibile assegnare valori aggiornati a tutte le proprietà restituite nell'oggetto options utilizzando l'evento dashboard:options:set . |
dashboard:run:start
Questo evento viene creato all'inizio del caricamento di una dashboard e del caricamento dei relativi riquadri e dell'esecuzione di query sui dati.
type: "dashboard:run:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:run:complete
Questo evento viene creato al termine dell'esecuzione di una dashboard e al termine del caricamento e dell'esecuzione di query per tutti i riquadri. Questo evento viene creato indipendentemente dal fatto che tutti i riquadri vengano caricati correttamente o meno.
type: "dashboard:run:complete",
status: "complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://my.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attributo | Formato | Descrizione |
---|---|---|
status |
Stringa | Indica se la dashboard e i suoi elementi sono stati eseguiti correttamente. Se la dashboard e i suoi elementi sono stati eseguiti correttamente, status restituisce "complete" ; in caso contrario, status restituisce "error" . Se la dashboard in esecuzione è stata interrotta, dall'interfaccia utente o con l'azione dashboard:stop , status restituirà "stopped" . |
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
Oggetto | Le proprietà e i valori del layout della dashboard, del componente del layout della dashboard e degli elementi della dashboard. È possibile assegnare valori aggiornati a tutte le proprietà restituite nell'oggetto options utilizzando l'azione dashboard:options:set . |
dashboard.tileStatuses |
Array di oggetti | Un array di oggetti che forniscono gli stati dei riquadri. Le proprietà degli oggetti sono:
|
dashboard:download
Questo evento viene creato quando inizia il download di un PDF di una dashboard.
type: "dashboard:download",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
fileFormat: "pdf"
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
fileFormat |
Stringa | Il formato della dashboard scaricata (al momento solo "pdf" ). |
dashboard:edit:start
AGGIUNTO il 22/20/2020 Questo evento viene creato quando una dashboard viene passata alla modalità di modifica.
type: "dashboard:edit:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:edit:cancel
AGGIUNTO il 22/22/2020 Questo evento viene creato quando una dashboard in modalità di modifica viene chiusa dalla modalità di modifica senza salvare.
type: "dashboard:edit:cancel",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:save:complete
Questo evento viene creato quando una dashboard viene modificata e poi salvata.
type: "dashboard:save:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
url: "/embed/dashboards/...",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.options |
Oggetto | Le proprietà e i valori del layout della dashboard, del componente del layout della dashboard e degli elementi della dashboard. È possibile assegnare valori aggiornati a tutte le proprietà restituite nell'oggetto options utilizzando l'evento dashboard:options:set . |
dashboard:delete:complete
Questo evento viene creato quando viene eliminata una dashboard.
type: "dashboard:delete:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
url: "/embed/dashboards/...",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.options |
Oggetto | Le proprietà e i valori del layout della dashboard, del componente del layout della dashboard e degli elementi della dashboard. È possibile assegnare valori aggiornati a tutte le proprietà restituite nell'oggetto options utilizzando l'evento dashboard:options:set . |
dashboard:tile:start
Questo evento viene creato quando un riquadro inizia il caricamento o l'esecuzione di query sui dati.
type: "dashboard:tile:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard a cui appartiene il riquadro. |
dashboard.title |
Stringa | Il titolo della dashboard, come mostrato nella parte superiore della dashboard a cui appartiene il riquadro. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso) a cui appartiene il riquadro. |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard a cui appartiene il riquadro. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard a cui appartiene il riquadro. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Numero intero | Il numero ID dell'evento, non del riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore del riquadro. |
tile.listen |
Oggetto | I filtri della dashboard globali sono in ascolto di questo riquadro. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...} |
dashboard:tile:complete
Questo evento viene creato quando un riquadro ha terminato l'esecuzione della query.
type: "dashboard:tile:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
status: "complete",
truncated: false,
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard a cui appartiene il riquadro. |
dashboard.title |
Stringa | Il titolo della dashboard, come mostrato nella parte superiore della dashboard a cui appartiene il riquadro. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso) a cui appartiene il riquadro. |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard a cui appartiene il riquadro. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard a cui appartiene il riquadro. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
status |
Stringa | Se la query del riquadro è stata completata correttamente. I valori possibili sono "complete" o "error" . |
truncated |
Booleano | Indica se i risultati della query del riquadro sono stati troncati in seguito alla restituzione di un numero di righe maggiore rispetto al limite di righe della query. Il limite di righe potrebbe essere un limite di righe specificato dall'utente o il limite di righe predefinito di Looker di 5000. |
tile.id |
Numero intero | Il numero ID dell'evento, non del riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore del riquadro. |
tile.listen |
Oggetto | I filtri della dashboard globali sono in ascolto di questo riquadro. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...} |
tile.errors |
Array di oggetti | Il campo viene compilato quando la proprietà status è "error" . Un array di oggetti che fornisce i dettagli dell'errore, inclusi il testo del messaggio, una descrizione più dettagliata dell'errore e la query SQL del riquadro che ha generato l'errore. |
dashboard:tile:download
Questo evento viene creato quando inizia il download dei dati di un riquadro.
type: "dashboard:tile:download",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales"
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
fileFormat: "pdf"
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard a cui appartiene il riquadro. |
dashboard.title |
Stringa | Il titolo della dashboard, come mostrato nella parte superiore della dashboard a cui appartiene il riquadro. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso) a cui appartiene il riquadro. |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard a cui appartiene il riquadro. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard a cui appartiene il riquadro. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Numero intero | Il numero ID dell'evento, non del riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore del riquadro. |
tile.listen |
Oggetto | I filtri della dashboard globali sono in ascolto di questo riquadro. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...} |
fileFormat |
Stringa | Il formato del riquadro scaricato (al momento solo "pdf" ). |
dashboard:tile:explore
Questo evento viene creato quando un utente fa clic sull'opzione Esplora da qui in un riquadro della dashboard.
type: "dashboard:tile:explore",
label: 'Explore From Here',
url: '/embed/explore/model/view...',
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Attributo | Formato | Descrizione |
---|---|---|
label |
Stringa | L'etichetta del pulsante. |
url |
Stringa | L'URL relativo (solo il percorso) dell'esplorazione da visualizzare. |
dashboard.id |
Numero/stringa | L'ID della dashboard a cui appartiene il riquadro. |
dashboard.title |
Stringa | Il titolo della dashboard, come mostrato nella parte superiore della dashboard a cui appartiene il riquadro. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso) a cui appartiene il riquadro. |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard a cui appartiene il riquadro. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard a cui appartiene il riquadro. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Numero intero | Il numero ID dell'evento, non del riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore del riquadro. |
tile.listen |
Oggetto | I filtri della dashboard globali sono in ascolto di questo riquadro. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...} |
dashboard:tile:view
Questo evento viene creato quando un utente fa clic sull'opzione Visualizza Look originale in un riquadro della dashboard.
type: "dashboard:tile:view",
label: 'View Original Look',
url: '/embed/look/...',
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Attributo | Formato | Descrizione |
---|---|---|
label |
Stringa | L'etichetta del pulsante. |
url |
Stringa | L'URL relativo (solo il percorso) del Look da visualizzare. |
dashboard.id |
Numero/stringa | L'ID della dashboard a cui appartiene il riquadro. |
dashboard.title |
Stringa | Il titolo della dashboard, come mostrato nella parte superiore della dashboard a cui appartiene il riquadro. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso) a cui appartiene il riquadro. |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard a cui appartiene il riquadro. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard a cui appartiene il riquadro. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Numero intero | Il numero ID dell'evento, non del riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore del riquadro. |
tile.listen |
Oggetto | I filtri della dashboard globali sono in ascolto di questo riquadro. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...} |
dashboard:filters:changed
Questo evento viene creato quando i filtri di una dashboard sono stati applicati o modificati.
type: "dashboard:filters:changed",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard. |
dashboard.title |
Stringa | Il titolo, come mostrato nella parte superiore della dashboard. |
dashboard.canEdit |
Booleano |
AGGIUNTO il 22/02/2020
Quando true , l'utente può modificare la dashboard. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso). |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
Oggetto | Le proprietà e i valori del layout della dashboard, del componente del layout della dashboard e degli elementi della dashboard. È possibile assegnare valori aggiornati a tutte le proprietà restituite nell'oggetto options utilizzando l'evento dashboard:options:set . |
look:ready
Questo evento viene creato quando un Look inizia a caricare i dati delle query, indipendentemente dal fatto che la query venga eseguita o meno.
type: "look:ready",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
look.url |
Stringa | L'URL del Look relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL del Look completo |
look:run:start
Questo evento viene creato quando un Look inizia a caricare i dati della query e l'esecuzione della query.
type: "look:run:start",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
look.url |
Stringa | L'URL del Look relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL del Look completo |
look:run:complete
Questo evento viene creato quando un Look ha terminato l'esecuzione della query.
type: look:run:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
look.url |
Stringa | L'URL del Look relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL del Look completo |
look:save:complete
Questo evento viene creato quando viene modificato e salvato un Look. Questo evento viene creato quando un utente esegue una delle seguenti attività:
- Fai clic sul pulsante Modifica per modificare il Look, poi fai clic su Salva.
- Salva un Look con l'opzione di menu Salva > Salva con nome...
- Sposta un Look da una cartella a un'altra
Questo evento non viene creato se il Look viene salvato con l'opzione di menu Salva > Nella dashboard esistente o Modifica impostazioni.
type: look:save:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
spaceId: 123
}
}
Attributo | Formato | Descrizione |
---|---|---|
look.url |
Stringa | L'URL del Look relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL del Look completo |
look.spaceID |
Numero intero | L'ID cartella in cui è archiviato il Look |
look:delete:complete
Questo evento viene creato quando un Look viene spostato nella cartella Cestino.
type: look:delete:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
look.url |
Stringa | L'URL del Look relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL del Look completo |
drillmenu:click
Questo evento viene creato quando un utente fa clic su un menu drill in una dashboard creata con il parametro LookML link
. Ad esempio, il seguente LookML crea un menu dettagliato in cui un utente può visualizzare i dati filtrati in base alla dimensione state
:
dimension: state {
type: string
sql: ${TABLE}.state ;;
link: {
label: "Filter by {{ state | encode_uri }}"
url: "filter::q={{ state | encode_uri }}"
icon_url: "https://google.com/favicon.ico"
}
}
Quando il filtro state
è impostato su Illinois
, l'evento drillmenu:click
restituisce quanto segue all'host dell'iframe:
type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
Attributo | Formato | Descrizione |
---|---|---|
label |
Stringa | L'etichetta del link come mostrata nel menu a discesa |
link_type |
Stringa | Il tipo di oggetto nella destinazione del link |
modal |
Booleano | Indica se verrà utilizzata la finestra di dialogo del livello di analisi anziché la navigazione del browser |
target |
Stringa | È _self se la destinazione del link sostituirà l'iframe corrente, _blank se la destinazione del link aprirà una nuova finestra |
url |
Stringa | L'URL della destinazione del link |
context |
Stringa | Attributo interno utilizzato da alcuni tipi di visualizzazioni |
La sandbox dell'iframe impedirà l'apertura dei clic del menu di analisi in una nuova finestra. Utilizza questi valori di sandboxing all'interno del tag iframe:
sandbox = "allow-same-origin allow-scripts"
drillmodal:download
Questo evento viene creato quando un utente apre una finestra di dialogo di analisi dettagliata dal riquadro di una dashboard e fa clic sull'opzione Scarica.
{
type: "drillmodal:download",
dashboard: {
id: 23,
title: "My Dashboard",
url: "/embed/dashboards/…",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/…",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
drillExploreUrl: "/embed...",
fileFormat: "pdf"
}
Attributo | Formato | Descrizione |
---|---|---|
dashboard.id |
Numero/stringa | L'ID della dashboard a cui appartiene il riquadro. |
dashboard.title |
Stringa | Il titolo della dashboard, come mostrato nella parte superiore della dashboard a cui appartiene il riquadro. |
dashboard.url |
Stringa | L'URL relativo della dashboard (solo il percorso) a cui appartiene il riquadro. |
dashboard.absoluteUrl |
Stringa | L'URL completo della dashboard a cui appartiene il riquadro. |
dashboard.dashboard_filters |
Oggetto | I filtri applicati alla dashboard a cui appartiene il riquadro. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
drillExploreUrl |
Stringa | L'URL di esplorazione relativo (solo il percorso) da scaricare. |
fileFormat |
Stringa | Il formato file del download dei dati. |
drillmodal:explore
Questo evento viene creato quando un utente fa clic sull'opzione Esplora da qui in una finestra di dialogo in dettaglio.
type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Attributo | Formato | Descrizione |
---|---|---|
label |
Stringa | L'etichetta del pulsante come mostrata nel menu a discesa |
url |
Stringa | L'URL di esplorazione relativo (solo il percorso) da visualizzare |
explore:ready
Questo evento viene creato quando un'esplorazione inizia a caricare i dati della query, indipendentemente dal fatto che la query venga eseguita o meno.
type: "explore:ready",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
explore.url |
Stringa | L'URL di esplorazione relativo (solo il percorso) |
explore.absoluteUrl |
Stringa | L'URL completo di Esplora |
explore:run:start
Questo evento viene creato quando un'esplorazione inizia a caricare i dati della query e l'esecuzione della query.
type: "explore:run:start",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
explore.url |
Stringa | L'URL di esplorazione relativo (solo il percorso) |
explore.absoluteUrl |
Stringa | L'URL completo di Esplora |
explore:run:complete
Questo evento viene creato quando un'esplorazione ha completato l'esecuzione della query.
type: "explore:run:complete",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
explore.url |
Stringa | L'URL di esplorazione relativo (solo il percorso) |
explore.absoluteUrl |
Stringa | L'URL completo di Esplora |
explore:state:changed
Questo evento viene creato quando l'URL di una pagina Esplora cambia in seguito alle azioni dell'utente.
type: "explore:state:changed",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
Attributo | Formato | Descrizione |
---|---|---|
explore.url |
Stringa | L'URL di esplorazione relativo (solo il percorso) |
explore.absoluteUrl |
Stringa | L'URL completo di Esplora |
page:changed
Questo evento viene creato quando un utente passa a una nuova pagina all'interno dell'iframe.
type: "page:changed",
page: {
type: "dashboard",
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
Attributo | Formato | Descrizione |
---|---|---|
page.type |
Stringa | Il tipo di pagina appena raggiunto, ad esempio "dashboard" , "look" o "explore" |
page.url |
Stringa | L'URL relativo (solo il percorso) della pagina su cui è stato appena raggiunto l'URL |
page.absoluteUrl |
Stringa | L'URL completo della pagina che è appena stata raggiunta |
page:properties:changed
Questo evento viene creato quando l'altezza dell'iframe di una dashboard cambia. Non è disponibile per i Look o le esplorazioni perché questi elementi adattano automaticamente la loro altezza alle dimensioni dell'iframe.
type: "page:properties:changed",
height: 1000
Attributo | Formato | Descrizione |
---|---|---|
height |
Numero intero | L'altezza in pixel dell'iframe della dashboard |
session:tokens
Questo evento indica che il client Looker richiede token per continuare. Questo evento viene creato immediatamente al momento della creazione dell'iframe e poi periodicamente per tutta la durata della sessione.
{
"type": "session:tokens",
"api_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoiYXBpX3Rva2VuIiwicmFuZG9taXplciI6IkxjYnpOeDNTVjNOb3o3UVlqTVJjNmhlMkdodjh1a2UwWUhiZWNRMHVCYm1KIn0.CBv1__QGc_H7bKNe31SHMMQCsc5ya1xOiEv1UDWAyxM",
"api_token_ttl": 463,
"navigation_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoibmF2aWdhdGlvbl90b2tlbiIsInJhbmRvbWl6ZXIiOiJHVVNlc00tdTRPRDlNdktodFJDU2pEcVFhUkJNeTh5dm42Q1FDUXhuLTNxMiJ9.sWo7LUEI5LeragVmeDamUR7u2myXpFJ0aqK_IIALUqI",
"navigation_token_ttl": 463,
"session_reference_token_ttl": 2924
}
Attributo | Formato | Descrizione |
---|---|---|
authentication_token |
Stringa | Token di autenticazione. Incluso al momento della creazione dell'iframe. Non incluso in una risposta a una richiesta di generazione di token o se la sessione è scaduta. |
authentication_token_ttl |
Numero | Durata del token di autenticazione in secondi. Incluso al momento della creazione dell'iframe. Non incluso in una risposta a una richiesta di generazione di token o se la sessione è scaduta. |
api_token |
Stringa | il token dell'API. Non è incluso se la sessione è scaduta. |
api_token_ttl |
Numero | Durata in secondi del token API. Non è incluso se la sessione è scaduta. |
navigation_token |
Stringa | Token di navigazione. Non è incluso se la sessione è scaduta. |
navigation_token_ttl |
Numero | Durata del token di navigazione in secondi. Non è incluso se la sessione è scaduta. |
session_references_token_ttl |
Numero | Durata della sessione in secondi. Il valore sarà 0 quando la sessione è scaduta. Per eseguire il ripristino, l'applicazione di incorporamento deve acquisire una nuova sessione. |
session:status
L'evento viene generato quando l'applicazione Looker incorporata gestisce le richieste di token di sessione.
{
"type": "session:status",
"session_ttl": 0,
"expired": true,
"interrupted": false
}
Attributo | Formato | Descrizione |
---|---|---|
session_ttl |
Numero | Durata della sessione in secondi. |
expired |
Booleano | Se true , indica che la sessione è scaduta. |
interrupted |
Booleano | Quando true , indica che non è stata ricevuta una risposta a una richiesta di token di sessione. Questo potrebbe indicare che un server è temporaneamente non disponibile. |
recoverable |
Booleano | Compilato solo quando interrotto è true . Indica se la sessione può essere recuperata o meno. Se il valore è false , probabilmente si è verificato un problema con l'applicazione di incorporamento. |
env:client:dialog
L'evento viene generato quando viene aperta una finestra di dialogo che potrebbe non essere visibile parzialmente, ad esempio una finestra di dettaglio. Questo evento consente all'applicazione di hosting di far scorrere la finestra di dialogo per visualizzarla con l'azione env:host:scroll
.
{
type: "env:client:dialog",
dialogType: 'drilling',
placement: 'cover',
open: true
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | env:client:dialog indica che è stata aperta o chiusa una finestra di dialogo. Al momento è supportata solo la finestra di dialogo del livello di analisi, ma in futuro potrebbero essere aggiunte altre finestre di dialogo. È possibile che la parte superiore della finestra di dialogo del drill non sia visibile poiché la finestra di dialogo copre l'area visibile dell'iframe. Questo evento consente all'applicazione host di scorrere la parte superiore della finestra di dialogo per visualizzarla. |
dialogType |
Stringa | Il tipo di finestra di dialogo. Al momento solo l'apertura o la chiusura del tipo di finestra di dialogo "drilling" attiva questo evento. |
placement |
Stringa | La posizione della finestra di dialogo. Nelle finestre di dialogo di tipo "foratura" viene sempre utilizzato un placement di "copertura". |
open |
Booleano | Indica se la finestra di dialogo viene aperta o se viene fatto scorrere. |
Modifiche all'iframe
Dopo aver preparato l'iframe per il recupero dei dati, puoi apportare modifiche all'iframe nel seguente modo:
Scrittura della richiesta in formato JSON
Puoi apportare diverse modifiche all'iframe, che dovrai inviare in formato JSON. Le opzioni disponibili sono descritte nella sezione Riferimento all'azione di questa pagina. Non dimenticare di utilizzare JSON.stringify
per convertire l'azione in JSON, ad esempio:
var my_request = JSON.stringify(
{
type: "dashboard:run"
}
);
Pubblicazione della richiesta nella proprietà contentWindow
dell'iframe
Infine, pubblica il tuo messaggio nel contentWindow
dell'iframe, in questo modo:
var my_iframe = document.getElementById("my_iframe_id");
my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');
Tabella di riepilogo delle azioni
La tabella seguente riassume le azioni. Seleziona un'azione per visualizzarne i dettagli.
Azione | Descrizione azione |
---|---|
dashboard:load |
Carica una nuova dashboard nell'iframe, sostituendo una dashboard esistente. |
dashboard:run |
Esegue la dashboard nell'iframe. |
dashboard:edit |
AGGIUNTO il 22/02/2020 Attiva la modalità di modifica per la dashboard. |
dashboard:filters:update |
Aggiorna un filtro della dashboard esistente nell'iframe. |
dashboard:options:set |
Scrive nuovi valori nel layout e nelle proprietà degli elementi della dashboard. |
dashboard:schedule_modal:open |
Apre lo scheduler, che consente agli utenti di inviare contenuti di Looker a varie destinazioni. |
dashboard:stop |
Interrompe una dashboard in esecuzione o in fase di ricarica dei dati. |
look:run |
Esegue il Look nell'iframe. |
look:filters:update |
Aggiorna un filtro Look esistente nell'iframe. |
explore:run |
Esegue l'esplorazione nell'iframe. |
explore:filters:update |
Aggiorna o rimuove un filtro Esplora esistente nell'iframe. |
session:tokens:request |
Invia i token in risposta a un evento session:tokens:request . |
env:host:scroll |
Invia informazioni sulla posizione di scorrimento corrente dell'iframe dell'host all'applicazione Looker incorporata. |
Riferimento azione
Di seguito sono riportate le azioni disponibili che puoi pubblicare nell'iframe incorporato:
dashboard:load
Utilizza questa azione per caricare una nuova dashboard nell'iframe, sostituendo una dashboard esistente. La nuova dashboard inizierà a eseguire query come se fosse stata aperta una nuova pagina della dashboard.
{
type: "dashboard:load",
id: "101",
pushHistory: false
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'uso del tipo dashboard:load indica che vuoi caricare una nuova dashboard nell'iframe. |
id |
Stringa | L'ID della dashboard da caricare. |
pushHistory |
Booleano | Se true , la dashboard caricata crea una nuova voce nella cronologia del browser e l'utente può utilizzare il pulsante Indietro del browser per tornare alla dashboard precedente. Se false , la dashboard attuale viene sostituita e la navigazione del browser non può essere utilizzata per riaprirla. |
dashboard:run
Utilizza questa azione per eseguire la dashboard nell'iframe. Questa azione è la stessa utilizzata dal pulsante Esegui o Ricarica dati sulla dashboard.
{
type: "dashboard:run"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | Se utilizzi il tipo dashboard:run , significa che vuoi eseguire la dashboard. |
dashboard:edit
AGGIUNTO il 22/22/2020 Utilizza questa azione per passare alla modalità di modifica di una dashboard esistente nell'iframe. Questa azione equivale a selezionare Modifica dashboard dal menu della dashboard.
{
type: "dashboard:edit"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | Se utilizzi il tipo dashboard:edit , significa che vuoi passare alla modalità di modifica della dashboard. |
dashboard:filters:update
Utilizza questa azione per aggiornare un filtro della dashboard esistente nell'iframe. Non puoi aggiungere un nuovo filtro alla dashboard utilizzando questo metodo.
{
type: "dashboard:filters:update",
filters: {
"Sale date": "Last 28 days",
"Sale amount": "Greater than 100"
}
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | Se utilizzi il tipo dashboard:filters:update , significa che vuoi aggiornare i filtri utilizzati dalla dashboard. |
filters |
Oggetto | I nuovi filtri da applicare alla dashboard. Questo oggetto ha il formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:options:set
Questa azione è disponibile dopo che si verifica l'evento dashboard:run:complete
.
L'incorporamento crea il messaggio e lo invia all'iframe, ma la dashboard non risponde finché non si verifica dashboard:run:complete
. L'azione dashboard:options:set
scrive nuovi valori nelle proprietà del layout e degli elementi della dashboard. È possibile aggiornare solo le proprietà restituite nell'attributo options
dell'evento dashboard:run:complete
utilizzando dashboard:options:set
. Tutte le proprietà impostate che non sono state restituite in precedenza dall'attributo options
dell'evento dashboard:run:complete
vengono ignorate.
{
type: "dashboard:options:set",
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'uso del tipo dashboard:options:set indica che vuoi scrivere nuovi valori nel layout della dashboard e nelle proprietà degli elementi della dashboard. |
layouts |
Oggetto | Le proprietà di layout della dashboard restituite dall'attributo options nell'evento dashboard:run:complete . che avranno un formato simile al seguente:
|
layouts.dashboard_layout_components |
Oggetto | Uno o più oggetti componenti di layout dashboard restituiti dall'attributo options nell'evento dashboard:run:complete . che avranno un formato simile al seguente:
|
elements |
Oggetto | Uno o più oggetti elemento della dashboard restituiti dall'attributo options nell'evento dashboard:run:complete . che avranno un formato simile al seguente:id: { title: "string", title_hidden: boolean, vis_config: { type: "string", title: "string" }} |
dashboard:schedule_modal:open
Utilizza questa azione per aprire lo scheduler, che consente agli utenti di pubblicare i contenuti di Looker su varie destinazioni.
{
type: "dashboard:schedule_modal:open"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | Se utilizzi il tipo dashboard:schedule_modal:open , indica che desideri aprire la finestra di dialogo Pianifica. |
dashboard:stop
Utilizza questa azione per arrestare una dashboard in esecuzione o per ricaricare i dati. Questa azione equivale a fare clic sul pulsante Annulla sulla dashboard. Una dashboard ha interrotto l'utilizzo di dashboard:stop
invia un evento dashboard:run:complete
con status:
impostato su "stopped"
.
{
type: "dashboard:stop"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'uso del tipo dashboard:stop indica che vuoi arrestare la dashboard in esecuzione. |
look:run
Utilizza questa azione per eseguire la query su cui si basa il Look nell'iframe. Questa azione è simile alla pressione del pulsante Esegui nel Look, ad eccezione del fatto che look:run
interroga sempre direttamente il database e non recupera i dati dalla cache di Looker.
{
type: "look:run"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | Se utilizzi il tipo look:run , significa che vuoi eseguire il Look. |
look:filters:update
Utilizza questa azione per aggiornare un filtro Look esistente nell'iframe. Non puoi aggiungere un nuovo filtro al Look utilizzando questo metodo.
{
type: "look:filters:update",
filters: {
"orders.created_at": "90 days",
"products.department": "sweaters"
}
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | Se utilizzi il tipo look:filters:update , significa che vuoi aggiornare i filtri utilizzati dal Look. |
filters |
Oggetto | I nuovi filtri che vuoi applicare al Look. Questo oggetto ha il formato: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...} |
explore:run
Utilizza questa azione per eseguire l'esplorazione nell'iframe. Questa azione è simile a quando premi il pulsante Esegui nell'esplorazione, ad eccezione del fatto che explore:run
esegue sempre una query direttamente sul database e non recupera i dati dalla cache di Looker.
{
type: "explore:run"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | Se utilizzi il tipo explore:run , significa che vuoi eseguire l'esplorazione. |
explore:filters:update
Utilizza questa azione per aggiornare o rimuovere un filtro Esplora esistente nell'iframe. Se includi un nuovo filtro che fa riferimento a un campo valido, il nuovo filtro verrà aggiunto all'esplorazione.
{
type: "explore:filters:update",
filters: {
"orders.created_at": "90 days",
"orders.status": "complete"
}
deleteFilters: ["products.department"]
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | Se utilizzi il tipo explore:filters:update , significa che vuoi aggiornare i filtri utilizzati dall'esplorazione. |
filters |
Oggetto | I nuovi filtri da applicare all'esplorazione. Se filters include un filtro che al momento non esiste nell'esplorazione, ma che fa riferimento a un campo valido, questo filtro verrà aggiunto all'esplorazione. Questo oggetto ha il formato: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...} |
deleteFilters |
Array | I filtri esistenti che vuoi rimuovere da Esplora. L'array ha il formato: ["view_name.field_name_1", "view_name.field_name_2", ...] |
session:tokens:request
Utilizza questa azione per inviare token in risposta a una richiesta session:tokens:request
.
{
type: "session:tokens:request",
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'uso del tipo session:tokens:request indica che vuoi inviare token in risposta a un evento session:tokens:request . |
env:host:scroll
Utilizza questa azione per inviare informazioni sulla posizione di scorrimento corrente dell'iframe host all'applicazione Looker incorporata.
{
type: "env:host:scroll",
offsetTop: 10,
offsetLeft: 10,
scrollX: 5,
scrollY: 5
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'utilizzo del tipo env:host:scroll indica che vuoi inviare informazioni sulla posizione di scorrimento corrente dell'iframe host all'applicazione Looker incorporata. |
offsetTop |
Numero | L'offset superiore dell'iframe. |
offsetLeft |
Numero | L'offset a sinistra dell'iframe. |
scrollX |
Numero | La posizione scrollX dell'host dell'applicazione. |
scrollY |
Numero | La posizione di scorrimentoY dell'host dell'applicazione. |