Compartir a través de

Inserción de un panel

En este artículo se explica cómo insertar un panel de INTELIGENCIA ARTIFICIAL o BI en un sitio web o aplicación externo. Un administrador del área de trabajo debe definir posibles superficies de inserción antes de que se puedan insertar paneles. Para más información sobre cómo configurar el área de trabajo Administrar la inserción del panel.

Los usuarios con al menos el permiso CAN EDIT pueden generar código iframe para un panel desde el cuadro de diálogo Compartir . Toda la configuración de uso compartido del panel publicado permanece en vigor. Solo los usuarios a los que se les ha concedido acceso explícitamente pueden ver los paneles incrustados. Consulte Uso compartido de un panel para obtener más información sobre el uso compartido de paneles. Los paneles incrustados siguen la misma cadencia de caché y actualización que todos los demás paneles. Consulte Almacenamiento en caché y actualización de datos.

Generación de código para insertar

Para insertar un panel, siga estos pasos:

  1. Abra un panel publicado que desee insertar. Consulte Visualización y organización de paneles para obtener información sobre cómo ver y acceder a los paneles del área de trabajo.

  2. Haga clic en Compartir en la esquina superior derecha.

  3. Haga clic en Insertar panel en el cuadro de diálogo Compartir .

  4. Se abre un cuadro de diálogo Copiar código para insertar . Si existe una lista de dominios de inserción permitidos, se muestra una lista de estos. Haga clic en el icono Copiar para copiar el fragmento de código.

    El cuadro de diálogo Copiar código para insertar muestra el código iframe generado y los dominios en los que se pueden insertar paneles publicados.

  5. Inserte el código para insertar en cualquier plataforma o aplicación que admita la inserción HTML y pueda representar contenido de iframe. Vea Ejemplos.

Nota:

Si el cuadro de diálogo Copiar código para insertar incluye una lista de dominios permitidos que no incluyen el dominio de destino, un administrador del área de trabajo puede agregarlo. Consulte Administrar inserción de paneles.

Ejemplos

En los ejemplos siguientes se incluyen instrucciones paso a paso para insertar los paneles en una aplicación. Cada conjunto de instrucciones supone que ya ha copiado el código para insertar descrito en la sección anterior.

Inserción en Confluence

El código de inserción generado requiere un pequeño ajuste para cumplir los requisitos de Confluence. Para insertar el panel en una página de Confluence, complete los pasos siguientes:

  1. Edite el código para insertar para incluir solo la dirección URL generada, no las etiquetas iframe ni los valores de marcado adicionales.

    Antes de editarlo, el código para insertar incluye una etiqueta HTML de iframe, un vínculo al panel para usar un origen en el iframe y especificaciones adicionales para alto, ancho y borde, como se muestra en el siguiente fragmento de código. En el panel, los marcadores de posición de ejemplo <databricks-instance-name> y <dashboard-and-workspace-ID> contienen los valores reales asociados al área de trabajo y al panel. Los pasos son los siguientes:

    • Tu <databricks-instance-name> es la primera parte de la dirección URL que utilizas al iniciar sesión en tu área de trabajo. Consulte Obtención de identificadores para objetos del área de trabajo.
    • <dashboard-and-workspace-ID> es la última parte de la dirección URL que apunta al panel. Parece algo parecido a: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447.
    <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>

    Edite la cadena para que incluya solo el texto del vínculo, como se muestra en el ejemplo siguiente.

    https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>

  2. Inserte un elemento iframe en la página. Para obtener información sobre cómo insertar un iframe en la página, consulte la documentación de Confluence.

  3. Pegue la dirección URL de inserción editada en el campo texto de la dirección URL y establezca el ancho en 100 %.

  4. Ajuste otras configuraciones según sus preferencias.

Un panel incrustado en una página borrador de Confluence.

Inserción en Salesforce Knowledge

Para insertar el panel en una página de conocimiento de Salesforce, complete los pasos siguientes:

  1. Cree una página de Visualforce. Para obtener instrucciones, consulte la documentación de Salesforce.

  2. Desde la pantalla Edición de página, mueva el cursor al editor de Marcado de Visualforce.

  3. Pega el código de inserción que copiaste entre las dos etiquetas <apex:page></apex:page>.

  4. Agregue dos etiquetas de párrafo (<p></p>) alrededor del código de inserción.

    En el ejemplo siguiente se usa el marcador de posición <dashboard-embed-code> para mostrar el aspecto que debe tener el marcado de Visualforce. La instancia debe incluir el código de inserción completo que usted copió.

    <apex:page >
<p><dashboard-embed-code></p>
</apex:page>

  5. Haga clic en Guardar para guardar los cambios.

  6. Haga clic en Vista previa y confirme que el tablero de control se muestra.

  7. Copie la dirección URL de la vista previa del componente y cree un nuevo componente de iframe. Debería tener un aspecto similar al siguiente fragmento de código. El marcador de posición <your-salesforce-domain> debe sustituirse por el dominio de Salesforce.

    <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>

  8. Vaya a la página de Conocimientos donde desea insertar el panel de control.

  9. Haga clic en Editar > agregar un componente multimedia.

  10. Pegue el código de iframe del paso anterior en el campo Insertar texto.

Insertar en SharePoint

Para insertar el panel en SharePoint, es posible que tenga que agregar la dirección URL de Azure Databricks a la lista de sitios permitidos para el contenido insertado en SharePoint. Consulte [documentación de Microsoft] para obtener información sobre cómo permitir la inserción de contenido en páginas de SharePoint. Después, complete los siguientes pasos:

  1. Vaya a la página de SharePoint donde desea hospedar el panel incrustado.
  2. Agregue un elemento Embed a la página.
  3. Pegue el código de inserción completo en el campo Dirección del sitio web o inserte código en el lado derecho de la pantalla.
  4. Haga clic fuera para confirmarlo.

Un panel incrustado en una página borrador de SharePoint

Inserción de un único widget

Para insertar un único widget desde un panel, necesita el código de inserción del panel y el identificador único del widget que desea mostrar.

Copia el identificador único

El identificador de un único widget es una combinación de un valor de página name y un valor de widget name , separado por un tilda (~).

Nota:

La name clave aparece en el archivo serializado que define el panel y no es accesible desde la interfaz de usuario de Azure Databricks. Es independiente del displayName valor , que define el nombre de página que se muestra en la interfaz de usuario. Consulte Editar un archivo de panel.

Para copiar el identificador único:

  1. Abre tu panel publicado en el área de trabajo de Azure Databricks.

  2. Haga clic en el icono de menú Kebab. Menú kebab del widget que desea insertar.

  3. Haga clic en Ver pantalla completa o copiar vínculo al widget. La dirección URL contiene los valores de página y widget name pertinentes.

  4. Copie el parámetro de búsqueda fullscreenWidget y todo lo que sigue al signo igual (=).

    En el ejemplo siguiente se muestra la última parte de la dirección URL de un widget de pantalla completa:

    fullscreenWidget=53eadf26~3490f286

Ajustar el código de inserción generado

  1. Consulte Generar código para insertar para encontrar los pasos para generar el código de inserción del panel.
  2. Agregue &fullscreenWidget=<ID> a la dirección URL de inserción y reemplace <ID> por el valor combinado <page-name>~<widget-name> .

Por ejemplo, si la dirección URL de inserción base es la siguiente:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

La dirección URL de inserción actualizada con el identificador único debe ser similar a la siguiente:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"

Ver un panel incrustado

Los paneles insertados ofrecen una manera segura de que los espectadores accedan a los datos del panel fuera de Azure Databricks. Se aplica toda la configuración de uso compartido existente. Se debe conceder acceso al panel a los destinatarios previstos. Consulte ¿Quién puede acceder al panel? Al acceder a un panel incrustado, se pide a los visores que inicien sesión en Azure Databricks, a menos que tengan una sesión activa desde un inicio de sesión reciente en la misma área de trabajo.

Para ver un panel insertado, haga lo siguiente:

  • Vaya a la página donde se ha insertado el panel.
  • En caso necesario, inicie sesión con las credenciales de Azure Databricks.

Pantalla de inicio de sesión de ejemplo desde un panel incrustado

Nota:

Si un usuario registrado que no tiene acceso al panel intenta verlo, recibirá un error en el que se indica que el panel no está disponible. Consulte Uso compartido de un panel publicado para obtener información sobre cómo ajustar la configuración de uso compartido.

Actualización de un panel insertado

Todos los espectadores de un panel insertado pueden actualizar manualmente los paneles a petición. También puede configurar una programación para actualizar los paneles periódicamente.

Consulte Administrar actualizaciones y suscripciones programadas del panel.

Solución de problemas de paneles embebidos

En esta sección se muestran los problemas comunes que podría encontrar y se ofrece una resolución sugerida:

El iframe insertado está en blanco

Si el iframe insertado no muestra datos, puede deberse a que ha deshabilitado las cookies de terceros. La habilitación de cookies de terceros es necesaria para permitir que el contenido externo, como paneles incrustados, funcione correctamente dentro de otra página web.

A fin de resolver este problema, puede ajustar la configuración del explorador para permitir o desbloquear cookies de terceros. Si no desea permitir todas las cookies de terceros, muchos navegadores le permiten agregar excepciones para sitios específicos en los que se deben permitir cookies de terceros. Consulte la documentación de ayuda de su navegador para obtener instrucciones detalladas sobre cómo administrar cookies.

En los pasos siguientes se explica cómo reiniciar la sesión con cookies de terceros habilitadas en el explorador Chrome. Este proceso garantiza un estado limpio deshabilitando primero y, a continuación, vuelve a habilitar las cookies de terceros:

  1. Cierre sesión en todas las sesiones activas de Azure Databricks.
  2. Haga clic en el icono del control deslizante situado junto a la dirección URL.
  3. Haga clic en Cookies y datos del sitio y deshabilite o bloquee cookies de terceros. Se le pedirá que actualice la página.
  4. Actualice la página y haga clic en Iniciar sesión en el iframe incrustado. Debería aparecer un mensaje de error. Cierra la ventana del explorador.
  5. En Cookies y datos del sitio, permita cookies de terceros.
  6. Actualice la página una vez más.
  7. Vaya al panel insertado y haga clic en Iniciar sesión.