Rôle
Pour les lignes respectant les conditions, affecte aux champs des constantes, paramètres, valeurs d’autres champs, résultats de formules ou NULL. Sans conditions, il s’applique à chaque ligne.
Entrées et sorties
Une entrée in et une sortie out. Le nombre de lignes est conservé ; les nouveaux champs sont créés dans chaque ligne et restent NULL dans les lignes non sélectionnées.
Paramètres
| Le paramètre | Réglages et valeurs | Options et limites |
|---|---|---|
mode | all/any pour les conditions de sélection des lignes. | Options : all, anyPar défaut : all |
predicates | Conditions de sélection des lignes. Chaque condition contient un champ, un opérateur et une valeur de comparaison. | Nombre : 0–100 |
assignments | De 1 à 100 affectations dans l’ordre d’exécution. Chaque champ n’est affecté qu’une fois dans le bloc. | Nombre : 1–100 |
decimal | Le séparateur décimal des valeurs numériques dans les données d’entrée. | Options : ., ,Par défaut : . |
Définir une condition
| Le paramètre | Élément configuré |
|---|---|
column | Le champ de la ligne à vérifier. |
op | Égal à eq, différent de ne, supérieur à gt, supérieur ou égal à gte, inférieur à lt, inférieur ou égal à lte, contient contains, commence par starts_with, dans une liste in, absent d’une liste not_in, vide empty, non vide not_empty. |
value_mode | Source de comparaison : constant — une valeur constante ; parameter — un paramètre d’un bloc précédent ; field — un autre champ de la ligne actuelle. Pour comparer avec un autre tableau, joignez d’abord le champ nécessaire. |
value / value_field | Une constante ou le nom du champ de comparaison. Pour in et not_in, saisissez une valeur par ligne. |
parameter_block / parameter | Le bloc de paramètres et le nom du paramètre ; le paramètre doit avoir été préparé plus tôt dans cette branche. |
numeric | Active la comparaison numérique. Une valeur vide ne satisfait pas une condition numérique ; un texte qui ne peut pas être converti en nombre provoque une erreur. |
Paramètres d’affectation
| Le paramètre | Élément configuré |
|---|---|
field | Le champ cible. |
source | constant, parameter, field, formula ou empty. |
value / value_type | Une constante et son type text/number/boolean/date. |
parameter_block / parameter | Une référence à un paramètre d’un bloc précédent. |
source_field | Un autre champ de cette ligne. |
expression | Une formule au même format que « Champs calculés ». |
Configuration étape par étape
- Ajoutez des conditions de sélection des lignes si nécessaire ; sans conditions, chaque ligne est modifiée.
- Ajoutez une affectation et sélectionnez le champ cible ou saisissez un nouveau nom.
- Indiquez la source constant/parameter/field/formula/empty.
- Pour une constante, sélectionnez son type ; pour une formule, vérifiez les champs et paramètres disponibles.
- Vérifiez les lignes correspondantes et non correspondantes.
Règles et diagnostics
- Les affectations s’exécutent de haut en bas : une affectation suivante voit la valeur définie par la précédente.
- Un champ existant est écrasé uniquement dans les lignes sélectionnées.
- Les constantes de date utilisent YYYY-MM-DD. Les nombres doivent être finis ; les booléens acceptent les valeurs oui/non correspondantes.
- Un champ source manquant ou un paramètre non encore préparé arrête le bloc.
- La comparaison avec un référentiel n’est pas prise en charge ici ; orientez les lignes en amont.
Exemple de configuration
Condition : Status=Draft. Affectations : Status ← texte Submitted, SubmittedAt ← formule today(), AmountUAH ← field("Amount") * param("Rate"). Les autres lignes conservent leur Status et ont NULL dans les nouveaux champs.
Comparaison avec un élément de référence
Une condition peut utiliser value_mode=member: un élément de dimension IBM Planning Analytics, un élément de dimension UBC Analytics ou une valeur de relation de formulaire. Sélectionnez la connexion et l’objet, puis l’élément et la méthode de correspondance. La valeur comparée est enregistrée lors de la configuration de la condition ; il ne s’agit pas d’une jointure dynamique avec une autre source pour chaque ligne. Revérifiez la sélection après toute modification de l’élément ou de l’attribut concerné. Utilisez value_mode=field pour comparer deux colonnes de la ligne actuelle.