Incorporer un contenu externe dans ArcGIS

Ce modèle repose sur une expérience utilisateur principale dans une application ArcGIS, telle qu’ArcGIS Experience Builder, ArcGIS Dashboard, d’autres applications Web configurables ou ArcGIS Pro. L’intégration souhaitée incorpore du contenu d’un autre système dans l’interface ArcGIS, selon l’un des modèles courants :

• Une intégration <iframe> complète, prise en charge dans ArcGIS Hub et ArcGIS Enterprise Sites, dans ArcGIS Experience Builder via le widget d’intégration et dans ArcGIS Dashboards en tant que contenu intégré.

• Le contenu HTML incorporé affiché dans une fenêtre contextuelle, comme une image incorporée. Ce contenu est limité aux balises HTML prises en charge et peut être utilisé pour afficher une image d’un système distant ou un lien vers une application ou un point de terminaison distant.

Modèles d’intégration dans ArcGIS

Diverses applications configurables ArcGIS Enterprise ou ArcGIS Online peuvent incorporer un contenu via une approche <iframe>. Toute application qui utilise une carte Web peut fonctionner avec une image incorporée configurée avec une fenêtre contextuelle (notamment ArcGIS Pro et ArcGIS Maps SDKs)

Prise en charge complète Prise en charge partielle

Utiliser les paramètres URL

De nombreuses applications Web externes prennent en charge un ensemble de propriétés configurables lors du chargement définies via des paramètres URL, tels que https://myapp.domain.com/showdocument/docId=BND12 (Afficher un document avec l’identifiant BND12). À 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 avec un identifiant BND12 dans l’application ArcGIS, l’iframe peut être défini de sorte à utiliser une URL qui charge l’application distante depuis le système externe avec les données d’intérêt déjà visibles ou un formulaire ou une interface préchargé.

Meilleures pratiques et défis liés aux 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.