Skip To Content

Intégration dans d’autres applications

Survey123 for ArcGIS est capable de s'intégrer dans d’autres applications par le biais d’une structure d’URL personnalisée. Une structure d’URL peut être utilisée dans un navigateur web afin d’ouvrir des applications sur votre ordinateur de bureau ou un autre appareil, ou à partir d'une autre application. Les applications ArcGIS qui peuvent être ouvertes avec une structure d’URL comprennent Survey123, Collector for ArcGIS et Navigator for ArcGIS.

Pour vous aider à comprendre la structure d’URL, les sections suivantes décrivent comment construire une URL qui ouvre Survey123 depuis un navigateur Internet et comment ouvrir Navigator depuis Survey123.

Lien vers Survey123 à partir d’autres applications

Vous pouvez créer une URL pour ouvrir l’application de terrain ou web Survey123, à incorporer dans votre propre application native ou web. Cette même URL peut servir au test dans un navigateur Internet.

  1. Tapez arcgis-survey123:// dans votre navigateur. Cela ouvre automatiquement l'application de terrain Survey123 (ou vous invite à le faire).

    Vous pouvez également ajouter une référence unique à une enquête et l’ajouter à l’URL. Vous devez dans un premier temps identifier l’ID d’élément de l’enquête à ouvrir. C'est la chaîne de caractères qu'ArcGIS Online utilise pour identifier de manière unique votre enquête, contenue dans l’URL de votre élément de formulaire dans ArcGIS Online. Par exemple, si l’URL de votre formulaire est https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, l’ID d’élément de votre formulaire est 36ff9e8c13e042a58cfce4ad87f55d19.

  2. Pour ajouter votre enquête à l’URL que vous construisez, ajoutez ?itemID= et l’ID d’élément de votre formulaire à l’URL.
    L'URL doit ressembler à ce qui suit :

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    Si vous testez votre URL, celle-ci doit maintenant ouvrir l’application de terrain Survey123 et ouvrir immédiatement votre enquête.

    Remarque :

    Vous devez télécharger l’enquête sur votre appareil pour pouvoir l'ouvrir.

  3. Vous pouvez également ajouter des réponses prédéfinies aux questions. Pour ce faire, l’URL doit comprendre une référence au champ utilisant le nom qui lui est attribué dans XLSForm (non son étiquette). Par exemple, pour renseigner un champ nommé Nom, tapez &field:Nom=et la valeur que vous voulez saisir. Le signe & est un séparateur de paramètres, et field: fait référence au nom de la question à renseigner.
    L'URL doit ressembler à ce qui suit :

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    L’URL ouvre maintenant l’application de terrain Survey123 et votre enquête, et renseigne la question donnée avec la réponse que vous avez déclarée. Vous pouvez renseigner plusieurs questions dans une seule URL d’enquête. Les noms de champ sont sensibles à la casse.

  4. Vous pouvez éventuellement ajouter des coordonnées à l’URL, ce qui définit une emplacement pour une question géopoint dans l’enquête. Pour ce faire, tapez &center=, puis saisissez les coordonnées. Saisissez les coordonnées de la latitude puis de la longitude en degrés décimaux, séparées par une seule virgule. Si vous le souhaitez, vous pouvez 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://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

L’URL complète ouvre maintenant l’application de terrain Survey123 et l’enquête que vous avez choisie, renseigne une question de texte et fournit un emplacement par défaut pour la question géopoint.

Les contenus des champs peuvent être également transmis à Survey123 à partir d’une fenêtre contextuelle dans une carte Web ArcGIS, permettant l’intégration avec toutes les applications Esri qui utilisent les fenêtres contextuelles dans une carte Web. Cette fonctionnalité peut être utilisée pour compléter un champ dans Survey123 avec le contenu d’un attribut d’entités, plutôt qu’une valeur définie, en fournissant le nom de l’attribut joint entre parenthèses. Pour ce faire, sélectionnez Configure Pop-up (Configurer la fenêtre contextuelle) pour une couche existante de votre carte Web. Dans le menu déroulant d'affichage, sélectionnez un affichage d'attribut personnalisé, puis cliquez sur Configure (Configurer) et insérez un lien vers votre enquête.

Définissez le lien pour la structure d’URL dans l'attribut personnalisé

Cet exemple d’URL complèterait le champ Surname (Prénom) avec le contenu de l'attribut du nom de l’entité plutôt qu'avec une valeur définie.

arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname={name}

Remarque :

Actuellement, un bogue est lié à la structure d’URL de Survey123 existe : les valeurs ne peuvent être transmises aux questions à réponse unique ou à réponses multiples que si le nom et l’intitulé du choix sont identiques dans la liste de choix.

Transmission de paramètres à l'application web Survey123

L'application web Survey123 peut accepter des paramètres dans le même format que l’application de terrain. La seule différence réside dans le fait qu’un point d’interrogation doit être utilisé pour séparer l’ID d'élément de l'enquête et le premier paramètre, à la place du caractère esperluète (qui continue d’être utilisé pour séparer les paramètres). Dans l'exemple d’URL 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 est également compatible avec plusieurs 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.

ParamètresDescription

masquer

Masque les éléments de l’enquête dans l’application Web. Ce paramètre peut accepter plusieurs paramètres, séparés par une virgule. Les valeurs valides sont barre de navigation (la barre en haut de l’enquête, y compris les options pour se connecter, se déconnecter et changer la langue), en-tête, description, pied de page, thème et field:fieldName (une question spécifique à votre enquête, avec le nom de la question à la place de fieldName).

ouvrir

Détermine l’application utilisée pour ouvrir l’enquête. Les valeurs valides sont web (ouvre l’enquête dans l’application Web), native (ouvre l’enquête dans l’application de terrain, si l’application de terrain est installée) et menu (ouvre une page Web pour laisser l’utilisateur décider dans quelle application l’enquête sera ouverte). Si le paramètre n’est pas fourni, l’URL ouvre l’application Web.

lang

Permet à votre enquête de passer d’une langue à l’autre. Ce paramètre fonctionne uniquement si plusieurs langues sont définies pour votre enquête. Il accepte les codes régionaux, par exemple zh-cn.

mode

Définit le mode du formulaire web. Actuellement, la seule valeur valide est Edit (Modifier), qui indiquera à votre enquête de modifier une entrée existante plutôt que d’en créer une nouvelle. Gardez à l’esprit que pour modifier une enquête, le paramètre objectId doit également être fourni.

objectId

Définit l’enregistrement exact de l’enquête chargé dans le formulaire pour modification. Les valeurs valides sont les identifiants d’objets disponibles pour l’enquête. Gardez à l’esprit que ce paramètre est sensible à la casse.

version

Définir la version de l’application web qui sera utilisée. Actuellement, la seule valeur valide est Latest (Dernière), qui indique à l’application web d’utiliser la dernière version de l’application web, même si la version de l’enquête est verrouillée.

Transmission de paramètres à Survey123 Connect

La structure d’URL utilisée par Survey123 Connect est arcgis-survey123connect://, où l’utilisateur peut automatiquement télécharger et ouvrir une enquête pour la modifier.

Cette structure d’URL accepte d’autres paramètres que l’application de terrain ou Web, en acceptant l’ID de l’élément du formulaire et l’URL du portail où l’élément est stocké. Cette URL d’exemple ouvre une enquête spécifique dans Survey123 Connect depuis le portail ArcGIS Enterprise fourni, en la téléchargeant le cas échéant.

arcgis-survey123connect://?portalUrl=https://exampleportal.esri.com/arcgis&itemID=36ff9e8c13e042a58cfce4ad87f55d19

Si votre enquête est enregistrée dans ArcGIS Online, vous devez quand même fournir l’URL du portail de ArcGIS Online.

arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19

Remarque :

Actuellement, ces paramètres d’URL ne permettent d’ouvrir que les formulaires dont vous êtes déjà propriétaires. Ils ne vous permettent pas d’ouvrir des enquêtes auxquelles vous avez accès, mais que vous n’avez pas créées.

Lien vers d’autres applications à partir de Survey123

Vous pouvez créer une URL qui ouvre une autre application et l’insérer dans votre enquête. Ces applications peuvent également accepter des paramètres personnalisés dans leurs URL de la même façon que Survey123.

Pour commencer, vous devez ajouter une question note à votre enquête avec une étiquette contenant l’URL.

Remarque :

Dans iOS 9 et versions ultérieures, les structures d’URL doivent être ajoutées à une liste blanche, ou une liste de structures approuvées, au sein de l’application. Les structures d’URL qui sont répertoriées sur des listes blanches dans Survey123 sont les suivantes :

  • arcgis-appstudio-player
  • arcgis-collector
  • arcgis-trek2there
  • arcgis-explorer
  • arcgis-navigator
  • arcgis-workforce
  • comgooglemaps
  • foreflightmobile
  • waze
  • spike-partner

Structure d'URL Navigator

  1. Pour ouvrir Navigator à partir d'une enquête, saisissez le texte suivant comme étiquette d'une question note :

    <a href="arcgis-navigator://">Lancez Navigator</a>

  2. Navigator peut accepter les interruptions comme paramètres personnalisés pour vous permettre d’envoyer une destination spécifique à l'application. Pour ouvrir Navigator avec un arrêt désigné par les coordonnées données, reportez-vous à l’exemple suivant :

    <a href="arcgis-navigator://?stop=34.057419, -117.182646">Lancez Navigator</a>

  3. Vous pouvez éventuellement ajouter un paramètre pour retourner à l’application de terrain Survey123 une fois la navigation terminée. Ce paramètre est indiqué comme callback. L’exemple suivant comprend un rappel de l’application de terrain Survey123 :

    <a href="arcgis-navigator://?stop=34.057419, -117.182646&callbackprompt=Survey123&callback=arcgis-survey123://">Lancez Navigator</a>

Pour en savoir plus, consultezNavigator custom URL scheme (Structure d’URL personnalisée de Navigator).

Structure d'URL Collector

  1. Pour ouvrir Collector à partir d'une enquête vers une carte spécifique, fournissez l’identifiant de l'article, comme dans cet exemple :

    <a href="arcgis-collector://?itemID=35b1ccecf226485ea7d593f100996b49">Lancez Collector</a>

  2. Collector peut accepter center (centre) comme paramètre personnalisé pour fournir les coordonnées de latitude et de longitude pour un emplacement par rapport auquel centrer la carte. Pour ouvrir Collector avec un emplacement central spécifique, consultez l’exemple suivant :

    <a href="arcgis-collector://?itemID=35b1ccecf226485ea7d593f100996b49&center=34.0547155,-117.1961714">Lancez Collector</a>

Pour en savoir plus, consultezCollector custom URL scheme (Structure d’URL personnalisée de Collector).

Structure d'URL Explorer

  1. Pour ouvrir Explorer à partir d'une enquête vers une carte spécifique, fournissez l’identifiant de l'article, comme dans cet exemple :

    <a href="arcgis-explorer://?itemID=35b1ccecf226485ea7d593f100996b49">Lancez Explorer</a>

  2. Explorer peut accepter center comme paramètre personnalisé pour fournir les coordonnées de latitude et de longitude pour un emplacement par rapport auquel centrer la carte. Pour ouvrir Explorer avec un emplacement central spécifique, consultez l’exemple suivant :

    <a href="arcgis-explorer://?itemID=35b1ccecf226485ea7d593f100996b49&center=34.0547155,-117.1961714">Lancez Explorer</a>

Pour en savoir plus, consultezExplorer custom URL scheme (Structure d’URL personnalisée de Explorer).

Remarque :

Actuellement, la structure d'URL Explorer est en mesure d’accepter un seul paramètre personnalisé à la fois.