Intégration dans d’autres applications

Vous pouvez intégrer ArcGIS QuickCapture à d’autres applications, à l’aide d’un lien QuickCapture ou 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. Ils peuvent s’ouvrir ou peuvent ouvrir d’autres applications ArcGIS prenant en charge la liaison d’applications et sont disponibles sur uiOS et Android uniquement. Les applications ArcGIS que vous pouvez ouvrir via un lien QuickCapture sont notamment ArcGIS Survey123, ArcGIS Collector, ArcGIS Navigator et ArcGIS Explorer.

Les liens de la structure d’URL personnalisée commencent par arcgis-quickcapture:// et peuvent être ouverts depuis d’autres applications ArcGIS ou peuvent ouvrir d’autres applications ArcGIS sur Android et Windows. Pour utiliser un lien de structure d’URL personnalisée sur iOS, QuickCapture doit également être approuvé dans l’autre application afin de permettre la liaison. Les applications ArcGIS que vous pouvez ouvrir via une structure d'URL à partir de QuickCapture sont notamment ArcGIS Survey123 et Collector for ArcGIS (Classic).

L’utilisation d’une structure d’URL personnalisée sur Windows est un très bon moyen de créer et de tester votre lien et ses paramètres avant de le déployer auprès de vos opérateurs de terrain, que ce soit en tant que structure d’URL personnalisée ou en tant que lien QuickCapture.

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.

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
portalUrl

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

portalUrl=https://myorg.arcgis.com

Chaîne

externalBrowserSignIn

Indique d'utiliser un navigateur externe pour se connecter

externalBrowserSignIn=true

Booléen

itemID

Spécifie le projet à ouvrir.

itemID=36ff9e8c13e042a58cfce4ad87f55d19

UUID

userInput

Indique la valeur avec laquelle la variable d’entrée utilisateur de projet doit être alimentée.

userInput:001=Area7

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.

  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=dcdb68465fbc4c38a6aba7f5165cdfd4, l’ID d’élément de votre projet est dcdb68465fbc4c38a6aba7f5165cdfd4.

  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=dcdb68465fbc4c38a6aba7f5165cdfd4

    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 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 :

    arcgis-quickcapture://?itemId=dcdb68465fbc4c38a6aba7f5165cdfd4&userInput:001=Area7

    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. 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=dcdb68465fbc4c38a6aba7f5165cdfd4&userInput:001=Area7&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.

    Définissez le lien de la structure d’URL dans l’attribut personnalisé.

    Pour insérer 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 :

    arcgis-quickcapture://?itemId=dcdb68465fbc4c38a6aba7f5165cdfd4&userInput:001={workArea}.

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 une fenêtre contextuelle Explorer. Ces liens sont inclus dans la fenêtre contextuelle d’une carte Web de votre organisation ArcGIS. Vous pouvez tester ces liens à l’aide d’un navigateur Web (en suivant des étapes similaires à celles de la section ci-dessus) sur un appareil iOS ou Android. Cependant, les liens ne fonctionneront pas sur Windows.

  1. Sélectionnez Configure Pop-up (Configurer la fenêtre contextuelle) pour une couche existante de votre carte Web qui sera affichée dans Explorer.
  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. Lancez votre carte Web dans Explorer sur un appareil mobile.
    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=dcdb68465fbc4c38a6aba7f5165cdfd4

    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=dcdb68465fbc4c38a6aba7f5165cdfd4&userInput:001=Area7

    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 Explorer.
  8. Pour insérer 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=dcdb68465fbc4c38a6aba7f5165cdfd4&userInput:001={workArea}

É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.

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://quickcapture.maps.arcgis.com/apps/webappviewer/index.html?id=00d69d13b139455ea8f3256a884a89fd comme URL.

Cette opération génère un bouton de lien qui lance le Marine Debris Dashboard (Tableau de bord Marine Debris) de QuickCapture une fois qu'il a été sélectionné 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

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