Utilisation de l'activité Recherche

Pourquoi et quand exécuter cette tâche

Pour configurer l'activité Recherche, procédez comme suit :

Procédure

  1. Dans l'onglet Activités, ouvrez le répertoire Qualité de données pour rechercher l'activité Recherche.
  2. Ajoutez l'activité à une orchestration. La liste de contrôle et le récapitulatif de l'activité sont affichés en dessous de l'orchestration.
  3. Dans la liste de contrôle, sélectionnez Sélectionner le noeud final et choisissez un noeud final de base de données. Vous trouverez des instructions pour la création ou l'édition d'un noeud final de base de données dans la section Création ou édition d'un noeud final de base de données.
    Remarque : Pour effectuer une recherche partielle, vous devez sélectionner la base de données de transfert locale. Pour accéder à la base de données de transfert locale :
    1. Dans la liste Type de base de données, sélectionnez Local. Staging (transfert) apparaît dans la zone Nom de base de données.
    2. Dans la zone de serveur d'emplacement réseau, indiquez l'adresse IP des données du dispositif d'intégration à laquelle la base de données de transfert locale est démarrée. La valeur du port est fixée à 1526.
    3. Entrez un nom d'utilisateur et un mot de passe.
      Important : Ces informations de connexion doivent correspondre à un utilisateur doté des privilèges d'administrateur ou de diffuseur de publications dans le dispositif d'intégration.
    4. Spécifiez tout paramètre supplémentaire. Pour plus d'informations sur les paramètres de bases de données, voir Création ou édition d'un noeud final de base de données.
    5. Cliquez sur OK. Le noeud final Base de données s'affiche dans le répertoire de noeuds finaux de la boîte à outils Studio.
  4. Dans la liste de contrôle, sélectionnez Configurer et spécifiez les informations suivantes :
    1. Le nom de la variable qui contient l'élément récurrent via lequel l'activité effectue sa boucle.
    2. Le nom de l'élément récurrent de la variable via lequel l'activité effectue sa boucle.

      Cliquez sur le bouton Parcourir ( ... ) pour ouvrir la fenêtre Sélectionner l'élément récurrent dans laquelle vous pouvez afficher tous les éléments de la variable que vous avez sélectionnée ci-dessus.

  5. Dans la liste de contrôle, sélectionnez Entrer la requête.
    1. Indiquez la requête pour la table de recherche.
      • Pour les recherches partielles, vous devez spécifier un et un seul paramètre.
      • Pour les recherches non partielles, vous pouvez spécifier un ou plusieurs paramètres.
    2. Dans la liste Codage, sélectionnez le type de codage.
    3. Cliquez sur Valider la requête.
      Remarque : Si vous utilisez un noeud final de base de données locale, vous devez démarrer la base de données de transfert locale dans le dispositif d'intégration pour pouvoir afficher des colonnes et valider des requêtes. Pour ce faire, dans la console de gestion Web (WMC), sélectionnez Staging > Staging Database Start/Stop.
    4. Cliquez sur Afficher les colonnes et sélectionnez une table pour consulter les informations de colonne détaillées pour cette table. L'option Masquer les tables tampon et de contrôle est sélectionnée par défaut.
  6. Dans la liste de contrôle, sélectionnez Configurer des paramètres d'entrée. La requête que vous avez entrée dans l'étape précédente s'affiche.

    Indiquez l'expression XPath d'entrée pour chaque paramètre d'entrée de la colonne XPath. L'expression XPath d'entrée est une expression XPath relative à l'élément récurrent qui spécifie la valeur de clé de recherche utilisée par la requête.

  7. Dans la liste de contrôle, sélectionnez Configurer un ensemble de résultats.
    1. Indiquez l'expression XPath de sortie pour chaque ligne de l'ensemble de résultats. L'expression XPath de sortie spécifie l'élément ou l'attribut relatif à l'élément récurrent qui contiendra la valeur de sortie.
    2. Utilisez l'arrobase (@) au début de l'expression XPath pour spécifier un attribut.
      • Si le nom de l'élément ou de l'attribut existe déjà, Studio remplace la valeur existante. Sinon, Studio crée un nouvel élément ou attribut nommé.
      • Si la recherche ne parvient pas à trouver une correspondance, la ligne est envoyée dans l'élément badXML.
  8. Dans la liste de contrôle, sélectionnez Règles de distribution et indiquez les règles de distribution suivantes :
    Règle de distribution Description
    Délai d'expiration de l'activité Spécifie en secondes la durée pendant laquelle le dispositif d'intégration attend que le noeud final réponde. La valeur par défaut est 300 secondes.
    Recherche partielle Détermine si la recherche est partielle. Sélectionnez cette option pour effectuer une recherche partielle.
    Important : Vous pouvez uniquement effectuer une recherche partielle sur un noeud final de base de données locale.
    Remarque : Avant d'exécuter l'orchestration, utilisez l'outil de génération de ressource de base de données ou la console WMC pour créer une table d'index.
    Ne pas sortir plus de __ correspondance(s) par recherche partielle Spécifie le nombre maximal de correspondances à sortir par recherche partielle.
    Seuil de similitude __ pour une recherche partielle Spécifie le seuil de similitude pour déterminer une correspondance lors d'une recherche partielle (0 ou 1).1 est une correspondance exacte.
    Ignorer la casse (pour la recherche partielle uniquement) Sélectionnez cette option pour que la recherche soit insensible à la casse.
    Ignorer les blancs de tête et de fin Lorsque cette option est sélectionnée, l'activité Recherche ignore les blancs placés avant et après les données. Pour les recherches non partielles, vous pouvez uniquement appliquer cette option à la valeur d'entrée. Pour les recherches partielles, vous pouvez appliquer cette option à la valeur d'entrée et la table de recherche.
    Précharger le cache Sélectionnez cette option pour précharger le cache de recherche.
    Ne pas mettre en cache plus de __ Résultats de la recherche Spécifie le nombre maximal de résultats de recherche à mettre en cache.

Que faire ensuite

Mappez la sortie de l'activité.