Agregar un campo a una tabla

Objetivo

Agregar un campo a una tabla existente para que sus registros puedan almacenar un dato más.

Requisitos previos

• Ha iniciado sesión con un rol de creador (o de administrador de la plataforma).
• La tabla ya existe (consulte Crear una tabla).

Pasos

1. Abra Tablas, elija el entorno y seleccione el nombre de la tabla en la lista de tablas para abrirla en la pestaña Campos.

2. Escriba el nombre para mostrar del nuevo campo (por ejemplo, Total).

3. Escriba un nombre lógico. El prefijo del editor propietario de la solución en la que está trabajando se muestra junto al cuadro y se aplica automáticamente, así que solo escribe el resto: total se convierte en par_total.

   Esto también ocurre en las tablas estándar. Account y Contact no tienen prefijo propio porque las proporciona Parsware, pero una columna que usted les agrega es suya: se convierte en par_accountnumber, no en accountnumber. Los nombres sin prefijo pertenecen a la plataforma, y uno que usted invente entraría en conflicto con la próxima columna que Parsware agregue con ese nombre.

4. Elija un tipo de datos. Solo aparecen las entradas pertinentes para el tipo elegido:

   • Texto: texto de una sola línea (puede fijar una longitud máxima; el valor predeterminado es 100).
   • Texto multilínea: texto largo.
   • Entero: números enteros.
   • Decimal: números de coma fija. La precisión es el número total de dígitos; la escala es cuántos de ellos van después del separador decimal. Así, 12 y 2 admite hasta 9.999.999.999,99, mientras que 2 y 2 no admite nada por encima de 0,99. El valor predeterminado es 18 y 2, que es lo que conviene para importes salvo que sepa otra cosa.
   • Booleano: verdadero/falso.
   • Fecha y hora: una fecha y una hora.
   • Búsqueda: una referencia a un registro de otra tabla; elija la tabla de destino (la propia tabla queda excluida de las opciones). Agregar un campo de búsqueda crea automáticamente la relación de uno a varios entre las dos tablas; no hace falta crear la relación por separado (consulte Crear una relación entre tablas).
   • Búsqueda (varias tablas): una referencia a un registro de cualquiera de varias tablas, por ejemplo un Cliente que puede ser una cuenta o un contacto. Marque al menos dos tablas; el campo guarda entonces en cuál de ellas está el registro junto con su id. No tiene clave externa, que es lo único a lo que renuncia a cambio; consulte Agregar una búsqueda de varias tablas.
   • Numeración automática: un número de referencia que la plataforma da a cada registro nuevo, como CR-2026-00417. Su único ajuste es el formato del número, con vista previa mientras escribe; nadie escribe el valor, así que no tiene casilla obligatorio. Consulte Numerar los registros automáticamente.

5. Si lo desea, marque el campo como obligatorio.

6. Seleccione Agregar campo.

7. El campo aparece en la lista de campos de la tabla y su columna ya existe: no hay que pulsar nada más.

Qué ocurre entre bastidores

El campo se almacena como metadatos de la tabla y su columna se agrega a la tabla de datos en el mismo paso, de modo que el campo está operativo en cuanto lo agrega: colóquelo en un formulario y los usuarios de la aplicación podrán rellenarlo. Un campo de búsqueda hace referencia a otra tabla por su nombre lógico y se convierte en una referencia real (clave externa) a ella.

Si la columna no se puede crear, el campo se retira de nuevo y se informa del error, de modo que un campo de esta lista siempre tiene una columna detrás. Consulte Qué ocurre al guardar una tabla.

Editar un campo

Marque la casilla del campo y seleccione Editar. Lo que puede cambiar es:

• Nombre para mostrar: la etiqueta en todos los lugares donde se muestra el campo. Cambiarle el nombre es seguro: todo lo que usa el campo se refiere a él por su nombre lógico, que no cambia.
• Obligatorio: si el campo es obligatorio de forma predeterminada en los formularios. Es una regla del formulario, no una restricción de la base de datos: todas las columnas aceptan un valor vacío, y un formulario puede seguir anulándola para una ubicación concreta (consulte Hacer que un campo sea obligatorio o de solo lectura). Por eso, activarla nunca invalida un registro existente.
• Longitud máxima (texto) o precisión y escala (decimal): el tamaño del campo. Deje un cuadro vacío para conservar el valor actual.

Lo que no puede cambiar es el nombre lógico del campo, su tipo de datos y, en un campo de búsqueda o de conjunto de opciones, a qué apunta. Se muestran pero están bloqueados, porque todo lo que usa el campo se refiere a él por su nombre, y su columna ya contiene datos de un tipo; los valores que contiene se validaron contra el destino o el conjunto que tiene ahora. Para cambiar cualquiera de ellos, elimine el campo y agréguelo de nuevo.

Cambiar el tamaño de un campo es un cambio real en la tabla de datos, porque su columna ya existe. Alargar un campo de texto siempre funciona. Acortarlo falla si algún registro ya contiene un valor más largo: al guardar se informa del error en lugar de recortar lo que alguien escribió. Amplíe el campo o limpie antes los datos.

Eliminar un campo

Marque la casilla del campo y seleccione Eliminar. El campo también se quita de todos los formularios y vistas de la tabla que lo usaban, para que nada quede apuntando a un campo que ya no existe. No necesita revisar cada formulario y cada vista usted mismo. Eliminar un campo de búsqueda también quita la relación que creó, de modo que una búsqueda eliminada nunca deja atrás una relación huérfana.

Conviene saber tres cosas antes de eliminar:

• Una sección que queda vacía se mantiene. Solo se quita el campo: la sección, la fila o la pestaña donde lo colocó permanecen, listas para otra cosa.
• Una vista que se queda sin columnas recurre a la columna principal de la tabla. Una vista tiene que mostrar algo.
• Una vista que filtraba por el campo mostrará más registros que antes. El filtro se va con el campo, porque no se puede aplicar un filtro a un campo que ya no existe. Si una vista existe para ocultar registros según este campo, revísela después.

El campo principal de la tabla no se puede eliminar. La columna de datos en sí se queda en la tabla: eliminar el campo lo quita de la aplicación, no de los datos almacenados.

Solución de problemas

• He agregado un campo, pero no aparece en la aplicación. — la columna existe en cuanto se agrega el campo, pero un campo solo se muestra donde se coloca. Agréguelo al formulario o a la vista que está mirando.
• «… must be lower snake-case and start with the publisher prefix.» — el nombre lógico del campo debe empezar por {prefix}_.
• «… must be namespaced by your publisher's prefix.» — el campo se envió sin ningún prefijo. Solo las columnas estándar propias de Parsware carecen de prefijo; todo lo que usted agrega lleva el prefijo de su editor, incluso en una tabla estándar.
• «A field named … already exists on this entity.» — elija otro nombre lógico; los nombres de campo son únicos dentro de una tabla.
• «The lookup target entity … was not found.» — cree primero la tabla de destino o corrija el destino que seleccionó.
• «Text maxLength must be between 1 and 4000.» / «Decimal precision/scale is out of range.» — ajuste la longitud o la precisión/escala al intervalo permitido.
• Al guardar un registro se indica que un número «must have at most 0 digits before the decimal point». — la precisión del campo cuenta todos los dígitos, no los decimales. Un campo pensado para importes con dos decimales necesita precisión 12 y escala 2; precisión 2 y escala 2 es una columna que no admite nada por encima de 0,99. El tipo de datos no se puede cambiar a posteriori, pero la precisión y la escala sí: seleccione el campo, pulse Editar y amplíelo.
• Editar no está disponible para un campo. — Editar requiere exactamente un campo seleccionado, y los campos de sistema propios de la plataforma (Fecha de creación, Modificado por, etc.) no se pueden editar: pertenecen a la plataforma, no a su tabla.
• Al acortar un campo se indica «value too long for type …». — un registro ya contiene un valor más largo que la nueva longitud. El cambio se rechaza en lugar de recortarlo. Amplíe el campo o acorte antes los registros afectados.

Escenarios relacionados

• Crear una tabla.
• Qué ocurre al guardar una tabla.
• Crear una relación entre tablas.