LookupRows

La transformation LookupRows examine les autres entrées de journal ayant 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.

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

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

Lorsque vous passez en revue les descriptions des paramètres dans le tableau suivant, pensez à ce qui suit :

  • La ligne de sortie correspond à 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 de sortie Valeur de ligne de sortie reste inchangé. L’entrée peut toujours être utilisée pour affecter d’autres entrées de journal.
Condition d’entrée Accepte les entrées pour la transformation à partir de certaines lignes d’entrée seulement. Si la condition Input 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 de saisie.
Entrée de la valeur de la ligne d’entrée Nom du champ de la ligne de saisie dont la valeur est copiée dans le champ du paramètre Output (Sortie de 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 de condition Input Condition et clé de ligne d’entrée pour produire une sortie :

  • La fonction PREMIER génère la valeur du champ dans le paramètre Input Row Value Input de la première ligne d’entrée correspondante dans les données (et non la première ligne correspondante après la ligne de sortie).
  • LAST génère la valeur du champ dans le paramètre Input Row Value Input 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 valeur de ligne de sortie Nom du champ de la ligne de sortie dont la valeur est copiée à partir du champ dans le paramètre Input Row Value (Valeur d’entrée de ligne) si toutes les conditions sont remplies. Toutes les lignes de sortie avec les mêmes valeurs x-trackingid et Output Row Key Input ont la même valeur Output Row Value Output.

Les paramètres Input Row Key Input, Input Row Value Input et Input Condition définissent ensemble le fichier de recherche pour chaque ID de suivi, tandis que les paramètres Output Row Key Input, Output Row Row Value Input et Condition contrôlent ce qui est recherché dans le fichier et quelle valeur est stockée dans le champ spécifié par Output Row Value Output.

Pour mieux comprendre le fonctionnement de la transformation, tenez compte des éléments 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 de saisie 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 Clé de ligne d’entrée de la ligne est égale à l’entrée Clé de ligne de sortie de la ligne de sortie,
  • et définissez la sortie Valeur de la ligne de sortie de la ligne de sortie sur Input Row Value Input de la ligne de saisie.

Considérations pour LookupRows

  • Les valeurs de clé vierges ne correspondent à rien. Même si des lignes de saisie avec des clés vides et des valeurs non vides correspondent à Input Condition, une Output Row Key Input de "" produira toujours une Output Row Value Output de "".

  • Si elle n’est pas interdite par Input Condition, une ligne peut se rechercher si ses valeurs Input Row Key Input et Output Row Key Input sont identiques.

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

Supposons que vous ayez un site web qui comporte une page d’enregistrement des animaux de compagnie, où le nom et la race sont saisis, et une page "acheter un jouet" ultérieure où seul le nom de l’animal de compagnie est utilisé. Vous souhaitez pouvoir associer le nom de l’animal à la race d’animaux de compagnie renseignée sur la page d’inscription. Pour ce faire, vous pouvez créer la transformation LookupRows suivante :

Analysons cet exemple en utilisant la composition précédente :

  • Pour chaque ligne de sortie satisfaisant une valeur non vide de cs-uri-query(petname) :

    • Recherchez la dernière ligne de saisie de 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 cs-uri-query(petbreed) de la ligne d’entrée.

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

Sur cette page