Configurar acciones de inicio para Indoor Viewer

Disponible para una organización de ArcGIS con licencia de la extensión Indoors.

ArcGIS Indoors es compatible con acciones de inicio de aplicaciones de terceros directamente desde el panel de información de Indoor Viewer. Las acciones de inicio de aplicación son una forma de incorporar sus sistemas empresariales críticos con ArcGIS Indoors.

Se puede configurar una acción de inicio para abrir una página web o aplicación móvil nativa y pasar automáticamente datos de interiores al sistema o aplicación de destino. De este modo, los usuarios pueden enviar incidentes o solicitudes sobre una entidad seleccionada en Viewer. Los usuarios pueden visualizar información relacionada con una entidad seleccionada en la aplicación Viewer y rellenar automáticamente campos de formularios con información actualizada usando una página web o aplicación móvil.

Puede configurar las acciones de inicio para Viewer de distintas formas:

• Desde el panel Configurar acciones de inicio de Indoors en ArcGIS Pro. Las acciones de inicio configuradas en ArcGIS Pro se pueden modificar más adelante durante la configuración de la aplicación.

  Nota:

  Las modificaciones realizadas en el panel Configurar aplicación solo afectan a las acciones de inicio de la aplicación Viewer.

• Desde el panel Configurar aplicación al crear o modificar una aplicación. Desde el panel de configuración puede modificar las acciones de inicio creadas en ArcGIS Pro o crear otras opciones.

Nota:

Indoors permite colocar chinchetas para ubicaciones fuera de un edificio, como los terrenos o jardines de un campus. Si se aplica una acción de inicio a Todas las capas en el panel de configuración, estas chinchetas colocadas también tienen disponible la acción.

Configurar acciones de inicio desde el panel de configuración

Durante la configuración de la aplicación Viewer, siga estos pasos para modificar las acciones de inicio creadas en ArcGIS Pro o crear nuevas acciones:

1. En el panel Configurar aplicación, vaya a la sección Inicio de aplicación.

   Nota:

   Si ha configurado acciones de inicio en ArcGIS Pro, estas aparecen en la sección Inicio de aplicación y podrá actualizarlas si es necesario.

2. Opcionalmente, agregue una nueva acción.
   1. Haga clic en Agregar para agregar una nueva acción.
   2. Proporcione un nombre para la acción en el cuadro de texto Etiqueta.
   3. Agregue la URL de la acción al cuadro de texto URL.
   4. Haga clic en Seleccionar categorías y capas y active la casilla de verificación de las capas y categorías a las que se asociará esta acción.

      De forma predeterminada, todas las capas y subcategorías están seleccionadas.

   5. Haga clic en Aceptar.
   6. Repita los pasos anteriores para cualquier acción adicional.
3. Haga clic en el botón Eliminar que aparece junto a las acciones de inicio que desee eliminar.
4. Reordene las acciones con las flechas arriba y abajo en caso necesario.
5. Haga clic en Guardar para guardar las actualizaciones en la plantilla de la aplicación.

Las acciones de inicio aparecen en una lista al hacer clic en el botón Más del panel de información para las entidades que tienen categorías y capas con acciones de inicio configuradas.

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}

Nota:

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}

Integración con 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}

Nota:

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.

Nota:

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

Integración con sistemas de administración de órdenes de trabajo

Indoors es compatible con el inicio de sistemas externos de administración de órdenes de trabajo y activos. El botón de acción del panel de información de Viewer se puede configurar, o bien para abrir un formulario web o una aplicación nativa de terceros a fin de registrar información nueva, como incidentes o solicitudes asociados con un espacio, activo u otro elemento de Indoors, o bien para abrir una orden de trabajo existente en una aplicación separada.

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.