Dopo aver creato l'incorporamento, puoi eseguire questa operazione pubblicamente, in privato con Single Sign-On (SSO) o tramite l'API, puoi interagire con quegli iframe tramite JavaScript. Puoi rendere la pagina più dinamica, in base allo stato dell'elemento incorporato o 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 tuo codice JavaScript in modo da tenere conto della gestione degli eventi dei diversi browser.
Puoi utilizzare JavaScript in due modi per i contenuti incorporati in Looker:
- Utilizzare l'SDK (Software Development Kit) per l'incorporamento di Looker, descritto nella pagina della documentazione Incorpora l'SDK.
- Utilizzare gli eventi JavaScript, descritti nella sezione Accedere agli eventi in JavaScript di questa pagina.
preparazione
Prima di poter interagire con l'iframe incorporato, devi intraprendere alcune azioni:
- Aggiungere un ID nell'iframe
- Aggiungi il dominio di incorporamento all'attributo iframe
src
. - Aggiungere il dominio di incorporamento alla lista consentita
Aggiungere un ID all'iframe
Una delle azioni che dovrai eseguire in un secondo momento consiste nel verificare che le informazioni su cui lavori provengono effettivamente dall'iframe di Looker. Per facilitare questa operazione, se non l'hai già fatto, aggiungi un ID all'iframe. Nell'esempio seguente, abbiamo aggiunto id="looker"
:
<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>
Aggiunta del dominio di incorporamento all'attributo iframe src
Nella sezione src
dell'iframe, aggiungi il dominio in cui viene utilizzato l'iframe. Nell'esempio seguente, abbiamo aggiunto ?embed_domain=https://mywebsite.com"
:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://mywebsite.com">
</iframe>
Se utilizzi l'incorporamento SSO, assicurati di aggiungere embed_domain
all'URL di incorporamento.
Non includere una barra finale (
/
) inembed_domain
.
Aggiungere il dominio di incorporamento alla lista consentita
Infine, devi aggiungere il dominio in cui viene utilizzato l'iframe alla lista consentita nella pagina Embed del riquadro Admin (Amministrazione) di Looker:
- Inserisci il dominio in cui viene utilizzato l'iframe. Dopo averlo digitato, assicurati di premere il tasto Tab per far sì che il dominio venga visualizzato in una casella. Non includere una barra finale (
/
) nell'URL del dominio. - Fai clic sul pulsante Aggiorna.
Puoi utilizzare il carattere jolly *
nella lista consentita per creare un pattern di dominio. Ad esempio, https://*.mycompany.com
consentirà sia https://analytics.mycompany.com
che https://data.mycompany.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 alla lista consentita tramite il riquadro Amministrazione > Incorpora. Leggi le best practice per la sicurezza se decidi di avvalerti 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 dominio e attendere gli eventi postMessage
.
Assicurati di verificare che gli eventi provengano dall'iframe e dal dominio di Looker per evitare messaggi dannosi.
L'iframe incorporato può creare alcuni tipi di eventi, come descritto nella sezione Riferimento tipo di evento in questa pagina.
Accedere agli eventi in JavaScript
Ecco un esempio di ascolto di questi eventi in JavaScript nativo e della relativa registrazione 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 poi 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 seguente tabella riassume i tipi di eventi. Fai clic su un tipo di evento per visualizzarne i dettagli.
Tipo di evento | Causa evento |
---|---|
dashboard:loaded |
Nelle dashboard in cui i riquadri non sono impostati per l'esecuzione automatica, viene caricata una dashboard con i relativi elementi, ma le query non sono ancora in esecuzione. |
dashboard:run:start |
È iniziato il caricamento di una dashboard e i suoi riquadri hanno iniziato a caricarsi e a eseguire query sui dati. |
dashboard:run:complete |
L'esecuzione di una dashboard è terminata e tutti i riquadri hanno completato il caricamento e l'esecuzione di query. |
dashboard:download |
È iniziato il download del file PDF di una dashboard. |
dashboard:edit:start |
AGGIUNTO 22.20
Una dashboard è passata alla modalità di modifica. L'evento dashboard:save:complete viene attivato quando la dashboard viene salvata correttamente. |
dashboard:edit:cancel |
AGGIUNTO 22.20 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 |
Una dashboard è stata eliminata. |
dashboard:tile:start |
Un riquadro ha iniziato a caricare o a 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 aspetto 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 dati di query, indipendentemente dal fatto che la query venga eseguita o meno. |
look:run:start |
Un Look ha iniziato a caricare i dati delle query e l'esecuzione della query è iniziata. |
look:run:complete |
La query ha terminato l'esecuzione di un look. |
look:save:complete |
Un look è stato modificato e salvato. |
look:delete:complete |
Un look è stato spostato nella cartella Cestino. |
drillmenu:click |
Un utente ha fatto clic su un menu drill-down in una dashboard creata con il parametro LookML link . |
drillmodal:download |
Un utente ha aperto una finestra di dialogo drill-down 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 drill-down. |
explore:ready |
L'esplorazione ha iniziato a caricare i dati delle query, indipendentemente dal fatto che la query venga eseguita o meno. |
explore:run:start |
Un'esplorazione inizia a caricare i dati delle query e l'esecuzione della query è iniziata. |
explore:run:complete |
L'esecuzione della query è stata completata in un'esplorazione. |
explore:state:changed |
L'URL di una pagina Esplora è cambiato a causa delle azioni dell'utente. |
page:changed |
Un utente è passato a una nuova pagina all'interno dell'iframe. |
page:properties:changed |
L'altezza di un iframe della dashboard è stata modificata. |
session:tokens |
Il client Looker richiede 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 non visibile, ad esempio una finestra di dialogo dettagliata. Questo evento consente all'applicazione di hosting di scorrere la finestra di dialogo per visualizzare. |
Riferimento ai tipi di eventi
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 relativi 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 22.20
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, del componente della dashboard e dell'elemento della dashboard. A tutte le proprietà restituite nell'oggetto options possono essere assegnati valori aggiornati utilizzando l'evento dashboard:options:set . |
dashboard:run:start
Questo evento viene creato all'inizio del caricamento di una dashboard, quando i relativi riquadri inizieranno a essere caricati e a eseguire 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 22.20
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 quando la dashboard è terminata e tutti i riquadri hanno terminato il caricamento e l'interrogazione. Questo evento viene creato se tutti i riquadri vengono caricati correttamente.
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" , altrimenti 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 22.20
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, del componente della dashboard e dell'elemento della dashboard. A tutte le proprietà restituite nell'oggetto options possono essere assegnati valori aggiornati utilizzando l'azione dashboard:options:set . |
dashboard.tileStatuses |
Array di oggetti | Un array di oggetti che forniscono stati di riquadri. Le proprietà dell'oggetto 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 22.20
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 22.20 Questo evento viene creato quando una dashboard passa 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 22.20
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 22.20 Questo evento viene creato quando una dashboard in modalità di modifica esce 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 22.20
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 22.20
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, del componente della dashboard e dell'elemento della dashboard. A tutte le proprietà restituite nell'oggetto options possono essere assegnati valori aggiornati 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 22.20
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, del componente della dashboard e dell'elemento della dashboard. A tutte le proprietà restituite nell'oggetto options possono essere assegnati valori aggiornati utilizzando l'evento dashboard:options:set . |
dashboard:tile:start
Questo evento viene creato quando un riquadro inizia a caricare o eseguire 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 22.20
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 il riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore della scheda. |
tile.listen |
Oggetto | La dashboard globale filtra 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 22.20
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 | Indica se la query di riquadro è stata completata correttamente. I valori possibili sono "complete" o "error" . |
truncated |
Booleano | Indica se i risultati della query di riquadro sono stati troncati perché la query ha restituito più righe rispetto al limite di righe della query. Il limite di righe può essere un limite di riga specificato dall'utente o il limite predefinito di 5000 righe di Looker. |
tile.id |
Numero intero | Il numero ID dell'evento, non il riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore della scheda. |
tile.listen |
Oggetto | La dashboard globale filtra questo riquadro. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...} |
tile.errors |
Array di oggetti | Completato quando la proprietà status è "error" . Un array di oggetti che forniscono dettagli dell'errore, tra cui il testo del messaggio di errore, 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 22.20
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 il riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore della scheda. |
tile.listen |
Oggetto | La dashboard globale filtra questo riquadro. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...} |
fileFormat |
Stringa | Il formato del riquadro scaricato (solo "pdf" al momento). |
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 22.20
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 il riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore della scheda. |
tile.listen |
Oggetto | La dashboard globale filtra 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 aspetto 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) dell'aspetto 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 22.20
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 il riquadro. |
tile.title |
Stringa | Il titolo del riquadro, come mostrato nella parte superiore della scheda. |
tile.listen |
Oggetto | La dashboard globale filtra 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 22.20
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, del componente della dashboard e dell'elemento della dashboard. A tutte le proprietà restituite nell'oggetto options possono essere assegnati valori aggiornati utilizzando l'evento dashboard:options:set . |
look:ready
Questo evento viene creato quando un oggetto Look inizia a caricare i dati delle query, indipendentemente dal fatto che 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 relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL completo |
look:run:start
Questo evento viene creato quando un oggetto Look inizia a caricare i dati di query e inizia la sua esecuzione.
type: "look:run:start",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
look.url |
Stringa | L'URL relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL completo |
look:run:complete
Questo evento viene creato al termine dell'esecuzione della query in un look.
type: look:run:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
look.url |
Stringa | L'URL relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL completo |
look:save:complete
Questo evento viene creato in seguito alla modifica e al salvataggio di un look. Questo evento viene creato quando un utente svolge una delle seguenti attività:
- Fai clic sul pulsante Modifica per modificare il Look e quindi su Salva
- Salva un look con l'opzione del menu Salva > Salva con nome.
- Consente di spostare un Look da una cartella a un'altra
Questo evento non viene creato se il look è 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 relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL 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 relativo (solo il percorso) |
look.absoluteUrl |
Stringa | L'URL completo |
drillmenu:click
Questo evento viene creato quando un utente fa clic su un menu di funzionalità in una dashboard creata con il parametro LookML link
. Ad esempio, il seguente LookML crea un menu drill-down 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 mostrato nel menu Trapano |
link_type |
Stringa | Il tipo di oggetto nella destinazione del link |
modal |
Booleano | Utilizzo della finestra di dialogo drill-down 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 sul menu drill-down in una nuova finestra. Utilizza questi valori del 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 drill-down da un riquadro della 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 relativo (solo il percorso) da scaricare. |
fileFormat |
Stringa | Il formato file del download di dati. |
drillmodal:explore
Questo evento viene creato quando un utente fa clic sull'opzione Esplora da qui in una finestra di dialogo drill-down.
type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Attributo | Formato | Descrizione |
---|---|---|
label |
Stringa | Etichetta del pulsante visualizzata nel menu Esegui un trapano |
url |
Stringa | L'URL Esplora relativo (solo il percorso) da visualizzare |
explore:ready
Questo evento viene creato quando un'esplorazione inizia a caricare i dati delle 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 Esplora relativo (solo il percorso) |
explore.absoluteUrl |
Stringa | L'URL Esplora completo |
explore:run:start
Questo evento viene creato quando un'esplorazione inizia a caricare i dati delle query e inizia 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 Esplora relativo (solo il percorso) |
explore.absoluteUrl |
Stringa | L'URL Esplora completo |
explore:run:complete
Questo evento viene creato al termine dell'esecuzione della query da parte di un Explore.
type: "explore:run:complete",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Attributo | Formato | Descrizione |
---|---|---|
explore.url |
Stringa | L'URL Esplora relativo (solo il percorso) |
explore.absoluteUrl |
Stringa | L'URL Esplora completo |
explore:state:changed
Questo evento viene creato quando un URL della 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 Esplora relativo (solo il percorso) |
explore.absoluteUrl |
Stringa | L'URL Esplora completo |
page:changed
Questo evento viene creato quando un utente accede 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 aperta, ad esempio "dashboard" , "look" o "explore" |
page.url |
Stringa | L'URL relativo (solo il percorso) della pagina che è stata appena raggiunta |
page.absoluteUrl |
Stringa | L'URL completo della pagina appena raggiunta. |
page:properties:changed
Questo evento viene creato quando l'altezza di un iframe della dashboard cambia. Non è disponibile per i Look o per le esplorazioni, in quanto questi elementi regolano automaticamente l'altezza in base alle dimensioni dell'iframe.
type: "page:properties:changed",
height: 1000
Attributo | Formato | Descrizione |
---|---|---|
height |
Numero intero | L'altezza dell'iframe della dashboard in pixel |
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, periodicamente, per 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 nella 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 nella creazione dell'iframe. Non incluso in una risposta a una richiesta di generazione di token o se la sessione è scaduta. |
api_token |
Stringa | Token dell'API. Non inclusa se la sessione è scaduta. |
api_token_ttl |
Numero | Durata del token API in secondi. Non inclusa se la sessione è scaduta. |
navigation_token |
Stringa | Token di navigazione. Non inclusa se la sessione è scaduta. |
navigation_token_ttl |
Numero | Durata del token di navigazione in secondi. Non inclusa se la sessione è scaduta. |
session_references_token_ttl |
Numero | Durata della sessione in secondi. Il valore sarà 0 alla scadenza della sessione. 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 | Quando true , la sessione è scaduta. |
interrupted |
Booleano | Quando true , indica che una richiesta di token di sessione non ha ricevuto risposta. Ciò potrebbe indicare che un server è temporaneamente non disponibile. |
recoverable |
Booleano | Compilato solo quando viene interrotto è true . Indica se la sessione può essere recuperata o meno. Un valore false significa probabilmente che 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 essere parzialmente non visibile, ad esempio una finestra di dialogo dettagliata. Questo evento consente all'applicazione di hosting di scorrere la finestra di dialogo in visualizzazione 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 drill-down, ma in futuro potrebbero essere aggiunte altre finestre di dialogo. È possibile che la parte superiore della finestra di dialogo di visualizzazione non sia visibile, poiché la finestra di dialogo copre l'area visibile dell'iframe. Questo evento consente all'applicazione host di scorrere nella parte superiore della finestra di dialogo per visualizzarla. |
dialogType |
Stringa | Il tipo della finestra di dialogo. Attualmente solo l'apertura o la chiusura del tipo di finestra di dialogo "drilling" attiva questo evento. |
placement |
Stringa | La posizione della finestra di dialogo. Le finestre di dialogo di tipo "drilling" utilizzano sempre una placement di "cover". |
open |
Booleano | Indica se la finestra di dialogo è aperta o aperta. |
Apportare modifiche all'iframe
Dopo aver preparato l'iframe per il recupero dei dati, puoi apportare modifiche all'iframe con i seguenti passaggi:
Scrittura della richiesta in JSON
Puoi apportare diverse modifiche all'iframe, che invierai sotto forma di JSON. Le opzioni disponibili sono descritte nella sezione Riferimento azione in questa pagina. Non dimenticare di utilizzare JSON.stringify
per trasformare la tua azione in JSON, come indicato di seguito:
var my_request = JSON.stringify(
{
type: "dashboard:run"
}
);
Pubblicazione della richiesta nella proprietà contentWindow
dell'iframe
Infine, pubblica il tuo messaggio nella 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 riepiloga le azioni. Fai clic su 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 |
AGGIUNTA 22.20 Attiva la modalità di modifica per la dashboard. |
dashboard:filters:update |
Aggiorna un filtro della dashboard esistente nell'iframe. |
dashboard:options:set |
Scrive i nuovi valori nelle proprietà di layout e elementi della dashboard. |
dashboard:schedule_modal:open |
Apre lo scheduler, che consente agli utenti di inviare contenuti Looker a varie destinazioni. |
dashboard:stop |
Consente di interrompere una dashboard che esegue o ricarica dati. |
look:run |
Esegue il look nell'iframe. |
look:filters:update |
Aggiorna un filtro Look esistente nell'iframe. |
explore:run |
Esegue Esplora per l'iframe. |
explore:filters:update |
Aggiorna o rimuove un filtro Esplora esistente nell'iframe. |
session:tokens:request |
Invia token in risposta a un evento session:tokens:request . |
env:host:scroll |
Invia informazioni sull'attuale posizione di scorrimento dell'iframe dell'host all'applicazione Looker incorporata. |
Riferimento all'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'utilizzo 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 della cronologia del browser e l'utente può usare il pulsante Indietro del browser per tornare alla dashboard precedente. Se false , la dashboard corrente viene sostituita e non è possibile tornare alla navigazione del browser. |
dashboard:run
Utilizza questa azione per eseguire la dashboard nell'iframe. È la stessa azione che si verifica premendo il pulsante Esegui o Ricarica dati sulla dashboard.
{
type: "dashboard:run"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'utilizzo del tipo dashboard:run indica che vuoi eseguire la dashboard. |
dashboard:edit
AGGIUNTO 22.20 Utilizza questa azione per passare a una dashboard esistente nell'iframe in modalità di modifica. È la stessa cosa che selezioni Modifica dashboard dal menu della dashboard.
{
type: "dashboard:edit"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'utilizzo del tipo dashboard:edit indica che vuoi attivare la 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 | L'utilizzo del tipo dashboard:filters:update indica che vuoi aggiornare i filtri utilizzati dalla dashboard. |
filters |
Oggetto | I nuovi filtri che vuoi 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 fino a quando non si verifica l'evento dashboard:run:complete
. L'azione dashboard:options:set
scrive nuovi valori nel layout della dashboard e nelle proprietà dell'elemento della dashboard. Solo le proprietà che sono state restituite nell'attributo options
dell'evento dashboard:run:complete
possono essere aggiornate utilizzando dashboard:options:set
. Qualsiasi proprietà impostata che non è stata restituita in precedenza dall'attributo options
dell'evento dashboard:run:complete
viene ignorata.
{
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'utilizzo del tipo dashboard:options:set indica che vuoi scrivere nuovi valori per il layout e le proprietà degli elementi della dashboard. |
layouts |
Oggetto | Le proprietà del layout della dashboard restituite dall'attributo options nell'evento dashboard:run:complete . Il formato sarà simile a: id: "string", |
layouts.dashboard_layout_components |
Oggetto | Uno o più oggetti del componente di layout della dashboard restituiti dall'attributo options nell'evento dashboard:run:complete . Il formato sarà simile a:id: "string", |
elements |
Oggetto | Uno o più oggetti elemento dashboard restituiti dall'attributo options nell'evento dashboard:run:complete . Il formato sarà simile a:id: { |
dashboard:schedule_modal:open
Utilizza questa azione per aprire lo scheduler, che consente agli utenti di caricare contenuti Looker in varie destinazioni.
{
type: "dashboard:schedule_modal:open"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'utilizzo del tipo dashboard:schedule_modal:open indica che vuoi aprire la finestra di dialogo Pianifica. |
dashboard:stop
Utilizza questa azione per interrompere una dashboard che esegue o ricarica dati. È la stessa azione che si verifica facendo clic sul pulsante Annulla nella dashboard. Una dashboard interrotta utilizzando dashboard:stop
invia un evento dashboard:run:complete
con status:
impostato su "stopped"
.
{
type: "dashboard:stop"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'utilizzo del tipo dashboard:stop indica che vuoi interrompere la dashboard in esecuzione. |
look:run
Utilizza questa azione per eseguire la query su cui si basa il Look nell'iframe. È simile a premere il pulsante Esegui sul look, ad eccezione del fatto che look:run
esegue sempre query direttamente sul database e non recupera i dati dalla cache di Looker.
{
type: "look:run"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'utilizzo del tipo look:run indica 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 | L'utilizzo del tipo look:filters:update indica 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 la funzionalità Explore in the iframe. Ciò è simile a premere il pulsante Esegui su Explore, con l'eccezione che explore:run
esegue sempre query direttamente sul database e non recupera i dati dalla cache di Looker.
{
type: "explore:run"
}
Attributo | Formato | Descrizione |
---|---|---|
type |
Stringa | L'utilizzo del tipo explore:run indica 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 | L'utilizzo del tipo explore:filters:update indica che vuoi aggiornare i filtri utilizzati da Explore. |
filters |
Oggetto | I nuovi filtri che vuoi applicare a Esplora. Se filters include un filtro che al momento non esiste in Explore, ma che fa riferimento a un campo valido, questo filtro verrà aggiunto all'Explore. 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'utilizzo 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 dell'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 dell'host all'applicazione Looker incorporata. |
offsetTop |
Numero | La parte superiore offset dell'iframe. |
offsetLeft |
Numero | L'offset sinistro dell'iframe. |
scrollX |
Numero | La posizione ScrollX dell'host dell'applicazione. |
scrollY |
Numero | La posizione ScrollY dell'host dell'applicazione. |