Configurer les actions de lancement pour les applications Indoors

Disponible avec un portail sous licence avec la fonctionnalité Indoors.​

ArcGIS Indoors prend en charge les actions de lancement d’applications tierces directement dans le volet d’informations d’Indoor Viewer et la fiche d’informations figurant dans ArcGIS Indoors for iOS et ArcGIS Indoors for Android. Ces actions de lancement permettent aux organisations Indoors d’intégrer facilement 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êts éventuellement inclus dans la carte Indoors à partir d’autres systèmes métier. Ceci est possible en autorisant les utilisateurs des applications Indoors à lancer directement des applications tierces. Il est possible de configurer une action de lancement de sorte qu’elle ouvre une page Web ou une application mobile native pour permettre aux intervenants de transmettre des incidents ou des demandes sur un élément sélectionné dans Indoors. Ils peuvent ainsi renseigner automatiquement les champs d’un formulaire à l’aide des informations sur l’élément ou ouvrir la page Web ou l’application mobile afin de saisir les informations sur l’élément sélectionné dans Indoors.

La possibilité d’inclure des actions de lancement simplifie, pour les utilisateurs de l’application Indoors, la transmission d’informations sur certains actifs et autres éléments dans la carte Indoors, ainsi que la recherche de détails supplémentaires concernant ces éléments sans avoir à utiliser plusieurs applications prenant en charge les divers systèmes métier. Cette fonction est disponible par le biais de la configuration du paramètre APP_LAUNCH_ACTIONS de la table Indoors Configuration (Configuration Indoors) dans ArcGIS Pro.

Lors de la préparation de votre base de données Indoors en vue du partage des cartes Web et des paquetages de cartes mobiles à utiliser dans les applications Indoors, vous êtes libre de fournir des actions de lancement pour des couches et/ou des catégories spécifiques en insérant une chaîne JSON correctement mise en forme dans le paramètre de configuration APP_LAUCH_ACTIONS avant de partager la carte Web ou le paquetages de cartes mobiles.

Remarque :

Si des membres de votre organisation utilisant Viewer n’emploient pas les applications mobiles Indoors natives, vous pouvez ignorer cette étape et utiliser le volet de configuration fourni par Viewer afin de configurer les actions de lancement à inclure dans l’instance de l’application ArcGIS Indoors configurable. Si vous prévoyez que les membres de votre organisation utilisent à la fois des applications mobiles Viewer et Indoors, vous pouvez tirer parti de ce volet de configuration dans Viewer en configurant d’abord les actions de lancement dans l’application Web et en copiant la chaîne JSON obtenue dans le paramètre de configuration APP_LAUNCH_ACTIONS avant de partager le paquetage de cartes mobiles dans le portail ArcGIS Enterprise.

Syntaxe d’JSON

Les actions de lancement sont activées en insérant une chaîne JSON correctement mise en forme dans le paramètre APP_LAUNCH_ACTIONS au sein de la table Indoors Configuration (Configuration Indoors) dans ArcGIS Pro. Lors de la définition des actions de lancement, vous pouvez appliquer ces actions sur certaines couches de votre carte et certaines catégories et sous-catégories comme définies dans la table Categories (Catégories).

La syntaxe de cette chaîne JSON est la suivante :

Clé JSON	Description
actions	Liste d’actions mises à disposition pour les couches et/ou catégories sélectionnées.
label	Nom d’une simple action affichée dans la liste des actions disponibles. Si une seule action est configurée pour être utilisée avec la carte Web Indoors ou un paquetage de cartes mobiles, une icône générique associée à l’action apparaît. Si plusieurs actions sont configurées, une icône « Plus » s’affiche et la liste des actions disponibles apparaît dans un menu déroulant lorsque le bouton est sélectionné dans les applications.
url	URL de lancement correctement mise en forme.
layers	Liste des couches de carte auxquelles l’action s’applique.
categories	Liste des catégories configurées auxquelles l’action s’applique.

Exemple :

{
  "actions": [
    {
      "label": "Fill out survey",
      "url": " https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal?field:room={Units.NAME}",
      "layers": [
        "Units",
        "Levels"
      ],
      "categories": [
        "Places + Things",
        "Fire Extinguisher"
      ]
    },
    {
      "label": "Report Incident",
      "url": "https://servicenow.com/report?username={user.username}",
      "layers": ["*"],
      "categories": ["*"]
    },
    {
      "label": "Make Request",
      "url": "https://servicenow.com/report?username={user.username}&room={Units.NAME}",
      "layers": ["Units"]
    }
  ]
}

Vous remarquerez que dans cet exemple trois actions séparées sont indiquées. La première catégorie, “Fill out survey”, a été limitée aux seuls éléments sélectionnés qui se trouvent dans les couches Units (Unités) ou Levels (Niveaux), ou dans la catégorie de niveau 1 Places + Things (Lieux + objets), ou encore dans la sous-catégorie de niveau 2 Fire Extinguisher (Extincteur). La nuance est importante car Indoors offre la possibilité de limiter l’intégration d’une action à des types d’éléments bien précis. C’est utile lorsqu’un système déterminé est destiné à prendre en charge des types de ressource ou d’activité spécifiques.

La deuxième action, “Report Incident”, inclut les termes clés correspondant à toutes les couches et catégories dans sa définition. Inclure le terme “*” dans la liste des couches et des catégories garantit que n’importe quel élément d’une couche ou d’une catégorie, s’il est sélectionné dans les applications Indoors, prend en charge ce type d’action dans le volet d’informations.

La troisième action, “Make Request”, est limitée aux éléments d’une couche unique et n’est associée à aucune catégorie.

Remarque :

• Les actions peuvent être affectées aux couches ou aux catégories, voire aux deux. Il n’est pas obligatoire d’affecter une action à une couche ainsi qu’à une catégorie. L’affectation d’une action à une couche représentée par des catégories applique l’action à toutes les catégories et sous-catégories configurées pour cette couche.
• Les actions affectées à une catégorie de niveau 1 sont systématiquement disponibles aux catégories de niveau 2 associées. Il est donc superflu de les répliquer dans la liste des catégories. Les actions affectées à une sous-catégorie de niveau 2 ne sont disponibles que pour les éléments figurant dans cette sous-catégorie particulière.
• Les actions sans aucune couche ni catégorie configurée ne s’affichent pas dans les applications Indoors.

Syntaxe d’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, et si elle n’est pas incluse, correspond par défaut à l’élément actuellement sélectionné dans 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 soit la transmission d’une valeur avec un argument générique (field={Units.UNIT_ID}), soit la désignation d’une valeur à un champ spécifique dans le formulaire Survey123 (field:room={Units.Name}).

Il est, par ailleurs, possible d’énumérer plusieurs arguments ensemble et de saisir du texte.

Exemple

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

Intégration de Survey123

Survey123 est inclus avec la 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.

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

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

Remarque :

Au cours de la configuration des actions de lancement à utiliser dans Viewer, faites attention aux URL spécifiques des applications mobiles natives. En effet, elles ne sont pas prises en charge dans les versions bureautiques. Lors de la définition des actions de lancement, l’utilisation de l’adresse URL d’une application native doit se limiter aux processus prenant en charge les applications natives Indoors ou les applications Viewer auxquelles on accède à partir d’un navigateur mobile.

Intégration de systèmes tiers

Le bouton d’action peut également être configuré 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 destinés à déclencher les actions dès le lancement. En pareil cas, utilisez une URL invoquant le système dans la configuration de l’application Indoors au moyen 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 Viewer et la fiche d’informations dans les applications mobiles Indoors peut être configuré pour ouvrir un formulaire Web ou une application native tierce à utiliser pour l’enregistrement de nouvelles informations. Ces informations peuvent se rapporter, par exemple, à des demandes ou des incidents liés à un espace, une ressource ou tout autre élément figurant dans Indoors. Le bouton d’action permet également d’ouvrir un bon de travail dans une application tierce de gestion des bons de travail.

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

Définir la chaîne de configuration de l’action de lancement dans la table Configuration Indoors

Il est nécessaire d’ajouter une ou plusieurs URL d’accès aux applications de tierce partie à la table Indoors Configuration (Configuration Indoors) pour faire apparaître le bouton d’action sur la fiche d’informations Indoors for iOS ou Indoors for Android. Viewer Il est possible de configurer des actions de lancement dans le volet de configuration, mais si une chaîne de configuration JSON valide est incluse dans la table Indoors Configuration (Configuration Indoors), le volet de configuration utilise cette valeur comme paramètre par défaut. La table Indoors Configuration (Configuration Indoors) est une table autonome dans le modèle d’informations ArcGIS Indoors. Elle doit être incluse lorsque vous créez le paquetage de cartes mobiles pour Indoors, mais elle est facultative pour la carte Web d’Viewer.

Procédez selon les étapes suivantes pour configurer l’action de lancement avec une ou plusieurs URL dans la table Indoors Configuration (Configuration Indoors) :

1. Dans la fenêtre Contents (Contenu) d’ArcGIS Pro, cliquez avec le bouton droit sur la table Indoors Configuration (Configuration Indoors) et cliquez sur Open (Ouvrir).

   La vue tabulaire Indoors Configuration (Configuration Indoors) s’affiche.

2. Double-cliquez sur le champ Config Value du paramètre APP_LAUCH_ACTIONS (sous Config Key) et définissez la chaîne de configuration JSON pour vos actions configurées.

   Remarque :

   Si le paramètre APP_LAUCH_ACTIONS n’est pas défini, le bouton d’action de lancement est désactivé dans la fiche d’informations dans Indoors for Android et Indoors for iOS.