Configurar acciones de inicio para Indoor Viewer

Disponible con la extensión ArcGIS Indoors Maps.

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 consultar 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. Puede 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 Quitar 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 Información del panel de información para las entidades que tienen categorías y capas con acciones de inicio configuradas.

Sintaxis de URL

Las URL habilitan las acciones de inicio y la sintaxis debe seguir las convenciones comunes de URL. Por ejemplo, los caracteres especiales de los argumentos deben tener codificación URL, y los pares de valores o argumentos deben estar separados por convenciones estándar de URL.

En Indoors, los valores deben estar entre llaves y coincidir con esta sintaxis:

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

Nota:

La capa es opcional y, si no se incluye, de manera predeterminada es el elemento activo en la aplicación Indoors. Muchos casos de uso requieren transmitir atributos desde una capa diferente del mapa o escena. Se admite con el operador de capa. Los argumentos y valores no distinguen entre mayúsculas y minúsculas.

Consulte los siguientes ejemplos:

Valor único

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

Varios valores

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

Valor de otra clase de entidad

&site={FACILITIES.SITE_ID}

Transmitir valor a un campo específico

&field:room={units.name}

Formatos de valor y argumento admitidos

La URL de acción de inicio puede admitir la transmisión de un valor con un argumento genérico (field={Units.UNIT_ID}) o señalar el valor en un campo específico del formulario de Survey123 (field:room={Units.Name}).

Además, es posible enumerar varios argumentos juntos y agregar texto entre ellos.

Ejemplo

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

Integración con Survey123

Survey123 se incluye con su licencia de Indoors. Si no dispone de ningún sistema de tickets ni órdenes de trabajo compatible, es posible configurar acciones de inicio para que utilicen Survey123.

Para personalizar la experiencia del botón de acción con Survey123, incorpore pares de valores o argumentos válidos a la URL.

Al crear una encuesta en su organización de ArcGIS Online, se abrevia de forma predeterminada la dirección URL para compartir la encuesta. Para habilitar acciones de inicio, debe utilizar la dirección URL completa cuando se anexan argumentos y pares. Para obtener la dirección URL completa para una encuesta existente, complete lo siguiente:

  1. En Survey123, haga clic en la pestaña Mis encuestas y haga clic en la encuesta para la que desea crear una acción de inicio.
  2. Haga clic en la pestaña Colaborar y haga clic en Compartir la encuesta.
  3. Copie la dirección URL abreviada, péguela en un navegador y cargue la encuesta.

    La dirección URL completa aparece en la barra de direcciones.

  4. Copie la dirección URL completa desde la barra de direcciones.

Ahora puede adjuntar argumentos y pares a esta dirección URL como sea necesario al configurar acciones de inicio.

Ejemplo: URL base de comportamiento predeterminado

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

Ejemplo: personalizado

Este ejemplo invalida la entrada de salas predeterminada con el campo de nombre de la capa Units.

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

Ejemplo: iniciar la aplicación nativa de Survey123 en dispositivos móviles

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

Nota:

Tenga cuidado al utilizar URL específicas de aplicaciones móviles nativas al configurar acciones de inicio para su uso en Viewer, puesto que no son compatibles en el caso de usuarios de escritorio. Utilice solo URL de aplicaciones nativas al definir acciones de inicio para flujos de trabajo que admitan las aplicaciones de Indoors nativas o Viewer, si se accede desde un navegador móvil.

Integración con sistemas de terceros

También se puede configurar el botón de acción para abrir una URL externa y transmitirle valores de atributo, siempre y cuando el sistema de terceros admita formatos o parámetros configurables de URL para dirigir acciones tras el inicio. En este caso, utilice una URL que llame al sistema en la configuración de la aplicación de Indoors con una URL adecuada para el sistema integrado. Entre los usos habituales se encuentran la vinculación con sistemas de administración de activos o sistemas de administración de órdenes de trabajo de terceros.

Tenga en cuenta lo siguiente al trabajar con sistemas de terceros:

  • Es posible que el operador field: sea diferente.
  • Es posible que los formularios web que admiten argumentos de URL requieran configuración adicional.
  • Consulte los detalles del sistema integrado para obtener más información sobre si funciona y cómo lo hace.

Nota:

En algunos casos, en función del sistema empresarial que se utilice, es posible que no se admitan algunos caracteres, como # o +.

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 admite la transmisión de órdenes de trabajo y atributos de capas de Indoors como una cadena de caracteres de consulta en la URL. La sintaxis debe seguir el esquema de URL/URI para Indoors y el sistema de la aplicación de órdenes de trabajo para admitir el inicio de acciones.

El valor de atributo se debe escribir entre llaves y debe coincidir con esta sintaxis:

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

A continuación, se ofrecen más muestras de sintaxis:

Valor único de capa de órdenes de trabajo

?arg={workorderid}

Varios valores de capa de órdenes de trabajo

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

Valor de orden de trabajo y capa de Indoors

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

URL de ServiceNow

La siguiente muestra transmite el número de orden de trabajo como un parámetro y abre una orden de trabajo existente:

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

Consulte más ejemplos sobre cómo configurar acciones de inicio para ServiceNow.