Lancer l’application Web

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&center=37.8199,-122.4783

L’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ètreDescriptionType

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 :

isOrgSignIn=false

Booléen

center

Centre la carte sur la latitude connue, la longitude et éventuellement l’altitude.

Exemple :

center=37.8199,-122.4783,20

Chaîne

field:fieldname

Renseigne les questions de l’enquête avec des valeurs de champ.

Exemple :

 field:surname=Klauser

Chaîne

portalUrl

Spécifie l’URL du portail où l’élément d’enquête est hébergé.

Exemple :

portalUrl=https://myorg.arcgis.com

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 :

open=web

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 :

hide=header,description,footer,theme

Chaîne

locale

Permet à l’enquête de passer d’une langue à l’autre. Fonctionne uniquement si l’enquête comprend plusieurs langues.

Exemple :

locale=zh-cn

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 :

mode=edit&globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

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 :

globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

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 :

recalculate=field:question1,field:question2

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 :

version=latest

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 :

token=E60M4Gsc-h4Q8plqQ...

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 :

autoReload=3

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 :

encodeUrlParams=true

Booléen

width

Définit la largeur de l’enquête, en pixels. Cela affecte également d’autres contrôles dans l’enquête, par exemple les zones de texte.

Exemple :

width=1000

Entier

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