Entrée de Registre Unique

Spécifiez qu'une colonne ou une combinaison de colonnes doit être unique pour pouvoir sauvegarder un enregistrement, et un message s'affiche si l'unicité n'est pas respectée.

EMu fournit deux entrées de Registre différentes pour spécifier l'unicité des champs, l'entrée de Registre Unique et l'entrée de Registre Unique Index. Ces deux entrées peuvent être utilisées pour spécifier qu'un ou plusieurs champs sont uniques. Consultez Champs à valeur unique pour en savoir plus sur les différences entre les deux.

Tip: En général, sauf si vous cherchez à activer la vérification de l'unicité et l'auto-incrémentation d'une valeur dans un champ, il est recommandé que vous utilisiez l'entrée de Registre Unique pour spécifier le caractère unique des colonnes.

L'entrée de Registre Unique spécifie qu'une colonne ou une combinaison de colonnes doit être unique pour pouvoir sauvegarder un enregistrement, et un message s'affiche si l'unicité n'est pas respectée :

  • C'est une entrée côté client et l'unicité est vérifiée lorsque l'enregistrement est sauvegardé. Si un champ ou une combinaison de champs qui nécessite d'être unique n'est pas unique, l'enregistrement n'est pas sauvegardé et un message s'affiche avertissant l'utilisateur de changer la valeur.
  • Ce paramètre peut être ignoré en utilisant une entrée de Registre Unique Override (les utilisateurs / groupes peuvent sauvegarder un enregistrement même si une entrée de Registre Unique spécifie qu'une colonne ou une combinaison de colonnes doit être unique pour sauvegarder un enregistrement). Le message d'avertissement défini dans l'entrée de Registre Unique s'affichera, mais l'utilisateur aura le choix de sauvegarder l'enregistrement quand même.

Utilisation

Cette entrée de Registre est attribuée aux utilisateurs et aux groupes :

Clé Utilisateur Utilisateur Groupe Groupe Groupe Groupe
Clé 1 User User Group Group Group Group
Clé 2 utilisateur utilisateur groupe groupe Default Default
Clé 3 Table Table Table Table Table Table
Clé 4 table Default table Default table Default
Clé 5 Unique
Clé 6 colonne;colonne;...
Valeur message
User utilisateur Table table Unique colonne;colonne;... message
User utilisateur Table Default Unique colonne;colonne;... message
Group groupe Table table Unique colonne;colonne;... message
Group groupe Table Default Unique colonne;colonne;... message
Group Default Table table Unique colonne;colonne;... message
Group Default Table Default Unique colonne;colonne;... message

où :

colonne;colonne;...

est une colonne ou une combinaison de colonnes (séparées par un point-virgule) qui doit être unique (ou vide) pour pouvoir sauvegarder un enregistrement.

Notez que si plus d'une colonne est spécifiée, c'est la combinaison de colonnes qui doit être unique, et non pas chaque colonne individuelle dans la combinaison.

Par exemple, si une combinaison unique de trois colonnes est requise pour sauvegarder un enregistrement, deux enregistrements peuvent partager deux des trois valeurs, tant que la troisième valeur est différente. Si la combinaison de Champ1, Champ2 et Champ3 doit être unique, ces deux enregistrements pourraient être sauvegardés :

Enregistrement 1 : Champ1 = A, Champ2 = B, Champ3 = C

Enregistrement 2 : Champ1 = A, Champ2 = B, Champ3 = D

Remarque :

  • Seules les colonnes atomiques de types de base (texte, entiers, devise et float) peuvent être utilisées.
  • L'entrée de Registre Unique peut être appliquée à des tables imbriquées et doublement imbriquées : chaque valeur dans la table affectée doit n'apparaître qu'une seule fois.

message

est un message qui apparaît si la combinaison n'est pas unique.

Dans un système multilingue, les traductions du message peuvent être fournies en séparant les traductions avec le délimiteur de langue (par exemple ;:;), par exemple : message_english;:;message_français;:;...

Remarque :

  • L'unicité est vérifiée uniquement quand un enregistrement est sauvegardé.
  • Si la colonne ou la combinaison de colonnes n'est pas unique, le message d'avertissement s'affiche et le curseur se déplace sur le contrôle associé à la première colonne figurant dans l'entrée de Registre Unique.
  • Les champs uniques sont généralement définis au niveau Group|Default et sont les mêmes pour tous les utilisateurs, même si ils peuvent être définis pour des utilisateurs et groupes spécifiques.
  • Si un champ à valeur unique est vide, mais pas obligatoire, l'enregistrement peut quand même être sauvegardé.

Exemple

L'entrée de Registre suivante spécifie qu'une combinaison de la Date de naissance, Prénom du Nom et dans le module Personnes / Organisations doit être unique pour pouvoir sauvegarder l'enregistrement :

Clé Réglage Description
Clé 1 Group  
Clé 2 Default  
Clé 3 Table  
Clé 4 eparties  
Clé 5 Unique  
Clé 6 BioBirthDate;NamFirst;NamLast L'ensemble de ces 3 champs doit être unique pour sauvegarder l'enregistrement.
Valeur Cet enregistrement n'est pas unique. Le message à afficher lorsque la combinaison de champs n'est pas unique.

Lorsqu'un enregistrement est sauvegardé dans le module Personnes / Organisations, un contrôle est lancé pour déterminer si la combinaison des champs est unique, sinon le message d'avertissement s'affiche.