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 peuvent être ouverts à partir d’autres applications ArcGIS, ou ils peuvent ouvrir d’autres applications ArcGIS qui prennent en charge la liaison entre applications. Ils sont disponibles sur iOS et Android uniquement. Les applications ArcGIS qui peuvent être ouvertes 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 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 pour permettre la liaison. Les applications ArcGIS qui peuvent être ouvertes 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.

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

Vous pouvez créer un lien pour ouvrir l’application mobile QuickCapture, qui peut être incorporé dans une autre application. Ce même lien peut servir au test dans un navigateur Web. 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).

  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. Elle 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, 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é.

  4. Vous pouvez également inclure une variable d’entrée utilisateur de projet prédéterminée.
  5. Pour renseigner la variable d’entrée utilisateur de projet, saisissez &userInput= 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=Area7

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

  6. Les contenus des champs peuvent également être transmis à QuickCapture à 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.
  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 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={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={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 renseigner la variable d’entrée utilisateur de projet, saisissez &userInput= 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=Area7

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

  7. Le contenu des champs peut également être transmis à une variable d’entrée utilisateur de projet depuis Explorer.
  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={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={workArea}

Établir un lien vers une autre application depuis QuickCapture

Vous pouvez configurer un projet QuickCapture de façon à 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 du bouton de lien. Dans le concepteur, vous pouvez configurer le bouton de façon à 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 lancera le QuickCapture tableau de bord Marine Debris une fois sélectionné dans l’application mobile. Dans l’éditeur de texte, vous pouvez saisir n’importe quelle URL de type HTTPS, ou la structure d’URL personnalisée d’une autre application ayant autorisé QuickCapture.

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. 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 dans les 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, si vous voulez 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