ArcGIS Survey123 peut être intégré à d’autres applications par le biais de liens permettant d’ouvrir l’application de terrain ou l’application Web Survey123, Survey123 Connect ou une autre application. Par exemple, vous pouvez créer des liens d’application pour lancer et ouvrir l’application de terrain Survey123 à partir d’une autre application Esri, d’une fenêtre contextuelle de carte Web ou d’un simple hyperlien dans un e-mail ou sur un site Web. Vous pouvez utiliser une URL pour télécharger et ouvrir automatiquement une enquête à mettre à jour dans Survey123 Connect. Vous pouvez également accéder à d’autres applications à partir de Survey123 (par exemple, à ArcGIS QuickCapture et ArcGIS Field Maps).
Utilisez les modèles d’URL du tableau pour créer des liens permettant un accès à partir d’un navigateur Web ou d’une autre application.
| Élément à lancer | Origine du lien | Modèle d’URL à utiliser |
|---|---|---|
Application Web | Navigateur web | Formulaire d’enquête par ID : |
Application de terrain | Android et iOS | Lien d’application Survey123 : |
Windows, Android, un certain groupe d’applications sous iOS | Structure d’URL personnalisée : | |
Survey123 Connect | Windows | Structure d’URL personnalisée : |
Autre application | Formulaire d’enquête | Lien de Survey123 : varie selon l’application |
Les exemples suivants montrent comment ouvrir une enquête spécifique à l’aide de ces modèles d’URL :
- https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
- https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19
Les liens d’application Survey123 sont conformes aux exigences définies par App Store et Google Play, permettent l’accès à davantage d’applications, et prennent en charge les liens abrégés, plus faciles à partager.
Les liens de structure d’URL personnalisée ne peuvent pas être abrégés et peuvent être difficiles à ouvrir sur Android. Envisagez de présenter les liens de structure d’URL personnalisée sous forme d’hyperliens, comme suit :
<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>Paramètres URL
Vous pouvez ajouter des paramètres d’URL à la fin des liens pour personnaliser davantage le mode d’ouverture de l’application. Par exemple, vous pouvez définir l’emplacement par défaut d’une question géopoint ou répondre à une question textuelle.
Les paramètres d’URL commencent par le caractère ? et sont séparés par le caractère &. L’exemple suivant montre une structure d’URL personnalisée, le premier paramètre (itemID) commençant par le caractère ? et les paramètres de champ suivants (color_1 et color_2) étant séparés par le caractère &.
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=bluePour des exemples d’URL supplémentaires et les paramètres d’URL pris en charge, reportez-vous aux rubriques Lancer l’application Web, Lancer l’application de terrain, Lancer Survey123 Connect et Lancer une autre application à partir de Survey123.
Remarque :
Avant d’utiliser un lien qui contient des paramètres permettant de lancer une enquête dans l’application de terrain, il est préférable que l’application soit déjà installée sur l’appareil. Pour plus d’informations, reportez-vous à la rubrique Installer l’application de terrain Survey123.
Encodage d’URL
Même si les paramètres d’URL non codés fonctionnent dans certains environnement, il est conseillé de les coder. Le codage remplace les caractères non valides par le signe de pourcentage (%) suivi de leur équivalent hexadécimal.
Par exemple, voici un lien Survey123 qui utilise un rappel pour revenir à un projet spécifique dans QuickCapture avec des paramètres qui ne sont pas codés :
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43Voici la même URL avec des paramètres codés :
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43Un signe égal qui indique une rupture entre une clé et sa valeur ne doit pas être codé.
Conseil :
Pour créer des paramètres codés, vous pouvez utiliser ArcGIS Arcade. La fonction UrlEncode vous permet de définir un ensemble de paires clés-valeurs représentant chaque paramètre et de générer une URL avec le codage approprié.
L’auteur d’une enquête peut également masquer les paramètres URL de sorte que les données sensibles ne soient plus visibles dans l’URL. Dans ce cas, lorsque vous créez une URL à utiliser dans l’application Web, ajoutez encodeUrlParams=true. Pour plus d’informations, reportez-vous à la rubrique Paramètres d’URL permettant d’ouvrir l’application Web.
Vous avez un commentaire à formuler concernant cette rubrique ?