Integrar contenido externo en ArcGIS

Este patrón se basa en una experiencia de usuario principal en una aplicación de ArcGIS, como ArcGIS Experience Builder, ArcGIS Dashboard, otras aplicaciones web configurables o ArcGIS Pro. La integración deseada integra contenido de otro sistema en la interfaz de ArcGIS, siguiendo uno de varios patrones comunes:

• Una incrustación completa de <iframe>, compatible con ArcGIS Hub y ArcGIS Enterprise Sites, en ArcGIS Experience Builder a través del widget Integrar, y en ArcGIS Dashboards como contenido incrustado.

• Contenido HTML incrustado mostrado en una ventana emergente, como una imagen incrustada. Esto está limitado a etiquetas HTML compatibles y puede usarse para mostrar una imagen de un sistema remoto o un vínculo a una aplicación o extremo remoto.

Patrones de integración en ArcGIS

Diversas aplicaciones configurables de ArcGIS Enterprise o ArcGIS Online pueden incrustar contenido mediante un método <iframe>. Cualquier aplicación que consuma un mapa web puede funcionar con imágenes incrustadas configuradas con una ventana emergente, incluidas ArcGIS Pro y ArcGIS Maps SDKs.

Compatibilidad completa Compatibilidad parcial

Usar parámetros de dirección URL

Muchas aplicaciones web externas admiten un conjunto de propiedades configurables en carga definidas mediante parámetros de URL, como https://myapp.domain.com/showdocument/docId=BND12 (Mostrar un documento con el identificador BND12). Al utilizar este patrón de integración, es habitual establecer dinámicamente estos parámetros de URL (que controlan cómo se cargará la aplicación en iframe) a partir de propiedades de la aplicación principal o del sistema de negocio. Por ejemplo, si el usuario está viendo un registro con un identificador BND12 en la aplicación ArcGIS, el iframe puede definirse para usar una URL que cargue la aplicación remota desde el sistema externo con los datos de interés ya visibles, o con un formulario o una interfaz precargados.

Mejores prácticas y desafíos de las integraciones mediante <iframe>

Históricamente, los iframes han sido una tecnología popular que también ha supuesto una amplia variedad de desafíos de seguridad. Esto ha dado lugar a diversas limitaciones impuestas por los navegadores sobre los iframe, lo que puede restringir la funcionalidad o la facilidad de uso entre sistemas. Algunos de los principales retos incluyen:

• El inicio de sesión único es complicado. Los estándares de los navegadores suelen bloquear la reutilización de cookies de sesión existentes en un <iframe>, a menos que el dominio del <iframe> coincida con el dominio del contenido principal. Esto significa que, a menudo, un usuario debe autenticarse en el sistema ArcGIS incrustado en el <iframe>, lo que requerirá una interacción de inicio de sesión. Si tanto el elemento principal del marco como el propio marco se autentican mediante el mismo proveedor de identidad, es posible que los usuarios esperen una experiencia de inicio de sesión único y se sientan insatisfechos si se les exige un segundo inicio de sesión. Algunos proveedores de identidad empresarial también pueden bloquear el uso de su cuadro de diálogo de inicio de sesión dentro de un iframe, y puede ser necesario recurrir a otros enfoques, como encabezados de Content-Security-Policy cuidadosamente configurados.
• Para abordar mejor este problema, utilice el mismo dominio (por ejemplo, .domain.com) tanto para el sitio principal como para el sitio del iframe, emplee el mismo proveedor de inicio de sesión único y permita que la aplicación redirija automáticamente a los usuarios al inicio de sesión cuando sea necesario.

• Las descargas o subidas de archivos pueden bloquearse. La seguridad del navegador puede bloquear la descarga de archivos desde iframe; en esos casos, un enlace o botón de descarga en una aplicación incrustada puede no mostrar ningún error error o fallo y, simplemente, no descargar el archivo, como una exportación desde una tabla de entidades. Esta categoría de problema suele notificarse mediante un mensaje en la consola JavaScript del navegador.

• El tamaño de la pantalla puede afectar negativamente a las interfaces de usuario. Los iframe suelen definirse con un tamaño de marco fijo en píxeles, y las aplicaciones que vayan a incrustarse deberían diseñarse para ese tamaño de visualización previsto. Si la aplicación principal puede escalar de forma inteligente el iframe según la resolución de pantalla del usuario, quienes dispongan de pantallas más grandes podrán tener una experiencia adaptable; sin embargo, un iframe de tamaño fijo dará lugar a una ventana incrustada pequeña que puede perjudicar la experiencia de usuario. Las aplicaciones incrustadas deberían diseñarse de modo que todos los elementos principales de la interfaz y las interacciones puedan realizarse dentro del área de pantalla disponible.

• La comunicación entre el iframe y la ventana principal suele ser limitada. Aunque algunos patrones de <iframe> permiten la comunicación entre la ventana principal y el <iframe> mediante protocolos o mecanismos como postMessage, la mayoría de las aplicaciones de ArcGIS no ofrecen esta capacidad, por lo que las interacciones en la aplicación incrustada no afectan a la ventana principal, ni viceversa.