ComposantsComponents

ComposantsComponents › InternetInternet

tSocketOutput

tSocketOutput

InternetInternet

Se connecte à un port TCP, en général celui d'un tSocketInput qui attend dans un autre job, et y envoie les lignes de son flux sous forme de texte délimité (comme un fichier CSV), une à une, puis ferme la connexion à la fin du sous-job. Si personne n'écoute encore, il réessaie plusieurs fois. Ni chiffrement ni authentification. Connects to a TCP port, usually the one of a tSocketInput waiting in another job, and sends the rows of its flow there as delimited text (like a CSV file), one by one, then closes the connection at the end of the subjob. When nobody listens yet, it tries again several times. No encryption, no authentication.

EntréeInput

Main les lignes à envoyer.the rows to send.

SortieOutput

Un lien Main facultatif : les lignes reçues, transmises telles quelles après leur envoi.An optional Main link: the received rows, passed on as they are after being sent.

Déclencheurs en sortieOutput triggers

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

UtilisationUsage

Le job qui envoieThe job that sends

row1 (Main) OnSubjobOk tFixedFlowInput_1 tSocketOutput_1 tJava_1

Les lignes vont au tSocketInput d'un autre job, lancé avant lui ou peu après (le temps des nouvelles tentatives). Le tJava affiche NB_LINE. The rows go to the tSocketInput of another job, started before it or shortly after (within the time of the new tries). The tJava prints NB_LINE.

Envoi et réception dans un même jobSending and receiving in one job

row1 (Main) OnSubjobOk OnComponentError row2 (Main) OnSubjobOk tSocketInput_1 tLogRow_1 tJava_1 tJava_2 tFixedFlowInput_1 tSocketOutput_1 tJava_3

Avec Exécution multi thread cochée dans les réglages du job (page Extra), les deux sous-jobs démarrent ensemble ; si l'envoi part avant que le port soit ouvert, il est refusé puis réessayé une seconde plus tard. Sortie de ce job : voir les exemples du tSocketInput. With Multi thread execution checked in the job settings (Extra page), both subjobs start together; when the sending starts before the port is opened, it is refused then tried again one second later. Output of this job: see the examples of the tSocketInput.

  1. Déposez le tSocketOutput depuis la famille Internet de la palette et reliez-lui le flux à envoyer. Le schéma suit celui du flux : ses colonnes partent dans cet ordre. Drop the tSocketOutput from the Internet family of the palette and connect the flow to send to it. The schema follows the one of the flow: its columns are sent in that order.
  2. Renseignez l'Hôte et le Port du tSocketInput. Fill in the Host and the Port of the tSocketInput.
  3. Donnez les mêmes séparateurs, entourage, encodage et compression qu'au tSocketInput ; préférez "UTF-8" des deux côtés. Give the same separators, enclosure, encoding and compression as the tSocketInput; prefer "UTF-8" on both sides.
  4. Réglez Nombre d'essais et Délai avant expiration sur le temps que met le tSocketInput à être prêt, et reliez une sortie d'erreur. Set Retry Times and Timeout to the time the tSocketInput takes to be ready, and connect an error output.

Paramètres simplesBasic settings

Les libellés sont ceux de l'onglet Composant, dans son ordre ; 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. Les séparateurs, le caractère d'échappement et l'entourage sont des textes entre guillemets d'un seul caractère. Labels are those of the Component tab, in its order; the technical name, in grey, is the parameter name in the job file. The component has no advanced settings of its own. The separators, the escape character and the enclosure are texts in quotes of a single character.

ParamètreSetting DéfautDefault VisibleShown Description
HôteHostHOST "127.0.0.1" ToujoursAlways Nom ou adresse de la machine du tSocketInput, entre guillemets. Name or address of the machine of the tSocketInput, in quotes.
PortPORT 3456 ToujoursAlways Le Port du tSocketInput, expression Java entière. The Port of the tSocketInput, integer Java expression.
CompresserCompressCOMPRESS NonNo ToujoursAlways Chaque valeur est compressée (zip) puis codée en Base64, sur des lignes de 76 caractères. Le tSocketInput doit avoir Décompresser coché et un entourage. Cela n'allège que les longues valeurs : une ligne de quatre valeurs courtes est passée de 31 à 829 octets (voir Ce qui est envoyé). Each value is compressed (zip) then coded in Base64, in lines of 76 characters. The tSocketInput must have Uncompress checked and an enclosure. It only lightens long values: a row of four short values went from 31 to 829 bytes (see What is sent).
Nombre d'essaisRetry TimesRETRY 10 ToujoursAlways Le composant fait une tentative de moins que ce nombre : 9 avec 10. Avec 1 (ou moins), il n'en fait aucune et échoue sur une NullPointerException (voir La connexion). Seul un refus de connexion est réessayé. The component makes one try fewer than this number: 9 with 10. With 1 (or less), it makes none and fails on a NullPointerException (see The connection). Only a refused connection is tried again.
Délai avant expirationTimeoutTIMEOUT 1000 ToujoursAlways Pause, en millisecondes, après chaque tentative refusée, y compris la dernière. Ce n'est pas un délai de connexion : la connexion elle-même n'a pas de délai réglé (lu dans le modèle). Pause, in milliseconds, after each refused try, including the last one. This is not a connection timeout: the connection itself has no timeout set (read in the template).
Séparateur de lignesRow SeparatorROWSEPARATOR "\n" ToujoursAlways "\n" et "\r" envoient la fin de ligne du système qui exécute le job : \r\n sous Windows (mesuré pour les deux). Un autre caractère ("#") : ce caractère. Deux caractères ("\r\n") font échouer la compilation. "\n" and "\r" send the line end of the system that runs the job: \r\n on Windows (measured for both). Another character ("#"): that character. Two characters ("\r\n") make the compilation fail.
Séparateur de champsField SeparatorFIELDSEPARATOR ";" ToujoursAlways Un caractère : ";", "|", "\t". One character: ";", "|", "\t".
Caractère d'échappementEscape charESCAPE_CHAR "\"" ToujoursAlways "\\" : un guillemet dans une valeur est précédé d'une barre oblique inverse. Toute autre valeur : il est doublé. "\\": a quote in a value is preceded by a backslash. Any other value: it is doubled.
Entourage du texteText enclosureTEXT_ENCLOSURE "\"" ToujoursAlways Renseigné : toutes les valeurs sont entourées, nombres et valeurs vides compris. Vide : aucune ne l'est et rien n'est échappé ; une valeur qui contient le séparateur décale alors les champs à la réception. Filled in: all the values are enclosed, numbers and empty values included. Empty: none is and nothing is escaped; a value that holds the separator then shifts the fields at the reception.
SchémaSchemaSCHEMA celui du fluxthe one of the flow ToujoursAlways Chaque colonne devient un champ : null s'envoie vide ; une Date avec un motif est écrite avec ce motif ; les autres valeurs en texte Java. Lu dans le modèle : une Date sans motif part sous la forme Thu Jan 15 00:00:00 CET 2026, un tableau d'octets est décodé avec l'encodage par défaut de Java et non avec l'Encodage. Each column becomes a field: null is sent empty; a Date with a pattern is written with this pattern; the other values as Java text. Read in the template: a Date without a pattern goes out as Thu Jan 15 00:00:00 CET 2026, a byte array is decoded with the default encoding of Java and not with the Encoding.
EncodageEncodingENCODING "ISO-8859-15" ToujoursAlways Encodage des octets envoyés ; un caractère qu'il ne connaît pas part en ?. Le même qu'au tSocketInput (voir l'encodage du tSocketInput). Encoding of the sent bytes; a character it does not know goes out as ?. The same as at the tSocketInput (see the encoding of the tSocketInput).

Variables globalesGlobal variables

NB_LINE
Integer, disponible après le composant : nombre de lignes écrites sur la connexion. Il ne prouve pas leur réception (voir Pièges).Integer, available after the component: number of rows written on the connection. It does not prove their reception (see Pitfalls).
ERROR_MESSAGE
String, message de la dernière erreur ; rangé aussi à chaque tentative refusée.String, message of the last error; also stored at each refused try.
((Integer) globalMap.get("tSocketOutput_1_NB_LINE"))

Ce qui est envoyéWhat is sent

Le job qui envoie, vers un serveur d'essai qui journalise les octets reçus à la place d'un tSocketInput. Le journal coupe les octets à chaque \n et les montre en notation Python : \r est un retour chariot, \xe9 l'octet E9, \\ une seule barre oblique inverse. Schéma id (Integer), name, city, since (Date, motif "yyyy-MM-dd") ; les lignes : The job that sends, to a test server that logs the received bytes instead of a tSocketInput. The log cuts the bytes at each \n and shows them in Python notation: \r is a carriage return, \xe9 the E9 byte, \\ a single backslash. Schema id (Integer), name, city, since (Date, pattern "yyyy-MM-dd"); the rows:

id  name                      city        since
1   "Zoé"                     "Lyon"      TalendDate.parseDate("yyyy-MM-dd", "2026-01-15")
2   "Grace; \"Amazing\""      "New York"  TalendDate.parseDate("yyyy-MM-dd", "2025-06-01")
3   "Ada"                     null        null

Réglages par défautDefault settings

[tcplog] connection from 127.0.0.1:65378
[tcplog] closed by client after 98 bytes
[tcplog]   b'"1";"Zo\xe9";"Lyon";"2026-01-15"\r'
[tcplog]   b'"2";"Grace; ""Amazing""";"New York";"2025-06-01"\r'
[tcplog]   b'"3";"Ada";"";""\r'
[tcplog]   b''

Tout est entouré de guillemets, les guillemets de la valeur sont doublés, chaque ligne finit par \r\n, le « é » est l'octet E9 de l'ISO-8859-15, les null sont vides. Everything is enclosed in quotes, the quotes of the value are doubled, each row ends with \r\n, the "é" is the E9 byte of ISO-8859-15, the null values are empty.

Autres séparateurs, sans entourage, UTF-8Other separators, no enclosure, UTF-8

Séparateur de champs "|", de lignes "#", Entourage du texte "", Encodage "UTF-8". Field Separator "|", Row Separator "#", Text enclosure "", Encoding "UTF-8".

[tcplog] connection from 127.0.0.1:49302
[tcplog] closed by client after 70 bytes
[tcplog]   b'1|Zo\xc3\xa9|Lyon|2026-01-15#2|Grace; "Amazing"|New York|2025-06-01#3|Ada||#'

Les valeurs partent brutes, guillemets compris ; le « é » prend deux octets en UTF-8. Avec ces séparateurs et l'UTF-8 des deux côtés, mais l'entourage par défaut, un tSocketInput a relu les trois lignes correctement. The values go out raw, quotes included; the "é" takes two bytes in UTF-8. With these separators and UTF-8 on both sides, but the default enclosure, a tSocketInput read the three rows back correctly.

Échappement par barre oblique inverseBackslash escape

Caractère d'échappement "\\", la deuxième ligne seule. Escape char "\\", the second row only.

[tcplog] connection from 127.0.0.1:62067
[tcplog] closed by client after 50 bytes
[tcplog]   b'"2";"Grace; \\"Amazing\\"";"New York";"2025-06-01"\r'
[tcplog]   b''

Séparateur de lignes "\r""\r" row separator

La première ligne seule. The first row only.

[tcplog] connection from 127.0.0.1:57280
[tcplog] closed by client after 31 bytes
[tcplog]   b'"1";"Zo\xe9";"Lyon";"2026-01-15"\r'
[tcplog]   b''

Le même \r\n qu'avec "\n" : 29 octets de valeurs et 2 de fin de ligne. The same \r\n as with "\n": 29 bytes of values and 2 of line end.

CompressionCompression

Compresser cochée, la première ligne seule (31 octets sans compression) : Compress checked, the first row only (31 bytes without compression):

[tcplog] connection from 127.0.0.1:63860
[tcplog] closed by client after 829 bytes
[tcplog]   b'"UEsDBBQACAgIAFd9dV0AAAAAAAAAAAAAAAAOAAAAc2VydmxldHNlcnZpY2UzBABQSwcIt+/cgwMA\r'
[tcplog]   b'AAABAAAAUEsBAhQAFAAICAgAV311Xbfv3IMDAAAAAQAAAA4AAAAAAAAAAAAAAAAAAAAAAHNlcnZs\r'
[tcplog]   b'ZXRzZXJ2aWNlUEsFBgAAAAABAAEAPAAAAD8AAAAAAA==";"UEsDBBQACAgIAFd9dV0AAAAAAAAAAAAAAAAOAAAAc2VydmxldHNlcnZpY2WLyn8JAFBLBwjAX9ml\r'
[tcplog]   b'BQAAAAMAAABQSwECFAAUAAgICABXfXVdwF/ZpQUAAAADAAAADgAAAAAAAAAAAAAAAAAAAAAAc2Vy\r'
[tcplog]   b'dmxldHNlcnZpY2VQSwUGAAAAAAEAAQA8AAAAQQAAAAAA";"UEsDBBQACAgIAFd9dV0AAAAAAAAAAAAAAAAOAAAAc2VydmxldHNlcnZpY2XzqczPAwBQSwcIcVDJ\r'
[tcplog]   b'4wYAAAAEAAAAUEsBAhQAFAAICAgAV311XXFQyeMGAAAABAAAAA4AAAAAAAAAAAAAAAAAAAAAAHNl\r'
[tcplog]   b'cnZsZXRzZXJ2aWNlUEsFBgAAAAABAAEAPAAAAEIAAAAAAA==";"UEsDBBQACAgIAFd9dV0AAAAAAAAAAAAAAAAOAAAAc2VydmxldHNlcnZpY2UzMjAy0zUw1DU0BQBQ\r'
[tcplog]   b'SwcIQRkZXwwAAAAKAAAAUEsBAhQAFAAICAgAV311XUEZGV8MAAAACgAAAA4AAAAAAAAAAAAAAAAA\r'
[tcplog]   b'AAAAAHNlcnZsZXRzZXJ2aWNlUEsFBgAAAAABAAEAPAAAAEgAAAAAAA=="\r'
[tcplog]   b''

Chaque valeur est une archive zip complète (une entrée nommée servletservice), codée en Base64 avec des retours à la ligne \r\n tous les 76 caractères : sans entourage, ces retours coupent la ligne et le tSocketInput échoue sur java.io.EOFException. Each value is a full zip archive (one entry named servletservice), coded in Base64 with \r\n line breaks every 76 characters: without enclosure, these breaks cut the row and the tSocketInput fails on java.io.EOFException.

La connexionThe connection

La connexion est ouverte au début du sous-job, avant la première ligne. Refusée (personne n'écoute), elle est retentée après une pause d'un Délai avant expiration ; les autres erreurs (nom d'hôte inconnu…) font échouer le composant tout de suite. Après la dernière tentative, le composant échoue sur le refus. Chaque ligne est envoyée dès qu'elle arrive ; la connexion est fermée à la fin du sous-job, ce qui termine la réception du tSocketInput. The connection is opened at the start of the subjob, before the first row. Refused (nobody listening), it is tried again after a pause of one Timeout; the other errors (unknown host name…) make the component fail at once. After the last try, the component fails on the refusal. Each row is sent as soon as it arrives; the connection is closed at the end of the subjob, which ends the reception of the tSocketInput.

Personne n'écouteNobody listening

Le job qui envoie, vers un port libre, avec un tJava relié par On Component Error qui affiche le message ; Nombre d'essais 3, Délai avant expiration 500. Nom du job remplacé par MyJob, pile abrégée : The job that sends, to a free port, with a tJava connected with On Component Error that prints the message; Retry Times 3, Timeout 500. Job name replaced with MyJob, shortened stack:

Exception in component tSocketOutput_1 (MyJob)
java.net.ConnectException: Connection refused: connect
	at java.base/sun.nio.ch.Net.connect0(Native Method)
	…
	at java.base/java.net.Socket.<init>(Socket.java:324)
	at demo.myjob_0_1.MyJob.tFixedFlowInput_1Process(MyJob.java:914)
	…
On Component Error: ERROR_MESSAGE = Connection refused: connect

Le job entier a duré 3,4 s, préparation comprise ; avec les réglages par défaut, le même message est venu au bout de 11,6 s : 9 tentatives et 9 pauses d'une seconde. Le tJava relié par On Subjob Ok ne s'exécute pas. The whole job took 3.4 s, preparation included; with the default settings, the same message came after 11.6 s: 9 tries and 9 one-second pauses. The tJava connected with On Subjob Ok does not run.

Nombre d'essais à 1Retry Times set to 1

Le même job, Nombre d'essais 1 : The same job, Retry Times 1:

Exception in component tSocketOutput_1 (MyJob)
java.lang.NullPointerException: Cannot invoke "java.net.Socket.getOutputStream()" because "<local9>" is null
	at demo.myjob_0_1.MyJob.tFixedFlowInput_1Process(MyJob.java:930)
	…
On Component Error: ERROR_MESSAGE = Cannot invoke "java.net.Socket.getOutputStream()" because "<local9>" is null

La boucle des tentatives va jusqu'au nombre moins un : avec 1, aucune tentative n'est faite, et le composant échoue même si un tSocketInput attend. Mettez au moins 2 pour une seule tentative. The loop of tries goes up to the number minus one: with 1, no try is made, and the component fails even when a tSocketInput is waiting. Set at least 2 for a single try.

Pièges et sécuritéPitfalls and security

Un envoi réussi n'est pas une réceptionA successful sending is not a reception

Le composant ne reçoit aucune réponse : il se termine sans erreur dès que ses lignes sont écrites. Lors de nos essais, un second tSocketOutput connecté au même tSocketInput a fini avec NB_LINE = 1 alors que sa ligne a été perdue (voir les pièges du tSocketInput). Comparez le NB_LINE des deux bouts quand la perte compte. The component receives no answer: it ends without an error as soon as its rows are written. In our runs, a second tSocketOutput connected to the same tSocketInput ended with NB_LINE = 1 while its row was lost (see the pitfalls of the tSocketInput). Compare the NB_LINE of both ends when a loss matters.

En clair sur le réseauIn clear on the network

Les lignes circulent sans chiffrement et le composant ne vérifie pas à qui il parle : tout programme qui écoute sur l'hôte et le port donnés les reçoit. Réservez-le à une même machine ("127.0.0.1") ou à un réseau de confiance (voir la sécurité du tSocketInput). The rows travel without encryption and the component does not check whom it talks to: any program that listens on the given host and port receives them. Keep it for a single machine ("127.0.0.1") or a trusted network (see the security of the tSocketInput).

Un seul caractère par séparateurOne character per separator

Les séparateurs, l'entourage et l'échappement sont écrits dans le code comme des caractères Java. Séparateur de lignes "\r\n" a fait échouer la compilation du job (unclosed character literal sur setLineEnd(""+'\r\n')) ; laissez "\n", qui envoie déjà \r\n sous Windows. The separators, the enclosure and the escape are written in the code as Java characters. Row Separator "\r\n" made the compilation of the job fail (unclosed character literal on setLineEnd(""+'\r\n')); leave "\n", which already sends \r\n on Windows.

La bulle de la paletteThe palette tooltip

Le texte du composant dans la palette (« Lit un fichier ligne par ligne avec des champs simple séparés ») et plusieurs libellés de ses traductions viennent d'un composant de lecture de fichier : ils ne décrivent pas le tSocketOutput. The text of the component in the palette ("Reads a file row by row with simple separated fields") and several labels of its translations come from a file-reading component: they do not describe the tSocketOutput.

Voir aussiSee also

Les autres composants de la famille Internet, et ceux qui servent avec le tSocketOutput : The other components of the Internet family, and those used with the tSocketOutput: