Available for an ArcGIS organization licensed with the Indoors extension.
ArcGIS Indoors es compatible con acciones de inicio de aplicaciones de terceros directamente desde el panel de información de Indoor Viewer. Estas acciones de inicio permiten que las organizaciones de Indoors integren información fácilmente de otros sistemas empresariales. Una acción de inicio se puede configurar para abrir una página web o aplicación móvil nativa. Permite a los usuarios enviar incidentes o solicitudes sobre un elemento seleccionado en Indoors. Los usuarios pueden visualizar información relacionada con un elemento seleccionado desde Indoors y rellenar automáticamente campos de formularios con información actualizada usando una página web o aplicación móvil.
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 seleccionado actualmente en 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 las siguientes muestras.
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 se puede introducir 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 compatibles, 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.
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
"url": "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. Utilizar URL de aplicaciones nativas al definir acciones de inicio debería estar limitado a 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
El botón de acción también se puede configurar 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 la documentación 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 de administración de órdenes de trabajo de terceros.
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 para Indoors y el sistema de la aplicación de órdenes de trabajo para admitir el inicio.
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.
Definir la cadena de configuración de la acción de inicio
Es posible configurar acciones de inicio para Viewer de varias formas. Es posible especificar una cadena de configuración JSON en la tabla Indoors Configuration de ArcGIS Pro.
Las acciones de inicio también se pueden definir en el configurador del portal cuando se crea una aplicación a partir de la plantilla de Indoor Viewer. En este escenario, si la cadena de acción de inicio se encuentra en la tabla Indoors Configuration, proporciona los valores predeterminados para acciones de inicio. Los cambios que se realicen en el panel del configurador invalidan la configuración de la tabla Indoors Configuration.
Una vez se han configurado acciones de inicio de aplicación en el configurador de Viewer, se pueden exportar para utilizarse en ArcGIS Indoors for iOS y ArcGIS Indoors for Android.