Crear un formulario

Objetivo

Crear un formulario que distribuye los campos de una tabla en pestañas y secciones, y que se usa para ver y editar un único registro.

Requisitos previos

• Ha iniciado sesión con un rol de creador (o de administrador de la plataforma).
• La tabla existe y tiene los campos que quiere colocar en el formulario (consulte Crear una tabla y Agregar un campo a una tabla).

Pasos

1. Abra la tabla en Tablas y vaya a la pestaña Formularios. La pestaña es una lista de los formularios existentes de la tabla.
2. Seleccione Nuevo para abrir el Diseñador de formularios.
3. Escriba un nombre para mostrar (por ejemplo, Main) y un nombre lógico. El prefijo del editor propietario de la solución en la que está trabajando se muestra como una etiqueta fija en el cuadro del nombre lógico: escriba solo la parte que va detrás (por ejemplo, invoice_main). Esto también ocurre en las tablas estándar: un formulario que agrega a Account lleva su prefijo, porque los nombres sin prefijo pertenecen a Parsware.
4. Construya el diseño en el lienzo. Un formulario se compone de pestañas; cada pestaña contiene filas de ancho completo; cada fila contiene de una a cuatro secciones; cada sección contiene campos. Agregue pestañas, filas y secciones con los controles + del lienzo.
5. Arrastre un campo desde la paleta de campos de la izquierda a una sección. Arrastre un campo ya colocado para moverlo entre secciones o cambiar su orden.
6. Seleccione cualquier pestaña, fila, sección o campo para editar sus propiedades en el panel Propiedades: el título y el icono de una pestaña, el número de columnas de una fila, el título, el icono y el ancho de una sección, o la etiqueta y el control de entrada de un campo (consulte Elegir el control de un campo). Aquí también se puede marcar la ubicación de un campo como Obligatorio o Solo lectura (consulte Hacer que un campo sea obligatorio o de solo lectura en un formulario).
7. Arrastre hasta cuatro campos a la franja Encabezado, sobre las pestañas: Propietario, Estado, un total. Consulte La franja de encabezado más abajo.
8. Si lo desea, marque el formulario como formulario predeterminado de la tabla.
9. Seleccione Guardar.
10. El formulario aparece en la lista de formularios de la tabla. Seleccione la fila del formulario (o selecciónelo y elija Editar) para volver a abrirlo en el diseñador.

Los dos tipos de formulario

Junto al nombre hay un Tipo de formulario. Indica para qué sirve el formulario y cambia dónde se puede mostrar:

Tipo	Qué es	Dónde se usa
Principal	La página completa del registro: barra de título, barra de comandos, pestañas y franja de encabezado.	Al abrir un registro desde una lista, una pestaña de relacionados o un vínculo. Todo formulario creado antes de que existieran los tipos de formulario es de este tipo.
Creación rápida	Los campos y Guardar/Cerrar. Nada más.	El widget de creación rápida de un panel, y cualquier otro lugar donde la superficie que lo rodea ya tiene un marco: un cuadro de diálogo, un panel lateral.

Una tabla puede tener un predeterminado de cada tipo. Marcar un formulario de Creación rápida como predeterminado no quita esa condición a su formulario Principal: los abren superficies distintas, y borrar el predeterminado entre tipos cambiaría discretamente la página del registro al agregar un mosaico.

Mantenga breve un formulario de Creación rápida. Sirve para «agregar uno de estos sin dejar lo que estoy haciendo», así que incluya solo los campos realmente obligatorios; el registro se puede abrir después como es debido para el resto.

Hacer que una sección sea más ancha que las demás

Una fila distribuye sus secciones en columnas iguales, pero una sección puede ocupar más de una. Seleccione la sección y establezca su Ancho: el número de columnas de la fila que ocupa.

Eso es lo que permite que una fila sea desigual. Una fila de cuatro columnas cuya segunda sección tiene un ancho de tres le da una sección estrecha junto a una ancha, una forma que antes no se podía conseguir, porque la única manera de dar más espacio a una sección era cambiar el número de columnas de la fila, lo que movía todas las demás secciones.

La lista desplegable solo ofrece hasta el número de columnas de la propia fila, ya que algo más ancho no es una opción. Y una fila de una columna no lo ofrece en absoluto: ocupar una columna de una es lo que una sección ya hace.

Estrechar una fila más adelante es seguro. Una sección con un ancho de tres en una fila de cuatro columnas pasa a ocupar todo el ancho si cambia esa fila a dos columnas: se redistribuye en lugar de desbordarse o negarse a abrir. El ancho que estableció se conserva, no se sobrescribe: vuelva a ampliar la fila a cuatro y la sección vuelve a ocupar tres columnas. Lo que ve mientras la fila es estrecha es el valor ajustado, así que cambiar entonces la lista desplegable sí lo reemplaza.

La franja de encabezado

Sobre las pestañas del lienzo hay una franja Encabezado. Los campos que se sueltan ahí se representan junto al nombre del registro y permanecen visibles sea cual sea la pestaña abierta, así que son para el puñado de datos que alguien necesita antes de decidir adónde ir: quién es el propietario, en qué estado está, a cuánto asciende.

• Arrastre un campo desde la paleta, o desde una sección, igual que en cualquier otro sitio. Arrástrelo fuera para quitarlo.
• Admite cuatro campos. Un encabezado es una franja junto a un título; un quinto la convierte en una sección que casualmente está arriba, y el formulario ya tiene secciones.
• Los campos del encabezado son de solo lectura de forma predeterminada. Para eso sirve un encabezado, y el mismo campo suele estar también en una pestaña, donde se puede editar. Seleccione el elemento y desmarque Solo lectura en el panel Propiedades si quiere que se pueda editar allí mismo.
• Todo lo demás de una ubicación funciona también ahí: una etiqueta reemplazada, un control, un texto de ayuda.

Qué ocurre entre bastidores

El diseño del formulario se guarda como una definición canónica y se comprueba contra el esquema de formularios. Todo campo colocado en el formulario debe ser un campo real de la tabla; un formulario que hace referencia a un campo inexistente se rechaza. Marcar un formulario como predeterminado quita esa condición al predeterminado anterior de la tabla.

La definición guardada es el formulario: el diseñador es una manera de editarlo, no la única. Un formulario escrito a mano o generado por una herramienta se comprueba de la misma forma, y al abrirlo en el diseñador se muestra exactamente lo que describe.

Solución de problemas

• «… is not defined on this entity.» — un campo colocado no existe; agregue primero el campo a la tabla o quítelo del formulario.
• «… must be lower snake-case and start with the publisher prefix.» — corrija el nombre lógico del formulario.
• «The definition is not valid: …» — el diseño no superó la validación del esquema (por ejemplo, una sección sin campos); agregue al menos un campo a cada sección.
• «A form or view named … already exists on this entity.» — elija otro nombre lógico.

Escenarios relacionados

• Crear una tabla.
• Agregar un campo a una tabla.
• Elegir el control de un campo.
• Hacer que un campo sea obligatorio o de solo lectura en un formulario.
• Agregar una nota o etiqueta a un formulario.
• Agrupar botones en una barra de comandos.
• Cambiar el nombre de un comando, ocultarlo o reordenarlo.
• Crear una vista.