Paramètres dynamiques

Il existe de nombreux cas de figure dans lesquels vous pourriez avoir besoin de changer des paramètres à l'exécution d'un Job.

1. En bref

Par exemple, vous avez un Job qui importe un fichier Excel dans une base de données, mais le nom de fichier n'est pas le même d'un mois à l'autre.

Ce Job √©tant lanc√© √† partir de l'application Client (fournie) par un utilisateur de votre soci√©t√©. Il ne peut bien s√Ľr pas √©diter le Job, mais pourra n√©anmoins changer les param√®tres dynamiques d√©finis dans celui-ci.

L'exemple le plus simple serait :

MyImportTable:SELECT * FROM {?1}.XLSX

Celà signifie que la partie scriptée {?1} sera remplacée par le premier paramètre dynamique défini : l'utilisateur est désormais capable de "choisir" le nom du fichier sans intervenir dans le Job !

2. L'utilité des paramètres dynamiques

Vous pouvez faire de nombreuses choses

La section "Paramètres Dynamiques"

Il y a 3 fonctionnalités :

  • Textes statiques : Vous pouvez √©crire n'importe quelle cha√ģne de caract√®re en tant que param√®tre (ex : MaChaine)
  • Script dynamique : Vous avez acc√®s √† une liste de mots-cl√© qui seront automatiquement remplac√©s (ex : -%MM-%YYYY)
  • R√©sultat d'une commande Pr√©-Job : Vous pouvez configurer un Job de telle sorte √† ce qu'une commande soit lanc√©e avant son ex√©cution. La valeur retourn√©e par cette commande peut √™tre utilis√©e en tant que param√®tre dynamique (ex : %CS1)

2.1. Cha√ģnes statiques

C'est particulièrement utile quand vous avez besoin d'ajouter des colonnes additionnelles à vos données source

  • Exemple :
Définissez "MyString" dans l'onglet "Configuration du Job"
Add a customized column in the “Target” tab and set the value to {?1}
Ecvrivez une requête dans l'onglet "Requêtes"
Regardez le résultat. "NEWCOLUMN" a été ajouté, avec "MyString" en tant que valeur

2.2. Mots-clé

C'est particulièrement utile lorsque vous manipulez des dates dynamiques dans votre Job.

Vous pouvez choisir n'importe quel mot-clé dans la liste proposée, et l'utiliser à votre guise.
Ils peuvent √™tre concat√©n√©s et int√©gr√©s dans une cha√ģne de caract√®res de n'importe quelle mani√®re !
  • Exemple :
Ecrire ‚Äú%YYYY-%MM-‚ÄĚ dans l'onglet de configuration signifie que ce script sera remplac√© par l'ann√©e, le mois et le jour actuel, comme vous pouvez le voir sous la zone de saisie.
Vous n'aurez donc pas à changer ce paramètre à chaque fois que vous voulez lancer le Job.
Une requête utilisant le paramètre dynamique en tant que filtre.
Les données associées à la requête. "dt_random_date" a été filtré conformément au paramètre dynamique.

2.3. Résultat d'une commande Pré-Job

C'est par exemple utile pour filtrer une requête dans un scénario "BDD vers mail".

  • Exemple :
En écrivant "%CS1" dans l'onglet de configuration, ce script sera remplacé par la valeur renvoyée par la commande Pré-Job de la connexion Source.
Astuce : Définir une pré-commande sur une connexion (Source ou Cible) est optionnel
Le menu "Source" a une section spécialement réservée pour les commandes Pré ou Post Job.
- Si la connexion Source est une base de données SQL, n'importe quelle commande SQL (ou procédure stockée) est acceptée.
- Si la connexion Source est un fichier, n'importe quelle commande du shell Windows est acceptée.
Une requête utilisant le paramètre dynamique en tant que filtre.
Dans ce cas, {?1} sera remplacé par la valeur retournée par :
SELECT MAX(id_sample) FROM sample_table_3;
En consultant les données, on constate que "id_sample" a été filtré conformément au paramètre dynamique.

fr_FRFrench