ArcGIS Arcade puede utilizarse para calcular campos en registros capturados con ArcGIS QuickCapture. El autor de un proyecto puede escribir una expresión que utilice funciones de Arcade, operadores, valores de registro.
El perfil de Arcade QuickCapture incluye las siguientes variables, que pueden utilizarse para devolver valores de registro:
- $feature: atributos del registro actual
- $layer: entidades de la misma capa que el registro actual
- $datastore: capas del mismo servicio de entidades o de la misma base de datos que el registro actual
- $map: colección de capas de servicios de entidades del mapa web utilizado por el proyecto de QuickCapture
Para obtener más información, consulte Variables de perfil de QuickCapture.
De forma predeterminada, el mapa web del proyecto no incluye las capas del proyecto, por lo que, para utilizar expresiones que hagan referencia a las capas por su nombre, por ejemplo, var layername = FeatureSetByName($map, "layer_name"), debe elegir la opción de crear un mapa web al configurar el proyecto de QuickCapture o sustituir el mapa web predeterminado por uno que contenga todas las capas necesarias para la expresión. Para obtener más información, consulte Configuración del mapa del proyecto.
Nota:
Si tiene previsto utilizar expresiones de Arcade en su proyecto, compruebe las capas del proyecto y el mapa web correspondientes a los tipos de campos DateOnly, TimeOnly, TimestampOffset o BigInteger. Debe crear una vista de capa de entidades alojada que excluya estos campos y utilice la vista de capa del proyecto en su lugar. Estos tipos de campos no se admiten en la versión Arcade (1.18) que se utiliza en la aplicación móvil QuickCapture.
Para obtener más información, consulte Crear vistas de capas de entidades alojadas en ArcGIS Online o Crear vistas de capas de entidades alojadas en ArcGIS Enterprise.
Los siguientes son casos de uso que se pueden construir como expresión Arcade:
- Calcule un valor a partir de valores de otro campo.
- Haga un punto en una consulta de polígono para que se devuelva un valor de atributo.
- Utilice una función para calcular la duración temporal de una polilínea capturada.
El diseñador de QuickCapture incluye un generador de expresiones para ayudar a los autores a escribir expresiones y utiliza el perfil de QuickCapture. Una vez que una expresión Arcade se guarda en el diseñador, puede asignarse a varios botones, igual que las entradas de usuario se definen una vez y pueden utilizarse en varios botones.
Los campos que gestiona ArcGIS, como OBJECTID, GlobalID, CreationDate, Creador, EditDate y Editor, no deben utilizarse en una expresión porque sus valores no se conocen hasta después de enviar un registro. Si una expresión requiere un valor correspondiente a un nombre de usuario o a una fecha de captura de registros, la expresión debería hacer referencia a un campo que se haya rellenado con una variable del dispositivo.
Nota:
Los registros capturados con el dispositivo sin conexión que contienen expresiones Arcade se procesarán cuando el dispositivo vuelva a estar conectado exclusivamente, y solo entonces se enviarán.
Usar Arcade
Para configurar una expresión Arcade correspondiente a un campo, siga estos pasos:
- Verifique que haya iniciado sesión en una organización.
- Abra un proyecto y seleccione un botón para configurar.
- En la pestaña Datos, en el menú desplegable del campo de captura, elija Expresión de Arcade y seleccione Crear nuevo.
- Escriba una expresión con ayuda de las opciones de menú Variables de perfil y Funciones.
- Proporcione una etiqueta para la expresión y elija Crear.
La etiqueta de la expresión que acaba de crear se muestra en el campo de captura de la pestaña Datos del diseñador web. Esta expresión también está disponible para reutilizarla en el campo de captura de otros botones de este proyecto.
Uso del asistente de ArcGIS Arcade (beta)
El asistente de ArcGIS Arcade (beta) utiliza inteligencia artificial (IA) para generar expresiones de Arcade a partir de instrucciones que ha introducido en lenguaje natural. Para obtener los mejores resultados, utilice un lenguaje claro y sencillo y repita las respuestas que reciba.
Para utilizar el asistente de ArcGIS Arcade (beta) en QuickCapture, siga estos pasos:
- Verifique que haya iniciado sesión en una organización.
Debe iniciar sesión como miembro de una organización con un rol que incluya privilegios para utilizar asistentes de IA.
- Abra un proyecto y seleccione un botón para configurar.
- En la pestaña Datos, en el menú desplegable del campo de captura, elija Expresión de Arcade y seleccione Crear nuevo.
- Haga clic en el botón Asistente de Arcade
.Aparece el panel Asistente de Arcade.
- Utilice el asistente mediante una de las acciones siguientes:
- Haga clic en una sugerencia y modifíquela para crear una indicación que se adapte a sus datos.
- Utilice su idioma preferido para introducir una indicación para construir una expresión Arcade.
- Haga clic en Generar para realizar la consulta.
El asistente de ArcGIS Arcade (beta) sugiere una expresión en el panel Asistente de Arcade.
Sugerencia:
Desplace el cursor sobre el botón Contexto de perfil
para ver dónde se aplicará la expresión sugerida en la configuración de la capa. - Para interactuar con las sugerencias, siga uno de los métodos siguientes:
- Haga clic en Agregar al editor para agregar la expresión al panel del generador de expresiones.
Sugerencia:
Coloque el puntero en el panel del generador de expresiones donde desea agregar el contenido. Por ejemplo, en el panel del generador de expresiones, mueva el puntero y haga clic delante de una línea de código existente. Al hacer clic en Agregar al editor en el panel de Asistente de Arcade, la expresión sugerida se agregará al panel del generador de expresiones en la posición del puntero.
- Haga clic en Reemplazar todo el código en el editor
para sustituir cualquier contenido existente en el panel del generador de expresiones por la expresión sugerida. - Haga clic en Copiar código al portapapeles
para copiar la expresión sugerida al portapapeles. - Para realizar ajustes en la indicación, edite la indicación anterior en el área de texto o copie y pegue una indicación anterior y, a continuación, y haga clic en Refinar para enviar la consulta modificada.
- Para proporcionar comentarios sobre el asistente, haga clic en el botón Útil
o No útil 
y complete la encuesta. Las opiniones se utilizan para guiar el desarrollo.
- Haga clic en Agregar al editor para agregar la expresión al panel del generador de expresiones.
- Para borrar el historial de consultas y empezar de nuevo, haz clic en Reiniciar en cualquier momento.
Nota:
Para obtener más información sobre el uso del asistente de ArcGIS Arcade (beta), consulte Comprender las mejores prácticas y Comprender las limitaciones del contexto.