ComposantsComponents

ComposantsComponents › DiversMisc

tContextDump

tContextDump

DiversMisc

Transforme le contexte du job en lignes : une ligne par variable de contexte, avec son nom (key) et sa valeur en texte (value). Pour afficher les valeurs avec lesquelles le job tourne, les écrire dans un fichier, ou vérifier ce qu'un tContextLoad a chargé. Turns the job context into rows: one row per context variable, with its name (key) and its value as text (value). To display the values the job runs with, write them to a file, or check what a tContextLoad has loaded.

EntréeInput

Aucune : il commence toujours un sous-job. Il ne peut pas être itéré. None: it always starts a subjob. It cannot be iterated.

SortieOutput

Main un flux : une ligne par variable, colonnes key et valueone flow: one row per variable, key and value columns

Déclencheurs en sortieOutput triggers

On Subjob Ok On Subjob Error On Component Ok On Component Error Run if

UtilisationUsage

Afficher le contexteDisplay the context

row1 (Main) tContextDump_1 tLogRow_1

Le cas le plus courant : voir dans la console les valeurs de l'environnement de contexte choisi pour l'exécution. The most common case: see in the console the values of the context environment chosen for the run.

Après un chargementAfter a load

row1 (Main) OnSubjobOk row2 (Main) tFileInputDelimited_1 tContextLoad_1 tContextDump_1 tLogRow_1

Le tContextDump lit le contexte tel qu'il est au moment où il s'exécute : ici, avec les valeurs que le tContextLoad vient de charger. The tContextDump reads the context as it is when it runs: here, with the values that the tContextLoad has just loaded.

  1. Déposez le tContextDump depuis la famille Divers de la palette. Drop the tContextDump from the Misc family of the palette.
  2. Reliez sa sortie à un tLogRow ou à un composant de sortie (clic droit › Ligne › Main). Le schéma est fixe : key et value, de type String. Connect its output to a tLogRow or an output component (right-click › Row › Main). The schema is fixed: key and value, of type String.
  3. Lancez le job : une ligne sort pour chaque variable de contexte, dans un ordre qui n'est pas celui de l'onglet Contextes (voir les conseils). Run the job: one row comes out for each context variable, in an order that is not the one of the Contexts tab (see the tips).

ParamètresSettings

Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Le composant n'a pas de paramètres avancés propres. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The component has no advanced settings of its own.

ParamètreSetting DéfautDefault OngletTab Description
SchémaSchemaSCHEMA key, value Paramètres simplesBasic settings Deux colonnes fixes, de type String : key, le nom de la variable, et value, sa valeur en texte. Une date sort au format de sa valeur dans le contexte (2026-01-01 00:00:00). Two fixed columns, of type String: key, the name of the variable, and value, its value as text. A date comes out in the format of its value in the context (2026-01-01 00:00:00).
Masquer le mot de passeHide PasswordHIDE_PASSWORD OuiYes Paramètres simplesBasic settings Remplace chaque caractère de la valeur d'une variable de type Password par une étoile. Décochée, le mot de passe sort en clair, déchiffré. Les autres types ne sont jamais masqués. Replaces each character of the value of a Password variable with a star. Unchecked, the password comes out in clear, decrypted. The other types are never hidden.

Variable globaleGlobal variable

NB_LINE (Integer, disponible après le composant) : nombre de lignes envoyées, une par variable. Par exemple dans un tJava relié par On Subjob Ok : NB_LINE (Integer, available after the component): number of rows sent, one per variable. For example in a tJava connected with On Subjob Ok:

System.out.println("NB_LINE = " + globalMap.get("tContextDump_1_NB_LINE"));

ExemplesExamples

Le job a cinq variables de contexte, ci-dessous avec leur valeur par défaut. Le tLogRow est en mode Table. Sorties copiées depuis une exécution du job ; le chemin du fichier est raccourci. The job has five context variables, below with their default value. The tLogRow is in Table mode. Outputs copied from a run of the job; the file path is shortened.

VariableVariable Type Valeur par défautDefault value
hostStringlocalhost
portInteger8080
debugBooleanfalse
startDate2026-01-01 00:00:00
dbPasswordPasswords3cret

Réglages par défautDefault settings

row1 (Main) tContextDump_1 tLogRow_1

Un tJava relié au tContextDump par On Subjob Ok affiche NB_LINE. A tJava connected to the tContextDump with On Subjob Ok prints NB_LINE.

.----------+-------------------.
|          tLogRow_1           |
|=---------+------------------=|
|key       |value              |
|=---------+------------------=|
|port      |8080               |
|debug     |false              |
|host      |localhost          |
|dbPassword|******             |
|start     |2026-01-01 00:00:00|
'----------+-------------------'

NB_LINE = 5

Le mot de passe est masqué, une étoile par caractère. Les lignes ne suivent pas l'ordre de déclaration des variables. The password is hidden, one star per character. The rows do not follow the declaration order of the variables.

Masquer le mot de passe décochéHide Password unchecked

Le même job, seule la case change. The same job, only the box changes.

.----------+-------------------.
|          tLogRow_1           |
|=---------+------------------=|
|key       |value              |
|=---------+------------------=|
|port      |8080               |
|debug     |false              |
|host      |localhost          |
|dbPassword|s3cret             |
|start     |2026-01-01 00:00:00|
'----------+-------------------'

NB_LINE = 5

Le mot de passe, enregistré chiffré dans le job, sort déchiffré. The password, stored encrypted in the job, comes out decrypted.

Après un tContextLoadAfter a tContextLoad

row1 (Main) OnSubjobOk row2 (Main) tFixedFlowInput_1 tContextLoad_1 tContextDump_1 tLogRow_1

Le tContextLoad charge host / db.example.com, start / 2026-12-31 08:30:00 et timeout / 30, qui n'est pas une variable du job. The tContextLoad loads host / db.example.com, start / 2026-12-31 08:30:00 and timeout / 30, which is not a variable of the job.

.----------+-------------------.
|          tLogRow_1           |
|=---------+------------------=|
|key       |value              |
|=---------+------------------=|
|port      |8080               |
|debug     |false              |
|host      |db.example.com     |
|timeout   |30                 |
|dbPassword|******             |
|start     |2026-12-31 08:30:00|
'----------+-------------------'

Les valeurs chargées remplacent les valeurs par défaut. timeout sort aussi : le tContextDump envoie toutes les propriétés du contexte, y compris les clés qu'un tContextLoad a chargées sans qu'elles soient des variables. The loaded values replace the default values. timeout comes out too: the tContextDump sends all the context properties, including the keys that a tContextLoad has loaded without them being variables.

Pièges et conseilsPitfalls and tips

Enregistrer puis recharger un mot de passe masquéSaving then reloading a hidden password

row1 (Main) OnSubjobOk row2 (Main) OnSubjobOk tContextDump_1 tFileOutputDelimited_1 tFileInputDelimited_1 tContextLoad_1 tJava_1

Le contexte est écrit dans C:/data/saved_context.csv, réglages par défaut, puis relu par un tContextLoad : The context is written to C:/data/saved_context.csv, default settings, then read back by a tContextLoad:

port;8080
debug;false
host;localhost
dbPassword;******
start;2026-01-01 00:00:00
// tJava_1
System.out.println("dbPassword = " + context.dbPassword);
System.out.println("start = " + TalendDate.formatDate("yyyy-MM-dd HH:mm:ss", context.start));
dbPassword = ******
start = 2026-01-01 00:00:00

Les étoiles sont écrites dans le fichier puis rechargées : le mot de passe vaut désormais ******. La date, elle, se recharge sans perte. Pour un fichier à recharger, décochez Masquer le mot de passe et protégez le fichier. The stars are written to the file then loaded back: the password is now ******. The date is reloaded without loss. For a file to be reloaded, uncheck Hide Password and protect the file.

La longueur du mot de passe reste visibleThe length of the password stays visible

Une étoile remplace chaque caractère : s3cret donne ******, six étoiles. Dans un journal partagé, c'est déjà une indication. One star replaces each character: s3cret gives ******, six stars. In a shared log, that is already a hint.

L'ordre des lignesThe order of the rows

Les variables sont déclarées host, port, debug, start, dbPassword et sortent port, debug, host, dbPassword, start : le composant parcourt les propriétés du contexte (java.util.Properties), sans ordre défini. Pour une liste stable, triez les lignes sur key avec un tSortRow. The variables are declared host, port, debug, start, dbPassword and come out port, debug, host, dbPassword, start: the component goes through the context properties (java.util.Properties), with no defined order. For a stable list, sort the rows on key with a tSortRow.

Garder une trace de l'exécutionKeep a record of the run

Relié à un tFileOutputDelimited, le tContextDump écrit un fichier clé;valeur que le tContextLoad sait relire : de quoi savoir avec quelles valeurs un job a tourné, ou les reprendre plus tard. Connected to a tFileOutputDelimited, the tContextDump writes a key;value file that the tContextLoad can read back: a way to know which values a job ran with, or to take them again later.

Des valeurs en texteValues as text

La colonne value est un String, quel que soit le type de la variable. Pour calculer avec une valeur, lisez plutôt la variable elle-même, context.port, dans un tJava. The value column is a String, whatever the type of the variable. To compute with a value, rather read the variable itself, context.port, in a tJava.

Voir aussiSee also

Les autres composants de la famille Divers, et ceux qui servent souvent avec le tContextDump : The other components of the Misc family, and those often used with the tContextDump: