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

L’exemple suivant illustre l’utilisation d’un code personnalisé pour incorporer un iframe :

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

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é.

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.

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 personnalisé afin d’incorporer des éléments tiers dans votre expérience. Les formats HTML et CSS sont pris en charge dans les balises <style> et le format JavaScript est pris en charge dans les balises <script>.

    Conseil :

    Si vous voulez incorporer une page HTML complexe qui dépasse la taille limite de 8 Ko imposée pour des raisons de performance, déployez-la sur votre propre serveur et incorporez par URL à la place.

    Remarque :

    Lorsque vous incorporez par code, l’attribut sandbox est automatiquement ajouté sans la directive allow-same-origin. Cela permet au contenu incorporé d’exécuter JavaScript et de lire ses propres informations sur le stockage local et les cookies, mais pas d’accéder au DOM de l’application Experience Builder, ni aux cookies, stockage local, etc.

• 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/opsdashboard/index.html#/<id>?state={appURL.search.state}