Horodatage Unix

Présentation

Dans NocoBase, l’horodatage Unix (Unix timestamp) sert à enregistrer des horodatages Unix.

Les horodatages Unix sont souvent utilisés pour l’intégration avec des systèmes externes, les données de journaux ou la migration de données historiques. Ils sont enregistrés sous forme numérique, mais leur signification métier correspond à une date et une heure.

En l’absence d’exigence d’horodatage provenant d’un système externe, il est plus facile de comprendre et de maintenir les données en utilisant directement Date et heure.

Cas d’utilisation

L’horodatage Unix convient aux scénarios métier suivants :

  • Synchronisation des horodatages avec des systèmes externes
  • Heure à laquelle un événement a été enregistré dans les journaux
  • Unix timestamp renvoyé par une API
  • Champs temporels lors de la migration de données historiques

Création et configuration

Dans la page « Configure fields » de la table de données, cliquez sur « Add field », puis sélectionnez « Horodatage Unix » pour créer un champ Horodatage Unix.

20240512180432

ConfigurationDescription
Field interfaceType d’interface du champ. L’horodatage Unix correspond à unixTimestamp, qui détermine la manière de saisir et d’afficher la valeur dans la page.
Field display nameNom affiché pour le champ dans l’interface, par exemple « Horodatage de synchronisation », « Heure du journal » ou « Heure de mise à jour externe ». Il est recommandé d’utiliser un nom directement compréhensible par les utilisateurs métier.
Field nameNom d’identification du champ, utilisé pour les API, les champs de relation, les autorisations, les workflows et autres références internes. Il n’est généralement plus modifiable après la création, accepte uniquement les lettres, les chiffres et les traits de soulignement, et doit commencer par une lettre.
Field typeType du champ au niveau des données. L’horodatage Unix est généralement enregistré sous forme d’entier ou de grand entier.
Default valueValeur par défaut. Lors de la création d’un enregistrement, cette valeur peut être renseignée automatiquement si l’utilisateur ne saisit rien.
Validation rulesRègles de validation. Il est possible de configurer l’obligation de saisie et la plage de valeurs numériques.
DescriptionDescription du champ. Elle peut préciser la signification du champ, les règles de saisie, la source des données ou la personne responsable de sa maintenance.
Attention

Le nom du champ sera référencé par les blocs de page, les autorisations, les workflows et les API. Vérifiez la nomenclature avant la création afin d’éviter des coûts d’ajustement de configuration par la suite.

Caractéristiques du champ

Le comportement par défaut du champ Horodatage Unix est le suivant :

CaractéristiqueDescription
Field interface par défautunixTimestamp.
Field type par défautbigInt.
Field type disponiblesinteger, bigInt.
Composant de pageEn mode édition, le champ est traité par le composant de champ d’horodatage.
FiltragePrend en charge le filtrage par valeur numérique de l’horodatage ou par plage temporelle correspondante.
TriLe tri est pris en charge.
ValidationLa validation de l’obligation de saisie et de la plage de valeurs numériques est prise en charge.

Modification de la configuration

Après la création, cliquez sur « Edit » à droite du champ pour modifier la configuration du champ Horodatage Unix. La modification d’un champ sert principalement à ajuster sa présentation et son utilisation dans NocoBase, par exemple son nom d’affichage, sa description, sa valeur par défaut, ses règles de validation ou ses paramètres propres.

Si le champ provient d’une table déjà synchronisée dans la base de données principale, sa modification consiste généralement à effectuer une mise en correspondance de champ : le champ de la base de données est associé à un Field type et à un Field interface de NocoBase.

ConfigurationModifiableDescription
Field display nameOuiModifie le nom affiché du champ dans l’interface sans changer son nom d’identification.
Field nameNonLe nom d’identification du champ ne peut généralement pas être modifié dans le formulaire d’édition après la création.
Field interfaceSelon les conditionsLes champs de la base de données principale ou les champs synchronisés peuvent être ajustés lors de la mise en correspondance. Cette modification affecte le mode de saisie, d’affichage et de validation dans les pages.
Field typeSelon les conditionsLes champs de la base de données principale ou les champs synchronisés peuvent être ajustés lors de la mise en correspondance. Avant toute modification, vérifiez que les données existantes peuvent être utilisées avec le nouveau type.
Default valueOuiModifie la valeur par défaut des nouveaux enregistrements.
Validation rulesOuiModifie les règles de validation du champ.
DescriptionOuiComplète la signification du champ, les règles de saisie, la source des données ou la personne responsable de sa maintenance.
Attention

Changer le Field type ou le Field interface ne revient pas à modifier simplement un nom d’affichage. Cela affecte le mode de stockage du champ, le composant de saisie, les règles de validation, les conditions de filtrage et le mode d’utilisation des variables dans les workflows. Lorsque le volume de données existantes est important, vérifiez d’abord que leur format correspond.

Suppression d’un champ

Cliquez sur « Delete » à droite du champ pour supprimer le champ Horodatage Unix. Dans la base de données principale, vous pouvez également sélectionner plusieurs champs et les supprimer en une seule fois.

Lors de la suppression d’un champ Horodatage Unix créé dans la base de données principale, la colonne correspondante dans la base de données ainsi que les données qu’elle contient sont généralement supprimées en même temps. Lorsqu’un champ est synchronisé depuis une base de données ou provient d’une mise en correspondance avec une source de données externe, l’étendue des conséquences dépend de la source de données et de l’origine du champ.

Avertissement

La suppression d’un champ peut affecter les blocs de page, les formulaires, les filtres, les autorisations, les workflows, les API, les importations et exportations, ainsi que les données existantes. Avant de le supprimer, vérifiez qu’il n’est plus référencé par des configurations métier.

Utilisation dans la configuration des pages

Le champ Horodatage Unix convient aux intégrations avec des systèmes externes et aux scénarios liés aux journaux. 20260709232558

ScénarioUtilisation
Bloc de formulaireSaisir ou mettre en correspondance un horodatage.
Bloc de tableauAfficher, trier et filtrer les horodatages.
WorkflowUtiliser l’horodatage comme condition temporelle pour un système externe.
APIIntégrer une API nécessitant un Unix timestamp.

Liens associés