Tous les groupes de questions : FAQ de l'IDE
Fonctionnement d'une transformation
Section intitulée « Fonctionnement d'une transformation »Comment une transformation modifie-t-elle une valeur ?
En deux phases. L'expression principale est d'abord évaluée une seule fois. Les actions de transformation s'exécutent ensuite l'une après l'autre sur son résultat. [data] contient la valeur courante à mesure qu'elle passe par les actions, et [original] conserve le résultat de l'expression avant toute modification par une action.
En savoir plus : Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel · Référence des fonctions
À quoi une expression peut-elle faire référence ?
Aux colonnes source sous la forme [My field name], à vos Variables sous la forme [<my variable>], aux Variables générées automatiquement sous la forme [<#my auto generated variable>], ainsi qu'à [data] et [original]. Coller la colonne, Coller la variable et Coller la valeur, ou le menu contextuel, insèrent la notation correcte à votre place. Dans un ForEach, une colonne source correspond à la fois à sa Variable générée et à [#source columns].
En savoir plus : Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel
Quel type de données une transformation doit-elle renvoyer ?
Le type de sa destination, qui est fixé à Texte, DateTime ou Nombre : l'expression, ainsi que la valeur obtenue après toutes les actions, doivent produire ce type. Une action Expression doit également renvoyer le même type que celui qu'elle a reçu.
En savoir plus : Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel
Comment insérer un guillemet double dans une expression ?
Avec Char(34). Une expression ne peut pas contenir de guillemet double littéral, mais Char() peut en produire un.
En savoir plus : Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel · Char()
Une expression peut-elle rechercher une valeur dans une base de données ?
Oui : cochez SQL SELECT 1 ligne/colonne et choisissez une connexion — SQL Server, MS Access, ODBC ou la base de données interne. L'expression est alors un unique SELECT qui renvoie une seule colonne, et elle peut utiliser [data], des colonnes et des Variables. Plusieurs lignes sont concaténées avec %NewLine%, dans la limite de 250. Cela ne fonctionne que dans l'expression principale, et SELECT est le seul mot-clé SQL autorisé.
En savoir plus : Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel
Où trouver toutes les fonctions utilisables ?
Dans la référence des fonctions, regroupées en Logique, Texte, Date et heure, Numérique, Gestion des fichiers, JSON, Application Nextcloud et SharePoint, chacune avec ses arguments et des exemples. Dans l'éditeur d'expressions, clic droit → Coller la fonction insère n'importe laquelle d'entre elles avec ses arguments nommés, et Tester l'expression permet d'essayer une expression sur une valeur que vous saisissez.
En savoir plus : Référence des fonctions · Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel
Validation et correspondance de valeurs
Section intitulée « Validation et correspondance de valeurs »Comment consigner un avertissement ou une erreur pour une valeur ?
Avec une action Validation des données. Elle renvoie une chaîne qui commence par Ok:, Warning:, Error:, Ignore: ou Return:, et le texte qui suit les deux-points est écrit dans le journal de session de la tâche — par exemple If( Dec('[data]') > 100.01 , 'Error:[data]>100.01' , 'Ok:' ). Ok: n'ajoute aucune ligne ; Ignore: ignore la valeur ; Return: arrête les actions restantes.
En savoir plus : Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel
Comment faire correspondre d'anciennes valeurs à de nouvelles ?
Avec une liste de correspondance de valeurs composée de lignes Valeur recherchée → Valeur de remplacement. Une action Recherche fait correspondre la valeur entière 1:1, et Si aucune correspondance n'est trouvée détermine ce qui se passe dans le cas contraire ; Remplacer les occurrences remplace les correspondances à l'intérieur de la valeur. Les listes sont tenues à jour manuellement, collées à partir de deux colonnes Excel, ou alimentées par une tâche DataETL via la base de données interne.
En savoir plus : Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel
Conditions d'appel
Section intitulée « Conditions d'appel »Comment exécuter un composant uniquement sous condition ?
Attribuez-lui une condition d'appel dans sa Collection avec Créer une condition. Il s'agit d'une expression unique qui ne peut faire référence qu'à des Variables, et qui renvoie True (exécuter), False (ignorer), ExitGroup, ExitGroupWarning, StopJob ou StopJobWarning. Un message placé après des deux-points est écrit dans le journal de session : If( [<MyVariable>] > 0 , 'True' , 'StopJob:Job cannot continue' ).
En savoir plus : Fonctionnement des fonctions dans les transformations, les variables et les conditions d'appel