Experience Builder vous permet d’ajouter des paramètres d’URL dans vos applications. Vous pouvez utiliser les paramètres d’URL pour améliorer une expérience en définissant une langue, renvoyant vers une page donnée, activant l’aperçu avant impression et bien plus.
Les paramètres sont ajoutés à la fin de l’URL et sont mis en forme en tant que paire clé-valeur connectée avec un signe égal. Les applications Experience Builder prennent en charge les paramètres qui sont des chaînes de requête, c’est-à-dire qu’ils commencent par un point d’interrogation. Pour ajouter plusieurs paramètres, vous devez les séparer par des esperluettes (&). Les URL d’expérience avec des paramètres utilisent la structure suivante : https://<domain>/experience/<AppID>/[?<param1=value>&<param2=value>&...]
En voici un exemple :https://experience.arcgis.com/experience/<AppId>/
L’URL d’une expérience peut contenir un ou plusieurs paramètres parmi les suivants.
Paramètres généraux
Voici une liste de paramètres d’URL généraux.
Changer de langue
Pour modifier la langue de l’application, utilisez le paramètre locale et un code de langue ISO 639-1 de deux lettres. Experience Builder prend en charge les mêmes langues que ArcGIS Enterprise, notamment les codes de langue suivants : ar, bg, bs, ca, cs, da, de-at, de-de, de-ch, el, en-au, en-ca, en-gb, en-us, es-es, es-mx, et, fi, fr-fr, fr-ch, he, hr, hu, id, it-it, it-ch, ja, ko, lt, lv, nb, nl, pl, pt-br, pt-pt, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-cn, zh-hk et zh-tw.
Pour utiliser une application Experience Builder en français et en français suisse, vous pouvez ajouter locale=fr à l’URL, comme dans les exemples suivants :https://experience.arcgis.com/experience/<AppId>/?locale=frhttps://experience.arcgis.com/experience/<AppId>/?locale=fr-ch
Remarque :
Si vous attribuez une langue sans préciser le pays, par exemple fr au lieu de fr-ch ou fr-fr, vous n’êtes pas certain que le format de date ou de nombre obtenu corresponde à vos attentes. En effet, différents pays qui parlent la même langue peuvent avoir différentes notations pour les dates et les nombres, comme aux États-Unis (en-us) et au Royaume-Unis (en-gb).
Accéder à une page
Pour renvoyer vers une page spécifique, utilisez page suivi du nom de la page. Dans les applications ArcGIS Online Experience Builder, le paramètre de page ne fait pas partie d’une chaîne de requête et ne suit pas un point d’interrogation. Il est ajouté dans le chemin de l’URL, comme dans les exemples suivants :https://experience.arcgis.com/experience/<AppId>/page/Page-4https://experience.arcgis.com/experience/<AppId>/page/{xxxHome}/
Accéder à une vue
Pour renvoyer vers la vue d’une section active spécifique, utilisez views suivi d’une étiquette de vue comme v1 ou View 1.
https://experience.arcgis.com/experience/<AppId>/?views=View-2https://experience.arcgis.com/experience/<AppId>/?views=v1Ouvrir une fenêtre
Pour renvoyer vers une fenêtre active spécifique, utilisez dlg suivi d’un ID ou d’une étiquette de fenêtre.https://experience.arcgis.com/experience/<AppId>/?dlg=Window-1
Contrôler l’activation des fenêtres
Si vous voulez incorporer une application Experience Builder avec des fenêtres d’accueil, des fenêtres de page ou des fenêtres fixes et ne souhaitez pas que l’application accède automatiquement à ces fenêtres, vous pouvez utiliser le paramètre disable_window_focus pour contrôler ce comportement. Ajoutez l’URL suivante à la page Web hôte pour désactiver le comportement d’accès. Par défaut, disable_window_focus est défini sur False (Faux).https://experience.arcgis.com/experience/<AppId>/?disable_window_focus=true
Afficher le mode brouillon
Lorsque vous prévisualisez une application, le paramètre draft est automatiquement ajouté. Il vous permet d’obtenir les ressources des applications non publiées.https://experience.arcgis.com/experience/<AppId>/?draft=truehttps://experience.arcgis.com/experience/<AppId>/?draft=1
Ouvrir l’aperçu avant impression
Pour activer le mode d’aperçu avant impression, utilisez print_preview.https://experience.arcgis.com/experience/<AppId>/?print_preview=truehttps://experience.arcgis.com/experience/<AppId>/?print_preview=1
Paramètres liés aux données
Voici une liste de paramètres d’URL liés aux données.
Indiquer l’ID d’une source de données
Chaque source de données dans une application possède son propre ID de source de données. Lorsque vous sélectionnez un enregistrement de données, l’ID de la source de données est ajouté dans l’URL de l’application, comme dans les exemples suivants :https://experience.arcgis.com/experience/<AppId>/?data_id=<dsID>:<selectedrecordID>https://experience.arcgis.com/experience/<AppId>/?data_id=dataSource_1-csv_966%3A0
Vous pouvez utiliser cette méthode pour trouver l’ID de la source de données spécifique d’une couche. Par exemple, vous pouvez ajouter un widget Liste et le connecter à une couche, prévisualiser l’application et sélectionner des enregistrements dans la liste. L’URL est renseignée comme dans l’exemple suivant :https://experience.arcgis.com/experience/<AppId>/?data_id=dataSource_2-Shelters_966%3Axxxxxx
La valeur après ?data_id= et avant :<selectedrecordID> (ou %3A<selectedrecordID>) est l’ID de la source de données de la couche. Muni de l’ID, vous pouvez l’utiliser avec d’autres paramètres pour filtrer la source de données ou changer les versions.
Filtrer les sources de données.
Pour filtrer directement une source de données, utilisez data_filter. Le format de filtre est une syntaxe de clause WHERE standard qui ne peut pas contenir "," ou ":". Pour filtrer plusieurs sources de données, utilisez le [<dsId:filter>,<dsId:filter>].https://experience.arcgis.com/experience/<AppId>/?data_filter=dataSource_1:st=’HI’
L’URL ci-dessus est égale à l’URL encodée suivante :https://experience.arcgis.com/experience/<AppId>/?data_filter=dataSource_1:st=%27HI%27
Voici un autre exemple d’URL avec ce paramètre :https://experience.arcgis.com/experience/<AppId>/?data_filter=ds1:objectid=1,ds2:fielda>2
Modifier la version de géodatabase d’une source de données
Pour modifier la version de géodatabase d’une source de données, utilisez data_version.https://experience.arcgis.com/experience/<AppId>/?data_version=<dsId:version>,<dsId:version>https://experience.arcgis.com/experience/<AppId>/?data_version=dsId1:v1, dsID2:v1
Paramètres de connexion
Voici une liste de paramètres d’URL liés à la connexion
Partager l’authentification via un widget Incorporer
Certaines applications Web invitent les utilisateurs à se connecter avec un compte ArcGIS. Une application peut demander aux utilisateurs de se connecter 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 incorporer une application Web ArcGIS dans votre application Experience Builder et que toutes deux demandent aux utilisateurs de se connecter, 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 intégrer une application basée sur une API JavaScript, 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 basée sur une API JavaScript. Voici quelques exemples :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/opsdashboard/index.html#/<appID>?arcgis-auth-origin=https://experience.arcgis.com&arcgis-auth-portal=https://<myorg>.maps.arcgis.com
Vous avez un commentaire à formuler concernant cette rubrique ?