Eventos de JavaScript incorporados

Después de crear una incorporación (que se puede hacer de forma pública, privada, con incorporaciones firmadas o mediante la API), puedes usar JavaScript para interactuar con esos iframes. Puedes hacer que tu página sea más dinámica según el estado del elemento incrustado e incluso puedes realizar cambios al elemento incrustado desde tu página web.

Ten en cuenta que Looker no controla el orden en el que los navegadores envían eventos a las aplicaciones web. Esto significa que el orden de los eventos no se garantiza en todos los navegadores o plataformas. Asegúrate de escribir correctamente tu código JavaScript para tener en cuenta el manejo de eventos en diferentes navegadores.

Puedes usar JavaScript de una de las siguientes maneras para el contenido incorporado de Looker:

  • Usa el kit de desarrollo de software (SDK) de Looker de Looker, que se describe en la página de documentación de Embed SDK
  • Uso de eventos de JavaScript, que se describen en la sección Cómo acceder a eventos en JavaScript de esta página

Preparación

Antes de interactuar con el iframe incorporado, sigue estos pasos:

Agrega un ID al iframe

Más adelante, cuando recupes los datos del iframe, tendrás que validar que la información con la que trabajas realmente provenga del iframe de Looker. Para facilitar este proceso, si aún no lo hiciste, asegúrate de agregar un ID al iframe. En el siguiente ejemplo, se agrega id="looker" al iframe para configurar el ID como looker:

<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>

Agrega el dominio de incorporación al atributo src de iframe

En el atributo src del iframe, incluye el dominio en el que se usa el iframe. En el siguiente ejemplo, puedes especificar myownpersonaldomain.com como el dominio agregando ?embed_domain=https://myownpersonaldomain.com" al final de la URL en el atributo src:

<iframe
  id="looker"
  src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com">
</iframe>

Si usas la incorporación firmada, asegúrate de agregar el embed_domain a la URL de incorporación.

Si usas el SDK de incorporación, agrega sdk=2 al final de la URL de incorporación. El parámetro sdk=2 indica que el SDK está presente y que Looker puede aprovechar las funciones adicionales que proporciona el SDK, como pasar eventos de JavaScript entre el iframe de Looker y tu dominio. El SDK no puede agregar este parámetro por sí mismo porque forma parte de la URL firmada. Por ejemplo:

<iframe
  id="looker"
  src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com&sdk=2">
</iframe>

Agrega el dominio de incorporación a la lista de entidades permitidas

Por último, deberás agregar el dominio en el que se usa el iframe a la lista de entidades permitidas en la página Incorporar del panel Administrador de Looker siguiendo estos pasos:

  1. En el campo Lista de entidades permitidas del dominio incorporado, ingresa el dominio en el que se usa el iframe y, luego, presiona la tecla Tab para que el dominio aparezca en un cuadro dentro del campo.

  2. Haga clic en Update.

Puedes usar el comodín * en la lista de entidades permitidas para crear un patrón de dominio. Por ejemplo, https://*.myownpersonaldomain.com permitiría https://analytics.myownpersonaldomain.com y https://data.myownpersonaldomain.com.

Si usas la incorporación sin cookies con Looker 23.8 o una versión posterior, se puede especificar el dominio de incorporación cuando se adquiere la sesión sin cookies. Esta es una alternativa a agregar el dominio de incorporación a la lista de entidades permitidas desde el panel Administrador > Incorporar. Si decides aprovechar esta función, revisa las prácticas recomendadas de seguridad.

Cómo recuperar datos del iframe

Después de completar los pasos de preparación, podrás acceder a los eventos que se pasan entre el iframe de Looker y tu dominio escuchando los eventos de postMessage.

El iframe incorporado puede crear algunos tipos de eventos, como se describe en la sección Referencia de tipos de eventos en esta página.

Accede a eventos en JavaScript

A continuación, se muestra un ejemplo de cómo escuchar estos eventos en JavaScript nativo y, luego, registrarlos en la consola:

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));
    }
  }
});

A continuación, te mostramos un ejemplo de cómo escuchar estos eventos en jQuery y, luego, registrarlos en la consola:

$(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));
    }
  }
});

Tabla de resumen de los tipos de eventos

En la siguiente tabla, se resumen los tipos de eventos. Selecciona un tipo de evento para ver sus detalles.

Tipo de evento Causa del evento
dashboard:loaded En los paneles en los que los mosaicos no están configurados para ejecutarse automáticamente, se cargaron un panel y sus elementos, pero aún no se ejecutan las consultas.
dashboard:run:start Un panel comenzó a cargarse y sus mosaicos comenzaron a cargar y consultar datos.
dashboard:run:complete Se terminó de ejecutar un panel y se cargaron y consultaron todos los mosaicos.
dashboard:download Se inició la descarga de un PDF de un panel.
dashboard:edit:start SE AGREGÓ 22.20 Se cambió un panel al modo de edición. El evento dashboard:save:complete se activará cuando el panel se guarde correctamente.
dashboard:edit:cancel AGREGA 22.20 Un panel que está en modo de edición salió del modo de edición sin guardar.
dashboard:save:complete Se editó y guardó un panel.
dashboard:delete:complete Se borró un panel.
dashboard:tile:start Una tarjeta comenzó a cargar o consultar datos.
dashboard:tile:complete Una tarjeta terminó de ejecutar la consulta.
dashboard:tile:download Se comenzaron a descargar los datos de una tarjeta.
dashboard:tile:explore Un usuario hizo clic en la opción Explore from Here en un mosaico del panel.
dashboard:tile:view Un usuario hizo clic en la opción Ver vista original en un mosaico de un panel.
dashboard:filters:changed Se aplicaron o cambiaron los filtros de un panel.
look:ready Una vista comenzó a cargar datos de consultas, ya sea que se ejecuten o no.
look:run:start Una vista comenzó a cargar datos de consultas y esta comenzó a ejecutarse.
look:run:complete Una vista terminó de ejecutar la consulta.
look:save:complete Se editó y guardó una vista.
look:delete:complete Se movió una vista a la carpeta Papelera.
drillmenu:click Un usuario hizo clic en un menú de desglose de un panel que se creó con el parámetro link de LookML.
drillmodal:download Un usuario abrió un cuadro de diálogo de desglose de un mosaico del panel y, luego, hizo clic en la opción Descargar.
drillmodal:explore Un usuario hizo clic en la opción Explore From Here en un cuadro de diálogo.
explore:ready Una exploración comenzó a cargar datos de consultas, independientemente de si estas se ejecutarán o no.
explore:run:start La exploración comenzó a cargar los datos de la consulta y esta comenzó a ejecutarse.
explore:run:complete Una exploración terminó de ejecutar la consulta.
explore:state:changed La URL de una página de Explorar cambió debido a las acciones del usuario.
page:changed Un usuario navegó a una nueva página dentro del iframe.
page:properties:changed Cambió la altura de un iframe del panel.
session:tokens El cliente de Looker requiere tokens para continuar.
session:status Envía información sobre el estado de una sesión.
env:client:dialog Se abrió un cuadro de diálogo que puede estar parcialmente fuera de vista, como un cuadro de diálogo de desglose. Este evento permite que la aplicación host se desplace por el cuadro de diálogo para verlo.

Referencia de tipo de evento

El iframe incorporado puede crear muchos tipos diferentes de eventos:

dashboard:loaded

En los paneles en los que los mosaicos no están configurados para ejecutarse automáticamente, este evento se crea después de que se cargan un panel y sus elementos, pero antes de que se ejecuten las consultas.


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"
        }
      }
    }
  }
}
Atributo Formato Descripción
status String Indica si el panel y sus elementos se cargaron correctamente.
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String La URL del panel completa.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.options Objeto Propiedades y valores del diseño del panel, del componente de diseño del panel y del elemento de panel. Todas las propiedades que se muestran en el objeto options pueden recibir valores actualizados mediante el evento dashboard:options:set.

dashboard:run:start

Este evento se crea cuando un panel comienza a cargarse, cuando sus mosaicos comienzan a cargar y consultar datos.

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"
  }
}
Atributo Formato Descripción
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.absoluteUrl String La URL del panel completa.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:run:complete

Este evento se crea cuando termina de ejecutarse un panel y se terminan de cargar y consultar todos los mosaicos. Este evento se crea aunque todos los mosaicos se carguen correctamente o no.

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"
        }
      }
    }
  }
}
Atributo Formato Descripción
status String Indica si el panel y sus elementos se ejecutaron correctamente. Si el panel y sus elementos se ejecutaron correctamente, status muestra "complete"; de lo contrario, status muestra "error". Si se detuvo el panel en ejecución, ya sea desde la interfaz de usuario o con la acción dashboard:stop, status mostrará "stopped".
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.absoluteUrl String La URL del panel completa.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options Objeto Propiedades y valores del diseño del panel, del componente de diseño del panel y del elemento de panel. Todas las propiedades que se muestran en el objeto options pueden recibir valores actualizados mediante la acción dashboard:options:set.
dashboard.tileStatuses Array de objetos Es un array de objetos que proporcionan estados de tarjetas. Las propiedades del objeto son las siguientes:

  • tileId: Es el número de ID del mosaico.
  • status: Si la consulta de mosaicos se ejecutó correctamente, status muestra "complete"; de lo contrario, status muestra "error".
  • errors: Se propaga cuando la propiedad status es "error". Un array de objetos que proporciona detalles sobre el error, como el texto del mensaje de error, una descripción más detallada del error y la consulta en SQL de la tarjeta que produjo el error.

dashboard:download

Este evento se crea cuando se comienza a descargar un PDF de un panel.

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"
Atributo Formato Descripción
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.absoluteUrl String La URL del panel completa.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
fileFormat String El formato del panel descargado (solo "pdf" en este momento).

dashboard:edit:start

SE AGREGA 22.20 Este evento se crea cuando se cambia al modo de edición de un panel.

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"
  }
}
Atributo Formato Descripción
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.absoluteUrl String La URL del panel completa.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:edit:cancel

AGREGA 22.20 Este evento se crea cuando un panel que está en modo de edición sale del modo de edición sin guardar.

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"
  }
}
Atributo Formato Descripción
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.absoluteUrl String La URL del panel completa.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:save:complete

Este evento se crea cuando un panel se edita y, luego, se guarda.

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"
        }
      }
    }
  }
}
Atributo Formato Descripción
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String La URL del panel completa.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.options Objeto Propiedades y valores del diseño del panel, del componente de diseño del panel y del elemento de panel. Todas las propiedades que se muestran en el objeto options pueden recibir valores actualizados mediante el evento dashboard:options:set.

dashboard:delete:complete

Este evento se crea cuando se borra un panel.

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"
        }
      }
    }
  }
}
Atributo Formato Descripción
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String La URL del panel completa.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.options Objeto Propiedades y valores del diseño del panel, del componente de diseño del panel y del elemento de panel. Todas las propiedades que se muestran en el objeto options pueden recibir valores actualizados mediante el evento dashboard:options:set.

dashboard:tile:start

Este evento se crea cuando una tarjeta comienza a cargar o consultar datos.

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"
  }
}
Atributo Formato Descripción
dashboard.id Número/cadena Es el ID del panel al que pertenece el mosaico.
dashboard.title String El título del panel, como se muestra en la parte superior del panel al que pertenece el mosaico.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta) a la que pertenece el mosaico.
dashboard.absoluteUrl String La URL completa del panel al que pertenece el mosaico.
dashboard.dashboard_filters Objeto Son los filtros que se aplican al panel al que pertenece el mosaico. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer El número de ID del evento, no del mosaico.
tile.title String Es el título del mosaico, como se muestra en la parte superior.
tile.listen Objeto Los filtros del panel global que escucha este mosaico. Este objeto tiene el formato: {"Filter Label": "Filter Field", ...}

dashboard:tile:complete

Este evento se crea cuando un mosaico termina de ejecutar la consulta.

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"
  }
}
Atributo Formato Descripción
dashboard.id Número/cadena Es el ID del panel al que pertenece el mosaico.
dashboard.title String El título del panel, como se muestra en la parte superior del panel al que pertenece el mosaico.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta) a la que pertenece el mosaico.
dashboard.absoluteUrl String La URL completa del panel al que pertenece el mosaico.
dashboard.dashboard_filters Objeto Son los filtros que se aplican al panel al que pertenece el mosaico. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
status String Indica si la consulta de mosaicos se completó correctamente. Los valores posibles son "complete" o "error".
truncated Booleano Indica si los resultados de la consulta de mosaicos se truncaron como resultado de que la consulta mostró más filas que el límite de filas de la consulta. El límite de filas puede ser un límite de filas especificado por el usuario o el límite de filas predeterminado de Looker de 5,000.
tile.id Integer El número de ID del evento, no del mosaico.
tile.title String Es el título del mosaico, como se muestra en la parte superior.
tile.listen Objeto Los filtros del panel global que escucha este mosaico. Este objeto tiene el formato: {"Filter Label": "Filter Field", ...}
tile.errors Array de objetos Se propaga cuando la propiedad status es "error". Un array de objetos que proporciona detalles sobre el error, como el texto del mensaje de error, una descripción más detallada del error y la consulta en SQL de la tarjeta que produjo el error.

dashboard:tile:download

Este evento se crea cuando comienzan a descargarse los datos de una tarjeta.

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"
Atributo Formato Descripción
dashboard.id Número/cadena Es el ID del panel al que pertenece el mosaico.
dashboard.title String El título del panel, como se muestra en la parte superior del panel al que pertenece el mosaico.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta) a la que pertenece el mosaico.
dashboard.absoluteUrl String La URL completa del panel al que pertenece el mosaico.
dashboard.dashboard_filters Objeto Son los filtros que se aplican al panel al que pertenece el mosaico. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer El número de ID del evento, no del mosaico.
tile.title String Es el título del mosaico, como se muestra en la parte superior.
tile.listen Objeto Los filtros del panel global que escucha este mosaico. Este objeto tiene el formato: {"Filter Label": "Filter Field", ...}
fileFormat String Es el formato de la tarjeta descargada (solo "pdf" en este momento).

dashboard:tile:explore

Este evento se crea cuando un usuario hace clic en la opción Explorar desde aquí en un mosaico del panel.

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"
  }
}
Atributo Formato Descripción
label String La etiqueta del botón.
url String Es la URL relativa (solo la ruta) de la exploración que se mostrará.
dashboard.id Número/cadena Es el ID del panel al que pertenece el mosaico.
dashboard.title String El título del panel, como se muestra en la parte superior del panel al que pertenece el mosaico.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta) a la que pertenece el mosaico.
dashboard.absoluteUrl String La URL completa del panel al que pertenece el mosaico.
dashboard.dashboard_filters Objeto Son los filtros que se aplican al panel al que pertenece el mosaico. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer El número de ID del evento, no del mosaico.
tile.title String Es el título del mosaico, como se muestra en la parte superior.
tile.listen Objeto Los filtros del panel global que escucha este mosaico. Este objeto tiene el formato: {"Filter Label": "Filter Field", ...}

dashboard:tile:view

Este evento se crea cuando un usuario hace clic en la opción Ver vista original en un mosaico del panel.

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"
  }
}
Atributo Formato Descripción
label String La etiqueta del botón.
url String La URL relativa (solo la ruta) de la vista que se mostrará.
dashboard.id Número/cadena Es el ID del panel al que pertenece el mosaico.
dashboard.title String El título del panel, como se muestra en la parte superior del panel al que pertenece el mosaico.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta) a la que pertenece el mosaico.
dashboard.absoluteUrl String La URL completa del panel al que pertenece el mosaico.
dashboard.dashboard_filters Objeto Son los filtros que se aplican al panel al que pertenece el mosaico. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer El número de ID del evento, no del mosaico.
tile.title String Es el título del mosaico, como se muestra en la parte superior.
tile.listen Objeto Los filtros del panel global que escucha este mosaico. Este objeto tiene el formato: {"Filter Label": "Filter Field", ...}

dashboard:filters:changed

Este evento se crea cuando se aplican o cambian los filtros de un panel.

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"
        }
      }
    }
  }
}
Atributo Formato Descripción
dashboard.id Número/cadena El ID del panel.
dashboard.title String El título, como se muestra en la parte superior del panel.
dashboard.canEdit Booleano SE AGREGA 22.20 Con true, el usuario puede editar el panel.
dashboard.url String La URL del panel relativa (solo la ruta de acceso).
dashboard.absoluteUrl String La URL del panel completa.
dashboard.dashboard_filters Objeto Los filtros que se aplican al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options Objeto Propiedades y valores del diseño del panel, del componente de diseño del panel y del elemento de panel. Todas las propiedades que se muestran en el objeto options pueden recibir valores actualizados mediante el evento dashboard:options:set.

look:ready

Este evento se crea cuando una vista comienza a cargar datos de consultas, independientemente de si se ejecuta o no.

type: "look:ready",
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Atributo Formato Descripción
look.url String La URL de vista relativa (solo la ruta de acceso)
look.absoluteUrl String La URL de la vista completa

look:run:start

Este evento se crea cuando una vista comienza a cargar datos de la consulta y esta comienza a ejecutarse.

type: "look:run:start",
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Atributo Formato Descripción
look.url String La URL de vista relativa (solo la ruta de acceso)
look.absoluteUrl String La URL de la vista completa

look:run:complete

Este evento se crea cuando una vista termina de ejecutar la consulta.

type: look:run:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Atributo Formato Descripción
look.url String La URL de vista relativa (solo la ruta de acceso)
look.absoluteUrl String La URL de la vista completa

look:save:complete

Este evento se crea cuando se edita y guarda una vista. Este evento se crea cuando un usuario realiza una de las siguientes tareas:

Este evento no se crea si la vista se guarda con las opciones de menú Guardar > En el panel existente o Editar configuración.

type: look:save:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  folderid: 123
  }
}
Atributo Formato Descripción
look.url String La URL de vista relativa (solo la ruta de acceso)
look.absoluteUrl String La URL de la vista completa
look.folderid Integer El ID de carpeta en el que se almacena la vista

look:delete:complete

Este evento se crea cuando una vista se mueve a la carpeta Papelera.

type: look:delete:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Atributo Formato Descripción
look.url String La URL de vista relativa (solo la ruta de acceso)
look.absoluteUrl String La URL de la vista completa

drillmenu:click

Este evento se crea cuando un usuario hace clic en un menú de desglose en un panel creado con el parámetro link de LookML. Por ejemplo, el siguiente LookML crea un menú de desglose en el que un usuario puede ver los datos filtrados por la dimensión 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"
  }
}

Cuando el filtro state se establece en Illinois, el evento drillmenu:click muestra lo siguiente en el host del iframe:

type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
Atributo Formato Descripción
label String La etiqueta del vínculo como se muestra en el menú de desglose
link_type String El tipo de objeto en el destino del vínculo
modal Booleano Si se usará el cuadro de diálogo de taladro en lugar de la navegación del navegador
target String Es _self si el destino del vínculo reemplazará el iframe actual y _blank si el destino del vínculo abrirá una ventana nueva.
url String La URL del destino del vínculo
context String Atributo interno que se usa en algunos tipos de visualizaciones

Si se está en la zona de pruebas del iframe, no se podrán abrir los clics en el menú de desglose en una ventana nueva. Usa estos valores de zona de pruebas dentro de la etiqueta de iframe:

sandbox = "allow-same-origin allow-scripts"

drillmodal:download

Este evento se crea cuando un usuario abre un cuadro de diálogo de desglose desde un mosaico del panel y hace clic en la opción Descargar.

{
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"
}
Atributo Formato Descripción
dashboard.id Número/cadena Es el ID del panel al que pertenece el mosaico.
dashboard.title String El título del panel, como se muestra en la parte superior del panel al que pertenece el mosaico.
dashboard.url String La URL del panel relativa (solo la ruta) a la que pertenece el mosaico.
dashboard.absoluteUrl String La URL completa del panel al que pertenece el mosaico.
dashboard.dashboard_filters Objeto Son los filtros que se aplican al panel al que pertenece el mosaico. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
drillExploreUrl String La URL de exploración relativa (solo la ruta) que se descargará.
fileFormat String El formato de archivo de la descarga de datos.

drillmodal:explore

Este evento se crea cuando un usuario hace clic en la opción Explorar desde aquí en un cuadro de diálogo.

type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Atributo Formato Descripción
label String La etiqueta del botón como se muestra en el menú de desglose
url String La URL de exploración relativa (solo la ruta) que se debe ver

explore:ready

Este evento se crea cuando una exploración comienza a cargar datos de una consulta, independientemente de si se ejecuta o no.

type: "explore:ready",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Atributo Formato Descripción
explore.url String La URL de exploración relativa (solo la ruta)
explore.absoluteUrl String La URL completa de Explorar

explore:run:start

Este evento se crea cuando una exploración comienza a cargar datos de la consulta y esta comienza a ejecutarse.

type: "explore:run:start",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Atributo Formato Descripción
explore.url String La URL de exploración relativa (solo la ruta)
explore.absoluteUrl String La URL completa de Explorar

explore:run:complete

Este evento se crea cuando una exploración termina de ejecutar la consulta.

type: "explore:run:complete",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Atributo Formato Descripción
explore.url String La URL de exploración relativa (solo la ruta)
explore.absoluteUrl String La URL completa de Explorar

explore:state:changed

Este evento se crea cuando la URL de una página Explorar cambia como resultado de las acciones del usuario.

type: "explore:state:changed",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
Atributo Formato Descripción
explore.url String La URL de exploración relativa (solo la ruta)
explore.absoluteUrl String La URL completa de Explorar

page:changed

Este evento se crea cuando un usuario navega a una página nueva dentro del iframe.

type: "page:changed",
page: {
  type: "dashboard",
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
Atributo Formato Descripción
page.type String Indica el tipo de página a la que se acaba de navegar, como "dashboard", "look" o "explore".
page.url String La URL relativa (solo la ruta de acceso) de la página a la que se acaba de navegar
page.absoluteUrl String La URL completa de la página a la que se acaba de navegar

page:properties:changed

Este evento se crea cuando cambia la altura de un iframe del panel. No está disponible para las vistas ni las exploraciones porque esos elementos ajustan automáticamente su altura al tamaño del iframe.

type: "page:properties:changed",
height: 1000
Atributo Formato Descripción
height Integer La altura del iframe del panel en píxeles

session:tokens

Este evento indica que el cliente de Looker requiere tokens para continuar. Este evento se crea inmediatamente después de que se crea el iframe y, luego, periódicamente mientras dure la sesión.

{
  "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
}
Atributo Formato Descripción
authentication_token String Token de autenticación Se incluye cuando se crea el iframe. No se incluye en la respuesta a una solicitud para generar tokens o si la sesión venció.
authentication_token_ttl Número Tiempo de actividad del token de autenticación en segundos. Se incluye cuando se crea el iframe. No se incluye en la respuesta a una solicitud para generar tokens o si la sesión venció.
api_token String token de API. No se incluye si la sesión venció.
api_token_ttl Número Tiempo de actividad del token de API en segundos. No se incluye si la sesión venció.
navigation_token String Token de navegación. No se incluye si la sesión venció.
navigation_token_ttl Número Tiempo de actividad del token de navegación en segundos. No se incluye si la sesión venció.
session_references_token_ttl Número Tiempo de actividad de la sesión en segundos. El valor será 0 cuando la sesión caduque. Para la recuperación, la aplicación de incorporación debe adquirir una nueva sesión.

session:status

El evento se genera cuando la aplicación de Looker incorporada controla las solicitudes de tokens de sesión.

{
  "type": "session:status",
  "session_ttl": 0,
  "expired": true,
  "interrupted": false
}
Atributo Formato Descripción
session_ttl Número Tiempo de actividad de la sesión en segundos.
expired Booleano Cuando es true, indica que la sesión venció.
interrupted Booleano Cuando es true, indica que no se respondió una solicitud de tokens de sesión. Esto podría indicar que un servidor no está disponible temporalmente.
recoverable Booleano Solo se completa cuando se interrumpe es de true. Indica si la sesión se puede recuperar o no. Un valor de false probablemente significa que hay un problema con la aplicación de incorporación.

env:client:dialog

El evento se genera cuando se abre un cuadro de diálogo que puede estar parcialmente fuera de vista, como un cuadro de diálogo de desglose. Este evento permite que la aplicación de hosting desplace el cuadro de diálogo para verlo con la acción env:host:scroll.

{
  type: "env:client:dialog",
  dialogType: 'drilling',
  placement: 'cover',
  open: true
}
Atributo Formato Descripción
type String env:client:dialog indica que se abrió o cerró un cuadro de diálogo. Actualmente, solo se admite el cuadro de diálogo de desglose, pero es posible que se agreguen otros en el futuro. Es posible que la parte superior del cuadro de diálogo de desglose no esté a la vista, ya que el cuadro de diálogo cubre el viewport del iframe. Este evento permite que la aplicación host se desplace por la parte superior del cuadro de diálogo para verlo.
dialogType String Indica el tipo de cuadro de diálogo. Actualmente, solo la apertura o el cierre del tipo de diálogo de "profundización" activa este evento.
placement String Es la ubicación del diálogo. Los cuadros de diálogo del tipo "perforación" siempre usan un placement de "cover".
open Booleano Indica si el diálogo se abrió o se desplazó.

Realiza cambios en el iframe

Una vez que hayas preparado tu iframe para la recuperación de datos, puedes realizar cambios en el iframe. Para ello, sigue estos pasos:

  1. Escribe tu solicitud en JSON.
  2. Publica la solicitud en el contentWindow del iframe.

Escribe tu solicitud en JSON

Puedes realizar varios cambios en el iframe, y debes enviarlos en formato JSON. Las opciones disponibles se describen en la sección Referencia de acciones en esta página. No olvides usar JSON.stringify para convertir tu acción en JSON, de la siguiente manera:

var my_request = JSON.stringify(
  {
    type: "dashboard:run"
  }
);

Cómo publicar la solicitud en la propiedad contentWindow del iframe

Por último, publica el mensaje en la contentWindow del iframe, de la siguiente manera:

var my_iframe = document.getElementById("my_iframe_id");

my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');

Tabla de resumen de acciones

En la siguiente tabla, se resumen las acciones. Selecciona una acción para ver sus detalles.

Acción Descripción de la acción
dashboard:load Carga un panel nuevo en el iframe y reemplaza un panel existente.
dashboard:run Ejecuta el panel en el iframe.
dashboard:edit SE AGREGA 22.20 Cambia el panel al modo de edición.
dashboard:filters:update Actualiza un filtro de panel existente en el iframe.
dashboard:options:set Escribe valores nuevos en el diseño del panel y las propiedades de los elementos del panel.
dashboard:schedule_modal:open Abre el programador, que permite a los usuarios entregar contenido de Looker a varios destinos.
dashboard:stop Detiene un panel que se ejecuta o vuelve a cargar datos.
look:run Ejecuta la vista en el iframe.
look:filters:update Actualiza un filtro de vista existente en el iframe.
explore:run Ejecuta la función Explorar en el iframe.
explore:filters:update Actualiza o quita un filtro Explorar existente en el iframe.
session:tokens:request Envía tokens en respuesta a un evento session:tokens:request.
env:host:scroll Envía información sobre la posición actual de desplazamiento del iframe del host a la aplicación de Looker incorporada.

Referencia de acción

Estas son las acciones disponibles que puedes publicar en el iframe incorporado:

dashboard:load

Usa esta acción para cargar un panel nuevo en el iframe que reemplace un panel existente. El nuevo panel comenzará a ejecutar consultas como si se hubiera abierto una nueva página del panel.

{
  type: "dashboard:load",
  id: "101",
  pushHistory: false
}
Atributo Formato Descripción
type String El uso del tipo dashboard:load indica que deseas cargar un panel nuevo en el iframe.
id String El ID del panel que se cargará.
pushHistory Booleano Si es true, el panel cargado crea una nueva entrada del historial del navegador, y el usuario puede usar el botón Atrás del navegador para volver al panel anterior. Si es false, se reemplaza el panel actual y no se puede usar la navegación del navegador para regresar a él.

dashboard:run

Usa esta acción para ejecutar el panel en el iframe. Esta acción es la misma que presionar el botón Run o Reload Data del panel.

{
  type: "dashboard:run"
}
Atributo Formato Descripción
type String Usar el tipo dashboard:run indica que deseas ejecutar el panel.

dashboard:edit

SE AGREGA 22.20 Usa esta acción para cambiar un panel existente en el iframe al modo de edición. Esta acción es la misma acción que seleccionar Editar panel en el menú del panel.

{
  type: "dashboard:edit"
}
Atributo Formato Descripción
type String El uso del tipo dashboard:edit indica que deseas cambiar el panel al modo de edición.

dashboard:filters:update

Usa esta acción para actualizar un filtro de panel existente en el iframe. No puedes agregar un filtro nuevo al panel con este método.

{
  type: "dashboard:filters:update",
  filters: {
    "Sale date": "Last 28 days",
    "Sale amount": "Greater than 100"
  }
}
Atributo Formato Descripción
type String Usar el tipo dashboard:filters:update indica que deseas actualizar los filtros que usa el panel.
filters Objeto Los filtros nuevos que deseas aplicar al panel. Este objeto tiene el formato: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:options:set

Esta acción está disponible después de que ocurre el evento dashboard:run:complete.

La incorporación crea el mensaje y lo envía al iframe, pero el panel no responde hasta después de que ocurre dashboard:run:complete. La acción dashboard:options:set escribe valores nuevos en el diseño del panel y las propiedades de los elementos del panel. Solo las propiedades que se mostraron en el atributo options del evento dashboard:run:complete se pueden actualizar con dashboard:options:set. Se ignorarán las propiedades establecidas que el atributo options del evento dashboard:run:complete no haya devuelto antes.

{
  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"
      }
    }
  }
}
Atributo Formato Descripción
type String Usar el tipo dashboard:options:set indica que deseas escribir valores nuevos en el diseño del panel y las propiedades de los elementos del panel.
layouts Objeto Las propiedades de diseño del panel que muestra el atributo options en el evento dashboard:run:complete. Tendrán un formato similar al siguiente:

  • id: "string",
  • dashboard_id: "string",
  • type: "newspaper",
  • active: boolean,
  • column_width: number,
  • width: number
layouts.dashboard_layout_components Objeto Uno o más objetos del componente de diseño del panel que muestra el atributo options en el evento dashboard:run:complete Tendrán un formato similar al siguiente:

  • id: "string",
  • dashboard_layout_id: "string",
  • dashboard_element_id: "string",
  • row: number,
  • column: number,
  • width: number,
  • height: number,
  • deleted: boolean,
elements Objeto Uno o más objetos dashboard element que muestra el atributo options en el evento dashboard:run:complete Tendrán un formato similar al siguiente:

id: {

  title: "string",

  title_hidden: boolean,

  vis_config: {

    type: "string", title: "string"

  }

}

dashboard:schedule_modal:open

Usa esta acción para abrir el programador, que les permite a los usuarios publicar contenido de Looker a varios destinos.

{
  type: "dashboard:schedule_modal:open"
}
Atributo Formato Descripción
type String Si usas el tipo dashboard:schedule_modal:open, indicas que deseas abrir el cuadro de diálogo Programa.

dashboard:stop

Usa esta acción para detener un panel que esté ejecutando o volviendo a cargar datos. Esta acción es la misma que hacer clic en el botón Cancel en el panel. Un panel que deja de usar dashboard:stop envía un evento dashboard:run:complete con status: establecido en "stopped".

{
  type: "dashboard:stop"
}
Atributo Formato Descripción
type String Usar el tipo dashboard:stop indica que deseas detener la ejecución del panel.

look:run

Usa esta acción para ejecutar la consulta en la que se basa la vista en el iframe. Esta acción es similar a presionar el botón Run en la vista, con la excepción de que look:run siempre consulta la base de datos directamente y no recupera datos de la caché de Looker.

{
  type: "look:run"
}
Atributo Formato Descripción
type String Usar el tipo look:run indica que quieres ejecutar la vista.

look:filters:update

Usa esta acción para actualizar un filtro de vista existente en el iframe. No puedes agregar un filtro nuevo a la vista con este método.

{
  type: "look:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "products.department": "sweaters"
  }
}
Atributo Formato Descripción
type String Usar el tipo look:filters:update indica que quieres actualizar los filtros que usa la vista.
filters Objeto Los filtros nuevos que quieras aplicar a la vista. Este objeto tiene el formato: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}

explore:run

Usa esta acción para ejecutar Explorar en el iframe. Esta acción es similar a presionar el botón Run en Explorar, con la excepción de que explore:run siempre consulta la base de datos directamente y no recupera datos de la caché de Looker.

{
  type: "explore:run"
}
Atributo Formato Descripción
type String Usar el tipo explore:run indica que deseas ejecutar la exploración.

explore:filters:update

Usa esta acción para actualizar o quitar un filtro de Explorar existente en el iframe. Si incluyes un filtro nuevo que haga referencia a un campo válido, el filtro nuevo se agregará a Explorar.

{
  type: "explore:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "orders.status": "complete"
  }
  deleteFilters:  ["products.department"]
}
Atributo Formato Descripción
type String Si usas el tipo explore:filters:update, indicas que deseas actualizar los filtros que usa Explorar.
filters Objeto Los filtros nuevos que quieres aplicar a Explorar. Si filters incluye un filtro que no existe actualmente en Explorar, pero que hace referencia a un campo válido, se agregará ese filtro a Explorar. Este objeto tiene el formato: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}
deleteFilters Array Los filtros existentes que quieres quitar de Explorar. El array tiene el siguiente formato: ["view_name.field_name_1", "view_name.field_name_2", ...]

session:tokens:request

Usa esta acción para enviar tokens en respuesta a una solicitud session:tokens:request.

{
  type: "session:tokens:request",
}
Atributo Formato Descripción
type String El uso del tipo session:tokens:request indica que quieres enviar tokens en respuesta a un evento session:tokens:request.

env:host:scroll

Usa esta acción para enviar información sobre la posición actual de desplazamiento del iframe del host a la aplicación de Looker incorporada.

{
  type: "env:host:scroll",
  offsetTop: 10,
  offsetLeft: 10,
  scrollX: 5,
  scrollY: 5
}
Atributo Formato Descripción
type String El uso del tipo env:host:scroll indica que quieres enviar información sobre la posición actual de desplazamiento del iframe del host a la aplicación de Looker incorporada.
offsetTop Número El desplazamiento superior del iframe.
offsetLeft Número El desplazamiento a la izquierda del iframe.
scrollX Número La posición desplazamientoX del host de la aplicación.
scrollY Número La posición de desplazamiento del host de la aplicación.