Table des fichiers
Présentation
La table des fichiers convient à la conservation des métadonnées des fichiers, comme le nom, l’extension, la taille, le type MIME, le chemin, l’URL, l’adresse d’aperçu, l’emplacement de stockage et les métadonnées personnalisées. Le contenu des fichiers est conservé par le moteur de stockage des fichiers, tandis que la table des fichiers conserve leurs métadonnées.
La table des fichiers peut uniquement être créée depuis la page de la base de données principale. Les bases de données externes, les sources de données REST API et les sources de données NocoBase externes ne prennent pas en charge la création de tables de fichiers.
Cas d’utilisation
La table des fichiers convient aux scénarios métier suivants :
- Pièces jointes de contrats, factures et justificatifs de remboursement
- Images de produits, pièces d’identité des employés et documents de projet
- Fichiers téléversés, fichiers d’aperçu et fichiers à télécharger des enregistrements métier
- Bibliothèque de pièces jointes nécessitant une gestion distincte des métadonnées de fichiers
Processus d’utilisation
La table des fichiers n’est généralement pas utilisée directement comme table métier principale. Le processus courant est le suivant :
- Créer une table des fichiers pour conserver le titre, le nom, la taille, le type, l’URL, l’emplacement de stockage et autres métadonnées des fichiers.
- Créer un champ de relation dans la table métier et l’associer à la table des fichiers. Par exemple, associer la table « Pièces jointes de contrat » dans la table « Contrats ».
- Ajouter le champ de relation dans le bloc de formulaire de la table métier afin que les utilisateurs puissent téléverser des fichiers lors de la création ou de la modification d’un enregistrement métier.
- Une fois le téléversement terminé, NocoBase écrit les métadonnées du fichier dans la table des fichiers et associe l’enregistrement du fichier à l’enregistrement métier actuel via le champ de relation.
- Afficher le champ de pièce jointe dans le bloc de détails, le bloc de tableau ou le bloc de liste de la table métier afin que les utilisateurs puissent consulter, prévisualiser ou télécharger les fichiers.
Configuration de la création
Dans la base de données principale, cliquez sur « Create collection », puis sélectionnez « File collection » pour créer une table des fichiers.
La configuration de création d’une table des fichiers est globalement identique à celle d’une table ordinaire. Une série de champs de métadonnées de fichiers est préconfigurée afin de conserver le titre, le chemin, l’URL, l’emplacement de stockage et les informations d’extension des fichiers téléversés.
Champs intégrés
Après sa création, une table des fichiers contient généralement les champs intégrés suivants. Le contenu des fichiers est conservé dans le stockage des fichiers, tandis que la table des fichiers conserve ces métadonnées.
Champ de clé primaire
Comme les tables ordinaires, les tables des fichiers doivent posséder un champ de clé primaire. Les champs de pièces jointes et les champs de relation utilisent la clé primaire pour associer les métadonnées des fichiers.
Si la table des fichiers ne possède pas de clé primaire, définissez « Record unique key » lors de la modification de la table de données. Sinon, les enregistrements de pièces jointes risquent de ne pas pouvoir être correctement associés, prévisualisés ou modifiés.
Créer une relation
Créez un champ de relation dans la table métier et associez-le à la table des fichiers.
Utilisation dans la configuration des pages
Les données de la table des fichiers sont généralement générées automatiquement lors du téléversement via le composant de pièces jointes. Elles sont utilisées dans les blocs de formulaire, de détails ou de relation.
Modifier la configuration
Dans la liste des tables de données, cliquez sur « Edit » à droite de la table des fichiers pour modifier son nom d’affichage, sa catégorie, sa description, le mode de pagination simplifié et d’autres paramètres tels que « Record unique key ».
Les champs de métadonnées des fichiers sont généralement renseignés automatiquement lors du téléversement. Il est déconseillé d’attribuer une autre signification métier à des champs tels que url, path et storageId. Si vous devez étendre les informations métier des fichiers, vous pouvez ajouter des champs, par exemple « Type de fichier », « Étape concernée » ou « Archivé ».
Supprimer une table de données
Dans la liste des tables de données, cliquez sur « Delete » à droite de la table des fichiers pour la supprimer.
La suppression d’une table des fichiers supprime les enregistrements de métadonnées des fichiers ainsi que les métadonnées Collection associées. Avant la suppression, vérifiez si les champs de pièces jointes, les champs de relation, les blocs de page, les autorisations, les workflows et les API des tables métier en dépendent encore.
La table des fichiers conserve les métadonnées des fichiers. La suppression d’un enregistrement de la table des fichiers peut invalider les références aux pièces jointes dans les enregistrements métier ; la suppression simultanée du contenu des fichiers dépend du stockage des fichiers et de la configuration métier. Avant toute opération, vérifiez si les fichiers sont encore utilisés par le système métier.
Liens associés
- Table ordinaire — Consulter la configuration générale et les modes d’utilisation des blocs
- Champs de table de données — Consulter la configuration des champs de pièces jointes et des champs de relation
- Gestionnaire de fichiers — Consulter la configuration du stockage des fichiers
- Multi-espace — En savoir plus sur les champs d’espace et les capacités d’isolation par espace