Widget Embed (Incorporer)

Le widget Embed (Incorporer) permet d’incorporer le contenu d’un site Web à l’aide d’une URL ou d’un code pour des fonctionnalités supplémentaires personnalisées.

Exemples

Utilisez ce widget pour prendre en charge les exigences de conception d’application, telles que les suivantes :

• Vous devez fournir des informations supplémentaires d’un site Web en fonction d’une entité sélectionnée. La couche d’entités contient un champ avec des URL vers les sites Web à incorporer une fois qu’un utilisateur a sélectionné une entité sur la carte ou qu’il a cliqué sur un bouton pour afficher davantage d’informations pour cette entité.
• Vous voulez incorporer un tableau de bord dans votre application et permettre aux utilisateurs finaux d’ajouter un paramètre d’URL à la fin de l’URL d’expérience Web de sorte à modifier la vue actuelle du tableau de bord (par exemple, pour afficher les données d’une région spécifique).
• Vous souhaitez incorporer un contenu à l’aide d’un code HTML (tel qu’un site Web) ou copier le code d’un exemple (par exemple, agrégats de points).

Remarques sur l’utilisation

Pour créer une URL dynamique à l’aide de paramètres URL, enregistrez et rechargez votre application avec le paramètre URL que vous voulez utiliser afin de pouvoir sélectionner une clé correspondante dans la fenêtre URL info (Informations d’URL). Au moment de l’exécution, le widget Embed (Incorporer) recherche et apparie le nom de l’URL indiquée avec les paramètres URL ajoutés à l’URL de l’application d’hébergement, et résout l’URL en utilisant la valeur correspondante à afficher dans l’application incorporée.

Remarque :

Si vous choisissez d’afficher un PDF directement dans le widget Embed (Incorporer), il se peut que certains utilisateurs ne puissent pas le visualiser dans certains navigateurs, pour des raisons de sécurité.

Paramètres

Le widget Embed (Incorporer) inclut les paramètres suivants :

• Embed by (Intégrer par) : indiquez si vous souhaitez procéder à l’intégration par une URL ou par du code.
  • URL : incorporez une URL statique à un site Web ou utilisez les options suivantes pour former une URL dynamique :

    Remarque :

    Seules les URL HTTPS sont prises en charge. Pour des raisons de sécurité, l’application incorporée est limitée par la règle d’origine identique. Pour les domaines autres que *.arcgis.com et *.esri.com, l’attributsandbox est ajouté automatiquement.

    • Connect to data (Connexion aux données) : sélectionnez une couche comme source de données (ajoutée à partir de cartes Web, de scènes Web, de couche directe ou via une URL) et cliquez sur le bouton Data (Données) pour sélectionner un attribut contenant des URL ou pour ajouter une URL existante comme paramètres. Utilisez le champ Label (Étiquette) pour afficher une description dans le widget lorsqu’il n’est pas renseigné par le contenu d’une URL dans les données.
    • URL info (Informations d’URL) : récupérez les paramètres URL à ajouter comme suffixe à l’URL de votre application dans le générateur. Configurez une URL dynamique pour transmettre des paramètres URL depuis le widget Incorporer à l’application incorporée. Ainsi, les utilisateurs peuvent ajouter des paramètres URL à l’URL de l’expérience Web au moment de l’exécution afin de contrôler ce qui s’affiche dans l’application incorporée.

      Remarque :

      Pour plus d’informations sur les paramètres d’URL pris en charge dans l’application intégrée, reportez-vous à la documentation correspondante, comme par exemple pour ArcGIS Dashboards et ArcGIS Web AppBuilder.

  • Code (Code) : ajoutez votre propre code HTML personnalisé afin d’incorporer des éléments tiers dans votre expérience.

    Pour satisfaire les exigences de conformité, le widget limite le contenu que vous pouvez incorporer par code. Actuellement, le widget prend en charge le contenu d’URL dans un iframe HTML, le code partagé à partir d’une sélection de sites Web de réseaux sociaux populaires et un sous-ensemble de balises et d’attributs HTML. Voici une liste des formats HTML pris en charge :

    Format	Exemple
    Iframe HTML standard avec contenu d'URL	<iframe width="100%" height="600px" frameborder="0" scrolling="yes" marginheight="" marginwidth="" src="https://developers.arcgis.com/"></iframe>
    YouTube	<iframe width="560" height="315" src="https://www.youtube.com/embed/pNrsd5naN7U" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
    Twitter	Exemple de chronologie Twitter : <a class="twitter-timeline" href="https://twitter.com/ArcGISApps?ref_src=twsrc%5Etfw">Tweets by ArcGISApps</a> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
    Facebook	<iframe src="https://www.facebook.com/plugins/post.php?href=https%3A%2F%2Fwww.facebook.com%2Fesrigis%2Fphotos%2Fa.433181450280%2F10160256145415281%2F&show_text=true&width=500" width="500" height="417" style="border:none;overflow:hidden" scrolling="no" frameborder="0" allowfullscreen="true" allow="autoplay; clipboard-write; encrypted-media; picture-in-picture; web-share"></iframe>
    Instagram	<blockquote class="instagram-media" data-instgrm-permalink="https://www.instagram.com/reel/CmZQDMJtMvc/?utm_source=ig_embed&amp;utm_campaign=loading" data-instgrm-version="14" style=" background:#FFF; border:0; border-radius:3px; box-shadow:0 0 1px 0 rgba(0,0,0,0.5),0 1px 10px 0 rgba(0,0,0,0.15); margin: 1px; max-width:540px; min-width:326px; padding:0; width:99.375%; width:-webkit-calc(100% - 2px); width:calc(100% - 2px);"><div style="padding:16px;"> <a href="https://www.instagram.com/reel/CmZQDMJtMvc/?utm_source=ig_embed&amp;utm_campaign=loading" style=" background:#FFFFFF; line-height:0; padding:0 0; text-align:center; text-decoration:none; width:100%;" target="_blank"> <div style=" display: flex; flex-direction: row; align-items: center;"> <div style="background-color: #F4F4F4; border-radius: 50%; flex-grow: 0; height: 40px; margin-right: 14px; width: 40px;"></div> <div style="display: flex; flex-direction: column; flex-grow: 1; justify-content: center;"> <div style=" background-color: #F4F4F4; border-radius: 4px; flex-grow: 0; height: 14px; margin-bottom: 6px; width: 100px;"></div> <div style=" background-color: #F4F4F4; border-radius: 4px; flex-grow: 0; height: 14px; width: 60px;"></div></div></div><div style="padding: 19% 0;"></div> <div style="display:block; height:50px; margin:0 auto 12px; width:50px;"><svg width="50px" height="50px" viewBox="0 0 60 60" version="1.1" xmlns="https://www.w3.org/2000/svg" xmlns:xlink="https://www.w3.org/1999/xlink"><g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd"><g transform="translate(-511.000000, -20.000000)" fill="#000000"><g><path d="M556.869,30.41 C554.814,30.41 553.148,32.076 553.148,34.131 C553.148,36.186 554.814,37.852 556.869,37.852 C558.924,37.852 560.59,36.186 560.59,34.131 C560.59,32.076 558.924,30.41 556.869,30.41 M541,60.657 C535.114,60.657 530.342,55.887 530.342,50 C530.342,44.114 535.114,39.342 541,39.342 C546.887,39.342 551.658,44.114 551.658,50 C551.658,55.887 546.887,60.657 541,60.657 M541,33.886 C532.1,33.886 524.886,41.1 524.886,50 C524.886,58.899 532.1,66.113 541,66.113 C549.9,66.113 557.115,58.899 557.115,50 C557.115,41.1 549.9,33.886 541,33.886 M565.378,62.101 C565.244,65.022 564.756,66.606 564.346,67.663 C563.803,69.06 563.154,70.057 562.106,71.106 C561.058,72.155 560.06,72.803 558.662,73.347 C557.607,73.757 556.021,74.244 553.102,74.378 C549.944,74.521 548.997,74.552 541,74.552 C533.003,74.552 532.056,74.521 528.898,74.378 C525.979,74.244 524.393,73.757 523.338,73.347 C521.94,72.803 520.942,72.155 519.894,71.106 C518.846,70.057 518.197,69.06 517.654,67.663 C517.244,66.606 516.755,65.022 516.623,62.101 C516.479,58.943 516.448,57.996 516.448,50 C516.448,42.003 516.479,41.056 516.623,37.899 C516.755,34.978 517.244,33.391 517.654,32.338 C518.197,30.938 518.846,29.942 519.894,28.894 C520.942,27.846 521.94,27.196 523.338,26.654 C524.393,26.244 525.979,25.756 528.898,25.623 C532.057,25.479 533.004,25.448 541,25.448 C548.997,25.448 549.943,25.479 553.102,25.623 C556.021,25.756 557.607,26.244 558.662,26.654 C560.06,27.196 561.058,27.846 562.106,28.894 C563.154,29.942 563.803,30.938 564.346,32.338 C564.756,33.391 565.244,34.978 565.378,37.899 C565.522,41.056 565.552,42.003 565.552,50 C565.552,57.996 565.522,58.943 565.378,62.101 M570.82,37.631 C570.674,34.438 570.167,32.258 569.425,30.349 C568.659,28.377 567.633,26.702 565.965,25.035 C564.297,23.368 562.623,22.342 560.652,21.575 C558.743,20.834 556.562,20.326 553.369,20.18 C550.169,20.033 549.148,20 541,20 C532.853,20 531.831,20.033 528.631,20.18 C525.438,20.326 523.257,20.834 521.349,21.575 C519.376,22.342 517.703,23.368 516.035,25.035 C514.368,26.702 513.342,28.377 512.574,30.349 C511.834,32.258 511.326,34.438 511.181,37.631 C511.035,40.831 511,41.851 511,50 C511,58.147 511.035,59.17 511.181,62.369 C511.326,65.562 511.834,67.743 512.574,69.651 C513.342,71.625 514.368,73.296 516.035,74.965 C517.703,76.634 519.376,77.658 521.349,78.425 C523.257,79.167 525.438,79.673 528.631,79.82 C531.831,79.965 532.853,80.001 541,80.001 C549.148,80.001 550.169,79.965 553.369,79.82 C556.562,79.673 558.743,79.167 560.652,78.425 C562.623,77.658 564.297,76.634 565.965,74.965 C567.633,73.296 568.659,71.625 569.425,69.651 C570.167,67.743 570.674,65.562 570.82,62.369 C570.966,59.17 571,58.147 571,50 C571,41.851 570.966,40.831 570.82,37.631"></path></g></g></g></svg></div><div style="padding-top: 8px;"> <div style=" color:#3897f0; font-family:Arial,sans-serif; font-size:14px; font-style:normal; font-weight:550; line-height:18px;">View this post on Instagram</div></div><div style="padding: 12.5% 0;"></div> <div style="display: flex; flex-direction: row; margin-bottom: 14px; align-items: center;"><div> <div style="background-color: #F4F4F4; border-radius: 50%; height: 12.5px; width: 12.5px; transform: translateX(0px) translateY(7px);"></div> <div style="background-color: #F4F4F4; height: 12.5px; transform: rotate(-45deg) translateX(3px) translateY(1px); width: 12.5px; flex-grow: 0; margin-right: 14px; margin-left: 2px;"></div> <div style="background-color: #F4F4F4; border-radius: 50%; height: 12.5px; width: 12.5px; transform: translateX(9px) translateY(-18px);"></div></div><div style="margin-left: 8px;"> <div style=" background-color: #F4F4F4; border-radius: 50%; flex-grow: 0; height: 20px; width: 20px;"></div> <div style=" width: 0; height: 0; border-top: 2px solid transparent; border-left: 6px solid #f4f4f4; border-bottom: 2px solid transparent; transform: translateX(16px) translateY(-4px) rotate(30deg)"></div></div><div style="margin-left: auto;"> <div style=" width: 0px; border-top: 8px solid #F4F4F4; border-right: 8px solid transparent; transform: translateY(16px);"></div> <div style=" background-color: #F4F4F4; flex-grow: 0; height: 12px; width: 16px; transform: translateY(-4px);"></div> <div style=" width: 0; height: 0; border-top: 8px solid #F4F4F4; border-left: 8px solid transparent; transform: translateY(-4px) translateX(8px);"></div></div></div> <div style="display: flex; flex-direction: column; flex-grow: 1; justify-content: center; margin-bottom: 24px;"> <div style=" background-color: #F4F4F4; border-radius: 4px; flex-grow: 0; height: 14px; margin-bottom: 6px; width: 224px;"></div> <div style=" background-color: #F4F4F4; border-radius: 4px; flex-grow: 0; height: 14px; width: 144px;"></div></div></a><p style=" color:#c9c8cd; font-family:Arial,sans-serif; font-size:14px; line-height:17px; margin-bottom:0; margin-top:8px; overflow:hidden; padding:8px 0 7px; text-align:center; text-overflow:ellipsis; white-space:nowrap;"><a href="https://www.instagram.com/reel/CmZQDMJtMvc/?utm_source=ig_embed&amp;utm_campaign=loading" style=" color:#c9c8cd; font-family:Arial,sans-serif; font-size:14px; font-style:normal; font-weight:normal; line-height:17px; text-decoration:none;" target="_blank">A post shared by Esri (@esrigram)</a></p></div></blockquote> <script async src="//www.instagram.com/embed.js"></script>
    Vimeo	<iframe src="https://player.vimeo.com/video/344310270?h=f8c418505e" width="640" height="360" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen></iframe> <p><a href="https://vimeo.com/344310270">The Science of Where - ESRI</a> from <a href="https://vimeo.com/south422">422 South</a> on <a href="https://vimeo.com">Vimeo</a>.</p>
    Autre	En savoir plus sur le HTML pris en charge

    Attention :

    Pour des raisons de performance, une taille limite de 8 Ko (8192 caractères) est imposée.

    Conseil :

    Si vous voulez intégrer une page HTML complexe qui dépasse la taille limite ou qui ne provient pas de l’une des sources prises en charge, déployez la page sur votre propre serveur et intégrez son URL à la place.

• Auto refresh (Actualisation automatique) : définissez un intervalle de temps (en minutes) pour l’actualisation automatique du contenu incorporé dans le widget Embed (Incorporer). La valeur minimale que vous pouvez définir est de 0,2 minutes (12 secondes).

Configurer une URL dynamique

Pour récupérer les paramètres URL depuis votre expérience Web et les transmettre à une application incorporée, effectuez les étapes suivantes :

1. Ajoutez un widget Incorporer et enregistrez.
2. Dans la barre d’adresse de la fenêtre du navigateur, ajoutez le paramètre URL à l’URL de votre expérience Web et appuyez sur Enter (Entrée) pour recharger la page.

   Conseil :

   Comme le générateur inclut déjà un paramètre d’identifiant de l’application, ajoutez le paramètre URL en utilisant une esperluette (par exemple &state=) au lieu d’un point d’interrogation.

   Une fois le générateur rechargé avec le paramètre URL, le bouton URL info (Informations d’URL) affiche la clé de génération d’une URL dynamique.

3. Dans la zone de saisie d’URL Embed by (Incorporer par), collez l’URL de l’application que vous voulez incorporer.
4. À la fin de l’URL incorporée, saisissez le paramètre URL (par exemple, ?state=).
5. Cliquez sur le bouton URL info (Informations d’URL) et sélectionnez la clé correspondante pour finaliser la génération de l’URL dynamique.

   Voici un exemple d’URL dynamique pour un tableau de bord incorporé :

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

Partager l’authentification

Certaines applications Web invitent les utilisateurs à se connecter avec un compte ArcGIS. Une application peut requérir une connexion en raison de ses paramètres de partage, car elle inclut des widgets qui utilisent un contenu Premium ou pour d'autres raisons.

Si vous souhaitez imbriquer une application Web ArcGIS dans votre application Experience Builder et que toutes deux requièrent une connexion, vous pouvez ajouter les paramètres d'URL arcgis-auth-origin et arcgis-auth-portal pour partager l'authentification entre ces deux applications afin que les utilisateurs n'aient à se connecter qu'une seule fois.

Pour imbriquer une application Experience Builder privée dans une autre application Experience Builder, utilisez ?arcgis-auth-origin= afin de définir l'URL du domaine d'application hôte pour l'authentification. En voici un exemple :

https://<orgdomain>/experience/<AppID>/?arcgis-auth-origin=<your host app domain, such as https://localhost:3001>

Pour imbriquer une application JavaScript basée sur une API, telle qu'une application Web AppBuilder, utilisez ?arcgis-auth-origin= pour l'authentification du domaine d'application hôte et ?arcgis-auth-portal= pour l'authentification du domaine de l'application JavaScript basée sur une API. En voici un exemple :

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

https://www.arcgis.com/apps/dashboards/index.html#/<appID>?arcgis-auth-origin=https://experience.arcgis.com&arcgis-auth-portal=https://<myorg>.maps.arcgis.com