Les valeurs de données de référence d'un ensemble sont généralement identifiées par un code unique. Toutefois, vous devrez peut-être identifier les données à l'aide de plusieurs colonnes. Une clé composite est une combinaison de la colonne de code et jusqu'à 5 colonnes personnalisées dans un jeu de données de référence. La clé composite est ensuite utilisée pour identifier de manière unique chaque valeur de données de référence.

Droits requis Pour créer, éditer ou supprimer des jeux de données de référence, vous devez disposer des droits utilisateursuivants:

• Accès aux artefacts de gouvernance

Vous devez aussi avoir l'un des rôles de collaborateur de catégorie suivants dans la catégorie primaire du jeu de données de référence :

• Administrateur
• Propriétaire
• Éditeur
• Rôle personnalisé avec le droit de créer des ensembles de données de référence.

Une clé composite est utilisée pour identifier de manière unique chaque valeur de données de référence. Avec une clé composite, les valeurs de la colonne de code n'ont plus besoin d'être uniques. L'unicité n'est garantie que lorsque les valeurs de toutes les colonnes spécifiées sont combinées-les valeurs des colonnes individuelles ne sont pas nécessairement uniques.

Lorsque vous définissez une clé composite pour l'ensemble, chaque valeur de données de référence d'un tel ensemble est identifiée dans le système par une représentation physique de la clé composite, qui est une concaténation de la colonne de code et des colonnes personnalisées de clé composite dans l'ordre spécifié lors de la création initiale de l'ensemble. Les valeurs sont délimitées par |, par exemple: CODE|CC1|CC2|CC3. Cette représentation physique est utilisée pour identifier les valeurs de données de référence dans le système (par exemple, pour suivre les relations) et ne peut pas être modifiée.

Les restrictions suivantes s'appliquent aux colonnes personnalisées utilisées pour créer une clé composite:

• Les colonnes de clé composite ne peuvent être ajoutées qu'à des jeux de données de référence nouveaux ou vides. Si des valeurs de données de référence sont déjà ajoutées à un ensemble, vous ne pouvez pas définir de clé composite.
• Les colonnes personnalisées que vous souhaitez valider doivent être de type Texte.
• Il peut y avoir jusqu'à 5 colonnes personnalisées ajoutées à la colonne Code pour comprendre une clé composite. La colonne de code est toujours la première.
• Si la colonne personnalisée fait partie de la clé composite, elle doit être définie comme obligatoire.
• Lorsque des valeurs de données de référence sont ajoutées à l'ensemble, la clé composite ne peut plus être modifiée. Si une modification est nécessaire, vous devez créer un nouveau jeu de données de référence.
• La colonne de clé composite peut comporter jusqu'à 200 caractères. Les colonnes personnalisées qui ne font pas partie de la clé composite ont la limite définie sur 2000.
• Les caractères | et UNIT SEPARATOR (code ASCII 0x31) ne doivent pas être utilisés dans la colonne de code ni dans les colonnes personnalisées utilisées pour créer la clé composite. Ce caractère est utilisé pour séparer les valeurs de clé composite lors de la création d'une représentation physique de la clé composite dans la base de données. Cette restriction s'applique uniquement à l'API v4.

Pour créer un jeu de données de référence avec une clé composite à l'aide d'un fichier CSV avec des valeurs:

1. Choisissez Gouvernance > Données de référence, puis cliquez sur Ajouter un jeu de données de référence.

2. Cliquez sur Nouveau jeu de données de référence et indiquez ce qui suit dans le panneau Détails:

   1. Téléchargez le fichier CSV.
   2. Indiquez un nom pour le jeu de données de référence.
   3. Indiquez le type des valeurs: Texte, Nombre ou Date.
   4. Sélectionnez la catégorie dans laquelle créer le jeu de données de référence.
   5. Si vous le souhaitez, entrez une description.

3. Dans le panneau Mapper les colonnes , mappez les colonnes de votre fichier CSV aux colonnes cible:

   1. Indiquez si la première ligne d'un fichier CSV doit être utilisée comme en-tête de colonne à la place de la première valeur de données de référence.

   2. Mappez les colonnes de votre fichier une par une. L'aperçu de la colonne téléchargée s'affiche. Si les colonnes prédéfinies ne répondent pas à vos besoins, sélectionnez Nouvelle colonne personnalisée.

   3. Pour chaque colonne personnalisée, spécifiez:

      • Nom: le nom de colonne doit être unique dans un jeu de données de référence donné.
      • Type: Texte, Numéro ou Date.
      • Description: facultative.
      • Nombre maximal de caractères à utiliser pour un enregistrement dans une colonne. La limite pour une colonne de clé composite est 200. Pour toute autre colonne, la limite est 2000. Cette limite peut être modifiée uniquement lorsque le jeu de données de référence est vide. Lorsque des valeurs sont ajoutées dans l'ensemble, vous pouvez uniquement augmenter la limite.
      • Si vous le souhaitez, sélectionnez le jeu de données de référence à utiliser pour la validation-les valeurs de la colonne seront validées par rapport à la colonne CODE du jeu de données de référence sélectionné. Si une valeur de colonne personnalisée n'est pas valide pour une raison quelconque, la valeur de données de référence n'est pas créée ou importée et un avertissement est ajouté au rapport.

      Remarque :

      • Le jeu de données de référence que vous choisissez comme valideur ne peut plus être supprimé à moins que la validation par rapport à ce jeu ne soit supprimée.
      • Le valideur d'une colonne peut être défini ou modifié uniquement si le jeu de données de référence est vide.
      • Vous pouvez uniquement valider les colonnes de type Texte, car la colonne CODE que vous validez est toujours de ce type.

   4. Si vous souhaitez que la colonne personnalisée fasse partie de la clé composite, sélectionnez Partie de la clé composite. La colonne est alors automatiquement marquée comme Obligatoire, ce qui signifie que les valeurs ne peuvent pas être vides.

4. Lorsque toutes les colonnes sont mappées, passez en revue les informations du panneau Vérification . Notez qu'à ce stade, vous pouvez réorganiser les colonnes de clés composites en fonction de vos besoins. L'ordre des colonnes définies dans ce panneau influence la façon dont la représentation physique de la clé composite est formée dans le système. Par exemple, si les colonnes de ce panneau sont répertoriées dans l'ordre suivant:

   • colonne personnalisée 1
   • colonne personnalisée 2
   • colonne personnalisée 3

   La représentation physique de la clé composite pour ces valeurs de données de référence est ensuite formée sous la forme CODE|CC1|CC2|CC3. Lorsque vous ajoutez des valeurs au jeu de données de référence, cet ordre ne peut plus être modifié. Vous pouvez réorganiser les colonnes dans l'interface utilisateur lors de l'affichage de l'ensemble, mais cela n'a aucune incidence sur la composition réelle de la clé composite. Comparez l'ordre des colonnes à l'ordre spécifié dans le fichier CSV et modifiez-le si nécessaire.

5. Cliquez sur Créer. Le jeu de données de référence est sauvegardé en tant que brouillon.

Remarque: Lorsque vous utilisez les fichiers CSV avec des valeurs de données de référence, assurez-vous que la relation parent entre les valeurs est représentée par la concaténation des valeurs de colonne personnalisées CODE et de clé composite délimitées par |. Le code passe toujours en premier, puis les valeurs de colonne de clé composite. Assurez-vous que l'ordre de ces colonnes est identique dans le fichier CSV et dans le panneau récapitulatif de l'assistant de création ou d'importation.

Lorsque vous avez terminé, effectuez l'une des actions suivantes :

• Fermez le nouveau jeu de données de référence dans son état de brouillon.
• Cliquez sur Supprimer le brouillon pour supprimer le nouveau fichier de référence.
• En fonction de votre définition de flux de travaux , cliquez sur Publier ou sur Envoyer pour approbation pour traiter le jeu de données de référence.