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) 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) dans le volet d’informations pour les entités des catégories et couches dotées d’actions de lancement configurées.

URL syntax

Launch actions are enabled by URLs, and the syntax must follow common URL conventions. For example, special characters in the arguments must be URL encoded, and the argument or value pairs must be separated with standard URL conventions.

For Indoors, values must be contained in curly brackets and match the following syntax:

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

Remarque :

The layer is optional and, if not included, defaults to the active item in the Indoors app. Many use cases require passing attributes from a different layer in the map or scene. This is supported with the layer operator. Arguments and values are not case sensitive.

See the following samples:

Single value

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

Multiple values

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

Value from another feature class

&site={FACILITIES.SITE_ID}

Pass value to a specific field

&field:room={units.name}

Supported argument and value formats

The launch action URL can support either passing a value with a generic argument (field={Units.UNIT_ID}) or pointing the value at a specific field in the Survey123 form (field:room={Units.Name}).

In addition, multiple arguments can be listed together, and you can add text between them.

Example

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

Intégration à Survey123

Survey123 is included with your Indoors license. In the absence of any other supported work order or ticketing system, launch actions can be configured to use Survey123.

To customize the experience of the action button with Survey123, append valid argument or value pairs onto the URL.

When you create a survey in your ArcGIS Online organization, the URL to share the survey is shortened by default. To enable launch actions, you must use the full URL when appending arguments and pairs. To get the full URL for an existing survey, complete the following:

1. In Survey123, click the My Surveys tab and click the survey for which you want to create a launch action.
2. Click the Collaborate tab and click Share survey.
3. Copy the shortened URL, paste it into a browser, and load the survey.

   The full URL appears in the address bar.

4. Copy the full URL from the address bar.

You can now append arguments and pairs to this URL as necessary when configuring launch actions.

Example: Base URL for default behavior

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

Example: Custom

This example overrides the default room input with the name field from the Units layer.

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

Example: Launch the Survey123 native app on mobile devices

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

Remarque :

Be careful when using URLs specific to native mobile apps when configuring launch actions for use in Viewer as these are not supported for desktop users. Using a native app's URL when defining launch actions should be limited to workflows supporting the native Indoors apps or Viewer accessed from a mobile browser.

Integration with third-party systems

The action button can also be configured to open a third-party URL and pass attribute values to it, provided that the third-party system supports URL configurable forms or parameters to drive actions upon launch. In this case, use a URL that calls the system in the Indoors app configuration with an appropriate URL for the integrated system. Some common uses are linking to third-party work order management systems or asset management systems.

Consider the following when working with third-party systems:

• The field: operator may be different.
• Web forms that support URL arguments may require additional configuration.
• Consult the integrated system vendor for details on whether and how this works.

Remarque :

In some cases, depending on the business system being used, some characters may not be supported, such as the # or + characters.

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 supports passing work order and Indoors layer attributes as a query string in the URL. The syntax must follow the URL/URI schema for Indoors and work order app system to support launch actions.

The attribute value must be enclosed in curly brackets and match the following syntax:

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

The following are additional syntax samples:

Single value from work order layer

?arg={workorderid}

Multiple values from work order layer

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

Value from work order and Indoors layer

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

ServiceNow URL

The following sample passes the work order number as a parameter and opens an existing work order:

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

See more examples of configuring launch actions for ServiceNow.