Valeurs

La brick Valeurs (catégorie Transform) applique une liste ordonnée d'opérations de substitution sur le contenu des cellules : remplacer une valeur par une autre, ou traduire une colonne entière via un dictionnaire de correspondance. Elle prend un flux en entrée (in) et produit un flux en sortie (out).

note

Les opérations s'appliquent dans l'ordre déclaré et travaillent sur la représentation texte des valeurs : replace convertit les colonnes ciblées en type texte, map compare la valeur de chaque cellule convertie en texte aux clés du dictionnaire.

Opérations disponibles

replace : remplacer une valeur

Paramètre	Type	Description
columns	liste de textes	Colonnes ciblées
from_value	texte	Valeur (ou motif) recherchée
to_value	texte	Valeur de remplacement
regex	booléen	Interpréter from_value comme une expression régulière (défaut false)

Le remplacement porte sur les sous-chaînes : chaque occurrence de from_value est remplacée dans la cellule, pas seulement les cellules dont la valeur entière correspond.

Avant → après (columns: [statut], from_value: N/A, to_value: inconnu) :

client	statut		client	statut
Ada	actif	→	Ada	actif
Bob	N/A	→	Bob	inconnu

map : traduire via un dictionnaire

Paramètre	Type	Description
column	texte	Colonne source (requis)
mapping	dictionnaire	Correspondances clé → valeur (requis) ; les clés sont comparées en texte
default	valeur	Valeur pour les entrées sans correspondance (optionnel : null sinon)
output_name	texte	Colonne de sortie (défaut : écrase la colonne source)

Contrairement à replace, map compare la valeur entière de la cellule aux clés du dictionnaire. Toute valeur absente du dictionnaire devient default (ou null si default n'est pas renseigné).

Avant → après (column: pays, mapping FR → France, DE → Allemagne, default: Autre, output_name: pays_libelle) :

pays		pays	pays_libelle
FR	→	FR	France
DE	→	DE	Allemagne
US	→	US	Autre

Bonnes pratiques

• replace pour corriger un fragment de texte, map pour recoder un référentiel fermé (codes pays, statuts…) ; ne détournez pas l'un pour l'autre.
• Avec map, renseignez default et écrivez dans une nouvelle colonne (output_name) : vous gardez la valeur d'origine pour auditer les entrées non reconnues.
• Avec replace (ou map sans output_name), la colonne ciblée ressort en type texte : si elle doit rester numérique, recastez-la ensuite avec l'opération cast de la brick Colonnes.
• Pour un enrichissement depuis un autre flux de données (et non un dictionnaire statique), utilisez plutôt la brick Jointure.

Anciennes bricks remplacées

Cette méga-brick remplace les bricks atomiques Replace Values et Map Values. Voir Bricks héritées pour la table de correspondance.