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