Controles de formulario

Una vez que seleccionas un componente del formulario, se abre un asistente que muestra varias pestañas de configuración para permitir una mayor personalización para las diferentes funcionalidades. Compruebe el progreso en el panel de vista previa del asistente.

Cuando estés satisfecho con el diseño de un componente, selecciona Guardar.

La siguiente tabla describe la configuración y los controles disponibles para las pestañas del asistente común.

Pestaña del asistente	Descripción	Menciones Especiales
Visualización	Configure la forma en que se muestra el componente del formulario.	El nombre que establezcas en el campo obligatorio Etiqueta se convierte en el NombreDePropiedad en la pestaña Clave de campo .
Datos	Configure un valor predeterminado que los usuarios finales verán en el campo de texto.	Aquí se pueden definir los componentes que pueden contener varios elementos (p. Ej., Casillas de selección, pestañas).
Validación	Configure los requisitos de validación para habilitar otros componentes de la interfaz de usuario.	N/A
Clave del campo	Configure el nombre de propiedad del componente que desea utilizar en el flujo de trabajo.	De forma predeterminada, este valor es pasado desde el campo Etiqueta de la pestaña Mostrar.
Condicional	Configure las condiciones para el componente.	Puedes establecer condiciones avanzadas, como Javascript o JSON.
Lógica	Configure la lógica que desencadena las condiciones.	N/A

Algunos componentes de formulario tienen pestañas específicas, por ejemplo:

Componente	Pestaña del asistente	Descripción
Fecha / Hora	Fecha	Configure las fechas mínimas y máximas disponibles para la selección.
	Hora	Configure el paso incremental para horas y minutos.
Día	Día	Configure la forma en que el usuario comercial selecciona el día (incremental o desde una lista desplegable).
	Mes	Configure la forma en que el usuario comercial selecciona el mes (incremental o desde una lista desplegable).
	Año	Configure la forma en que el usuario comercial selecciona el año (incremental o de una lista desplegable), y también el año mínimo y máximo disponible para la selección.
Editar cuadrícula	Plantillas	Personalizar los encabezados y filas de los datos de su cuadrícula de edición.
Asignación de datos	Diseño	Aplica cambios de diseño marginales a tu mapa de datos.

Visualización

Etiqueta : el título del componente.

Posición de la etiqueta : la posición de la etiqueta para un campo.

Descripción : el texto que aparece debajo del campo de entrada.

Información sobre herramientas : añade un icono de información sobre herramientas a un lado del icono. Introduce el texto de la información sobre herramientas.

Clase CSS personalizada : añade una clase CSS personalizada al componente. Puedes añadir varias clases, separadas por un espacio.

Oculto : oculta un componente cuando se muestra el formulario.

Nota:

El componente sigue apareciendo en el archivo JSON.

Ocultar etiqueta : oculta la etiqueta de un componente.

Deshabilitado : deshabilita un campo en el formulario.

Marcador de posición : el texto que aparece cuando el campo está vacío.

Prefijo : el texto que se muestra antes de un campo.

Sufijo : el texto que se muestra después de un campo.

Único : cuando se marca, el campo se considera único en el formulario.

Protegido : cuando se marca, hace que el campo esté disponible solo para entrada.

Persistente : cuando se marca, almacena un campo en la base de datos. Si no quieres guardar un campo en la base de datos, desmarca Persistente.

Vista de tabla : cuando se marca, muestra el valor dentro de la vista de tabla de los envíos. Puedes utilizarlo para componentes secundarios que añadas dentro de Editar componentes de cuadrícula , para mostrar los componentes secundarios dentro de las filas. Si no se marca, los datos no se muestran en la fila contraída de Editar cuadrícula. Incluso si los datos no se muestran, puedes configurar un componente mientras editas una fila.

Máscara de entrada Una máscara de entrada proporciona un formato predefinido. Por ejemplo, para un campo de número de teléfono, la máscara de entrada predeterminada sería [phone].

Los elementos de la máscara de entrada son:

• 9 - numérico
• a : alfabético
• * : alfanumérico

Datos

Valor predeterminado : el valor del campo antes de que los usuarios interactúen con él. El valor predeterminado anula el texto del marcador de posición.

Múltiples valores : cuando se marca, se pueden añadir varios valores al campo. Los valores aparecen como una matriz en la API y aparece Añadir otro botón en el campo.

Contenido : la sección donde escribes el contenido de un componente.

Formato de datos : el formato moment.js que utilizas para guardar este campo. Por ejemplo, HH:mm:ss.

Redibujar en : redibuja este componente si otro componente del formulario cambia. Elija el evento en el que el componente debe volver a dibujarse en la lista desplegable. Los eventos predeterminados a elegir son Cualquier cambio y Enviar.

Validación

Obligatorio : cuando se marca, este campo debe tener un valor.

Validar en : determina cuándo este componente desencadena la validación de front-end. Elija un evento de la lista desplegable: Cambiar o Desenfocar.

Longitud mínima : el requisito de longitud mínima que debe cumplir este campo.

Longitud máxima : el requisito de longitud máxima que debe cumplir este campo.

Longitud mínima de palabra : la cantidad mínima de palabras que se pueden añadir a este componente.

Longitud máxima de palabra: la cantidad máxima de palabras que se pueden añadir a este campo.

Patrón de expresión regular : el patrón de expresión regular que el componente debe pasar antes de que se pueda enviar el formulario.

Etiqueta de error : la etiqueta que se muestra cuando se muestra un mensaje de error de validación.

Mensaje de error personalizado : un mensaje de error personalizado que se mostrará si se produce un error.

Permitir solo valores disponibles : cuando se marca, realiza una comprobación de validación para asegurarse de que el valor seleccionado es una opción disponible.

Clave del campo

Nombre de propiedad : el nombre del argumento correspondiente para un componente en la colección de argumentos.

Puedes utilizar el Nombre de propiedad para pasar argumentos (utilizando la actividad Establecer valores de formulario ) dentro del formulario, o para obtener valores fuera de un formulario (utilizando la actividad Obtener valores de formulario ).

Condicional

La pestaña Condicional en el Creador de formularios te permite colocar condiciones en los componentes de tu formulario, para ocultarlos o mostrarlos.

The Conditional tab has two sections:

• Simple
• Condiciones avanzadas

Condiciones simples

The Simple section of the Conditional tab allows you to hide or display a component, based on the value of another component.

The Simple section consists of three fields:

1. This component should Display - from this dropdown list, choose:

   • True if you want to condition when the component displays.
   • False if you want to condition when the component hides.

2. When the form component - from this dropdown list, choose a component in the form to act as a condition.

3. Has the value - type in the value that conditions the component when to display or hide.

   

Condiciones avanzadas

La sección Condiciones avanzadas te permite utilizar código JavaScript o JSONLogic para realizar combinaciones de condiciones.

Nota:

La lógica avanzada anula los resultados de la lógica condicional simple .

En la sección Código JavaScript, introduce un código JavaScript personalizado.

The show variable must be given a true or false value. The data variable is used to access other components in the form, through the API key.

Para aprender a utilizar componentes condicionales, consulta la página del tutorial Componentes condicionales .

Lógica

La pestaña Lógica del Creador de formularios te permite crear condiciones y scripts de lógica avanzada que pueden cambiar el estado o el comportamiento del componente de formulario seleccionado.

Con la lógica avanzada, puedes cambiar dinámicamente los controles, la apariencia y la funcionalidad de un componente del formulario.

La lógica de un formulario consta de dos partes: el desencadenador y la acción.

Desencadenador

El desencadenador lógico es la condición en la que tiene lugar la acción. Por ejemplo, es posible que desees mostrar un campo de formulario específico solo cuando se selecciona una opción de casilla de verificación. En este caso, la opción de casilla de verificación es el desencadenador y la acción muestra el campo de formulario.

Hay cuatro tipos de desencadenadores lógicos:

Tipo de desencadenador	Descripción	Ejemplo
Simple	Seleccione el tipo de desencadenador y el valor que desea usar en su lógica.
Javascript	Proporcionas una lógica JavaScript para un componente de formulario o datos de formulario. Utiliza la sintaxis de JavaScript para crear una lógica compleja, como un bucle o un comportamiento dinámico.
Lógica JSON	Proporcionas una lógica JSON para un componente de formulario o datos de formulario. Recomendado en casos en los que JavaScript no está permitido. No puede admitir bucles o comportamientos dinámicos.
Evento	Se define un evento de componente que, una vez emitido por el componente correspondiente, desencadena la acción deseada.

Acción

La acción lógica es el comportamiento del componente del formulario que debe ocurrir en función de las condiciones lógicas que establezca (es decir, el desencadenador). Por ejemplo, puede activar un botón para usuarios de una edad específica. En este caso, el rango de edad es el desencadenador y la activación del botón es la acción.

Hay cuatro tipos de acciones lógicas:

Tipo de acción	Descripción	Ejemplo
Propiedad	El desencadenador cambia una de las propiedades del componente disponibles, como Información sobre herramientas, Descripción, Clase CSS, etc. Las propiedades disponibles dependen del tipo de componente de activación.
Valor	El desencadenador cambia el valor del componente correspondiente. La acción debe definirse utilizando la sintaxis de JavaScript.
Fusionar esquema de componentes	El desencadenador cambia los parámetros del esquema del componente que se encuentran en el componente JSON. Para ver los parámetros del esquema que puedes cambiar, pasa el ratón por encima del componente correspondiente y haz clic en Editar JSON. Puedes cambiar varios parámetros dentro de una acción.
Acción personalizada	Una acción personalizada se define utilizando la sintaxis de JavaScript, de la misma manera que definiría el tipo de desencadenador de JavaScript.	N/A