Accéder au contenu principal Passer au contenu complémentaire

Ajouter un filtre de clés étrangères

L'une des annotations les plus utiles que vous pouvez configurer sur l'un des attributs (éléments) d'entités métier dans un modèle de données est le filtre de clés étrangères.

Avec cette annotation, vous pouvez filtrer les clés étrangères par :

  • valeurs extraites de l'enregistrement courant via l'utilisation du prédicat standard xpath de l'attribut correspondant,

  • Expressions complexes : littéral et fonctions,

  • valeurs de l'enregistrement courant et expressions complexes.

Notez que, si le filtre n'est pas une expression xpath mais une valeur, il doit être entouré de guillemets (").

Note InformationsRemarque : Les filtres personnalisés pour les clés étrangères ne sont pas supportés lorsque vous utilisez une base de données SQL pour stocker vos enregistrements de données.

Avant de commencer

Vous devez déjà avoir créé des modèles de données, des entités métier et des attributs dans le modèle de données. Pour plus d'informations, consultez Créer un modèle de données, Créer des entités métier dans un modèle de données et Ajouter des attributs à l'entité métier.

Pourquoi et quand exécuter cette tâche

Considérez que vos enregistrements de données contiennent les entités suivantes : Agency, Agent et Region. Les entités Agency et Region contiennent l'attribut Country. Dans Talend MDM Web UI, vous souhaitez filtrer les valeurs des clés étrangères par l'attribut Country.

Pour configurer un filtre de clés étrangères, procédez comme suit :

Procédure

  1. Cliquez-droit sur l'attribut que vous souhaitez ajouter à l'annotation, Agency > Region dans cet exemple.
  2. Dans le menu contextuel, sélectionnez Set the Foreign Key Filter.

    Une boîte de dialogue s'ouvre.

  3. Cliquez sur l'icône pour ajouter une ligne à la table dans laquelle vous pouvez configurer le filtre de clés étrangères.
  4. Cliquez dans la colonne XPath puis cliquez sur le bouton [...] pour ouvrir une boîte de dialogue dans laquelle vous pouvez sélectionner le chemin XPath sur lequel définir le filtre de clés étrangères.
  5. Sélectionnez Region > Country et cliquez sur Add dans la boîte de dialogue.

    Le chemin XPath est défini sur Region/Country.

  6. Cliquez dans la colonne Operator et sélectionnez un opérateur dans la liste, Contains dans cet exemple.
  7. Cliquez dans la colonne Value puis cliquez sur le bouton [...] pour ouvrir une boîte de dialogue dans laquelle vous pouvez sélectionner la valeur sur laquelle définir le filtre de clés étrangères.
  8. Sélectionnez Agency > Country puis cliquez sur Add dans la boîte de dialogue.

    La valeur du filtre de clés étrangères est définie sur Agency/Country.

    Note InformationsRemarque : Vous pouvez aussi utiliser la fonction avec le prédicat xpath de l'attribut correspondant pour définir la valeur du filtre de la clé étrangère, par exemple fn:abs(Product/Price). Il faut ajouter xpath: au prédicat d'un attribut de type String, par exemple fn:concat("xpath:Agency/Country","sample"). Vous pouvez trouver toutes les fonctions supportées dans la zone Expression. Elles serviront à définir la règle de valeur par défaut. Pour plus d'informations, consultez Définir une valeur par défaut pour un élément.
  9. Si nécessaire, ajoutez plusieurs conditions et combinez-les à l'aide de différents prédicats.
  10. Dans cet exemple, filtrez les clés étrangères à partir de l'attribut Country. Cliquez sur OK pour fermer cette boîte de dialogue.

    Le filtre de clés étrangères défini s'affiche sous le nœud Annotation de l'élément Region.

  11. Cliquez sur l'icône de sauvegarde dans la barre d'outils ou appuyez sur les touches Ctrl + S de votre clavier pour sauvegarder vos modifications.

Que faire ensuite

Dans n'importe quel enregistrement d'agence dans Talend MDM Web UI, à chaque fois qu'un utilisateur ou une utilisatrice cliquera sur l'icône d'une clé étrangère à côté du champ Region, la liste inclura uniquement les clés étrangères basées sur l'attribut Country.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.