Cómo comenzar a usar la incorporación privada

En esta página, se te guiará para configurar la incorporación privada. La opción de incorporación privada requiere que administres el elemento HTML <iframe> directamente para incorporar tu contenido de Looker y que el usuario acceda a Looker por separado de la aplicación host.

Analizaremos este ejemplo de código de incorporación privada:

<iframe
    src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
    width="600"
    height="300"
    frameborder="0">
</iframe>

1. Compila la URL del contenido incorporado

Considera un ejemplo de contenido de Looker en la URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. A partir de esta URL de contenido de Looker, construiremos la URL del contenido incorporado y estableceremos el atributo src del iframe en ella. No dudes en usar tu propia URL de contenido de Looker mientras sigues estos pasos.

La URL del contenido incorporado de la muestra de código anterior es la siguiente:

https://instance.looker.com/embed/dashboards/4?theme=red&Timeframe=14+day

La URL del contenido incorporado consta de tres partes:

  • Nombre de host: Es el nombre de host de tu instancia de Looker.
  • Ruta de acceso: Es la ruta de URL de contenido de Looker con el prefijo /embed (con pasos adicionales para las visualizaciones de consultas).
  • Parámetros: Son los parámetros de URL que especifican filtros y temas.

El protocolo siempre debe ser https://. Compilaremos cada parte en detalle.

Parte 1: Nombre de host

  1. Navega al contenido de Looker. Siguiendo la URL de contenido de Looker de ejemplo: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
  2. El nombre de host de la URL del contenido incorporado es instance.looker.com.

Parte 2: Ruta de acceso

La ruta de URL del contenido incorporado depende del contenido de Looker que incorpores.

Cómo incorporar todo el contenido de Looker, excepto las visualizaciones de consultas

  1. Navega al contenido de Looker. Siguiendo la URL de contenido de Looker de ejemplo: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. Identifica la ruta de acceso de la URL de contenido de Looker: /dashboards/4.
  3. Agrega el prefijo /embed a la ruta de acceso de la URL de contenido de Looker. La ruta de acceso de la URL del contenido incorporado es /embed/dashboards/4.

Cómo incorporar una visualización de consultas

  1. Navega a la visualización de consultas. URL de ejemplo: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
  2. Identifica el ID de cliente de la consulta. El parámetro qid: 1234567890abcdefghij12 es el ID de cliente de la consulta que representa la consulta y la configuración de visualizaciones.
  3. La ruta de URL del contenido incorporado es /embed/query-visualization/ agregada con el ID de cliente de la consulta. La ruta de acceso de la URL del contenido incorporado de ejemplo es /embed/query-visualization/1234567890abcdefghij12

Parte 3: Parámetros

Los parámetros de la URL del contenido incorporado controlan los filtros y los temas del contenido incorporado.

Filtros

  1. Navega a la URL de contenido de Looker.
  2. Ajusta manualmente los filtros del contenido a lo que desees. En este ejemplo, la URL de contenido de Looker resultante es: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Los parámetros de la URL del contenido incorporado son los parámetros de la URL de contenido de Looker, por ejemplo, Timeframe=14+day.

En este ejemplo, el parámetro Timeframe=14+day establece el valor del filtro Timeframe del panel.

Temas

Consulta la guía de temas para obtener información sobre cómo controlar la apariencia del contenido incorporado.

2. Prueba la URL del contenido incorporado

Abre la URL del contenido incorporado en tu navegador para obtener una vista previa del comportamiento y la apariencia del contenido incorporado.

3. Crea tu iframe

  1. Crea el elemento iframe en tu aplicación host.
  2. Establece el atributo src en la URL del contenido incorporado.
  3. Define el width, el height y otros atributos según lo que necesites para mostrar mejor el contenido de Looker incorporado.

4. Considera los problemas de acceso de los usuarios

El usuario debe acceder a Looker para ver el contenido incorporado. El iframe mostrará una página de error 401 si el usuario no está conectado.

Opciones de acceso de los usuarios

El usuario puede acceder a Looker de una de las siguientes maneras:

1. Accede a Looker de antemano

El usuario debe acceder a Looker en el mismo navegador antes de poder ver el contenido incorporado.

2. Habilita una pantalla de acceso de Looker incorporada opcional

Agrega allow_login_screen=true a los parámetros de la URL del contenido incorporado para presentar una pantalla de acceso de Looker en el iframe si el usuario no accedió. Nuestra URL de contenido incorporado de ejemplo se convierte en: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true

Ten en cuenta dos advertencias:

Looker usa cookies para la autenticación de usuarios y el almacenamiento de sesiones. El navegador del usuario debe habilitar las cookies de terceros si el usuario accede al nombre de host de la URL del contenido incorporado de la instancia de Looker en un dominio diferente de la aplicación host.

Algunos navegadores, como Firefox y Safari, usan de forma predeterminada una política de cookies que bloquea las cookies de terceros. Si el navegador del usuario no puede permitir cookies de terceros, puedes agregar un dominio personalizado a tu instancia de Looker para que la aplicación host y el nombre de host de la URL del contenido incorporado de la instancia de Looker residan en el mismo dominio.

5. Interactúa con tu iframe

Comienza a usar la mensajería de publicación de iframe de incorporación de Looker.

Próximos pasos

Comienza a usar la incorporación firmada con nuestro SDK de Embed y consulta ejemplos de lo que puedes hacer con la incorporación de Looker.