Tabla de archivos
Introducción
La tabla de archivos es adecuada para almacenar metainformación de archivos, como el nombre, la extensión, el tamaño, el tipo MIME, la ruta, la URL, la dirección de vista previa, la ubicación de almacenamiento y los metadatos personalizados. El contenido del archivo se guarda mediante el motor de almacenamiento de archivos; la tabla de archivos almacena los metadatos del archivo.
La tabla de archivos solo se puede crear desde la página de la base de datos principal. Las bases de datos externas, las fuentes de datos de la API REST y las fuentes de datos externas de NocoBase no admiten la creación de tablas de archivos.
Casos de uso
La tabla de archivos es adecuada para estos casos de uso:
- Adjuntos de contratos, archivos de facturas y comprobantes de reembolso
- Imágenes de productos, documentos de identidad de empleados y documentos de proyectos
- Archivos cargados, archivos de vista previa y archivos de descarga de registros empresariales
- Bibliotecas de adjuntos que requieren una gestión independiente de la metainformación de los archivos
Flujo de uso
Por lo general, la tabla de archivos no se utiliza directamente como tabla principal de negocio. El flujo habitual es:
- Crear una tabla de archivos para almacenar metainformación como el título, nombre, tamaño, tipo, URL y ubicación de almacenamiento del archivo.
- Crear un campo de relación en la tabla de negocio para asociarlo con la tabla de archivos. Por ejemplo, asociar la tabla «Contratos» con la tabla de archivos «Adjuntos de contratos».
- Añadir el campo de relación a un bloque de formulario de la tabla de negocio, para que los usuarios puedan cargar archivos al crear o editar registros de negocio.
- Una vez completada la carga, NocoBase escribirá la metainformación del archivo en la tabla de archivos y asociará el registro del archivo con el registro de negocio actual mediante el campo de relación.
- Mostrar el campo de adjuntos en los bloques de detalles, tabla o lista de la tabla de negocio, para que los usuarios puedan consultar, previsualizar o descargar los archivos.
Configuración de creación
En la base de datos principal, haz clic en «Create collection» y selecciona «File collection» para crear una tabla de archivos.
La configuración de creación de una tabla de archivos es básicamente igual que la de una tabla normal. La tabla de archivos incluye de forma predeterminada un conjunto de campos de metainformación para almacenar el título, la ruta, la URL, la ubicación de almacenamiento y la información ampliada de los archivos cargados.
Campos integrados
Después de crearla, la tabla de archivos normalmente contiene los siguientes campos integrados. El contenido de los archivos se guarda en el almacenamiento de archivos, mientras que la tabla de archivos almacena esta metainformación.
Campo de clave principal
Al igual que las tablas normales, las tablas de archivos necesitan un campo de clave principal. Los campos de adjuntos y de relación utilizan la clave principal para asociar los metadatos de los archivos.
Si la tabla de archivos no tiene una clave principal, debes configurar «Record unique key» al editar la tabla de datos; de lo contrario, los registros de adjuntos podrían no asociarse, previsualizarse o editarse correctamente.
Establecer relaciones
Crea un campo de relación en la tabla de negocio y asócialo con la tabla de archivos.
Uso en la configuración de páginas
Los datos de la tabla de archivos normalmente se generan automáticamente al cargar archivos mediante el componente de adjuntos. Se utilizan en bloques de formulario, detalles o relaciones.
Editar la configuración
En la lista de tablas de datos, haz clic en «Edit» a la derecha de la tabla de archivos para modificar configuraciones como el nombre visible de la tabla de datos, las categorías, la descripción, el modo de paginación simple y «Record unique key».
Los campos de metainformación de los archivos normalmente se rellenan automáticamente durante la carga. No se recomienda cambiar el significado de negocio de campos como url, path y storageId. Si necesitas ampliar la información de negocio de los archivos, puedes añadir campos, como «Tipo de archivo», «Fase» o «Archivado».
Eliminar la tabla de datos
En la lista de tablas de datos, haz clic en «Delete» a la derecha de la tabla de archivos para eliminarla.
Eliminar la tabla de archivos eliminará los registros de metainformación de los archivos y los metadatos relacionados de Collection. Antes de eliminarla, confirma que los campos de adjuntos, los campos de relación, los bloques de página, los permisos, los flujos de trabajo y las API de las tablas de negocio ya no dependan de ella.
La tabla de archivos almacena los metadatos de los archivos. Eliminar los registros de la tabla de archivos puede invalidar las referencias a los adjuntos en los registros de negocio; la eliminación simultánea del contenido de los archivos depende del almacenamiento de archivos y de la configuración de negocio. Antes de realizar esta operación, confirma que los archivos ya no se utilicen en el negocio.
Enlaces relacionados
- Tabla normal — Consulta la configuración general y el uso de los bloques
- Campos de la tabla de datos — Consulta la configuración de los campos de adjuntos y de relación
- Gestor de archivos — Consulta la configuración relacionada con el almacenamiento de archivos
- Espacios múltiples — Obtén más información sobre los campos de espacio y las capacidades de aislamiento por espacio