Cómo comenzar a usar la incorporación privada

En esta página, se explica cómo 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 de contenido incorporado y configuraremos el atributo src del iframe. No dudes en usar tu propia URL de contenido de Looker mientras sigues estos pasos.

A continuación, se muestra la URL del contenido incorporado de la muestra de código anterior:

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

La URL del contenido incorporado tiene tres partes:

  • Nombre de host: El nombre de host de tu instancia de Looker
  • Ruta: ruta de URL del contenido de Looker con el prefijo /embed (con pasos adicionales para visualizar consultas)
  • Parámetros: Parámetros de URL que especifican filtros y temas

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

Parte 1: Nombre de host

  1. Navega a tu contenido de Looker. Sigue la URL de contenido de ejemplo de Looker: 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.

Incorporar todo el contenido de Looker, excepto las visualizaciones de consultas

  1. Navega a tu 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 tu URL de contenido de Looker. La ruta de acceso de la URL del contenido incorporado es /embed/dashboards/4.

Incorporar una visualización de consulta

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

Parte 3: Parámetros

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

Filtros

  1. Navega a la URL de tu contenido de Looker.
  2. Ajusta manualmente los filtros del contenido según lo que quieras. En este ejemplo, la URL de contenido de Looker resultante es: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Tus parámetros de URL de contenido incorporado son los 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 saber cómo controlar la apariencia del contenido incorporado.

2. Prueba la URL de tu 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. Configura el atributo src en la URL del contenido incorporado.
  3. Define width, height y otros atributos según lo que necesites para mostrar mejor tu contenido de Looker incorporado.

4. Considera los problemas de acceso de los usuarios

El usuario debe haber accedido a Looker para ver tu contenido incorporado. El iframe mostrará una página de error 401 si el usuario no accedió.

Opciones de acceso del usuario

El usuario puede acceder a Looker de una de estas dos maneras:

1. Accede a Looker de antemano

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

2. Habilitar una pantalla de acceso opcional de Looker para incorporar

Agrega allow_login_screen=true a los parámetros de URL de contenido incorporado para presentar una pantalla de acceso de Looker en el iframe si el usuario no accedió a su cuenta. Nuestro ejemplo de URL de contenido incorporado es: 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 accede a la URL de contenido incorporado de tu instancia de Looker cuyo nombre de host se encuentra en un dominio diferente al de tu aplicación host.

Algunos navegadores, como Firefox y Safari, utilizan 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 tu aplicación host y la instancia de Looker del nombre de host de la URL del contenido incorporado residan en el mismo dominio.

5. Cómo interactuar con tu iframe

Comienza con los mensajes posteriores a la incorporación de iframe en Looker.

Próximos pasos

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