Icono

Introducción

En NocoBase, el icono (Icon) se utiliza para guardar identificadores de iconos.

El campo de icono es adecuado para proporcionar un identificador visual a categorías, menús, estados y entradas. Guarda el valor del icono, que se renderiza mediante el componente de icono cuando se muestra en la página.

Si quieres subir una imagen real, selecciona Adjunto. Si solo quieres guardar una descripción del icono, selecciona Texto de una línea.

Casos de uso

El campo de icono es adecuado para estos escenarios empresariales:

  • Iconos de menú e iconos de entradas de funciones
  • Iconos de categorías e iconos de etiquetas
  • Iconos de estado e iconos de nivel
  • Identificadores visuales en paneles o tarjetas

Creación y configuración

En la página «Configure fields» de la tabla de datos, haz clic en «Add field» y selecciona «Icono» para crear un campo de icono.

20240512180027

ConfiguraciónDescripción
Field interfaceTipo de interfaz del campo. Para el icono corresponde a icon, que determina cómo se introduce y se muestra en la página.
Field display nameNombre con el que se muestra el campo en la interfaz, por ejemplo, «Icono del menú», «Icono de categoría» o «Icono de estado». Se recomienda utilizar un nombre que el personal empresarial pueda entender directamente.
Field nameNombre identificador del campo, utilizado para referencias internas en la API, campos de relación, permisos, flujos de trabajo, etc. Normalmente no se modifica después de su creación. Solo admite letras, números y guiones bajos, y debe comenzar con una letra.
Field typeTipo del campo en la capa de datos. De forma predeterminada, el campo de icono es string.
Default valueValor predeterminado. Al crear un registro, si el usuario no introduce ningún valor, se puede completar automáticamente con el valor predeterminado.
Validation rulesReglas de validación. Normalmente basta con configurar el campo como obligatorio.
DescriptionDescripción del campo. Es adecuado indicar su significado, los requisitos de introducción, el origen de los datos o la persona responsable del mantenimiento.
Nota

El nombre del campo será utilizado por bloques de página, permisos, flujos de trabajo y API después de su creación. Confirma el nombre antes de crearlo para evitar costes de configuración derivados de cambios posteriores.

Características del campo

El comportamiento predeterminado del campo de icono es el siguiente:

CaracterísticaDescripción
Field interface predeterminadaicon.
Field type predeterminadostring.
Field type disponiblestring.
Componente de páginaEn el modo de edición se utiliza un componente de selección de iconos.
FiltradoNormalmente no se utiliza como condición de filtrado principal.
OrdenaciónNormalmente no se utiliza para ordenar.
ValidaciónAdmite validaciones básicas, como la obligatoriedad.

Edición de la configuración

Después de crear el campo, haz clic en «Edit» a la derecha del campo para editar su configuración. La edición del campo se utiliza principalmente para ajustar cómo se muestra y se utiliza en NocoBase, por ejemplo, para modificar el nombre mostrado, la descripción, el valor predeterminado, las reglas de validación o la configuración específica del campo.

Si el campo procede de una tabla ya sincronizada de la base de datos principal, la edición normalmente consiste en realizar una asignación de campos: asignar el campo de la base de datos a un Field type y un Field interface de NocoBase.

ConfiguraciónSe puede editarDescripción
Field display nameModifica el nombre con el que se muestra el campo en la interfaz, sin cambiar su nombre identificador.
Field nameNoNormalmente, el nombre identificador del campo no se puede modificar en el formulario de edición después de su creación.
Field interfaceSegún las condicionesLos campos de la base de datos principal o los campos sincronizados se pueden ajustar durante la asignación de campos. El cambio afectará a la forma de introducir, mostrar y validar los datos en la página.
Field typeSegún las condicionesLos campos de la base de datos principal o los campos sincronizados se pueden ajustar durante la asignación de campos. Antes de hacerlo, es necesario confirmar que los datos existentes se puedan utilizar con el nuevo tipo.
Default valueAjusta el valor predeterminado al crear nuevos registros.
Validation rulesAjusta las reglas de validación del campo.
DescriptionCompleta el significado del campo, los requisitos de introducción, el origen de los datos o la persona responsable del mantenimiento.
Nota

Cambiar el Field type o el Field interface no equivale simplemente a modificar un nombre mostrado. Afecta a la forma de almacenamiento del campo, al componente de entrada, a las reglas de validación, a las condiciones de filtrado y a la forma de utilizar las variables en los flujos de trabajo. Si ya hay muchos datos, confirma primero que el formato de los datos sea compatible.

Eliminación del campo

Haz clic en «Delete» a la derecha del campo para eliminarlo. En la base de datos principal también puedes seleccionar varios campos y eliminarlos por lotes.

Al eliminar un campo de icono creado en la base de datos principal, normalmente también se eliminan la columna real correspondiente de la base de datos y los datos existentes en dicha columna. Al eliminar un campo sincronizado desde una base de datos o asignado desde una fuente de datos externa, el alcance del impacto depende de la fuente de datos y del origen del campo correspondientes.

Advertencia

La eliminación de un campo puede afectar a bloques de página, formularios, filtros, permisos, flujos de trabajo, API, importaciones y exportaciones, así como a los datos existentes. Antes de eliminarlo, confirma que el campo ya no sea utilizado por ninguna configuración empresarial.

Uso en la configuración de páginas

El campo de icono es adecuado para proporcionar indicaciones visuales en listas, tarjetas y vistas de detalle. 20260709225630

EscenarioUso
Bloque de formularioSeleccionar un icono.
Bloque de detalleMostrar un icono.
Lista o tarjetaUtilizarlo como identificador visual de una categoría, un estado o una entrada.
Permisos y flujos de trabajoNormalmente no se utiliza como campo de condición principal.

Enlaces relacionados

  • Campos — Conoce la función, clasificación y lógica de asignación de los campos
  • Tabla normal — Crear y gestionar campos en una tabla normal
  • Color — Guardar identificadores de color
  • Adjunto — Subir imágenes o archivos