Lignes de recherche

La transformation LookupRows examine les autres entrées du journal avec le même ID de suivi et définit la valeur du champ de sortie sur la valeur d’un champ désigné dans la ligne d’entrée.

Comme la LookupRows transformation effectue sa recherche sur les entrées du journal et non sur les fichiers de recherche, elle est très similaire à la CrossRows transformation. Voir CrossRows.

Pour fonctionner, la LookupRows transformation nécessite que les données soient classées dans le temps et regroupées par ID de suivi dans vos données source. Par conséquent, LookupRows fonctionne uniquement lorsqu’il est défini dans le Transformation.cfg fichier ou dans un Transformation Dataset Include fichier.

Lorsque vous passez en revue les descriptions des paramètres du tableau suivant, tenez compte des points suivants :

La ligne de sortie est la ligne de données sur laquelle la transformation fonctionne à un moment donné.
Les lignes d’entrée sont toutes les autres lignes de données (avant, après ou incluant la ligne de sortie) dont les valeurs du champ d’entrée servent d’entrées à la transformation.

Paramètre	Description	Par défaut
Nom	Nom descriptif de la transformation. Vous pouvez saisir n’importe quel nom ici.
Commentaires	Facultatif. Remarques sur la transformation.
Condition	Limite la sortie de la transformation à certaines entrées de journal. Si la condition n’est pas remplie pour une entrée de journal spécifique, le champ du paramètre Sortie de valeur de ligne de sortie reste inchangé. L'entrée peut toujours être utilisée pour affecter d'autres entrées du journal.
Condition d’entrée	Accepte les entrées pour la transformation à partir de certaines lignes d’entrée uniquement. Si la condition d’entrée n’est pas remplie pour une ligne d’entrée spécifique, le champ d’entrée de cette ligne est ignoré et n’affecte pas les autres lignes de sortie. Cependant, le champ de sortie de cette ligne est toujours modifié selon la condition spécifiée.
Entrée de clé de ligne d’entrée	Nom du champ à utiliser comme clé pour les lignes d’entrée.
Entrée Valeur de ligne d’entrée	Nom du champ de la ligne d’entrée dont la valeur est copiée dans le champ du paramètre Output de la valeur de la ligne de sortie si toutes les conditions sont remplies.
Opération	Opération qui, pour chaque ligne de sortie, est appliquée à toutes les lignes d’entrée satisfaisant à toutes les conditions définies par les paramètres Condition d’entrée et Entrée de ligne clé d’entrée pour produire une sortie : FIRST génère la valeur du champ dans le paramètre Entrée valeur de ligne d’entrée à partir de la première ligne d’entrée correspondante dans les données (et non de la première ligne correspondante après la ligne de sortie). LAST génère la valeur du champ dans le paramètre Entrée valeur de ligne d’entrée de la dernière ligne d’entrée dans les données (et non la dernière ligne correspondante avant la ligne de sortie).
Entrée de clé de ligne de sortie	Nom du champ à utiliser comme clé pour la ligne de sortie.
Sortie de la valeur de ligne de sortie	Nom du champ de la ligne de sortie dont la valeur est copiée à partir du champ du paramètre Entrée valeur de ligne d’entrée si toutes les conditions sont remplies. Toutes les lignes de sortie avec les mêmes valeurs d’entrée de clé de ligne de sortie et de trackingid x-trackingid ont la même valeur de sortie de ligne de sortie.

Les paramètres Entrée de clé de ligne d’entrée, Entrée de valeur de ligne et Condition d’entrée définissent ensemble le fichier de recherche pour chaque ID de suivi, tandis que les paramètres Entrée de clé de ligne de sortie, Entrée de valeur de ligne de sortie et Condition contrôlent ce qui est recherché dans le fichier et quelle valeur est stockée dans le champ spécifié par Sortie de ligne de sortie.

Pour mieux comprendre le fonctionnement de la transformation, tenez compte des points suivants :

Pour chaque ligne de sortie satisfaisant à la condition et ayant une entrée de clé de ligne de sortie non vide :
- Recherchez la ligne d’entrée PREMIER ou DERNIER de sorte que
  - la ligne d’entrée satisfait à la condition d’entrée, et
  - le x-trackingid de la ligne d’entrée est égal au x-trackingid de la ligne de sortie, et
  - l’entrée de clé de ligne d’entrée de la ligne d’entrée est égale à l’entrée de clé de ligne de sortie de la ligne de sortie,
et définissez la sortie de la ligne de sortie Valeur de la ligne de sortie sur Entrée Valeur de ligne de sortie Entrée de la ligne d’entrée.

Remarques concernant LookupRows

Les valeurs de clé vierge ne correspondent à rien. Même s’il existe des lignes d’entrée avec des clés vides et des valeurs non vides qui correspondent à la Input Condition, une valeur Output Row Key Input " produira toujours une Output Row Value Output valeur "".
Si elle n’est pas interdite par la Input Condition, une ligne peut se vérifier si ses Input Row Key Input et Output Row Key Input valeurs sont les mêmes.

Si vous disposez de plusieurs valeurs de clé, vous pouvez les combiner à l’aide d’une Format transformation (voir Format) avant d’appliquer une LookupRows transformation.

Supposons que vous disposez d’un site Web qui comporte une page d’enregistrement des animaux de compagnie, où le nom et la race sont entrés, et une page "Achetez un jouet" plus tard, où seul le nom de l’animal de compagnie est utilisé. Vous souhaitez pouvoir lier le nom de l'animal à la race de l'animal de compagnie entrée dans la page d'inscription. Pour ce faire, vous pouvez créer la LookupRows transformation suivante :

Examinons cet exemple à l'aide de l'aperçu précédent :

Pour chaque ligne de sortie satisfaisant d'avoir une valeur non vide de cs-uri-query(petname) :
- Recherchez la dernière ligne d’entrée de telle sorte que
  - la ligne d’entrée contient une valeur non vide de cs-uri-query(petbreed), et
  - le x-trackingid de la ligne d’entrée est égal au x-trackingid de la ligne de sortie, et
  - la valeur de cs-uri-query(petname) de la ligne d'entrée est égale à la valeur de cs-uri-query(petname) de la ligne de sortie,
et définissez la valeur de x-pet-breed de la ligne de sortie sur la valeur de cs-uri-query(petbreed) de la ligne d’entrée.

La LookupRows transformation utilise le nom de l’animal de compagnie (clé) pour vous assurer que la race d’animaux de compagnie est liée à la fois à l’enregistrement de l’animal de compagnie et aux pages d’achat des jouets afin que vous puissiez analyser les jouets achetés pour chaque race d’animaux de compagnie, même pour les visiteurs ayant plusieurs animaux de compagnie.