Configurar acciones de inicio

Disponible con las extensiones ArcGIS Indoors Pro o ArcGIS Indoors Maps.

ArcGIS Indoors es compatible con acciones de inicio para aplicaciones de terceros directamente desde el panel de información de Indoor Viewer y la tarjeta de información de las aplicaciones móviles de Indoors. Estas acciones de inicio permiten a las organizaciones integrar información relacionada con elementos de Indoors o elementos disponibles en otras capas de órdenes de trabajo, activos y puntos de interés que podrían incluirse en el mapa de Indoors en otras aplicaciones y flujos de trabajo.

Puede configurar una acción de inicio para abrir una página web o una aplicación móvil y permitir que los usuarios de la aplicación envíen incidentes o solicitudes con arreglo a una entidad seleccionada. Se pueden crear acciones de inicio para rellenar automáticamente campos de formularios con información del elemento o bien abrir una página web o una aplicación móvil directamente con información relacionada con el elemento.

Nota:

Las acciones de inicio no válidas se deben resolver para compartir correctamente un mapa web.

Acceder al panel Configurar acciones de inicio de Indoors

El panel Configurar acciones de inicio de Indoors permite crear y administrar acciones de inicio de forma interactiva. Al preparar mapas web y paquetes de mapas móviles, puede definir acciones de inicio en el mapa para capas o categorías concretas antes de compartirlo con su organización de ArcGIS.

Las acciones de inicio son compatibles para su uso con capas de entidades y capas de imágenes de mapa. Al preparar un mapa para utilizarlo con las aplicaciones móviles de Indoors, compruebe qué tipos de capa se admiten.

Siga estos pasos para acceder al panel en ArcGIS Pro:

  1. Haga clic en la pestaña Vista.
  2. En el grupo Ventanas, haga clic en la flecha desplegable Indoors y en Configurar acciones de inicio de Indoors Configurar acciones de inicio de Indoors.

    Aparece el panel Configurar acciones de inicio de Indoors.

Crear una acción de inicio

Puede crear una acción de inicio haciendo clic en el botón Crear acción de inicio de Indoors en el panel Configurar acciones de inicio de Indoors. Se abre un asistente que le guía a través del flujo de trabajo para crear una acción de inicio para el mapa activo. Una vez creada una acción de inicio, aparece en el panel Configurar acciones de inicio de Indoors por su descripción.

Editar una acción de inicio

Puede editar una acción de inicio haciendo clic con el botón derecho en una acción de inicio del panel Configurar acciones de inicio de Indoors y haciendo clic en Editar.

Nota:

Las acciones de inicio configuradas en el panel Configurar acciones de inicio de Indoors se pueden modificar más adelante al editar un mapa o publicar un mapa web en ArcGIS Pro o al configurar una aplicación de Viewer.

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.

Vea los ejemplos siguientes.

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

Determinados tipos de usuarios pueden acceder a ArcGIS Survey123. Es posible configurar acciones de inicio para que utilicen Survey123 en caso de que no se disponga de ningún sistema de tickets ni órdenes de trabajo compatible.

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.

  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 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.

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:

Cuando se utilizan direcciones URL específicas para aplicaciones móviles nativas y se configuran acciones de inicio para su uso en Viewer, las direcciones URL no son compatibles con los 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 que provocan acciones tras el inicio. 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 cabe citar 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 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 ejemplos adicionales 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 que impliquen configurar las acciones de inicio para ServiceNow.

Temas relacionados