Incorporer une application ArcGIS dans un <iframe>

Les iframes sont une technologie Web permettant d’incorporer du contenu d’un site Web dans un autre site Web ou une page HTML. La balise HTML <iframe> est utilisée à cette fin et peut être créée avec une grande variété de configurations et propriétés.

Lors de l’incorporation d’interfaces ou de fonctions ArcGIS dans d’autres systèmes d’entreprise, un modèle courant consiste à incorporer une application Web, telle qu’une application d’ArcGIS Instant Apps ou ArcGIS Experience Builder, ou une autre application créée avec Maps SDK for JavaScript, dans une autre application système d’entreprise via un iframe.

Cela peut impliquer d’écrire du code ou du HTML qui définit explicitement un <iframe>. L’autre système peut également avoir un modèle comme un outil ou un widget d’incorporation qui gère le traitement de l’iframe, ce qui peut imposer des restrictions supplémentaires sur ce dernier, ou contrôler les attributs de balise d’iframe pouvant être définis.

Voici quelques exemples de processus pouvant être pris en charge avec ce modèle :

• Incorporer une carte générale de situation dans une page Web plus grande pour rechercher des localisations de magasin ou des entités géographiques courantes.

• Créer une carte Web et une application modifiables et les incorporer dans un autre traitement de collecte ou configuration de données plus vaste, basé sur des formulaires ou créé avec une autre technologie.

• Afficher un formulaire ArcGIS Survey123 à l’aide des paramètres URL, dans un site Web ou une application qui collecte des données ou participe à un processus plus vaste.

Cette fonctionnalité et ses meilleures pratiques s’appliquent également aux scénarios où des applications ArcGIS sont incorporées dans d’autres applications ArcGIS.

Modèles d’intégration dans ArcGIS

Prise en charge complète Prise en charge partielle

Dans un système distant, un <iframe> permet d’incorporer des applications d’ArcGIS Online ou ArcGIS Enterprise, ou des applications personnalisées créées avec ArcGIS Maps SDK for JavaScript.

Utiliser les paramètres URL

De nombreuses applications Web ArcGIS prennent en charge un ensemble de propriétés configurables lors du chargement définies via des paramètres URL, tels que https://my.domain.com/portal/home/apps/viewer.html?center=-54,120&zoom=5 (centrer l’application sur ces coordonnées et zoomer au niveau d’échelle 5). À partir de ce modèle d’intégration, il est courant de définir dynamiquement ces paramètres URL (contrôlant le mode de chargement de l’application iframe) à l’aide des propriétés de l’application parent ou de l’application du système d’entreprise. Par exemple, si l’utilisateur consulte un enregistrement dans un système autre qu’un système ArcGIS avec l’identifiant BD1245 dans l’application parent, si le iframe est défini, il peut inclure une URL, telle que ../my-app.html?featureID=BD1245, de sorte que l’application est chargée avec les données d’intérêt déjà visibles et ciblées dans l’application.

Pratiques conseillées pour les incorporations <iframe>

Historiquement, les iframes étaient une technologie populaire ayant également introduit un large éventail de défis en matière de sécurité. Cela a conduit à diverses limitations de navigateur imposées aux iframes, qui peuvent limiter les fonctions ou la convivialité entre les systèmes. Voici quelques-uns des principaux défis à relever :

• L’authentification unique est compliquée. Les normes des navigateurs bloquent souvent la réutilisation des cookies de session existants dans un <iframe>, sauf si le domaine du <iframe> correspond au domaine du contenu parent. Cela signifie qu’un utilisateur doit souvent s’authentifier auprès du système ArcGIS intégré dans le <iframe>, ce qui nécessite une interaction de connexion. Si le parent de l’image et l’image elle-même sont authentifiées via le même fournisseur d’identités, les utilisateurs peuvent s’attendre à une expérience d’authentification unique et ne pas apprécier une seconde exigence de connexion. Certains fournisseurs d’identités d’entreprise peuvent également bloquer l’utilisation de leur boîte de dialogue de connexion dans un iframe, et d’autres approches, telles que des en-têtes CSP (stratégie de sécurité du contenu) soigneusement élaborés, peuvent être nécessaires.
• Pour mieux résoudre ce problème, utilisez le même domaine (par exemple, .domain.com) pour le site parent et le site de l’iframe, utilisez le même fournisseur d’authentification unique et autorisez l’application à rediriger automatiquement les utilisateurs vers la page de connexion, si nécessaire.

• Les téléchargements ou chargements de fichiers peuvent être bloqués. La sécurité du navigateur peut bloquer le téléchargement de fichiers depuis des iframes, avec un lien de téléchargement ou un bouton de téléchargement dans une application intégrée qui ne signale pas une error ou une défaillance, mais simplement un échec de téléchargement de fichier, tel qu’une exportation depuis une table d’entités. Cette catégorie de problèmes est généralement signalée via un message de la console JavaScript dans le navigateur.

• La taille de l’écran peut avoir un impact négatif sur les interfaces utilisateur. Les iframes sont généralement définis comme une taille d’image constante en pixels et les applications à incorporer doivent être conçues pour cette taille de vue attendue. Si l’application parent peut adapter intelligemment l’iframe à la résolution d’écran de l’utilisateur, les utilisateurs dont les écrans sont plus grands peuvent connaître une expérience réactive, mais un iframe de taille fixe générera une petite fenêtre intégrée qui risque de rendre l’expérience négative pour l’utilisateur. Les applications incorporées doivent être conçues de manière à ce que tous les éléments principaux de l’interface utilisateur et les interactions puissent être réalisés dans la zone d’écran fournie.

• Les communications entre l’iframe et la fenêtre parent sont généralement limitées. Certains modèles <iframe> prennent en charge les communications entre la fenêtre parent et les <iframe> via des protocoles ou modèles comme postMessage, mais la plupart des applications ArcGIS n’offrant pas cette fonctionnalité, les interactions dans l’application iframe n’affectent pas la fenêtre parent et inversement.