Tables, champs et enregistrements

Chaque table stocke les définitions de champs, les valeurs d'enregistrement, une matrice de données de cellules optionnelle, les ressources, les vues et les index dont dépendent la logique de rendu et de recherche.

Les nouveaux tableaux ne contiennent aucun enregistrement. Les enregistrements sont ajoutés par le biais du Facade API ou par l'importation de données instantanés.

Instantané d’une table

PropriétéTypeDescription
idstringIdentifiant de la table.
namestringNom de la table.
fieldsRecord\<string, IFieldSnapshot\>Définitions des champs indexées par identifiant de champ.
fieldOrderstring[]Liste ordonnée des identifiants de champs.
recordsRecord\<string, IRecordSnapshot\>Données des enregistrements indexées par identifiant d’enregistrement.
recordOrder?string[]Liste ordonnée des identifiants d’enregistrements.
primaryFieldIdstringIdentifiant du champ principal.
viewsRecord\<string, IViewSnapshot\>Vues indexées par identifiant de vue.
viewOrderstring[]Liste ordonnée des identifiants de vues.
resources?IBaseResourcesLes ressources d'option, de membre et d'attachement sont partagées dans toute la table.

Instantané d’un champ

PropriétéTypeDescription
idstringIdentifiant du champ.
namestringNom du champ.
description?stringDescription du champ.
typeBaseFieldTypeType du champ.
configRecord\<string, unknown\>Config spécifique au type de champ.
defaultValue?BaseCellValueValeur par défaut des nouveaux enregistrements.
system?booleanSi le champ est géré par le système.
readonly?booleanIndique si les valeurs sont en lecture seule.

Types de champs

Les types de champs courants comprennent text, number, currency, progress, rating, checkbox, singleSelect, multiSelect, person, group, date, attachment, formula, createdAt, updatedAt, createdBy et updatedBy.

Utilisez les enums Facade dans le code d'application:

TypeScript
const field = table.addField('Due date', univerAPI.Enum.BaseFieldType.Date)

Instantané d’un enregistrement

PropriétéTypeDescription
idstringIdentifiant de l’enregistrement.
valuesRecord\<string, BaseCellValue\>Valeurs indexées par identifiant de champ.
orderKeystringClé d’ordre stable.
createdAtnumberHorodatage de création.
updatedAtnumberChronographe de la dernière mise à jour.
createdBy?stringIdentifiant de l’auteur.
updatedBy?stringID de la dernière mise à jour.

Exemple avec Facade

TypeScript
const table = base.insertTable('Tasks', { primaryFieldName: 'Title' })const title = table.getPrimaryField()const status = table.addField('Status', univerAPI.Enum.BaseFieldType.SingleSelect)const record = table.addRecord({  [title.getId()]: 'Write guide',  [status.getId()]: 'In progress',})

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.