Configurer les actions de lancement

Disponible avec l’extension ArcGIS Indoors Pro ou ArcGIS Indoors Maps.

ArcGIS Indoors prend en charge les actions de lancement d’applications tierces directement dans le volet d’informations de Indoor Viewer et la fiche d’informations figurant dans les applications mobiles Indoors. Ces actions de lancement permettent aux organisations d’intégrer des informations concernant les éléments Indoors ou les éléments disponibles dans des couches supplémentaires de bons de travail, d’actifs ou d’autres points d’intérêt éventuellement inclus dans la carte Indoors à d’autres applications et processus.

Vous pouvez configurer une action de lancement pour ouvrir une page Web ou une application mobile et permettre aux utilisateurs de l’application d’envoyer des incidents ou des demandes concernant une entité sélectionnée. Vous pouvez créer des actions de lancement pour renseigner automatiquement des champs de formulaire avec des informations issues de l’élément, ou ouvrir une page Web ou une application mobile directement sur des informations liées à l’élément.

Remarque :

Toutes les actions de lancement non valides doivent être résolues avant le partage d’une carte Web.

Accéder à la fenêtre Configurer des actions de lancement Indoors

La fenêtre Configure Indoors Launch Actions (Configurer des actions de lancement Indoors) vous permet de créer et de gérer des actions de lancement de manière interactive. Lorsque vous préparez des cartes Web et paquetages de cartes mobiles, vous pouvez définir des actions de lancement dans la carte pour des couches ou des catégories spécifiques avant de les partager dans votre organisation ArcGIS.

Les actions de lancement sont prises en charge pour une utilisation avec les couches d’entités et les couches d’images de carte. Lorsque vous préparez une carte à utiliser avec les applications mobiles Indoors, vérifiez quels types de couches sont pris en charge.

Pour accéder à cette fenêtre dans ArcGIS Pro, procédez comme suit :

  1. Cliquez sur l’onglet View (Visualiser).
  2. Dans le groupe Windows (Fenêtres), cliquez sur la flèche de la liste déroulante Indoors puis sur Configure Indoors Launch Actions (Configurer des actions de lancement Indoors) Configure Indoors Launch Actions (Configurer des actions de lancement Indoors).

    La fenêtre Configure Indoors Launch Actions (Configurer des actions de lancement Indoors) s’affiche.

Créer une action de lancement

Vous pouvez créer une action de lancement en cliquant sur le bouton Create Indoors Launch Action (Créer une action de lancement Indoors) dans la fenêtre Configure Indoors Launch Actions (Configurer des actions de lancement Indoors). Un assistant s’ouvre et vous guide pendant la procédure de création d’une action de lancement pour la carte active. Une fois l’action de lancement créée, elle est répertoriée dans la fenêtre Configure Indoors Launch Actions (Configurer des actions de lancement Indoors) selon sa description.

Mettre à jour une action de lancement

Vous pouvez mettre à jour une action de lancement en cliquant avec le bouton droit de la souris sur une action de lancement dans le volet Configure Indoors Launch Actions (Configurer des actions de lancement Indoors) et en cliquant sur Edit (Mettre à jour).

Remarque :

Les actions de lancement configurées dans le volet Configure Indoors Launch Actions (Configurer des actions de lancement Indoors) peuvent être modifiées ultérieurement lors de la modification d’une carte ou d’une carte web publiée dans ArcGIS Pro, ou lors de la configuration d’une application Viewer.

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, la valeur par défaut est 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 dans 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

ArcGIS Survey123 est accessible par certains types d’utilisateurs. Les actions de lancement peuvent être configurées afin d’utiliser Survey123 en l’absence de tout autre système de bons de travail ou de tickets.

Pour personnaliser l’expérience du bouton d’action avec Survey123, ajoutez un argument valide ou des paires de valeurs à 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.

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

Les URL ne sont pas prises en charge dans les versions pour ordinateurs de bureau si vous utilisez des URL spécifiques aux applications mobiles natives et configurez des actions de lancement à utiliser dans Viewer. 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 tierce et lui transmettre des valeurs attributaires, à condition que le système tiers prenne en charge les formes d’URL configurables ou les paramètres qui déclenchent des actions dès le lancement. 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é, certains caractères ne sont pas acceptés. C’est le cas notamment des caractères # et +.

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}

Des exemples de syntaxe supplémentaires sont indiqués ci-dessous.

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}

Examinez d’autres exemples relatifs à la configuration des actions de lancement pour ServiceNow.

Rubriques connexes