ComposantsComponents › Logs & ErreursLogs & Errors
Reçoit les résultats des tAssert du job, et les exceptions Java qui l'arrêtent, sous la forme de lignes au schéma fixe : date, job, composant, statut Ok ou Failed, description. Il se pose à part, sans lien entrant : son sous-job est exécuté à chaque message. Reliez-le à un tLogRow, un fichier ou une table pour garder le compte rendu des vérifications.
Receives the results of the tAssert components of the job, and the Java exceptions that stop it, as rows with a fixed schema: date, job, component, Ok or Failed status, description. It is placed apart, with no incoming link: its subjob is run at each message. Connect it to a tLogRow, a file or a table to keep the report of the checks.
EntréeInput
Aucune : ni flux, ni On Subjob Ok. Il commence toujours son sous-job, que le job lance pour lui. None: no flow, no On Subjob Ok. It always starts its subjob, which the job runs for it.
SortieOutput
Un lien Main : une ligne par message, au schéma fixe. Ou un lien Iterate. One Main link: one row per message, with the fixed schema. Or one Iterate link.
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
Le tAssertCatcher n'est relié à rien d'autre que sa sortie. Chaque tAssert du job, à son exécution, lui remet un message et lance son sous-job ; il en va de même quand une exception Java arrête un sous-job. The tAssertCatcher is connected to nothing but its output. Each tAssert of the job, when it runs, hands it a message and runs its subjob; the same happens when a Java exception stops a subjob.
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. Malgré sa description dans la palette (« les autres commandes Die »), il n'a pas de case pour les tDie et ne les reçoit pas. 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. Despite its description in the palette ("other Die commands"), it has no box for tDie and does not receive them.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| SchémaSchemaSCHEMA | 9 colonnes9 columns | ToujoursAlways |
En lecture seule : les colonnes sont fixées par le composant. Une dixième colonne, exception, s'ajoute quand Obtenir l'exception originale est cochée.
Read-only: the columns are set by the component. A tenth column, exception, is added when Get original exception is checked.
|
| Capturer les exceptions JavaCatch Java ExceptionCATCH_JAVA_EXCEPTION | OuiYes | ToujoursAlways |
Une exception qui arrête un sous-job produit une ligne : status Failed, substatus Job execution error, description le message de l'exception, origin vide. Deux exceptions : l'arrêt par un tDie n'est pas transmis, ni l'exception d'un composant suivi d'un lien On Component Error.
An exception that stops a subjob produces a row: status Failed, substatus Job execution error, description the message of the exception, empty origin. Two exceptions to this: the stop by a tDie is not passed on, nor is the exception of a component followed by an On Component Error link.
|
| Obtenir l'exception originaleGet original exceptionGET_ORIGINAL_EXCEPTION | NonNo | Capturer les exceptions Java cochéeCatch Java Exception checked |
Ajoute au schéma la colonne exception, de type Object, qui porte l'exception Java elle-même (sa classe, sa trace), à lire dans un tJavaRow. Elle est null sur les lignes des tAssert.
Adds to the schema the exception column, of type Object, which carries the Java exception itself (its class, its trace), to read in a tJavaRow. It is null on the rows of the tAssert components.
|
| Capturer les tAssertCatch tAssertCATCH_TASSERT | OuiYes | ToujoursAlways |
Reçoit les messages Ok et Failed des tAssert. Décochée, les tAssert ne génèrent plus de code pour ce tAssertCatcher : il ne reçoit que les exceptions.
Receives the Ok and Failed messages of the tAssert components. Unchecked, the tAssert components generate no more code for this tAssertCatcher: it only receives the exceptions.
|
Colonnes du tAssertCatcher_java.xml, dans l'ordre. Contenu lu dans les modèles et vérifié sur les exécutions de cette page.
Columns of tAssertCatcher_java.xml, in order. Content read from the templates and checked on the runs of this page.
| ColonneColumn | Type | Message d'un tAssertMessage of a tAssert | Exception JavaJava exception |
|---|---|---|---|
moment | Date "yyyy-MM-dd HH:mm:ss" | date et heure du messagedate and time of the message | |
pid | String (20) | identifiant de l'exécution : six caractères tirés au hasard au lancement du jobidentifier of the run: six characters drawn at random when the job starts | |
project | String (50) | nom technique du projettechnical name of the project | |
job | String (255) | nom du jobname of the job | |
language | String (5) | java | |
origin | String (50) | nom du tAssert : tAssert_1name of the tAssert: tAssert_1 | null : le composant en erreur n'est pas indiqué: the failing component is not given |
status | String (10) | Ok ouor Failed | Failed |
substatus | String (255) | -- ouor Test logically failed | Job execution error |
description | String (255) | la Description du tAssertthe description of the tAssert | le message de l'exception (getMessage())the message of the exception (getMessage()) |
exception | Object | null | l'exception ; colonne présente seulement avec Obtenir l'exception originalethe exception; column only present with Get original exception |
Les longueurs sont celles du schéma, utiles pour créer une table ; le composant ne tronque rien. Le composant n'a pas de variable globale (RETURNS vide).
The lengths are those of the schema, useful to create a table; the component truncates nothing. The component has no global variable (empty RETURNS).
Sorties copiées depuis une exécution de chaque job ; les traces Java sont abrégées (…). Les colonnes moment et pid changent à chaque exécution ; project et job sont ceux du job d'essai.
Outputs copied from a run of each job; the Java traces are shortened (…). The moment and pid columns change at each run; project and job are those of the test job.
tJava_1 range 3 dans count et écrit Loaded 3 rows. tAssert_1 vérifie count > 0 (« At least one row »), tAssert_2 count <= 2 (« At most 2 rows ») : le détail est sur la page du tAssert. Réglages par défaut du tAssertCatcher.
tJava_1 stores 3 in count and writes Loaded 3 rows. tAssert_1 checks count > 0 ("At least one row"), tAssert_2 count <= 2 ("At most 2 rows"): the details are on the tAssert page. Default settings of the tAssertCatcher.
Loaded 3 rows .-----------------------------------. | #1. tLogRow_1 | +-------------+---------------------+ | key | value | +-------------+---------------------+ | moment | 2026-11-18 14:32:54 | | pid | B3LhWe | | project | DEMO | | job | JOB_DocLB_A14 | | language | java | | origin | tAssert_1 | | status | Ok | | substatus | -- | | description | At least one row | +-------------+---------------------+ .-------------------------------------. | #1. tLogRow_1 | +-------------+-----------------------+ | key | value | +-------------+-----------------------+ | moment | 2026-11-18 14:32:54 | | pid | B3LhWe | | project | DEMO | | job | JOB_DocLB_A14 | | language | java | | origin | tAssert_2 | | status | Failed | | substatus | Test logically failed | | description | At most 2 rows | +-------------+-----------------------+
Les deux lignes portent le numéro #1 : le sous-job du tAssertCatcher est exécuté une fois par message, et le tLogRow recommence à chaque fois. Le job se termine avec le code 0.
Both rows carry number #1: the subjob of the tAssertCatcher is run once per message, and the tLogRow starts over each time. The job ends with code 0.
Le même job, suivi d'un tJava_2 qui échoue. tLogRow en mode Table, réglages par défaut. The same job, followed by a tJava_2 that fails. tLogRow in Table mode, default settings.
// tJava_2
System.out.println("Parsing");
int n = Integer.parseInt("abc");
Loaded 3 rows .-------------------+------+-------+------------+--------+---------+------+---------+----------------. | tLogRow_1 | |=------------------+------+-------+------------+--------+---------+------+---------+---------------=| |moment |pid |project|job |language|origin |status|substatus|description | |=------------------+------+-------+------------+--------+---------+------+---------+---------------=| |2026-11-18 14:32:31|tZLRZZ|DEMO |JOB_DocLB_A6|java |tAssert_1|Ok |-- |At least one row| '-------------------+------+-------+------------+--------+---------+------+---------+----------------' .-------------------+------+-------+------------+--------+---------+------+---------------------+--------------. | tLogRow_1 | |=------------------+------+-------+------------+--------+---------+------+---------------------+-------------=| |moment |pid |project|job |language|origin |status|substatus |description | |=------------------+------+-------+------------+--------+---------+------+---------------------+-------------=| |2026-11-18 14:32:31|tZLRZZ|DEMO |JOB_DocLB_A6|java |tAssert_2|Failed|Test logically failed|At most 2 rows| '-------------------+------+-------+------------+--------+---------+------+---------------------+--------------' Parsing Exception in component tJava_2 (JOB_DocLB_A6) java.lang.NumberFormatException: For input string: "abc" at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67) … .-------------------+------+-------+------------+--------+------+------+-------------------+-----------------------. | tLogRow_1 | |=------------------+------+-------+------------+--------+------+------+-------------------+----------------------=| |moment |pid |project|job |language|origin|status|substatus |description | |=------------------+------+-------+------------+--------+------+------+-------------------+----------------------=| |2026-11-18 14:32:31|tZLRZZ|DEMO |JOB_DocLB_A6|java |null |Failed|Job execution error|For input string: "abc"| '-------------------+------+-------+------------+--------+------+------+-------------------+-----------------------'
L'exception donne une troisième ligne, sans nom de composant (origin est null) : seule la trace dit que c'est tJava_2. Le job se termine avec le code 1. Avec Capturer les exceptions Java décochée, la même exception n'écrit que sa trace, sans ligne du tAssertCatcher.
The exception gives a third row, with no component name (origin is null): only the trace tells it is tJava_2. The job ends with code 1. With Catch Java Exception unchecked, the same exception only writes its trace, with no row from the tAssertCatcher.
Le tJava qui échoue, seul, et un tAssertCatcher dont Obtenir l'exception originale est cochée. Le schéma a dix colonnes : The failing tJava, alone, and a tAssertCatcher whose Get original exception is checked. The schema has ten columns:
Parsing Exception in component tJava_1 (JOB_DocLB_A8) java.lang.NumberFormatException: For input string: "abc" at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67) … .-------------------+------+-------+------------+--------+------+------+-------------------+-----------------------+--------------------------------------------------------. | tLogRow_1 | |=------------------+------+-------+------------+--------+------+------+-------------------+-----------------------+-------------------------------------------------------=| |moment |pid |project|job |language|origin|status|substatus |description |exception | |=------------------+------+-------+------------+--------+------+------+-------------------+-----------------------+-------------------------------------------------------=| |2026-11-18 14:32:37|IcaL5I|DEMO |JOB_DocLB_A8|java |null |Failed|Job execution error|For input string: "abc"|java.lang.NumberFormatException: For input string: "abc"| '-------------------+------+-------+------------+--------+------+------+-------------------+-----------------------+--------------------------------------------------------'
Le tLogRow affiche l'objet par son toString() : la classe de l'exception, que description seule ne donne pas.
The tLogRow shows the object through its toString(): the class of the exception, which description alone does not give.
tJava_1 écrit Before tDie ; tDie et tAssertCatcher aux réglages par défaut.
tJava_1 writes Before tDie; tDie and tAssertCatcher with default settings.
Before tDie tDie_1JOB_DocLB_A9the end is near
Aucune ligne du tAssertCatcher ; le job se termine avec le code 4, celui du tDie. Pour les tDie, utilisez un tLogCatcher. No row from the tAssertCatcher; the job ends with code 4, that of the tDie. For tDie, use a tLogCatcher.
tJava_1 échoue comme plus haut ; tJava_2 écrit On Component Error.
tJava_1 fails as above; tJava_2 writes On Component Error.
Parsing Exception in component tJava_1 (JOB_DocLB_A10) java.lang.NumberFormatException: For input string: "abc" at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67) … On Component Error
L'erreur est traitée par le lien : le tAssertCatcher ne reçoit rien et le job se termine avec le code 0. Avec un lien On Subjob Error à la place, le tAssertCatcher reçoit la ligne Job execution error, puis le composant relié s'exécute ; code 0 aussi.
The error is handled by the link: the tAssertCatcher receives nothing and the job ends with code 0. With an On Subjob Error link instead, the tAssertCatcher receives the Job execution error row, then the connected component runs; code 0 as well.
Le job aux deux tAssert, le tAssertCatcher relié à un tFileOutputDelimited aux réglages par défaut (chemin du fichier abrégé) : The job with the two tAssert components, the tAssertCatcher connected to a tFileOutputDelimited with default settings (file path shortened):
Loaded 3 rows Exception in component tFileOutputDelimited_1 (JOB_DocLB_C1) java.lang.RuntimeException: The particular file "…\JOB_DocLB_C1.csv" already exist. If you want to overwrite the file, please uncheck the "Throw an error if the file already exist" option in Advanced settings. at demo.job_doclb_c1_0_1.JOB_DocLB_C1.tAssertCatcher_1Process(JOB_DocLB_C1.java:1782) at demo.job_doclb_c1_0_1.JOB_DocLB_C1.tAssert_2Process(JOB_DocLB_C1.java:880) …
Le fichier après l'exécution, puis le même job avec Écrire à la suite de coché dans le tFileOutputDelimited : The file after the run, then the same job with Append checked in the tFileOutputDelimited:
2026-11-18 14:38:19;sHW9ub;DEMO;JOB_DocLB_C1;java;tAssert_1;Ok;--;At least one row
2026-11-18 14:38:21;U7eJBr;DEMO;JOB_DocLB_C2;java;tAssert_1;Ok;--;At least one row 2026-11-18 14:38:21;U7eJBr;DEMO;JOB_DocLB_C2;java;tAssert_2;Failed;Test logically failed;At most 2 rows
Le sous-job du tAssertCatcher est exécuté à chaque message : au deuxième, le fichier existe déjà et le tFileOutputDelimited refuse de l'écraser. Le message Failed est perdu, et le job se termine pourtant avec le code 0. Cochez Écrire à la suite de (un second lancement du job complète alors le même fichier).
The subjob of the tAssertCatcher is run at each message: at the second one, the file already exists and the tFileOutputDelimited refuses to overwrite it. The Failed message is lost, and yet the job ends with code 0. Check Append (a second run of the job then adds to the same file).
La palette annonce « le tAssert ou les autres commandes Die ». Le composant n'a pourtant pas de case Capturer les tDie, et le code généré écarte l'arrêt par un tDie : voir l'exemple plus haut. The palette announces "tAssert or other Die commands". Yet the component has no Catch tDie box, and the generated code leaves out the stop by a tDie: see the example above.
Recevoir un Failed d'un tAssert n'arrête pas le job et ne change pas son code de sortie. Une exception Java garde son code 1, qu'elle soit reçue ou non.
Receiving a Failed from a tAssert does not stop the job nor change its exit code. A Java exception keeps its code 1, whether it is received or not.
Pour une exception, origin est toujours null. Le tLogCatcher est l'outil prévu pour journaliser les erreurs Java.
For an exception, origin is always null. The tLogCatcher is the tool meant for logging Java errors.
Avec un tLogRow en mode Table ou Vertical, chaque message a son propre cadre. Le mode Simple donne une ligne par message, plus lisible dans un journal. With a tLogRow in Table or Vertical mode, each message has its own frame. Basic mode gives one line per message, easier to read in a log.
Placez un tFilterRow après le tAssertCatcher, condition status égal à "Failed" : les vérifications réussies ne sont plus écrites.
Place a tFilterRow after the tAssertCatcher, condition status equal to "Failed": the successful checks are no longer written.
Un job peut contenir plusieurs tAssertCatcher : chacun reçoit tous les messages, selon ses propres cases. L'un peut écrire les tAssert dans une table, l'autre les exceptions dans la console. A job can hold several tAssertCatcher components: each receives all the messages, according to its own boxes. One can write the tAssert results to a table, the other the exceptions to the console.
tAssert · la vérification qui produit les messagesthe check that produces the messagestLogCatcher · tWarn, tDie et erreurs JavatWarn, tDie and Java errorstStatCatcher · début, fin et durée des composantsstart, end and duration of the componentstFlowMeterCatcher · les comptages des tFlowMeterthe counts of the tFlowMeter componentstLogRow · afficher le compte rendu dans la consoleshow the report in the consoletFileOutputDelimited · l'écrire dans un fichier, avec Écrire à la suite dewrite it to a file, with Append