L’application Web Survey123 peut accepter les paramètres au même format que l’application de terrain. Notez cependant que l’ID d’élément de l’enquête fait partie du chemin de l’URL et non d’un paramètre d’URL (utilisé par les autres liens pour ouvrir les enquêtes). Lorsque vous ajoutez des paramètres à cette URL, vous devez utiliser un point d’interrogation pour séparer l’ID d’élément d’enquête dans le chemin du premier paramètre, puis utiliser des perluètes pour séparer les paramètres suivants. Dans l’URL figurant dans l’exemple suivant, le nom de famille et les paramètres de coordonnées sont transmis à une enquête dans l’application Web Survey123 :
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783L’application Web Survey123 prend également en charge un certain nombre de paramètres avec lesquels l’application de terrain Survey123 n’est pas compatible. Ces paramètres concernent la présentation de l’enquête dans un navigateur. Pour les paramètres d’URL et des exemples qui personnalisent le mode d’ouverture de l’application Web, reportez-vous au tableau ci-après.
Remarque :
Si une valeur de paramètre contient des espaces, des signes plus (+) ou d’autres caractères spéciaux, ces caractères doivent être codés avec le signe pour cent. Pour plus d’informations, reportez-vous à la rubrique Encodage d’URL.
Paramètres d’URL permettant de lancer l’application Web
| Paramètre | Description | Type |
|---|---|---|
signIn | Pour les enquêtes publiques, affiche le bouton de connexion ou demande aux utilisateurs de se connecter. Par défaut, l’application web ne propose pas de méthode de connexion des utilisateurs pour les enquêtes publiques, mais les enquêtes publiques peuvent inclure des entités qui fonctionnent uniquement lorsque les utilisateurs sont connectés. Par exemple, il est possible d’utiliser un calcul pour extraire l’adresse e-mail d’un utilisateur connecté. Les valeurs valides sont show, qui affiche le bouton de connexion dans la barre de navigation en haut de l’application web, et require, qui demande aux utilisateurs de se connecter en les redirigeant vers la page de connexion. Exemple : | Chaîne |
isOrgSignIn | Utilise la page de connexion spécifique de l’organisation. Par défaut, Survey123 utilise la page de connexion spécifique de l’organisation. Toutefois, lorsque des enquêtes sont partagées avec plusieurs organisations, il est préférable d’utiliser la page de connexion ArcGIS Online. Définissez ce paramètre sur false pour utiliser la page de connexion ArcGIS Online. Exemple : | Booléen |
center | Centre la carte sur la latitude connue, la longitude et éventuellement l’altitude. Exemple : | Chaîne |
field:fieldname | Renseigne les questions de l’enquête avec des valeurs de champ. Exemple : | Chaîne |
portalUrl | Spécifie l’URL du portail où l’élément d’enquête est hébergé. Exemple : | Chaîne |
| open | Spécifie l’application utilisée pour ouvrir l’enquête. Les valeurs valides sont web, qui ouvre l’enquête dans l’application Web (par défaut), native, qui ouvre l’enquête dans l’application de terrain si cette dernière est installée et menu, qui ouvre une page Web qui permet d’indiquer l’application qui ouvrira l’enquête. Exemple : | Chaîne |
| hide |
Masque les éléments de l’enquête dans l’application Web. Le paramètre peut accepter plusieurs valeurs séparées par une virgule. Les valeurs valides sont navbar (barre en haut de l’enquête, avec les options permettant de se connecter, de se déconnecter et de changer de langue), header, description, footer, submit, theme et leaveDialog (message d’avertissement affiché lorsque l’utilisateur s’éloigne de la page ou la ferme). Vous pouvez également utiliser le paramètre field:fieldName pour masquer une question, un groupe, une page ou une répétition spécifique, en spécifiant le nom au lieu de fieldName. Les questions dans les répétitions ne peuvent pas être masquées individuellement. Exemple : | Chaîne |
| locale | Permet à l’enquête de passer d’une langue à l’autre. Fonctionne uniquement si l’enquête comprend plusieurs langues. Exemple : | Chaîne |
| mode | Définit le mode de l’application Web. Les valeurs valides sont edit, qui permet à l’enquête de modifier une entrée existante plutôt que d’en créer une ; view qui ouvre une entrée existante en lecture seule et copy, qui crée une enquête dont le contenu correspond à l’entrée spécifiée. Lorsque vous utilisez ce paramètre, le paramètre globalId doit également être indiqué. Exemple : | Chaîne |
| globalId | Spécifie l’enregistrement de l’enquête qui est chargé dans le formulaire. Les valeurs valides sont les ID globaux des enregistrements existants de l’enquête. Le nom de ce paramètre est sensible à la casse. Exemple : | Chaîne |
recalculate | Peut uniquement être utilisé avec mode=edit. Force les questions spécifiées à être recalculées lorsque l’enquête est chargée, sans utiliser le bouton Recalculate (Recalculer). Exemple : | Chaîne |
| version | Définit la version de l’application Web qui sera utilisée. La seule valeur valide est latest, qui utilise la dernière version de l’application Web, même si la version de l’enquête est verrouillée. Exemple : | Chaîne |
| token | Transmet un jeton valide pour une enquête. Vous pouvez utiliser ce paramètre pour autoriser les participants à répondre à une enquête nécessitant un compte ArcGIS sans se connecter. Exemple : | Chaîne |
autoReload | Recharge l’enquête après la soumission. Spécifiez le délai (en secondes) avant le rechargement de l’enquête. Auparavant appelé autoRefresh. Le paramètre autoRefresh est pris en charge dans le cadre de la rétrocompatibilité. Exemple : | Entier |
| encodeUrlParams | Masque les paramètres d’URL. L’URL obtenue comprend en revanche un paramètre code qui représente tous les paramètres codés. Les paramètres inclus en dehors de ce paramètre code sont ignorés. Exemple : | Booléen |
width | Définit la largeur de l’enquête, en pixels ou en tant que fraction de la largeur de l’écran. Une valeur supérieure à 1 définit la largeur en pixels. Si la valeur en pixels est inférieure à la largeur de l’écran, la largeur de l’écran est utilisée. Une valeur comprise entre 0 et 1 définit la largeur du formulaire comme une fraction de la largeur de l’écran. Cela affecte également d’autres contrôles dans l’enquête, par exemple les zones de texte, et peut contribuer à l’amélioration de l’affichage par l’application web d’une grille fixe ou dynamique. Exemples : | Chaîne |
Remarque :
Le paramètre field:fieldname prend en charge les questions de type géopoint, géotrace et géoforme dans l’application Web. Pour les questions de type géopoint, indiquez la latitude, la longitude et l’altitude (facultatif) séparées par des espaces. S’agissant de la géotrace et de la géoforme, indiquez pour chaque sommet la latitude et la longitude séparées par un espace, chaque paire de coordonnées étant séparées par un point-virgule. Cet exemple fonctionne pour une question de type géoforme :
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766
Vous avez un commentaire à formuler concernant cette rubrique ?