ArcGIS Survey123 peut être intégré à d’autres applications par l’intermédiaire de liens permettant d’ouvrir l’application d’un composant spécifique. Par exemple, vous pouvez créer des liens d’application pour lancer et ouvrir Survey123 Mobile à 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).
Conseil :
Survey123 Mobile ouvre les liens pour trois applications : Survey123 Mobile, l’application de terrain Survey123 et QuickCapture. Lorsque ces liens sont lancés depuis Survey123 Mobile (depuis Use a link (Utiliser un lien), Scan a QR code (Scanner un QR Code) ou depuis un lien à l’intérieur d’une enquête ou d’un projet QuickCapture), ils s’ouvrent dans Survey123 Mobile. Pour plus d’informations, reportez-vous à la rubrique Ouvrir le contenu.
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. Les exemples inclus montrent comment ouvrir une enquête spécifique à l’aide de ces modèles d’URL :
| Élément à lancer | Origine du lien | Modèle d’URL à utiliser |
|---|---|---|
| Survey123 Mobile | Android iOS | Lien d’application Survey1231 : Exemple : |
Windows Android iOS2 | Structure d’URL personnalisée3 : Exemple : | |
Application Web | Navigateur web | Formulaire d’enquête par ID : Exemple : |
Application de terrain | Android iOS | Lien d’application Survey1231 : Exemple : |
Windows Android iOS2 | Structure d’URL personnalisée3 : Exemple : | |
| Survey123 Studio | Windows | Structure d’URL personnalisée3 : Exemple : |
Survey123 Connect | Windows | Structure d’URL personnalisée3 : Exemple : |
Autre application | Formulaire d’enquête | Lien de Survey123 : varie selon l’application |
1 : les liens d’application Survey123 sont conformes aux exigences définies par App Store et Google Play, permettent la liaison à davantage d’applications, et prennent en charge les liens abrégés, qui sont plus faciles à partager.
2 : sur les appareils iOS, les structures d’URL personnalisées sont approuvées uniquement pour un certain groupe d’applications.
3 : 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-mobile://?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-mobile://?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 Survey123 Mobile, Fonctions d’entités | ArcGIS Arcade | Esri Developer, 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 Survey123 Mobile ou 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 ArcGIS 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-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43Voici la même URL avec des paramètres codés :
https://survey123-mobile.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 ?