El valor de variable de entrada del usuario de un proyecto lo rellena el usuario de la aplicación y se puede aplicar a uno o varios botones de un proyecto. El usuario de la aplicación introduce el valor; no obstante, el creador del proyecto debe definir los botones y campos a los que se aplicará la variable.
Lo siguiente se aplica a una variable de entrada de usuario de un proyecto:
- Se pueden definir hasta tres variables de entrada de usuario de proyecto por proyecto.
- El usuario introduce su valor antes de pulsar un botón. Si la entrada de usuario se define como obligatoria, se solicita al usuario que introduzca este valor al iniciar el proyecto, pero podrá editar el valor en cualquier momento.
- Puede aplicar su valor a cualquier campo de texto de cualquier botón.
- Puede aplicar su valor a un campo de texto o entero que esté configurado con un dominio de valor codificado.
- No puede aplicar su valor a un campo de texto que esté configurado con un dominio de rango.
Las propiedades de la variable de entrada de usuario de proyecto son las siguientes:
- Etiqueta: texto que aparecerá como título de la página de entrada del usuario de proyecto en la aplicación.
- Tipo de entrada: puede ser texto de una sola línea, texto multilínea o lista de opciones. En el caso de las listas de opciones, define los valores y puede permitir entrada de texto libre. Utilice una lista de opciones dinámica para rellenar los valores a partir de los campos de una tabla o capa de consulta que ha agregado al proyecto.
- Aplicar sugerencia: muestre un texto de sugerencia en la página de la entrada de usuario de proyecto en la aplicación.
- Aplicar una máscara de entrada: defina el formato de entrada de datos mediante el uso de caracteres y símbolos para definir una máscara de entrada.
- Mostrar escáner de código de barras: utilice el escáner de código de barras en el cuadro de diálogo de entrada para la introducción de campos de texto.
Nota:
Se admiten los siguientes formatos: QR CODE, UPC A, UPC E, EAN 8, EAN 13, CODE 39 y CODE 128.
- Obligatorio: especifica si el usuario de la aplicación móvil debe proporcionar el valor de entrada del usuario antes de que pueda pulsar cualquier botón. Si no es obligatorio, el usuario puede introducir si lo desea un valor de entrada de usuario seleccionando el botón Editar (junto al valor de entrada de usuario mostrado en la parte superior de la pantalla) e introduciendo un valor.
Nota:
Al aplicar un valor de entrada de usuario a una capa de entidades con campos obligatorios, asegúrese de que su propiedad obligatoria esté definida como true para evitar errores de envío.
El creador del proyecto crea y configura una variable de entrada de usuario del proyecto, ya sea en la pestaña Datos de cada campo en el elemento de menú Entrada de usuario del proyecto.
Para asignar una variable de entrada de usuario de proyecto a un campo de captura de un botón, en la pestaña Datos, en el menú desplegable del campo de captura, elija Entrada de usuario de proyecto.
En la aplicación móvil, se impedirá al usuario introducir un texto que supere la longitud del campo de datos.
Listas de selección dinámica
La entrada de usuario de un proyecto se puede rellenar con una lista de opciones dinámica asociándola a una capa o tabla de entidades existente. La capa o tabla de entidades puede ser editable o de solo lectura. El autor puede controlar el contenido de la lista configurando las propiedades de la lista.
Para utilizar una lista de opciones dinámica en la entrada de un usuario del proyecto, primero debe agregarse al proyecto como una capa de consulta o tabla:
- En el menú principal, haga clic en Administrar capas de proyecto
. - Seleccione la pestaña Consulta en el panel Capas.
- Haga clic en Agregar.
- Seleccione la capa que rellenará su lista de opciones dinámica y haga clic en Agregar.
Ahora que existe la capa de consulta, se puede agregar a un botón:
- Haga clic en el botón de un proyecto para mostrar el panel Botón y seleccione la pestaña Datos.
- Elija Entradas de usuario del proyecto para el campo Capturar que almacenará el valor seleccionado de la lista de opciones dinámica.
- En el menú desplegable del campo Capturar, seleccione Crear nuevo.
- Introduzca una etiqueta para la entrada del usuario del proyecto. Esta etiqueta se mostrará encima de la lista de opciones dinámica.
- Elija Lista de opciones dinámica para el Tipo de entrada.
- Seleccione la capa de entidades o la tabla que haya creado en los pasos anteriores.
La última capa de consulta creada se seleccionará de forma predeterminada.
- Complete las propiedades restantes y haga clic en Crear.
Esta entrada de usuario del proyecto recién creada se establecerá automáticamente para el campo Capturar.
Nota:
Las capas de consulta no utilizadas se eliminan de un proyecto al guardar. Asegúrese de agregar la capa de consulta al menos a un botón antes de guardar el proyecto.
Las propiedades de una lista de opciones dinámica son las siguientes:
- Campo de visualización: el valor que se muestra en la aplicación móvil.
- Campo de valor: el valor que se almacena en la capa.
- Campo de ordenación: campo utilizado para ordenar la lista de opciones dinámica.
- Orden: ascendente o descendente.
- Modo de actualización: manual o automático. Cuando es manual, si la entrada del usuario se establece como obligatoria, la lista se actualiza solamente cuando el proyecto se abre por primera vez. Las actualizaciones posteriores solamente se producirán cuando el usuario arrastre la lista hacia abajo. En modo automático, si la entrada del usuario está definida como obligatoria, la lista se actualiza cuando se abre el proyecto o cuando se edita la entrada del usuario.
- Filtro: consulta utilizada para limitar los valores mostrados en la lista de selección dinámica. Al crear las condiciones de la cláusula de WHERE, puede utilizar las opciones para seleccionar una variable de dispositivo (username, fullName, firstName, lastName o email) o un campo de la capa seleccionada. Por ejemplo, suponiendo que el campo gestor de la capa seleccionada contenga nombres de usuario, para filtrar la lista a valores que solo coincidan con el nombre de usuario del gestor que ha iniciado sesión en la aplicación, introduzca la expresión Canvasser='${username}'.
La aplicación móvil solo devolverá la primera página de resultados de una lista, la cual, de manera predeterminada, es de 2000 registros para un servicio de entidades ArcGIS Online.
Hay disponible una lista de opciones dinámica para el uso sin conexión después de visualizarla una vez en la aplicación móvil. Para obtener actualizaciones de la lista, el dispositivo debe estar conectado cuando se recargue la lista.