Widget Integrar

El widget Integrar permite integrar contenido de sitio web usando una URL o código para funcionalidad personalizada adicional.

Ejemplos

Use este widget para apoyar los requisitos de diseño de la aplicación como por ejemplo los siguientes:

  • Tiene que proporcionar información adicional desde un sitio web basándose en la selección de una entidad. La capa de entidades contiene un campo con URL para sitios web que desea integrar una vez que un usuario seleccione una entidad en el mapa o haga clic en un botón para ver más información para esa entidad.
  • Desea integrar un cuadro de mando en su aplicación y permitir que los usuarios incorporen un parámetro de URL al final de la URL de experiencia web para cambiar la vista actual del cuadro de mando (por ejemplo, para mostrar datos de una región concreta).
  • Desea integrar contenido usando código HTML (como por ejemplo un sitio web) o copiar el código desde una muestra (como por ejemplo clustering de puntos).

Notas de uso

A continuación se incluye un ejemplo de cómo utilizar el código personalizado para integrar un iframe:

<iframe width="100%" height="600px" frameborder="0" scrolling="yes" marginheight="0" marginwidth="0" src="https://developers.arcgis.com/"></iframe></div>
Nota:

Si elige mostrar un PDF directamente en el widget Integrar, es posible que algunos usuarios no puedan verlo en determinados navegadores por motivos de seguridad.

Para crear una URL dinámica utilizando los parámetros de URL, guarde y vuelva a cargar la aplicación con el parámetro de URL que desee usar para que pueda seleccionar la clave correspondiente en la ventana Información de URL. En el tiempo de ejecución, el widget Integrar busca y correlaciona el nombre de la información de URL especificada con los parámetros de URL agregados a la URL de la aplicación host y resuelve la URL utilizando el valor correspondiente para mostrar la aplicación integrada.

Configuración

El widget Integrar incluye estos ajustes:

  • Integrar por: elija entre integrar por URL o código.
    • URL: integre un sitio web con una URL estática o utilice las siguientes opciones para formar una URL dinámica:
      Nota:

      Solo se admiten URL HTTPS. Por motivos de seguridad, la aplicación integrada se limita mediante la misma política de origen. Para dominios distintos de *.arcgis.com y *.esri.com, el atributo sandbox se agrega automáticamente.

      • Conectar a datos: seleccione una capa como fuente de datos (agregada desde mapas web, escenas web, capa directa o mediante URL) y haga clic en el botón Datos para seleccionar un atributo que contenga URL o para agregarlo a una URL existente como parámetros. Utilice el campo Etiqueta para mostrar una descripción en el widget cuando no se rellene con el contenido de una dirección URL de los datos.
      • Información de URL: obtenga parámetros de URL para agregarlos como sufijo a la URL de su aplicación en el builder. Configure una URL dinámica para trasladar parámetros de URL desde el widget Integrar a la aplicación integrada, de modo que los usuarios puedan agregar parámetros de URL a la URL de la experiencia web en el tiempo de ejecución para controlar lo que aparece en la aplicación integrada.
        Nota:

        Para obtener información sobre los parámetros de URL compatibles con la aplicación integrada, consulte la correspondiente documentación, por ejemplo para ArcGIS Dashboards y ArcGIS Web AppBuilder.

    • Código: agregue su propio código personalizado para integrar elementos de terceros en su experiencia. Admite HTML, CSS en etiquetas de <style> y JavaScript en etiquetas de <script>.
      Sugerencia:

      Si desea integrar una página HTML compleja que supere el límite de tamaño de 8 KB impuesto por motivos de rendimiento, impleméntela en su propio servidor e intégrela por la dirección URL.

      Nota:

      Cuando se integra por código, el atributo sandbox se agrega automáticamente sin la directiva allow-same-origin. Permite que el contenido integrado ejecute JavaScript y lea su propia información de cookies o almacenamiento local, pero no puede acceder al DOM, la cookie, el almacenamiento local, etc. de la aplicación Experience Builder.

  • Actualizar automáticamente: establezca un intervalo de tiempo personalizado (en minutos) para actualizar automáticamente el contenido integrado en el widget Integrar. El número mínimo que puede definir es 0,2 minutos (12 segundos).

Configurar una URL dinámica

Siga estos pasos para obtener parámetros de URL de su experiencia web que puede trasladar a una aplicación integrada:

  1. Agregue un widget Integrar y guarde.
  2. En la barra de direcciones de la ventana del navegador, agregue el parámetro de URL a la URL de su experiencia web y pulse Intro para volver a cargar la página.
    Sugerencia:

    Dado que el builder ya incluye el parámetro Id. de aplicación, agregue el parámetro de URL con un símbolo et (por ejemplo, &state=) en lugar de un signo de interrogación.

    Una vez que el builder se vuelve a cargar con el parámetro de URL, el botón Información de URL muestra su clave para crear una URL dinámica.

  3. En el cuadro de entrada Integrar por URL, pegue la URL de la aplicación que desee integrar.
  4. Al final de la URL integrada, escriba el parámetro de URL (por ejemplo, ?state=).
  5. Haga clic en el botón Información de URL y seleccione la clave correspondiente para completar la URL dinámica.

    A continuación, se muestra un ejemplo de URL dinámica para un cuadro de mando integrado:

    https://<your portal url>/apps/opsdashboard/index.html#/<id>?state={appURL.search.state}

Compartir autenticación

Algunas aplicaciones web solicitan a los usuarios que inicien sesión con una cuenta de ArcGIS. Una aplicación puede requerir inicio de sesión debido a su configuración de uso compartido, ya que la aplicación incluye widgets que utilizan contenido Premium o por otros motivos.

Si desea integrar una aplicación web de ArcGIS en su aplicación Experience Builder y ambas requieren inicio de sesión, puede agregar los parámetros arcgis-auth-origin y arcgis-auth-portal URL para compartir la autenticación entre las dos aplicaciones de modo que los usuarios solo tengan que iniciar sesión una vez.

Para integrar una aplicación privada Experience Builder en otra aplicación Experience Builder, utilice ?arcgis-auth-origin= para definir la URL del dominio de la aplicación host para la autenticación. A continuación, encontrará un ejemplo:

https://<orgA.arcgis.com>/apps/webappviewer/index.html?id=<appID>&arcgis-auth-origin=<your host app domain, such as https://localhost:3001>

Para integrar una aplicación basada en API JavaScript como, por ejemplo, una aplicación Web AppBuilder, utilice ?arcgis-auth-origin= para la autenticación del dominio de la aplicación host y para la autenticación JavaScript dominio de la aplicación basada en la API.?arcgis-auth-portal=JavaScript A continuación, encontrará un ejemplo:

https://<orgA.arcgis.com>/apps/webappviewer/index.html?id=<appID>&arcgis-auth-origin=<your host app domain, such as https://localhost:3001>&arcgis-auth-portal=<orgA URL>