Eventi JavaScript incorporati

Dopo aver creato un incorporamento, che può essere eseguito pubblicamente, privatamente, con l'incorporamento firmato o tramite l'API, puoi interagire con gli 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 da tenere conto della gestione degli eventi dei diversi browser.

Puoi utilizzare JavaScript in uno dei seguenti modi per i contenuti incorporati di Looker:

• Utilizzo del software development kit (SDK) di incorporamento di Looker, descritto nella pagina della documentazione dell'SDK Embed
• Utilizzo degli eventi JavaScript, descritti nella sezione Accedere agli eventi in JavaScript di questa pagina

preparazione

Prima di poter interagire con l'iframe incorporato, segui questi passaggi:

• Aggiungi un ID all'iframe.
• Aggiungi il dominio di incorporamento all'attributo src dell'iframe.
• Aggiungi il dominio di incorporamento 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 semplificare questa operazione, assicurati di aggiungere un ID all'iframe, se non l'hai ancora fatto. Nell'esempio seguente, 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 di incorporamento all'attributo src iframe

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 utilizzi l'incorporamento firmato, assicurati di aggiungere embed_domain all'URL di incorporamento.

Suggerimento: non includere una barra finale (/) nel valore specificato per il parametro embed_domain.

Se utilizzi l'SDK di incorporamento, aggiungi sdk=2 alla fine dell'URL di incorporamento. Il parametro sdk=2 indica che l'SDK è presente e che Looker può sfruttare le funzionalità aggiuntive fornite dall'SDK, ad esempio il passaggio di eventi JavaScript tra l'iframe di Looker e il tuo dominio. L'SDK non può aggiungere questo parametro 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 di incorporamento alla lista consentita

Infine, dovrai aggiungere il dominio in cui viene utilizzato l'iframe alla lista consentita nella pagina Incorpora del riquadro Amministrazione di Looker seguendo questi passaggi:

1. Nel campo Lista consentita dei domini incorporati, inserisci il dominio in cui viene utilizzato l'iframe e premi il tasto Tab in modo che il dominio venga visualizzato in una casella all'interno del campo.

   Importante: non includere una barra finale (/) nell'URL del dominio.

2. Fai clic su 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 che https://data.myownpersonaldomain.com.

Se utilizzi l'incorporamento senza cookie con Looker 23.8 o versioni successive, il dominio di incorporamento può essere specificato quando viene acquisita la sessione senza cookie. Questa è un'alternativa all'aggiunta del dominio di incorporamento alla lista consentita utilizzando il riquadro Amministrazione > Incorpora. Se decidi di utilizzare questa funzionalità, consulta le best practice di sicurezza.

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.

Importante: 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 ai tipi di evento di questa pagina.

Accesso agli eventi in JavaScript

Ecco un esempio di rilevamento di questi eventi in JavaScript nativo e successiva 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 rilevamento di questi eventi in jQuery e successiva registrazione 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 eventi

La tabella seguente riassume i tipi di eventi. Seleziona 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, 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 caricarsi ed eseguire query sui dati.
dashboard:run:complete	L'esecuzione di una dashboard è terminata e il caricamento e le query di tutti i riquadri sono stati completati.
dashboard:download	È iniziato il download di un PDF di una dashboard.
dashboard:edit:start	AGGIUNTA IL 22/02 È stata attivata la modalità di modifica di una dashboard. L'evento dashboard:save:complete viene attivato quando la dashboard viene salvata correttamente.
dashboard:edit:cancel	AGGIUNTA IL 22/20 È stata chiusa la modalità di modifica di una dashboard senza salvare.
dashboard:save:complete	Una dashboard è stata modificata e salvata.
dashboard:delete:complete	Una dashboard è stata eliminata.
dashboard:tile:start	È iniziato il caricamento di un riquadro o la query per i dati.
dashboard:tile:complete	L'esecuzione della query di un riquadro è terminata.
dashboard:tile:download	È iniziato il download dei dati di una scheda.
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 ha iniziato a essere eseguita.
look:run:complete	L'esecuzione della query di un look è terminata.
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 di visualizzazione dettagliata in una dashboard creata con il parametro LookML link.
drillmodal:download	Un utente ha aperto una finestra di dialogo di visualizzazione 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 di esplorazione.
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 e la query ha iniziato a essere eseguita.
explore:run:complete	L'esecuzione della query di un'esplorazione è terminata.
explore:state:changed	L'URL di una pagina di esplorazione è cambiato a seguito delle azioni dell'utente.
page:changed	Un utente ha visitato una nuova pagina all'interno dell'iframe.
page:properties:changed	L'altezza di un iframe della dashboard è cambiata.
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 nascosta, ad esempio una finestra di dialogo di visualizzazione dettagliata. Questo evento consente all'applicazione host di scorrere la finestra di dialogo in modo che sia visibile.

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 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 IL 22/02/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 della dashboard relativo (solo il percorso).
dashboard.options	Oggetto	Le proprietà e i valori di layout della dashboard, componente del layout della dashboard ed elemento della dashboard. A tutte le proprietà restituite nell'oggetto options è possibile assegnare valori aggiornati utilizzando l'evento dashboard:options:set.

dashboard:run:start

Questo evento viene creato quando inizia il caricamento di una dashboard, quando i relativi riquadri iniziano a caricarsi ed 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 IL 22/02/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativo (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 del caricamento e delle query di tutti i riquadri. Questo evento viene creato indipendentemente dal fatto che tutti i riquadri vengano 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 relativi elementi sono stati eseguiti correttamente. Se la dashboard e i relativi 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/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativo (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 di layout della dashboard, componente del layout della dashboard ed 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 gli stati dei riquadri. Le proprietà degli oggetti sono: tileId: il numero ID della scheda. status: se la query dei riquadri è stata eseguita correttamente, status restituisce "complete"; in caso contrario, status restituisce "error". errors: viene compilato quando la proprietà status è "error". Un array di oggetti che forniscono i 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:download

Questo evento viene creato quando è iniziato 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/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativo (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 Questo evento viene creato quando una dashboard viene messa in 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/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativo (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/02 Questo evento viene creato quando si esce dalla modalità di modifica di una dashboard 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/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativo (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/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 della dashboard relativo (solo il percorso).
dashboard.options	Oggetto	Le proprietà e i valori di layout della dashboard, componente del layout della dashboard ed elemento della dashboard. A tutte le proprietà restituite nell'oggetto options è possibile assegnare valori aggiornati utilizzando l'evento dashboard:options:set.

dashboard:delete:complete

Questo evento viene creato quando una dashboard viene eliminata.

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/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 della dashboard relativo (solo il percorso).
dashboard.options	Oggetto	Le proprietà e i valori di layout della dashboard, componente del layout della dashboard ed elemento della dashboard. A tutte le proprietà restituite nell'oggetto options è possibile assegnare 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, visualizzato nella parte superiore della dashboard a cui appartiene il riquadro.
dashboard.canEdit	Booleano	AGGIUNTO IL 22/02/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativa (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 globale che questo riquadro ascolta. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...}

dashboard:tile:complete

Questo evento viene creato al termine dell'esecuzione della query in un riquadro.

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, visualizzato nella parte superiore della dashboard a cui appartiene il riquadro.
dashboard.canEdit	Booleano	AGGIUNTO IL 22/02/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativa (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 dei riquadri è stata completata correttamente. I valori possibili sono "complete" o "error".
truncated	Booleano	Indica se i risultati della query dei riquadri sono stati troncati perché la query ha restituito più righe del limite di righe della query. Il limite di righe può essere un limite di righe specificato dall'utente o il limite di 5000 righe predefinito di Looker.
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 globale che questo riquadro ascolta. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...}
tile.errors	Array di oggetti	Viene compilato quando la proprietà status è "error". Un array di oggetti che forniscono i 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 è iniziato 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, visualizzato nella parte superiore della dashboard a cui appartiene il riquadro.
dashboard.canEdit	Booleano	AGGIUNTO IL 22/02/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativa (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 globale che questo riquadro ascolta. Questo oggetto ha il formato: {"Filter Label": "Filter Field", ...}
fileFormat	Stringa	Il formato della scheda scaricata (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, visualizzato nella parte superiore della dashboard a cui appartiene il riquadro.
dashboard.canEdit	Booleano	AGGIUNTO IL 22/02/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativa (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 globale che questo riquadro ascolta. 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, visualizzato nella parte superiore della dashboard a cui appartiene il riquadro.
dashboard.canEdit	Booleano	AGGIUNTO IL 22/02/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativa (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 globale che questo riquadro ascolta. 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/20 Quando true, l'utente può modificare la dashboard.
dashboard.url	Stringa	L'URL della dashboard relativo (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 di layout della dashboard, componente del layout della dashboard ed elemento della dashboard. A tutte le proprietà restituite nell'oggetto options è possibile assegnare valori aggiornati 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 completo del look

look:run:start

Questo evento viene creato quando un look inizia a caricare i dati della query e la query inizia a essere eseguita.

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 completo del look

look:run:complete

Questo evento viene creato al termine dell'esecuzione della query di 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 del look relativo (solo il percorso)
look.absoluteUrl	Stringa	L'URL completo del look

look:save:complete

Questo evento viene creato quando un look viene modificato e salvato. Questo evento viene creato quando un utente esegue una delle seguenti attività:

• Fai clic sul pulsante Modifica per modificare il look e poi fai clic su Salva.
• Salva un look con l'opzione di menu Salva > Salva come…
• Sposta un look da una cartella all'altra

Questo evento non viene creato se il look viene salvato con l'opzione di menu Salva > In una dashboard esistente o Modifica impostazioni.

type: look:save:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  folderid: 123
  }
}

Attributo	Formato	Descrizione
look.url	Stringa	L'URL del look relativo (solo il percorso)
look.absoluteUrl	Stringa	L'URL completo del look
look.folderid	Numero intero	L'ID della 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 completo del look

drillmenu:click

Questo evento viene creato quando un utente fa clic su un menu di visualizzazione in una dashboard creata con il parametro LookML link. Ad esempio, il seguente codice LookML crea un menu di visualizzazione dettagliata 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 mostrata nel menu di visualizzazione dettagliata
link_type	Stringa	Il tipo di oggetto nella destinazione del link
modal	Booleano	Indica se utilizzare la finestra di dialogo di visualizzazione dettagliata 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 impedisce l'apertura dei clic del menu di visualizzazione dettagliata 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 visualizzazione dettagliata 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, visualizzato nella parte superiore della dashboard a cui appartiene il riquadro.
dashboard.url	Stringa	L'URL della dashboard relativa (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 dell'esplorazione (solo il percorso) da scaricare.
fileFormat	Stringa	Il formato del 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 di visualizzazione dettagliata.

type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."

Attributo	Formato	Descrizione
label	Stringa	L'etichetta del pulsante mostrata nel menu di visualizzazione dettagliata
url	Stringa	L'URL dell'esplorazione relativa (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 di esplorazione relativo (solo il percorso)
explore.absoluteUrl	Stringa	L'URL completo dell'esplorazione

explore:run:start

Questo evento viene creato quando un'esplorazione inizia a caricare i dati delle query e la query inizia a essere eseguita.

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 dell'esplorazione

explore:run:complete

Questo evento viene creato al termine dell'esecuzione della query in un'esplorazione.

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 dell'esplorazione

explore:state:changed

Questo evento viene creato quando l'URL di una pagina di esplorazione cambia a seguito delle 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 dell'esplorazione

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 a cui è stato eseguito l'accesso, ad esempio "dashboard", "look" o "explore"
page.url	Stringa	L'URL relativo (solo il percorso) della pagina a cui si è appena eseguito il passaggio
page.absoluteUrl	Stringa	L'URL completo della pagina a cui è stato eseguito l'accesso

page:properties:changed

Questo evento viene creato quando l'altezza di un iframe della dashboard cambia. Non è disponibile per Look o Esplorazioni perché questi elementi regolano automaticamente la loro 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 successivamente 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 quando viene creato l'iframe. Non incluso nella risposta a una richiesta di generazione di token o se la sessione è scaduta.
authentication_token_ttl	Numero	Durata (TTL) del token di autenticazione in secondi. Incluso quando viene creato l'iframe. Non incluso nella risposta a una richiesta di generazione di token o se la sessione è scaduta.
api_token	Stringa	Token API. Non incluso se la sessione è scaduta.
api_token_ttl	Numero	Durata (TTL) del token API in secondi. Non incluso se la sessione è scaduta.
navigation_token	Stringa	Token di navigazione. Non incluso se la sessione è scaduta.
navigation_token_ttl	Numero	La durata (TTL) del token di navigazione in secondi. Non incluso se la sessione è scaduta.
session_references_token_ttl	Numero	Tempo di vita della sessione in secondi. Il valore sarà 0 quando la sessione è scaduta. Per recuperare, 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	Tempo di vita della sessione in secondi.
expired	Booleano	Se il valore è true, indica che la sessione è scaduta.
interrupted	Booleano	Se il valore è true, indica che non è stata data risposta a una richiesta di token di sessione. Ciò potrebbe indicare che un server non è temporaneamente disponibile.
recoverable	Booleano	Viene compilato solo quando il valore di interrupted è true. Indica se la sessione può essere recuperata o meno. Un valore false indica probabilmente che si è verificato un problema con l'applicazione di incorporamento.

env:client:dialog

L'evento viene generato quando è stata aperta una finestra di dialogo che potrebbe essere parzialmente nascosta, ad esempio una finestra di dialogo di visualizzazione dettagliata. Questo evento consente all'applicazione di hosting di scorrere la finestra di dialogo in modo che sia visibile 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 di visualizzazione dettagliata, ma in futuro potrebbero essere aggiunte altre finestre di dialogo. È possibile che la parte superiore della finestra di dialogo di visualizzazione dettagliata non sia visibile perché 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 in modo che sia visibile.
dialogType	Stringa	Il tipo di finestra di dialogo. Al momento, questo evento viene attivato solo dall'apertura o dalla chiusura del tipo di finestra di dialogo "Visualizzazione dettagliata".
placement	Stringa	Il posizionamento della finestra di dialogo. Le finestre di dialogo di tipo "drilling" utilizzano sempre un placement di "cover".
open	Booleano	Indica se la finestra di dialogo è aperta o se è stato eseguito lo scorrimento.

Apportare modifiche all'iframe

Dopo aver preparato l'iframe per il recupero dei dati, puoi apportare modifiche all'iframe seguendo questi passaggi:

1. Scrivi la richiesta in JSON.
2. Pubblica la richiesta in contentWindow dell'iframe.

Scrivere la richiesta in JSON

Puoi apportare diverse modifiche all'iframe, che invierai in formato JSON. Le opzioni disponibili sono descritte nella sezione Riferimento alle azioni di questa pagina. Non dimenticare di utilizzare JSON.stringify per trasformare 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 messaggio in contentWindow dell'iframe, come segue:

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/20 Passa alla modalità di modifica della dashboard.
dashboard:filters:update	Aggiorna un filtro della dashboard esistente nell'iframe.
dashboard:options:set	Scrive nuovi valori nel layout della dashboard e nelle proprietà degli elementi della dashboard.
dashboard:schedule_modal:open	Apre la pianificazione, che consente agli utenti di pubblicare i contenuti di Looker in varie destinazioni.
dashboard:stop	Interrompe una dashboard in esecuzione o che sta ricaricando i dati.
look:run	Esegue la ricerca 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 di esplorazione esistente nell'iframe.
session:tokens:request	Invia token in risposta a un evento session:tokens:request.
env:host:scroll	Invia informazioni sulla posizione di scorrimento corrente dell'iframe 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, sostituendone una 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 nella cronologia del browser e l'utente può utilizzare il pulsante Indietro del browser per tornare alla dashboard precedente. Se false, la dashboard corrente viene sostituita e non è possibile utilizzare la navigazione del browser per tornare a visualizzarla.

dashboard:run

Utilizza questa azione per eseguire la dashboard nell'iframe. Si tratta della stessa azione eseguita facendo clic sul pulsante Esegui o Ricarica dati nella dashboard.

{
  type: "dashboard:run"
}

Attributo	Formato	Descrizione
type	Stringa	L'utilizzo del tipo dashboard:run indica che vuoi eseguire la dashboard.

dashboard:edit

AGGIUNTA IL 22/02/20 Utilizza questa azione per passare alla modalità di modifica di una dashboard esistente nell'iframe. Si tratta della stessa azione di selezionando Modifica dashboard dal menu della dashboard.

{
  type: "dashboard:edit"
}

Attributo	Formato	Descrizione
type	Stringa	L'utilizzo del tipo dashboard:edit indica 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	L'utilizzo del tipo dashboard:filters:update indica 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 l'evento dashboard:run:complete.

L'utente che inserisce il codice 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 nel layout della dashboard e nelle proprietà degli elementi della dashboard. Solo le proprietà restituite nell'attributo options dell'evento dashboard:run:complete possono essere aggiornate 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'utilizzo 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à del layout della dashboard restituite dall'attributo options nell'evento dashboard:run:complete. Saranno in un formato simile al seguente: id: "string", dashboard_id: "string", type: "newspaper", active: boolean, column_width: number, width: number
layouts.dashboard_layout_components	Oggetto	Uno o più oggetti componente di layout della dashboard restituiti dall'attributo options nell'evento dashboard:run:complete. Saranno in un formato simile al seguente: id: "string", dashboard_layout_id: "string", dashboard_element_id: "string", row: number, column: number, width: number, height: number, deleted: boolean,
elements	Oggetto	Uno o più oggetti elemento dashboard restituiti dall'attributo options nell'evento dashboard:run:complete. Saranno in 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 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 in esecuzione o che sta ricaricando i dati. Questa azione corrisponde a fare clic sul pulsante Annulla nella dashboard. Una dashboard che ha smesso di utilizzare 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. Questa azione è simile a quella del pulsante Esegui nel look, con la differenza 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 pubblicare 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 da 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 quella del pulsante Esegui nell'esplorazione, con la differenza 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 di esplorazione 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 dall'esplorazione.
filters	Oggetto	I nuovi filtri da applicare all'esplorazione. Se filters include un filtro che non esiste attualmente nell'esplorazione, ma fa riferimento a un campo valido, il 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 dall'esplorazione. 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 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 scrollY dell'host dell'applicazione.