Sintaxis de acción de inicio

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 y la tarjeta de información en aplicaciones móviles de Indoors. Las acciones de inicio se pueden configurar desde el panel Configurar acciones de inicio de Indoors en ArcGIS Pro y se pueden modificar al configurar una aplicación de Viewer desde su portal de ArcGIS Enterprise o su organización de ArcGIS Online.

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 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. 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 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 Viewer y la tarjeta de información de las aplicaciones móviles de Indoors se pueden configurar para abrir un formulario web o una aplicación nativa de terceros. El formulario web o la aplicación de terceros se pueden utilizar para registrar información nueva, como incidentes o solicitudes asociados con un espacio, un 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/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.