Vous pouvez créer des liens pour ouvrir Survey123 Mobile à partir d’une autre application, d’une fenêtre contextuelle de carte Web ou d’un hyperlien dans un e-mail ou sur un site Web. Utilisez une structure d’URL personnalisée pour lancer l’application à partir d’un navigateur Web ou un lien d’application Survey123 pour la lancer à partir d’une application sous Android ou iOS. Utilisez des paramètres d’URL pour personnaliser le mode d’ouverture de Survey123 Mobile, par exemple, pour charger une enquête spécifique, définir les coordonnées de la localisation par défaut sur la carte et répondre aux questions avec des valeurs prédéterminées ou en transmettant des attributs de données à partir d’une fenêtre contextuelle de carte Web.
Établir un lien à partir d’un navigateur Web sous Windows
Vous pouvez créer un lien pour ouvrir Survey123 Mobile et l’intégrer dans une autre application. Ce même lien peut servir au test dans un navigateur Web.
Remarque :
Une fois le lien créé, vous pouvez remplacer arcgis-survey123-mobile:// par https://survey123-mobile.arcgis.app comme lien Survey123 à utiliser sur iOS ou sur Android.
Pour créer une structure d’URL personnalisée et l’utiliser dans un navigateur Web de bureau, procédez comme suit :
- Saisissez arcgis-survey123-mobile:// dans votre navigateur.
Survey123 Mobile s’ouvre (ou vous êtes invité à l’ouvrir).
Remarque :
Pour lancer et télécharger une enquête depuis un portail donné, incluez le paramètre d’URL du portail, par exemple, arcgis-survey123-mobile://?portalUrl=host.domain.com/webadaptor (où host, domain et webadaptor sont remplacés par les informations du portail).
- Ajoutez une référence unique à une enquête et ajoutez-la à l’URL en procédant comme suit :
- Identifiez l’ID d’élément de l’enquête à ouvrir.
Remarque :
Il s’agit de la chaîne de caractères que ArcGIS Online utilise pour identifier de manière unique l’enquête. Elle se trouve dans l’URL de l’élément de formulaire dans ArcGIS Online. Par exemple, si l’URL de l’enquête est https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, l’ID d’élément du formulaire est 36ff9e8c13e042a58cfce4ad87f55d19.
- Ajoutez l’enquête à l’URL, en ajoutant ?itemID= et l’ID d’élément du formulaire à la fin de l’URL.
L’URL doit ressembler à ce qui suit :arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19Si vous testez l’URL, celle-ci doit ouvrir Survey123 Mobile et ouvrir immédiatement l’enquête.
Remarque :
Si l’enquête n’est pas encore sur votre appareil, elle est téléchargée.
- Identifiez l’ID d’élément de l’enquête à ouvrir.
- Incluez des réponses prédéterminées aux questions en ajoutant dans l’URL une référence à un champ à l’aide du nom qui lui est attribué dans le formulaire XLSForm (et non de son étiquette).
Par exemple, pour renseigner le champ Surname, saisissez &field:surname= et la valeur.
& sert de séparateur de paramètre et field: désigne le nom de la question à renseigner.
L’URL doit ressembler à ce qui suit :arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserVous pouvez maintenant utiliser l’URL pour ouvrir Survey123 Mobile et l’enquête, puis renseigner la question donnée avec la réponse que vous avez définie. Vous pouvez renseigner plusieurs questions dans une seule URL d’enquête. Les noms de champ sont sensibles à la casse.
- Définissez un emplacement pour une question géopoint dans l’enquête en ajoutant des coordonnées à l’URL comme suit :
- Saisissez ¢er=, puis entrez les coordonnées.
- Entrez les coordonnées de la latitude de la longitude en degrés décimaux, séparées par une seule virgule.
- Vous pouvez également ajouter l’altitude en mètres comme troisième valeur, également séparée par une seule virgule.
L’URL définitive doit ressembler à ce qui suit :
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Cette URL ouvre maintenant Survey123 Mobile et l’enquête que vous avez choisie, renseigne une question texte et fournit une localisation par défaut pour la question géopoint.
Les attributs de champ peuvent également être transmis à Survey123 Mobile à partir d’une fenêtre contextuelle dans une carte Web ArcGIS, ce qui permet de les intégrer à d’autres applications Esri qui utilisent des fenêtres contextuelles dans une carte Web. Cette fonctionnalité peut être utilisée pour renseigner un champ dans Survey123 Mobile avec la valeur d’un attribut d’entité, plutôt qu’une valeur définie, en fournissant le nom de l’attribut placé entre accolades.
- Ouvrez la carte Web, sélectionnez Pop-ups (Fenêtres contextuelles) pour l’une des couches, choisissez Add content (Ajouter un contenu), sélectionnez Text (Texte), indiquez le texte à afficher pour le lien et cliquez sur le bouton Link (Lien) pour saisir la valeur Link URL (URL du lien).
Établir un lien à partir d’une autre application sous iOS ou Android
Vous pouvez créer un lien à utiliser dans des applications ArcGIS pour ouvrir Survey123 Mobile et capturer les données d’une enquête. Procédez comme suit pour créer un lien d’application Survey123 et l’utiliser dans la fenêtre contextuelle d’une carte Web. Ce lien est entré dans la fenêtre contextuelle d’une carte Web dans votre organisation ArcGIS. Vous pouvez tester le lien à l’aide d’un navigateur Web (en procédant comme dans la section précédente) sur un appareil iOS ou Android.
- Ouvrez une carte Web destinée à être affichée sur l’appareil et sélectionnez Pop-ups (Fenêtres contextuelles) pour l’une des couches.
- Sélectionnez Add content (Ajouter un contenu), puis Text (Texte).
- Saisissez Lancer Survey123, mettez ce texte en surbrillance, cliquez sur le bouton Link (Lien) pour saisir l’URL du lien, saisissez https://survey123-mobile.arcgis.app, cliquez sur OK et procédez comme suit :
- Ouvrez la carte Web sur un appareil mobile depuis un navigateur ou une application ArcGIS.
- Sélectionnez une entité et cliquez sur le lien Launch Survey123 (Lancer Survey123) dans la fenêtre contextuelle pour ouvrir Survey123.
- Pour ajouter l’enquête à l’URL, ajoutez ?itemID= et l’ID d’élément du formulaire à la fin de l’URL. L’URL doit ressembler à ce qui suit :
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19Si vous testez l’URL, celle-ci doit maintenant ouvrir Survey123 Mobile et ouvrir immédiatement l’enquête.
Remarque :
Si l’enquête n’est pas encore sur votre appareil, elle est téléchargée.
- Incluez des réponses prédéterminées aux questions en ajoutant dans l’URL une référence à un champ à l’aide du nom qui lui est attribué dans le formulaire XLSForm (et non de son étiquette).
Par exemple, pour renseigner le champ Surname, saisissez &field:surname= et la valeur.
Le paramètre & joue le rôle de séparateur et field: désigne le nom de la question à renseigner.
L’URL doit ressembler à ce qui suit :https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserVous pouvez maintenant utiliser l’URL pour ouvrir Survey123 Mobile et l’enquête, puis vous pouvez renseigner la question donnée avec la réponse que vous avez définie. Vous pouvez renseigner plusieurs questions dans une seule URL d’enquête. Les noms de champ sont sensibles à la casse.
- Définissez un emplacement pour une question géopoint dans l’enquête en ajoutant des coordonnées à l’URL comme suit :
- Saisissez ¢er=, puis entrez les coordonnées.
- Entrez les coordonnées de la latitude de la longitude en degrés décimaux, séparées par une seule virgule.
- Vous pouvez également ajouter l’altitude en mètres comme troisième valeur, également séparée par une seule virgule.
L’URL définitive doit ressembler à ce qui suit :
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Cette URL complète ouvre maintenant Survey123 Mobile et l’enquête que vous avez choisie, renseigne une question texte et fournit une localisation par défaut pour la question géopoint.
Paramètres d’URL permettant de lancer Survey123 Mobile
Les paramètres suivants permettent de personnaliser le mode d’ouverture de Survey123 Mobile :
| Paramètre | Description | Type |
|---|---|---|
center | Centre la carte sur les valeurs de latitude et de longitude connues, et éventuellement sur l’altitude. Exemple : | Chaîne |
field:fieldname | Renseigne les questions de l’enquête avec des valeurs de champ. Exemple : | Chaîne |
portalUrl | URL du portail qui héberge l’élément d’enquête. Exemple : | Chaîne |
itemID | Formulaire à ouvrir. Exemple : | UUID |
download | Télécharge automatiquement l’enquête lorsque l’appareil est en ligne. La valeur par défaut est true. Exemple : | Booléen |
callback | URL de renvoi lorsqu’une action de formulaire (par exemple envoyer, ajouter aux brouillons, annuler ou quitter) est réalisée. Exemple : | URL |
callback:status | Exemple : | Chaîne |
Vous avez un commentaire à formuler concernant cette rubrique ?