Configurer les actions de lancement pour Indoor Viewer

Disponible pour une organisation ArcGIS disposant d’une licence pour l’extension Indoors.

ArcGIS Indoors comprend la prise en charge d’actions de lancement d’applications tierces à partir du volet d’informations figurant dans Indoor Viewer. Les actions de lancement d’applications sont une façon d’incorporer vos systèmes métier essentiels à ArcGIS Indoors.

Il est possible de configurer une action de lancement pour ouvrir une page Web ou une application mobile native et transmettre automatiquement des données intérieures au système ou à l’application cible. Cela permet aux utilisateurs de soumettre des incidents ou des requêtes sur une entité sélectionnée dans Viewer. Ils peuvent afficher les informations sur une entité sélectionnée dans l’application Viewer et renseigner automatiquement les champs des formulaires avec des informations à jour à l’aide d’une page Web ou d’une application mobile.

Vous pouvez configurer des actions de lancement Viewer des manières suivantes :

  • À l’aide de la fenêtre Configure Indoors Launch Actions (Configurer des actions de lancement Indoors) dans ArcGIS Pro. Les actions de lancement configurées dans ArcGIS Pro peuvent ensuite être modifiées lors de la configuration de l'application.
    Remarque :

    Les modifications apportées dans le volet Configure App (Configurer l’application) affectent uniquement les actions de lancement dans l’application Viewer.

  • À l’aide du volet Configure App (Configurer l’application) lorsque vous créez ou modifiez une application. Dans le volet de configuration, vous pouvez modifier les actions de lancement créées dans ArcGIS Pro ou en créer de nouvelles.

Remarque :

Indoors permet de positionner des épingles sur des emplacements situés en dehors d’un bâtiment, tels que les jardins d’un site. Si une action de lancement est appliquée à All Layers (Toutes les couches) dans le panneau de configuration, elle est également disponible pour ces épingles.

Configurer des actions de lancement à l’aide du volet de configuration

Au cours de la configuration de l’application Viewer, procédez comme suit pour modifier les actions de lancement de l’application créées dans ArcGIS Pro ou créer de nouvelles actions :

  1. Dans le volet Configure App (Configurer l’application), accédez à la section App Launch (Lancement de l’applicatio).
    Remarque :

    Si vous avez configuré des actions de lancement dans ArcGIS Pro, elles apparaissent dans la section App Launch (Lancer l’application) et vous pouvez les mettre à jour si nécessaire.

  2. Si vous le souhaitez, ajoutez une nouvelle action.
    1. Cliquez sur Add (Ajouter) pour ajouter une nouvelle action.
    2. Attribuez un nom à l’action dans la zone de texte Label (Étiquette).
    3. Ajoutez l’URL correspondant à l’action dans la zone de texte URL.
    4. Cliquez sur Select Categories and Layers (Sélectionner les catégories et les couches) et cochez la case des couches et catégories avec lesquelles associer l’action.

      Par défaut, toutes les couches et sous-catégories sont sélectionnées.

    5. Cliquez sur  OK.
    6. Répétez les étapes ci-dessus pour toute action supplémentaire.
  3. Cliquez sur le bouton Remove (Supprimer) Retirer en regard des actions de lancement à supprimer.
  4. Réorganisez les actions à l’aide des flèches dirigées vers le haut et le bas, si nécessaire.
  5. Cliquez sur Save (Enregistrer) pour enregistrer les modifications apportées au modèle d’application.

Les actions de lancement apparaissent dans une liste lorsque vous cliquez sur le bouton More (Plus) Plus dans le volet d’informations pour les entités des catégories et couches dotées d’actions de lancement configurées.

Syntaxe URL

Les actions de lancement sont activées par des URL, et la syntaxe doit se conformer aux conventions d’écriture des URL courantes. Par exemple, les caractères spéciaux figurant dans les arguments doivent être codés au format URL. Les paires d’arguments ou de valeurs doivent être séparées selon les conventions standards relatives aux URL.

Pour Indoors, les valeurs doivent être placées entre accolades et respecter la syntaxe suivante :

?arg={Layer.Attribute}&arg={Attribute}

Remarque :

La couche est facultative. Si elle n’est pas incluse, elle prend par défaut la valeur de l’élément actif dans l’application Indoors. Dans de nombreuses situations, il est nécessaire de transmettre les attributs d’une couche différente dans la carte ou la scène. Cette opération est prise en charge par l’opérateur de la couche. Les arguments et les valeurs ignorent la casse.

Consultez les exemples ci-dessous :

Valeur unique

?Name={KNOWNAS}&building={facility_name}&space={Units.Name}

Valeurs multiples

?center={shape.y},{shape.x}

Valeur provenant d’une autre classe d’entités

&site={FACILITIES.SITE_ID}

Transmettre la valeur à un champ spécifique

&field:room={units.name}

Formats des arguments et des valeurs pris en charge

L’URL des actions de lancement prend en charge la transmission d’une valeur avec un argument générique (field={Units.UNIT_ID}) ou la désignation d’une valeur à un champ spécifique dans le formulaire Survey123 (field:room={Units.Name}).

Par ailleurs, il est possible d’énumérer plusieurs arguments ensemble et d’y intercaler du texte.

Exemple

https://<MySurveyURL>?Name={knownas}&office=office%3A%20{units.NAME}&loc={shape.x},{shape.y},{shape.z}

Intégration à Survey123

Survey123 est inclus avec votre licence Indoors. En l’absence de tout autre système de bons de travail ou de tickets, les actions de lancement peuvent être configurées pour utiliser Survey123.

Pour personnaliser l’expérience du bouton d’action avec Survey123, ajoutez un argument ou une paire de valeurs valides à l’URL.

Lorsque vous créez une enquête dans votre organisation ArcGIS Online, l’URL servant à partager l’enquête est raccourcie par défaut. Pour activer des actions de lancement, vous devez utiliser l’URL complète lorsque vous ajoutez des arguments et des paires. Pour obtenir l’URL complète d’une enquête existante, procédez comme suit :

  1. Dans Survey123, cliquez sur l’onglet My Surveys (Mes enquêtes) et sur l’enquête pour laquelle vous voulez créer une action de lancement.
  2. Cliquez sur l’onglet Collaborate (Collaborer) et sur Share survey (Partager l’enquête).
  3. Copiez l’URL raccourcie, collez-la dans un navigateur et chargez l’enquête.

    L’URL complète apparaît dans la barre d’adresse.

  4. Copiez l’URL complète à partir de la barre d’adresse.

Vous pouvez maintenant ajouter des arguments et des paires à cette URL pour configurer des actions de lancement.

Exemple : URL de base du comportement par défaut

https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal

Exemple : URL personnalisée

Cet exemple remplace la salle par défaut en entrée par le champ de nom issu de la couche Units (Unités).

https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal&field:room={Units.NAME}

Exemple : lancer l’application native Survey123 sur les appareils mobiles

arcgis-survey123://?itemID=surveyformGUID&portalUrl=https://myportal.myorg.com/portal&field:comments={Units.NAME}

Remarque :

Lors de la configuration des actions de lancement à utiliser dans Viewer, faites attention aux URL spécifiques des applications mobiles natives, car elles ne sont pas prises en charge dans les versions pour ordinateurs de bureau. N’utilisez l’URL d’une application native que lors de la définition d’actions de lancement pour des processus prenant en charge les applications natives Indoors ou Viewer accessibles depuis un navigateur mobile.

Intégration de systèmes tiers

Vous pouvez également configurer le bouton d’action pour ouvrir une URL de tiers et lui transmettre des valeurs attributaires, à condition que le système tiers prenne en charge les formes d’URL configurables ou les paramètres destinés à déclencher les actions dès le lancement. En pareil cas, utilisez une URL appelant le système dans la configuration de l’application Indoors à l’aide de l’URL appropriée pour le système intégré. Des systèmes tiers de gestion des bons de travail ou des actifs sont couramment utilisés.

Tenez compte des éléments suivants si vous utilisez des systèmes tiers :

  • L’opérateur field: peut être différent.
  • Les formulaires Web prenant en charge les arguments URL peuvent nécessiter une configuration supplémentaire.
  • Pour savoir si cela fonctionne et comment cela fonctionne, consultez le fabricant du système intégré.

Remarque :

Selon le système métier utilisé, il arrive que certains caractères ne soient pas acceptés, comme le caractère # ou +.

Intégration de systèmes de gestion des bons de travail

Indoors prend en charge le lancement de systèmes externes de gestion des bons de travail et des actifs. Le bouton d’action situé sur le volet d’informations dans Viewer peut-être configuré de manière à ouvrir soit un formulaire Web ou une application native tierce permettant d’enregistrer de nouvelles informations, comme des incidents ou des demandes associés à un espace, une ressource ou un autre élément dans Indoors, soit un bon de travail existant dans une application distincte.

Indoors prend en charge la transmission des attributs de bons de travail et de la couche Indoors sous forme d’une chaîne de requête dans l’URL. Pour prendre en charge le lancement des actions, la syntaxe doit suivre le schéma URL/URI pour Indoors et le système de bons de travail.

La valeur attributaire doit être placée entre accolades et respecter la syntaxe suivante :

?arg={Work order Attribute}&arg={Layer.Attribute}

Voici des exemples de syntaxe supplémentaires :

Valeur unique d’une couche de bons de travail

?arg={workorderid}

Valeurs multiples d’une couche de bons de travail

?arg={workorderid}&arg={priority}

Valeur d’un bon de travail et d’une couche Indoors

?arg={workorderid}&arg={Layer.Attribute}

URL de ServiceNow

L’exemple suivant transmet le numéro du bon de travail sous forme d’un paramètre et ouvre un bon de travail existant :

https://<MyServerURL>/nav_to.do?uri=task.do?sysparm_query=number={workorderid}

Consultez d’autres exemples de configuration d’actions de lancement pour le système ServiceNow.