Syntaxe des actions de lancement

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 dans Indoor Viewer et la fiche d’informations figurant dans les applications mobiles Indoors. Vous pouvez configurer les actions de lancement à partir de la fenêtre Configure Indoors Launch Actions (Configurer des actions de lancement Indoors) dans ArcGIS Pro et les modifier lorsque vous configurez une application Viewer à partir de votre portail ArcGIS Enterprise ou de votre organisation ArcGIS Online.

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 ; en cas d’exclusion, elle correspond par défaut à l’élément actuellement sélectionné 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 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}).

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

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é, certains caractères ne sont pas acceptés. C’est le cas notamment des signes # 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’information Viewer et dans la fiche d’information dans les applications mobiles Indoors peut être configuré pour ouvrir un formulaire Web ou une application native tierce. Le formulaire Web ou l’application tierce peuvent être utilisé 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. 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.