Available for an ArcGIS organization licensed with the Indoors extension.
ArcGIS Indoors comprend la prise en charge d’actions de lancement d’applications tierces à partir du volet d’informations figurant dans Indoor Viewer. Ces actions de lancement permettent aux organisations Indoors d’intégrer facilement les informations d’autres systèmes d’entreprise. Une action de lancement peut être configurée pour ouvrir une page Web ou une application mobile native. Les utilisateurs peuvent ainsi soumettre des incidents ou des demandes pour un élément sélectionné dans Indoors. Ils peuvent afficher les informations sur un élément sélectionné dans Indoors et alimenter automatiquement les champs des formulaires avec des informations à jour à l’aide d’une page Web ou d’une application mobile.
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, sa valeur par défaut correspond à 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 suivants.
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 dans 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.
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. L’utilisation d’URL d’applications mobiles natives lors de la définition d’actions de lancement doit être limitée aux processus gérant les applications Indoors natives ou les applications Viewer accessibles via 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.
- Consultez la documentation du système intégré pour en savoir plus sur son fonctionnement.
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é 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, un actif 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. La syntaxe doit respecter la structure URL de l’application Indoors et du système de gestion des bons de travail pour assurer le lancement.
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 liée à l’action de lancement
Les actions de lancement peuvent être configurées dans Viewer de différentes façons. Il est possible de spécifier une chaîne de configuration JSON valide dans la table Indoors Configuration (Configuration Indoors) présente dans ArcGIS Pro.
Les actions de lancement peuvent également être définies dans le configurateur du portail lorsqu’une application est créée sur le modèle Indoor Viewer. Dans notre exemple, si la chaîne de l’action de lancement se trouve dans la table Indoors Configuration (Configuration Indoors), elle fournit les valeurs par défaut des actions de lancement. Toute modification apportée dans le volet du configurateur remplace les paramètres définis dans la table Indoors Configuration (Configuration Indoors).
Une fois les actions de lancement d’applications configurées à l’aide du configurateur Viewer, elles peuvent être exportées dans ArcGIS Indoors for iOS et ArcGIS Indoors for Android.
Vous avez un commentaire à formuler concernant cette rubrique ?