Intégration dans d’autres applications

ArcGIS QuickCapture peut être intégré dans d’autres applications, soit à l’aide d’un lien QuickCapture, soit à l’aide d’une structure d’URL personnalisée. Ces deux méthodes prennent en charge les mêmes paramètres, mais il existe des différences en fonction de la plateforme.

Les liens QuickCapture commencent par https://quickcapture.arcgis.app et fonctionnent uniquement sous iOS et Android. Les liens QuickCapture sont conformes aux exigences définies par l’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. Les applications ArcGIS que vous pouvez ouvrir via un lien QuickCapture sont notamment ArcGIS Survey123, ArcGIS Field Maps, ArcGIS Workforce et ArcGIS Navigator.

Les liens de structure d’URL personnalisée commencent par arcgis-quickcapture:// et fonctionnent sous Windows, sous Android et avec un groupe d’applications précis sous iOS. Les applications ArcGIS que vous pouvez ouvrir via une structure d’URL à partir de QuickCapture sont notamment ArcGIS Survey123 et ArcGIS Collector sous Windows. 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-quickcapture://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open project</a>

Les liens QuickCapture sont la méthode de liaison privilégiée des applications et les structures d’URL personnalisées sont la méthode privilégiée pour partager des projets.

Avant d’utiliser un lien qui contient des paramètres permettant de lancer un projet dans l’application mobile, il est préférable que l’application soit déjà installée sur l’appareil.

Paramètres de l’application mobile

Vous pouvez utiliser les paramètres suivants pour personnaliser le mode d’ouverture de l’application mobile :

ParamètreDescriptionExempleType

action

Spécifie le mode d’ouverture d’un projet. Les valeurs prises en charge sont press (pour appuyer sur un bouton identifié) et field (pour renseigner un champ correspondant à un bouton).

Les boutons sont identifiés par un GUID, qui s’affiche au bas des boutons de l’onglet Appearance (Apparence) dans le concepteur QuickCapture.

Pour capturer une entité ponctuelle, ou bien pour démarrer ou arrêter la capture d’une entité linéaire ou surfacique : action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4

Pour capturer une entité et renseigner le champ de diamètre de cette entité à l’aide de la valeur 20 : action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4&field:diameter=20

Chaîne

callback

Spécifie l’URL vers laquelle renvoyer lorsque l’utilisateur clique sur un bouton.

callback=https://survey123.arcgis.app

URL

center

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

center=37.8199,-122.4783,20

Chaîne

externalBrowserSignIn

Indique d'utiliser un navigateur externe pour se connecter

externalBrowserSignIn=true

Booléen

itemID

Spécifie le projet à ouvrir.

itemID=aabda4a5e36d42c2bcf1c479fe01e5e3

UUID

portalUrl

Spécifie l’URL du portail où l’élément de projet QuickCapture est hébergé.

portalUrl=https://myorg.arcgis.com

Chaîne

userInput

Indique l’ID et la valeur avec lesquels la variable d’entrée utilisateur de projet doit être renseignée.

userInput:001=Alice

Chaîne

Lien vers QuickCapture à partir d’un navigateur Web de bureau

Vous pouvez créer un lien pour ouvrir l'application mobile QuickCapture que vous pouvez imbriquer dans une autre application. Vous pouvez entrer ce même lien dans un navigateur Web à des fins de tests. Les étapes suivantes expliquent comment créer une structure d’URL personnalisée et l’utiliser dans un navigateur Web de bureau :

Remarque :

Une fois votre lien créé, vous pouvez remplacer arcgis-quickcapture:// par https://quickcapture.arcgis.app afin qu’il fonctionne comme un lien QuickCapture sur iOS ou Android.

  1. Saisissez arcgis-quickcapture:// dans votre navigateur.
    L’application mobile QuickCapture s’ouvre (ou vous êtes invité à l’ouvrir).
    Remarque :

    Pour lancer et télécharger un projet à partir d’un portail spécifique, incluez le paramètre d’URL du portail ; par exemple, arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor (où host, domain et webadaptor sont remplacés par les informations sur votre portail). Pour utiliser un navigateur externe afin de vous connecter, incluez le paramètre externalBrowserSignIn et définissez-le sur vrai ; par exemple, arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor&externalBrowserSignIn=true.

  2. Vous pouvez également ajouter une référence unique à un projet et l’ajouter à l’URL. Vous devez dans un premier temps identifier l’ID d’élément du projet à ouvrir. Il s’agit de la chaîne de caractères utilisée par ArcGIS Online pour identifier de manière unique votre projet. Cette chaîne fait partie de l’URL de votre élément de projet dans ArcGIS Online. Par exemple, si l’URL de votre projet est https://exampleurl.maps.arcgis.com/home/item.html?id=aabda4a5e36d42c2bcf1c479fe01e5e3, l’ID d’élément de votre projet est aabda4a5e36d42c2bcf1c479fe01e5e3.

  3. Pour inclure votre projet dans l’URL que vous construisez, ajoutez ?itemID= et l’ID d’élément de votre projet à l’URL.
    L’URL doit ressembler à ce qui suit :

    arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3

    Si vous testez votre URL, elle ouvre maintenant l’application mobile QuickCapture et ouvre immédiatement votre projet.

    Remarque :

    Si le projet n’est pas déjà présent sur votre appareil, il est téléchargé.

  4. Vous pouvez également inclure une variable d’entrée utilisateur de projet prédéterminée.
  5. Pour renseigner une variable d’entrée utilisateur de projet, saisissez &userInput:, ainsi que l’ID d’entrée utilisateur et la valeur séparés par le signe égal (=).
    Remarque :

    L’esperluette (&) fait office de séparateur de paramètres.

    Chaque entrée utilisateur de projet a un ID unique. Pour voir l’ID, passez à la vue JSON de votre projet et recherchez userInputs. Chaque entrée utilisateur de projet est répertoriée comme matrice de propriétés. Le premier élément est l’ID.

    ID d’entrée utilisateur affiché en JSON

    L’URL doit ressembler à ce qui suit :

    arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice

    Cette URL ouvre l’application mobile QuickCapture et votre projet. La valeur d’entrée utilisateur de projet Alice est utilisée dans tous les champs configurés pour l’accepter. Vous pouvez ajouter jusqu’à trois valeurs d’entrée utilisateur de projet à un projet. Une URL à plusieurs valeurs d’entrée utilisateur de projet doit ressembler à ce qui suit :

    arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice&userInput:002=Zone5

  6. Vous pouvez également transmettre les contenus des champs à QuickCapture à partir d’une fenêtre contextuelle dans une carte Web ArcGIS, ce qui permet de les intégrer à toutes les applications Esri qui utilisent des fenêtres contextuelles dans une carte Web.
  7. 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 a custom attribute display (Un affichage d’attribut personnalisé), cliquez sur Configure (Configurer) et insérez un lien vers votre projet.

    Pour renseigner une variable d’entrée utilisateur de projet avec la valeur du champ observer pour l’entité à partir de laquelle le lien a été lancé, saisissez &userInput:001={observer}. L’esperluette (&) fait office de séparateur de paramètres et les accolades ({}) indiquent un nom de champ.

    L’URL doit ressembler à ce qui suit :

    arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}.

Lien vers QuickCapture à partir d’une autre application

Vous pouvez créer un lien à utiliser dans d’autres applications pour lancer QuickCapture et capturer un enregistrement. Les étapes suivantes expliquent comment créer un lien QuickCapture 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 ci-dessus) sur un appareil iOS ou Android.

  1. Sélectionnez Configure Pop-up (Configurer la fenêtre contextuelle) pour une couche existante d’une carte Web qui sera affichée sur l’appareil.
  2. Dans le menu déroulant d’affichage, sélectionnez a custom attribute display (Un affichage d’attribut personnalisé), cliquez sur Configure (Configurer) et insérez un lien vers votre projet.
  3. Saisissez https://quickcapture.arcgis.app comme paramètre URL paramètre, saisissez Launch QuickCapture (Démarrer QuickCapture) comme Link Text (Texte du lien), puis cliquez sur OK.
    1. Ouvrez votre carte Web sur un appareil mobile depuis un navigateur ou une application ArcGIS.
    2. Sélectionnez une entité et cliquez sur le lien Launch QuickCapture (Démarrer QuickCapture) dans la fenêtre contextuelle pour lancer QuickCapture.
  4. Pour inclure votre projet dans l’URL que vous construisez, ajoutez ?itemID= et l’ID d’élément de votre projet à l’URL.
    L’URL doit ressembler à ce qui suit :
    https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3

    Si vous testez votre URL, celle-ci doit maintenant ouvrir l’application mobile QuickCapture et ouvrir immédiatement votre projet.

    Remarque :

    Si le projet n’est pas encore présent sur votre appareil, il est téléchargé.

  5. Vous pouvez également inclure une variable d’entrée utilisateur de projet prédéterminée.
  6. Pour insérer la variable d’entrée utilisateur de projet, saisissez &userInput:id= et la valeur que vous souhaitez entrer. L’esperluette (&) fait office de séparateur de paramètres.

    L’URL doit ressembler à ce qui suit :

    https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice

    Cette URL ouvre l’application mobile QuickCapture et votre projet. La valeur d’entrée utilisateur de projet Area7 est utilisée dans tous les champs configurés pour l’accepter.

  7. Vous pouvez également transmettre le contenu des champs à une variable d’entrée utilisateur de projet depuis une application ArcGIS.
  8. Pour renseigner une variable d’entrée utilisateur de projet avec la valeur du champ workArea pour l’entité à partir de laquelle le lien a été lancé, saisissez &userInput:001={workArea}. L’esperluette (&) fait office de séparateur de paramètres et les accolades ({}) indiquent un nom de champ.

    L’URL doit ressembler à ce qui suit :

    https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}

Établir un lien vers une autre application depuis QuickCapture

Vous pouvez configurer un projet QuickCapture de manière à ce qu’il lance une autre application via un bouton qui ouvre une URL. Cela permet aux opérateurs de terrain d’utiliser facilement QuickCapture et d’autres applications.

Pour établir un lien vers une autre application depuis QuickCapture, vous devez configurer un projet en ajoutant un bouton de lien et en configurant l’URL de ce bouton. Dans le concepteur, vous pouvez configurer le bouton de manière à ouvrir une URL dédiée, par exemple une URL personnalisée ou un lien d’application qui lance une autre application Esri. Dans le cas de l’application de terrain ArcGIS Survey123, vous pouvez également accéder à un formulaire d’enquête, le sélectionner et prédéfinir les valeurs des questions.

Bouton Configure a link (Configurer un lien)

Pour configurer un bouton qui lance une URL dans un tableau de bord, procédez comme suit :

  1. Cliquez sur le bouton et accédez à l’onglet Link (Lien).
  2. Cliquez sur URL.
  3. Saisissez https://www.arcgis.com/apps/dashboards/747e7365d1894db4bbadf100f65cf991 comme URL.

Cette opération génère un bouton de lien qui lance la fenêtre QuickCapture BioBlitz dashboard (Tableau de bord BioBlitz) après sa sélection dans l’application mobile. Dans l’éditeur de texte, vous pouvez saisir toute URL de type HTTPS ou la structure d’URL personnalisée d’une autre application ayant autorisé QuickCapture.

Remarque :

Vous pouvez créer des liens pour lancer des applications de communication (par exemple, e-mail, SMS et téléphone). Cela permet aux utilisateurs d'accéder rapidement à l’aide dans le projet. Voici quelques exemples de liens d’application de communication :

  • Envoyer un e-mail : mailto:sample@esri.com?subject=Fix%20the%20pipe&body=We%20really%20need%20to%20fix%20the%20pipe
  • SMS : sms:0291920995 (Sur Android, un corps de message peut également être inclus : sms:0291920995?body=We%20really%20need%20to%20fix%20the%20pipe)
  • Téléphone : tel:0291920995

Configurer un bouton ArcGIS Survey123

Pour configurer un bouton qui lance l’application de terrain ArcGIS Survey123, procédez comme suit :

  1. Cliquez sur le bouton et accédez à l’onglet Link (Lien).
  2. Cliquez sur Survey123 field app (Application de terrain Survey123).
  3. Sélectionnez une enquête à relier au bouton.

    Ceci définit le paramètre itemID dans le lien Survey123.

  4. Cliquez sur Add (Ajouter) pour ajouter une question d’enquête et apparier une valeur fixe, une variable de l’appareil ou une entrée utilisateur de projet à la question.

    Ceci définit la valeur du paramètre field:fieldname spécifié dans le lien Survey123. Répétez cette étape pour ajouter toutes les questions d’enquête requises. Pour supprimer une question d’enquête qui a été configurée, cliquez sur le bouton de suppression. Ceci supprime le paramètre field:fieldname spécifié dans le lien Survey123.

  5. Le cas échéant, activez l’option Pass location to Survey123 (Transmettre la localisation à Survey123) pour inclure le paramètre center avec les valeurs de latitude et de longitude dans le lien Survey123.

    Si une question de point géographique est incluse dans l’enquête, la carte est centrée sur la localisation transmise à l’enquête à partir de QuickCapture.

  6. Vous pouvez également activer Return to QuickCapture (Revenir à QuickCapture) pour rediriger l’utilisateur vers QuickCapture lorsqu’une enquête est envoyée.

    Ceci ajoute le paramètre callback:submit dans le lien Survey123.

Le concepteur construit le lien Survey123 automatiquement.

Votre URL doit ressembler à ce qui suit. Cet exemple inclut une valeur fixe pour condition, une variable de l’appareil pour capturetime et une entrée utilisateur de projet pour username.

arcgis-survey123://?itemID=2a41c332e24644ee895bbbd9b929773f&field:condition=damaged&field:capturetime=${captureTime}&field:username=${userInput:001}

Vous pouvez également construire manuellement le lien Survey123 avec l’option URL. Dans l’éditeur de texte, construisez l’URL manuellement ou utilisez la barre d’outils pour ajouter une valeur prédéfinie aux paramètres d’URL. Vous pouvez sélectionner une valeur fixe, une variable de l’appareil ou une variable d’entrée utilisateur de projet à ajouter à l’URL. Les variables sont désignées à l’aide d’accolades ({}) dans l’URL que vous avez construite. La valeur réelle entre accolades est renseignée automatiquement par l’application mobile lorsque le bouton est activé.

Lorsque vous basculez entre les options URL et Survey123 field app (Application de terrain Survey123), l’URL existante est ignorée.

Pour plus d’informations sur les paramètres pris en charge par Survey123, reportez-vous à la rubrique Intégrer Survey123 dans d’autres applications.

Remarque :

Lorsque vous attribuez des variables aux questions d’enquête, le type de champ doit correspondre.

Même si les paramètres d’URL qui ne sont pas codés fonctionnent dans certains environnements, il est conseillé de coder les paramètres d’URL lorsque vous construisez une URL manuellement. Le codage remplace les caractères non valides par le signe de pourcentage (%) suivi de leur équivalent hexadécimal. Par exemple, pour inclure le paramètre de rappel, votre URL doit ressembler à ce qui suit :

arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback:submit=https%3A%2F%2Fquickcapture.arcgis.app%253FitemID%99c18758066b42e1a0f4027603070b34