Langage de requête utilisé avec les composants Data Stewardship et l'API REST - 7.2

Guide d'utilisation de Talend Data Stewardship

author
Talend Documentation Team
EnrichVersion
7.2
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
task
Administration et monitoring > Gestion des utilisateurs
Gouvernance de données > Affectation des tâches
Gouvernance de données > Gestion des campagnes
Gouvernance de données > Gestion des modèles de données
Qualité et préparation de données > Gestion des tâches
Qualité et préparation de données > Gestion des types sémantiques
EnrichPlatform
Talend Data Stewardship

Vous pouvez utiliser un langage de requêtes Talend (TQL) avec les composants tDataStewardshipTaskDelete et tDataStewardshipTaskInput, pour effectuer des requêtes et filtrer les données à supprimer ou à lire depuis Talend Data Stewardship.

Syntaxe des requêtes TQL

L'instruction de requête utilisée pour filtrer les tâches sur le serveur se compose d'une ou plusieurs conditions.

Une condition de tâche se compose des éléments suivants :
  • un champ de nom avec le préfixe record., référençant les données des enregistrements ;
  • un opérateur et
  • une valeur, qui peut être n'importe quelle valeur littérale. Utilisez des guillemets simples autour des chaînes de caractères et faites précéder ces guillemets par une barre oblique inversée (\) dans la chaîne de caractères.

Les champs sur lesquels vous pouvez effectuer une requête avec TQL

Les noms des champs peuvent être sélectionnés parmi tous les champs de métadonnées et personnalisés.

Le tableau suivant liste tous les champs de métadonnées supportés sur les tâches :

Champ de métadonnée Description
id (string) Identifiant interne de la tâche
externalID (string) Identifiant externe de la tâche permettant d'accéder à une tâche donnée depuis un système externe.
currentState (string) État courant de la tâche dans le workflow de la campagne.
assignee (string) userId de l'arbitre de données assigné à la tâche.
targetTransition (string) Nom de la transition choisie par l'utilisateur pour déplacer la tâche à l'étape suivante dans le workflow de la campagne.
completed (boolean) true si la tâche est terminée (dans un état final dans le workflow).
priority (integer) Niveau de priorité de la tâche, de 0 (Very Low) à 4 (Very High). Le niveau par défaut est 2 (Medium).
dueDate Horodatage en millisecondes de l'échéance de cette tâche
matchScore (uniquement pour les campagnes Merging et Grouping) Valeur décimale indiquant le plus haut score de correspondance pour chaque groupe dans les données source.
version (integer) Valeur entière de la version de la tâche, incrémentée lorsque la tâche est mise à jour.
consumed (boolean) true si la tâche a déjà été traitée (elle ne peut donc plus être traitée - sauf si elle est rouverte).
createdBy (string) userId de l'utilisateur ayant créé la tâche.
creationDate (long) Horodatage en millisecondes de la date de création de cette tâche.
lastUpdatedBy (string) userId de l'arbitre de données ayant fait la dernière mise à jour sur la tâche.
lastUpdateDate (long) Horodatage en millisecondes de la dernière mise à jour faite sur la tâche.
tags (string) Liste des mots-clés saisis par l'utilisateur pour cette tâche.
arbitration (uniquement pour les campagnes Arbitration et Grouping) Choix d'arbitrage sélectionné par l'arbitre de données.

Opérateurs binaires supportés en TQL

Opérateur (symbole TQL) Description
= Retourne un résultat correspondant à la valeur saisie.
!= Retourne le résultat des valeurs différentes de celle qui a été saisie.
> Retourne un résultat supérieur à la valeur saisie.
>= Retourne un résultat supérieur ou égal à la valeur saisie.
< Retourne un résultat inférieur à la valeur saisie.
<= Retourne un résultat inférieur ou égal à la valeur saisie.
Par exemple, vous povuez filtrer les tâches créées après la date 2016-01-01, à l'aide de la requête suivante :
creationDate > 1451659712733

Opérateurs booléens supportés en TQL

Vous pouvez combiner ou inverser des conditions à l'aide des opérateurs booléens and et or, ou de l'opérateur not, respectivement. Les parenthèses sont supportées afin d'écraser la précédence booléenne par défaut.

Par exemple, vous pouvez filtrer les tâches par personne assignée et avoir un champ d'enregistrement firstname égal à John, à l'aide de la requête suivante :
assignee='user1@talend.com' and record.firstName='John'
Vous pouvez également filtrer les tâches par personne assignée et avoir un champ d'enregistrement firstname égal à De'wayne à l'aide de la requête suivante :
assignee='user2@talend.com' and record.firstName='De\'wayne'