ComposantsComponents › Internet
Envoie un message SOAP que vous écrivez en entier (l'enveloppe complète) à l'adresse d'un service, et en rend la réponse : l'en-tête, le corps et la faute dans trois colonnes texte, ou l'enveloppe entière dans un Document. Le composant ne lit pas de WSDL et ne vérifie pas le message : il l'envoie tel quel, avec le client SOAP de Java (SAAJ). Pour qu'un WSDL construise la requête à votre place, prenez un tWebService ou un tESBConsumer.Sends a SOAP message that you write in full (the whole envelope) to the address of a service, and gives its response: the header, the body and the fault in three text columns, or the whole envelope in a Document. The component does not read a WSDL and does not check the message: it sends it as is, with the SOAP client of Java (SAAJ). To have a WSDL build the request for you, take a tWebService or a tESBConsumer.
EntréeInput
Aucune : il commence le sous-job et fait un seul appel. Sinon un lien Main (un appel par ligne ; le message peut lire ses colonnes) ou Iterate.None: it starts the subjob and makes a single call. Otherwise one Main link (one call per row; the message can read its columns) or Iterate link.
SortieOutput
Un lien Main : une ligne par appel, colonnes Header, Body, Fault (String), ou Soap (Document) avec Écrire dans un document. Les colonnes reçues en entrée ne sont pas transmises.One Main link: one row per call, columns Header, Body, Fault (String), or Soap (Document) with Output in Document. The columns received as input are not passed on.
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
Le tSOAP commence le sous-job : un seul appel, une seule ligne en sortie. Le corps de la réponse arrive en texte XML dans Body, à découper ensuite (tExtractXMLField, tXMLMap).The tSOAP starts the subjob: a single call, a single output row. The body of the response arrives as XML text in Body, to be split next (tExtractXMLField, tXMLMap).
Chaque ligne reçue déclenche un appel. Le Message SOAP est une expression Java : il peut lire la ligne ("…<c:id>" + row1.id + "</c:id>…"), ou être pris tel quel dans une colonne avec Utiliser un message à partir du schéma.Each row received triggers a call. The SOAP Message is a Java expression: it can read the row ("…<c:id>" + row1.id + "</c:id>…"), or be taken as is from a column with Use a message from the schema.
Body pour une réponse normale, Fault pour une faute SOAP, qui n'arrête pas le job (voir La réponse).Connect the output: Body for a normal response, Fault for a SOAP fault, which does not stop the job (see The response).
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. La liste Version de SOAP enregistre Soap11 ou Soap12.Labels are those of the Component tab, in its order; the technical name, in grey, is the parameter name in the job file. The SOAP Version list stores Soap11 or Soap12.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| SchémaSchemaSCHEMA | Header, Body, Fault |
ToujoursAlways | En lecture seule. Trois colonnes String ; une seule colonne Soap de type Document quand Écrire dans un document est cochée.Read-only. Three String columns; a single Soap column of type Document when Output in Document is checked. |
| Utiliser le NTLMUse NTLMUSE_NTLM | NonNo | ToujoursAlways | Avec Authentification requise ?, l'utilisateur est donné à Java sous la forme domaine\utilisateur, sans en-tête Basic. Seule, la case n'a aucun effet. Non essayé (pas de serveur NTLM d'essai).With Need authentication?, the user is given to Java as domain\user, without a Basic header. Alone, the box has no effect. Not tried (no test NTLM server). |
| DomaineDomainNTLM_DOMAIN | "192.168.0.100" |
Utiliser le NTLM cochéUse NTLM checked | Domaine Windows du compte (le défaut ressemble à une adresse, mais c'est bien le domaine qui est attendu).Windows domain of the account (the default looks like an address, but the domain is what is expected). |
| Authentification requise ?Need authentication?NEED_AUTH | NonNo | ToujoursAlways | Authentification HTTP Basic. L'en-tête Authorization part avec la première requête ; en plus, l'identifiant est confié à Java, qui répond aux demandes du serveur (voir Sécurité).HTTP Basic authentication. The Authorization header leaves with the first request; in addition, the credentials are given to Java, which answers the challenges of the server (see Security). |
| UtilisateurUsernameAUTH_USERNAME | "username" |
Authentification requise ? cochéeNeed authentication? checked | Compte sur le service.Account on the service. |
| Mot de passePasswordAUTH_PASSWORD | "password" |
Authentification requise ? cochéeNeed authentication? checked | Mot de passe du compte. Une valeur entre guillemets est chiffrée dans le code généré ; une expression est reprise telle quelle.Password of the account. A value in quotes is encrypted in the generated code; an expression is used as is. |
| Utiliser un proxy httpUse http proxyUSE_PROXY | NonNo | ToujoursAlways | Pose les propriétés proxySet, proxyHost et proxyPort de la JVM : elles valent pour toute la suite du job. Voir Pièges.Sets the proxySet, proxyHost and proxyPort properties of the JVM: they apply to the whole rest of the job. See Pitfalls. |
| Hôte du proxyProxy hostPROXY_HOST | "127.0.0.1" |
Utiliser un proxy http cochéUse http proxy checked | Nom ou adresse du proxy HTTP.Name or address of the HTTP proxy. |
| Port du proxyProxy portPROXY_PORT | 8080 |
Utiliser un proxy http cochéUse http proxy checked | Un entier : la méthode appelée attend un int, une expression de type texte ne compile pas.An integer: the called method expects an int, a text expression does not compile. |
| Utilisateur(trice) du proxyProxy userPROXY_USERNAME | "" |
Utiliser un proxy http cochéUse http proxy checked | Rangés dans les propriétés http.proxyUser et http.proxyPassword, que Java ne lit pas : un proxy qui demande une authentification répond 407 (voir Pièges).Stored in the http.proxyUser and http.proxyPassword properties, which Java does not read: a proxy that asks for authentication answers 407 (see Pitfalls). |
| Mot de passe du proxyProxy passwordPROXY_PASSWORD | "" |
Utiliser un proxy http cochéUse http proxy checked | Voir la ligne précédente.See the previous row. |
| Sécuriser le serveur avec SSLTrust server with SSLNEED_SSL_TO_TRUSTSERVER | NonNo | ToujoursAlways | Pour une adresse https dont le certificat n'est pas reconnu par Java : pose javax.net.ssl.trustStore et javax.net.ssl.trustStorePassword, pour toute la JVM. Sans elle, le certificat d'essai a été refusé (PKIX path building failed).For an https address whose certificate Java does not recognize: sets javax.net.ssl.trustStore and javax.net.ssl.trustStorePassword, for the whole JVM. Without it, the test certificate was rejected (PKIX path building failed). |
| Fichier TrustStoreTrustStore fileSSL_TRUSTSERVER_TRUSTSTORE | "C:/clientTrustStore.trustStore" |
Sécuriser le serveur avec SSL cochéTrust server with SSL checked | Magasin qui contient le certificat du serveur ou de son autorité. Aucun type ne se règle : un fichier JKS a été lu.Store that holds the certificate of the server or of its authority. No type can be set: a JKS file was read. |
| Mot de passe du TrustStoreTrustStore passwordSSL_TRUSTSERVER_PASSWORD | "password" |
Sécuriser le serveur avec SSL cochéTrust server with SSL checked | Mot de passe du magasin.Password of the store. |
| ENDPOINTENDPOINT | "" |
ToujoursAlways | Adresse du service, http ou https : "http://server.example.com:8080/customers". Celle du soap:address du WSDL, pas l'adresse du WSDL lui-même.Address of the service, http or https: "http://server.example.com:8080/customers". The one of the soap:address of the WSDL, not the address of the WSDL itself. |
| Action SOAPSOAP ActionACTION | "" |
ToujoursAlways | SOAP 1.1 : envoyée telle quelle dans l'en-tête SOAPAction, sans guillemets ; écrivez "\"urn:hello\"" pour un service qui les exige. SOAP 1.2 : ajoutée au Content-Type (action="…"), et omise si elle est vide.SOAP 1.1: sent as is in the SOAPAction header, without quotes; write "\"urn:hello\"" for a service that requires them. SOAP 1.2: added to the Content-Type (action="…"), and left out when empty. |
| Version de SOAPSOAP VersionSOAP_VERSION | SOAP 1.1 | ToujoursAlways | SOAP 1.1 (text/xml) ou SOAP 1.2 (application/soap+xml). Elle décide du type de contenu et de la lecture de la réponse, pas de l'enveloppe : écrivez celle de la même version.SOAP 1.1 (text/xml) or SOAP 1.2 (application/soap+xml). It decides the content type and how the response is read, not the envelope: write the one of the same version. |
| Utiliser un message à partir du schémaUse a message from the schemaUSE_MESSAGE_FROM_SCHEMA | NonNo | ToujoursAlways | Cochée : le message est la valeur d'une colonne de la ligne reçue (.toString() : une colonne String ou Document). Sans lien d'entrée, le composant s'arrête sur There is no incoming connection or the incoming schema is empty.Checked: the message is the value of a column of the received row (.toString(): a String or Document column). Without an input link, the component stops on There is no incoming connection or the incoming schema is empty. |
| Message SOAPSOAP MessageSOAPMESSAGE_FROM_SCHEMA | videempty | Utiliser un message à partir du schéma cochéUse a message from the schema checked | Liste des colonnes du flux entrant : celle qui porte l'enveloppe.List of the columns of the incoming flow: the one that holds the envelope. |
| Écrire dans un documentOutput in DocumentOUTPUT_DOCUMENT | NonNo | ToujoursAlways | Cochée : l'enveloppe de la réponse entière, en-tête et faute compris, dans la colonne Soap. Dans ce mode, l'en-tête Basic n'est pas envoyé d'emblée (voir Sécurité).Checked: the whole envelope of the response, header and fault included, in the Soap column. In this mode, the Basic header is not sent up front (see Security). |
| Message SOAPSOAP MessageSOAPMESSAGE | "" |
Utiliser un message à partir du schéma décochéUse a message from the schema unchecked | Une expression Java de type texte : l'enveloppe complète. Elle peut tenir sur plusieurs lignes : les retours à la ligne du champ sont remplacés par des espaces à la génération. Voir Le message envoyé.A Java expression of type text: the whole envelope. It can span several lines: the line breaks of the field are replaced with spaces at generation. See The message sent. |
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Utiliser KerberosUse KerberosUSE_KERBEROS | NonNo | ToujoursAlways | L'appel est fait au nom du sujet Kerberos ouvert par un tSetKerberosConfiguration. Dans ce mode, une erreur d'appel est seulement écrite dans la console et rangée dans ERROR_MESSAGE : le job continue. Lu dans le modèle, non essayé (pas de KDC d'essai).The call is made on behalf of the Kerberos subject opened by a tSetKerberosConfiguration. In this mode, a call error is only written to the console and stored in ERROR_MESSAGE: the job goes on. Read in the template, not tried (no test KDC). |
| Configuration de KerberosKerberos configurationKERBEROS_CONFIGURATION | videempty | Utiliser Kerberos cochéUse Kerberos checked | Le tSetKerberosConfiguration du job. S'il n'a pas ouvert de sujet, le composant écrit Subject for Kerberos is null!.The tSetKerberosConfiguration of the job. If it did not open a subject, the component writes Subject for Kerberos is null!. |
| Appliquer les certificats NTLMEnforce NTLM credentialsENFORCE_NTLM | NonNo | Utiliser le NTLM et Authentification requise ? cochésUse NTLM and Need authentication? checked | Doit empêcher Java d'utiliser la session Windows à la place de l'identifiant donné. La bibliothèque ne le fait que si java.vendor.url vaut http://java.sun.com/ ou http://java.oracle.com/ : avec le Java 21 de nos essais (https://adoptium.net/), la case est sans effet.Is meant to stop Java from using the Windows session instead of the given credentials. The library only does it when java.vendor.url is http://java.sun.com/ or http://java.oracle.com/: with the Java 21 of our runs (https://adoptium.net/), the box has no effect. |
Le texte du message est lu comme un document SOAP et envoyé en POST, sans contrôle : une enveloppe SOAP 1.1 partie avec SOAP 1.2, un corps sans enveloppe ou un XML mal formé ont tous été envoyés, et c'est le service qui les a refusés (par une faute). Un message vide échoue avant l'envoi (Message send failed). Message et réglages des exemples :The text of the message is read as a SOAP document and sent with POST, without any check: a SOAP 1.1 envelope sent with SOAP 1.2, a body without an envelope or malformed XML were all sent, and the service rejected them (with a fault). An empty message fails before sending (Message send failed). Message and settings of the examples:
// ENDPOINT
"http://127.0.0.1:8186/customers"
// Action SOAP / SOAP Action
"urn:getCustomer"
// Message SOAP / SOAP Message
"<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:c=\"http://example.com/customers\">
<soapenv:Header/>
<soapenv:Body>
<c:getCustomer><c:id>2</c:id></c:getCustomer>
</soapenv:Body>
</soapenv:Envelope>"
Requête reçue par le service d'essai (son journal) :Request received by the test service (its log):
POST /customers HTTP/1.1 Accept: text/xml, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 SOAPAction: urn:getCustomer Content-Type: text/xml; charset=utf-8 Cache-Control: no-cache Pragma: no-cache User-Agent: Java/21.0.12.1 Host: 127.0.0.1:8186 Connection: keep-alive Content-Length: 240 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:c="http://example.com/customers"> <soapenv:Header/> <soapenv:Body> <c:getCustomer><c:id>2</c:id></c:getCustomer> </soapenv:Body> </soapenv:Envelope>
Le message part tel quel, sans déclaration XML ajoutée ; les retours à la ligne du champ sont devenus des espaces.The message leaves as is, with no XML declaration added; the line breaks of the field became spaces.
Même opération, SOAP 1.2 et une enveloppe http://www.w3.org/2003/05/soap-envelope : l'action passe dans le type de contenu.Same operation, SOAP 1.2 and a http://www.w3.org/2003/05/soap-envelope envelope: the action moves into the content type.
POST /customers HTTP/1.1 Accept: application/soap+xml, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 Content-Type: application/soap+xml; charset=utf-8; action="urn:getCustomer" Cache-Control: no-cache Pragma: no-cache User-Agent: Java/21.0.12.1 Host: 127.0.0.1:8186 Connection: keep-alive Content-Length: 238
Avec une Action SOAP vide, le type de contenu s'arrête à application/soap+xml; charset=utf-8.With an empty SOAP Action, the content type stops at application/soap+xml; charset=utf-8.
Le message est converti en octets dans l'encodage de sa déclaration XML (<?xml … encoding="…"?>), à défaut dans l'encodage par défaut de Java, UTF-8 avec Java 21. L'en-tête annonce toujours charset=utf-8. Et la réponse est relue dans ce même encodage, quel que soit celui du service : voir Pièges.The message is turned into bytes in the encoding of its XML declaration (<?xml … encoding="…"?>), otherwise in the default encoding of Java, UTF-8 with Java 21. The header always announces charset=utf-8. And the response is read back in that same encoding, whatever the one of the service: see Pitfalls.
| ColonneColumn | ContenuContent |
|---|---|
Header | Les éléments du soap:Header de la réponse, regroupés sous un élément <Header> sans espace de noms. Attention : si la réponse n'a pas d'en-tête, la colonne garde celui de l'appel précédent (voir Pièges).The elements of the soap:Header of the response, grouped under a <Header> element with no namespace. Beware: if the response has no header, the column keeps the one of the previous call (see Pitfalls). |
Body | L'élément contenu dans le soap:Body, en texte XML sans déclaration. Nul pour une faute et pour un corps vide. Un corps qui contient deux éléments arrête le composant : Cannot extract Document from body.The element held in the soap:Body, as XML text with no declaration. Null for a fault and for an empty body. A body that holds two elements stops the component: Cannot extract Document from body. |
Fault | L'élément soap:Fault, pour une faute SOAP 1.1 ou 1.2 (réponse HTTP 500). La faute ne lève pas d'erreur : le job continue et la ligne sort avec Body nul.The soap:Fault element, for a SOAP 1.1 or 1.2 fault (HTTP 500 response). The fault raises no error: the job goes on and the row comes out with a null Body. |
Soap | Avec Écrire dans un document : l'enveloppe complète (déclaration XML, en-tête, corps ou faute), en Document. Une faute arrive là aussi, sans erreur.With Output in Document: the whole envelope (XML declaration, header, body or fault), as a Document. A fault also arrives there, with no error. |
Toute autre réponse HTTP qu'un succès ou une faute (401, 404, 407…), comme un service injoignable, lève une erreur : voir Les erreurs.Any HTTP response other than a success or a fault (401, 404, 407…), like an unreachable service, raises an error: see Errors.
Sorties copiées depuis des exécutions des jobs (lancés depuis Talaxie, Java 21) contre un service SOAP d'essai installé sur le poste, à l'adresse http://127.0.0.1:8186/customers. Il connaît les clients 1 à 3 et répond à getCustomer avec un en-tête requestId (un compteur), à hello sans en-tête, et par une faute pour un client inconnu. Le tLogRow affiche Header|Body|Fault.Outputs copied from runs of the jobs (started from Talaxie, Java 21) against a test SOAP service installed on the machine, at http://127.0.0.1:8186/customers. It knows customers 1 to 3 and answers getCustomer with a requestId header (a counter), hello without a header, and with a fault for an unknown customer. The tLogRow displays Header|Body|Fault.
Le message de Le message envoyé (client 2) :The message of The message sent (customer 2):
<Header><tns:requestId xmlns:tns="http://example.com/customers">1</tns:requestId></Header>|<tns:getCustomerResponse xmlns:tns="http://example.com/customers"><tns:customer><tns:id>2</tns:id><tns:name>Grace Petit</tns:name><tns:city>Lyon</tns:city></tns:customer></tns:getCustomerResponse>|
Opération hello (<c:hello><c:name>Ada</c:name></c:hello>), réponse sans en-tête : Header reste nul.hello operation (<c:hello><c:name>Ada</c:name></c:hello>), response without a header: Header stays null.
|<tns:helloResponse xmlns:tns="http://example.com/customers"><tns:greeting>Hello, Ada!</tns:greeting></tns:helloResponse>|
Client 99, inconnu : le service répond 500 avec une faute. Le job continue (code 0).Customer 99, unknown: the service answers 500 with a fault. The job goes on (code 0).
||<soap:Fault xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><faultcode>soap:Client</faultcode><faultstring>Unknown customer 99</faultstring><detail><tns:customerFault xmlns:tns="http://example.com/customers"><tns:id>99</tns:id></tns:customerFault></detail></soap:Fault>
La même en SOAP 1.2 :The same in SOAP 1.2:
||<soap:Fault xmlns:soap="http://www.w3.org/2003/05/soap-envelope"><soap:Code><soap:Value>soap:Sender</soap:Value></soap:Code><soap:Reason><soap:Text xml:lang="en">Unknown customer 99</soap:Text></soap:Reason><soap:Detail><tns:customerFault xmlns:tns="http://example.com/customers"><tns:id>99</tns:id></tns:customerFault></soap:Detail></soap:Fault>
Pour séparer succès et fautes, un tFilterRow sur Fault nul, ou un tExtractXMLField sur faultstring.To split successes and faults, a tFilterRow on a null Fault, or a tExtractXMLField on faultstring.
Même appel (client 2), Écrire dans un document cochée : le tLogRow affiche la colonne Soap.Same call (customer 2), Output in Document checked: the tLogRow displays the Soap column.
<?xml version="1.0" encoding="UTF-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Header><tns:requestId xmlns:tns="http://example.com/customers">3</tns:requestId></soap:Header><soap:Body><tns:getCustomerResponse xmlns:tns="http://example.com/customers"><tns:customer><tns:id>2</tns:id><tns:name>Grace Petit</tns:name><tns:city>Lyon</tns:city></tns:customer></tns:getCustomerResponse></soap:Body></soap:Envelope>
Client 99 dans ce mode :Customer 99 in this mode:
<?xml version="1.0" encoding="UTF-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><soap:Fault><faultcode>soap:Client</faultcode><faultstring>Unknown customer 99</faultstring><detail><tns:customerFault xmlns:tns="http://example.com/customers"><tns:id>99</tns:id></tns:customerFault></detail></soap:Fault></soap:Body></soap:Envelope>
Le Document se lit ensuite avec un tXMLMap ou un tExtractXMLField, en tenant compte des espaces de noms.The Document is then read with a tXMLMap or a tExtractXMLField, taking the namespaces into account.
Trois lignes, id = 1, 99, 3. Le message lit la colonne :Three rows, id = 1, 99, 3. The message reads the column:
"<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:c=\"http://example.com/customers\">
<soapenv:Body>
<c:getCustomer><c:id>" + row1.id + "</c:id></c:getCustomer>
</soapenv:Body>
</soapenv:Envelope>"
<Header><tns:requestId xmlns:tns="http://example.com/customers">11</tns:requestId></Header>|<tns:getCustomerResponse xmlns:tns="http://example.com/customers"><tns:customer><tns:id>1</tns:id><tns:name>Ada Martin</tns:name><tns:city>Paris</tns:city></tns:customer></tns:getCustomerResponse>| <Header><tns:requestId xmlns:tns="http://example.com/customers">11</tns:requestId></Header>||<soap:Fault xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><faultcode>soap:Client</faultcode><faultstring>Unknown customer 99</faultstring><detail><tns:customerFault xmlns:tns="http://example.com/customers"><tns:id>99</tns:id></tns:customerFault></detail></soap:Fault> <Header><tns:requestId xmlns:tns="http://example.com/customers">12</tns:requestId></Header>|<tns:getCustomerResponse xmlns:tns="http://example.com/customers"><tns:customer><tns:id>3</tns:id><tns:name>Linus Morel</tns:name><tns:city>Paris</tns:city></tns:customer></tns:getCustomerResponse>|
La faute de la deuxième ligne n'a pas d'en-tête : la colonne Header y montre pourtant requestId 11, celui de la ligne précédente.The fault of the second row has no header: the Header column still shows requestId 11 there, the one of the previous row.
Le tFixedFlowInput porte une colonne message : trois enveloppes complètes, getCustomer 1, hello (Grace), getCustomer 99. Utiliser un message à partir du schéma cochée, colonne message, Action SOAP vide.The tFixedFlowInput holds a message column: three whole envelopes, getCustomer 1, hello (Grace), getCustomer 99. Use a message from the schema checked, message column, empty SOAP Action.
<Header><tns:requestId xmlns:tns="http://example.com/customers">13</tns:requestId></Header>|<tns:getCustomerResponse xmlns:tns="http://example.com/customers"><tns:customer><tns:id>1</tns:id><tns:name>Ada Martin</tns:name><tns:city>Paris</tns:city></tns:customer></tns:getCustomerResponse>| <Header><tns:requestId xmlns:tns="http://example.com/customers">13</tns:requestId></Header>|<tns:helloResponse xmlns:tns="http://example.com/customers"><tns:greeting>Hello, Grace!</tns:greeting></tns:helloResponse>| <Header><tns:requestId xmlns:tns="http://example.com/customers">13</tns:requestId></Header>||<soap:Fault xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><faultcode>soap:Client</faultcode><faultstring>Unknown customer 99</faultstring><detail><tns:customerFault xmlns:tns="http://example.com/customers"><tns:id>99</tns:id></tns:customerFault></detail></soap:Fault>
Chaque ligne appelle l'opération de son enveloppe ; le service ne lisait pas l'action. L'en-tête de la première réponse se répète sur les deux suivantes, qui n'en ont pas.Each row calls the operation of its envelope; the service did not read the action. The header of the first response repeats on the next two, which have none.
Adresse http://127.0.0.1:8186/secure/customers, protégée par Basic (demo / demo), client 1 :Address http://127.0.0.1:8186/secure/customers, protected by Basic (demo / demo), customer 1:
<Header><tns:requestId xmlns:tns="http://example.com/customers">4</tns:requestId></Header>|<tns:getCustomerResponse xmlns:tns="http://example.com/customers"><tns:customer><tns:id>1</tns:id><tns:name>Ada Martin</tns:name><tns:city>Paris</tns:city></tns:customer></tns:getCustomerResponse>|
La requête portait d'emblée Authorization: Basic ZGVtbzpkZW1v. Avec Écrire dans un document, la première requête est partie sans cet en-tête, le service a répondu 401, et Java a renvoyé la requête avec lui.The request carried Authorization: Basic ZGVtbzpkZW1v up front. With Output in Document, the first request left without that header, the service answered 401, and Java sent the request again with it.
Messages relevés dans la console. Le composant n'a pas de case Arrêter en cas d'erreur : une erreur arrête le job avec le code 1, sauf si un lien On Component Error ou On Subjob Error la reprend. Le message est aussi dans tSOAP_1_ERROR_MESSAGE.Messages seen in the console. The component has no Die on error box: an error stops the job with code 1, unless an On Component Error or On Subjob Error link takes it over. The message is also in tSOAP_1_ERROR_MESSAGE.
| CasCase | ERROR_MESSAGE |
|---|---|
| Faute SOAP (HTTP 500)SOAP fault (HTTP 500) | aucune erreur : la faute est dans Fault (ou Soap)no error: the fault is in Fault (or Soap) |
| Adresse inconnue du serviceAddress unknown to the service | com.sun.xml.messaging.saaj.SOAPExceptionImpl: Bad response: (404Not Found |
| Pas d'authentification, ou mot de passe refuséNo authentication, or password rejected | com.sun.xml.messaging.saaj.SOAPExceptionImpl: Bad response: (401Unauthorized |
| Proxy qui demande une authentificationProxy that asks for authentication | com.sun.xml.messaging.saaj.SOAPExceptionImpl: Bad response: (407Proxy Authentication Required |
| Rien n'écoute sur le portNothing listens on the port | com.sun.xml.messaging.saaj.SOAPExceptionImpl: Message send failed, cause java.net.ConnectException: Connection refused: connectcom.sun.xml.messaging.saaj.SOAPExceptionImpl: Message send failed, cause java.net.ConnectException: Connection refused: connect |
| Certificat non reconnu (HTTPS)Certificate not recognized (HTTPS) | … Message send failed, cause javax.net.ssl.SSLHandshakeException: (certificate_unknown) PKIX path building failed: …… Message send failed, cause javax.net.ssl.SSLHandshakeException: (certificate_unknown) PKIX path building failed: … |
| Message videEmpty message | … Message send failed, cause java.lang.IndexOutOfBoundsException: Range [0, 0 + -1) out of bounds for length 1024… Message send failed, cause java.lang.IndexOutOfBoundsException: Range [0, 0 + -1) out of bounds for length 1024 |
| Deux éléments dans le corps de la réponseTwo elements in the body of the response | Cannot extract Document from body |
| Message tiré du schéma, sans lien d'entréeMessage from the schema, without an input link | There is no incoming connection or the incoming schema is empty |
ENDPOINT "http://127.0.0.1:8186/nothing", tSOAP suivi d'un tJava par On Subjob Ok seulement. Nom du job remplacé par MyJob, pile abrégée :ENDPOINT "http://127.0.0.1:8186/nothing", tSOAP followed by a tJava through On Subjob Ok only. Job name replaced with MyJob, shortened stack:
nov. 21, 2026 3:34:29 PM com.sun.xml.messaging.saaj.client.p2p.HttpSOAPConnection post GRAVE: SAAJ0008 : réponse incorrecte ; Not Found Exception in component tSOAP_1 (MyJob) com.sun.xml.messaging.saaj.SOAPExceptionImpl: com.sun.xml.messaging.saaj.SOAPExceptionImpl: Bad response: (404Not Found at com.sun.xml.messaging.saaj.client.p2p.HttpSOAPConnection.call(HttpSOAPConnection.java:127) at org.talend.soap.SOAPUtil.invokeSOAP(SOAPUtil.java:142) at demo.myjob_0_1.MyJob.tSOAP_1Process(MyJob.java:804) …
Les deux premières lignes viennent de la bibliothèque SOAP, dans la langue du système. Le tJava n'est pas exécuté ; le job se termine avec le code 1. Avec un tJava relié par On Component Error, il affiche ERROR_MESSAGE et le job se termine avec le code 0.The first two lines come from the SOAP library, in the language of the system. The tJava is not run; the job ends with code 1. With a tJava connected through On Component Error, it prints ERROR_MESSAGE and the job ends with code 0.
Le composant n'en déclare aucune : ni NB_LINE, ni code de statut HTTP. Sur une erreur, le message est dans ERROR_MESSAGE, comme pour tout composant.The component declares none: no NB_LINE, no HTTP status code. On an error, the message is in ERROR_MESSAGE, as for any component.
((String) globalMap.get("tSOAP_1_ERROR_MESSAGE"))
En plus de l'en-tête Basic, le composant confie l'identifiant à Java (Authenticator), qui répond à chaque refus du serveur avec le même identifiant. Avec un mot de passe faux, le service d'essai a reçu 20 requêtes, toutes refusées (401), pour un seul appel. Un serveur qui bloque un compte après quelques échecs le bloquera. L'identifiant reste aussi en place pour les autres connexions HTTP de la JVM.On top of the Basic header, the component gives the credentials to Java (Authenticator), which answers each rejection of the server with the same credentials. With a wrong password, the test service received 20 requests, all rejected (401), for a single call. A server that locks an account after a few failures will lock it. The credentials also stay in place for the other HTTP connections of the JVM.
L'en-tête Basic n'est qu'un encodage (ZGVtbzpkZW1v = demo:demo) : sur une adresse http, il circule lisible. Préférez https. Un mot de passe écrit entre guillemets est chiffré dans le code généré, mais la clé qui le déchiffre est livrée avec le job : passez-le par une variable de contexte chargée au lancement (tContextLoad).The Basic header is only an encoding (ZGVtbzpkZW1v = demo:demo): on an http address, it travels readable. Prefer https. A password written in quotes is encrypted in the generated code, but the key that decrypts it ships with the job: pass it through a context variable loaded at start (tContextLoad).
Le TrustStore et le proxy sont des propriétés système : ils valent pour toutes les connexions de la JVM qui suivent, d'autres composants compris. Pour plusieurs magasins de certificats dans un même job, un tSetKeystore rend la chose explicite.The TrustStore and the proxy are system properties: they apply to all the following connections of the JVM, other components included. For several certificate stores in the same job, a tSetKeystore makes it explicit.
La bibliothèque ne remet pas Header à vide quand une réponse n'a pas d'en-tête : la ligne reçoit celui de l'appel précédent (exemples Un appel par ligne et Message pris dans une colonne). Si l'en-tête compte, tirez-le d'Écrire dans un document, où chaque ligne porte sa propre enveloppe.The library does not reset Header when a response has no header: the row receives the one of the previous call (examples One call per row and Message taken from a column). If the header matters, take it from Output in Document, where each row carries its own envelope.
L'utilisateur et le mot de passe du proxy vont dans des propriétés que Java ignore : la requête est arrivée au proxy d'essai sans Proxy-Authorization, et il a répondu 407. Avec un proxy sans authentification, l'appel est bien passé par lui. Pour un proxy authentifié, voyez tSetProxy.The user and the password of the proxy go into properties that Java ignores: the request reached the test proxy without Proxy-Authorization, and it answered 407. With a proxy without authentication, the call did go through it. For an authenticated proxy, see tSetProxy.
Java ne passe jamais par un proxy pour localhost et 127.* (liste par défaut de http.nonProxyHosts) : nos premiers appels, vers 127.0.0.1, sont allés directement au service. Il a fallu lancer le job avec -Dhttp.nonProxyHosts= (liste vide) pour voir passer les appels par le proxy.Java never goes through a proxy for localhost and 127.* (default list of http.nonProxyHosts): our first calls, to 127.0.0.1, went straight to the service. The job had to be started with -Dhttp.nonProxyHosts= (empty list) to see the calls go through the proxy.
La réponse est relue dans l'encodage déclaré par le message envoyé. Opération hello avec le nom Zoé ; le service répond en UTF-8. Sans déclaration, puis avec <?xml version="1.0" encoding="ISO-8859-1"?> en tête du message :The response is read back in the encoding declared by the message sent. hello operation with the name Zoé; the service answers in UTF-8. Without a declaration, then with <?xml version="1.0" encoding="ISO-8859-1"?> at the start of the message:
|<tns:helloResponse xmlns:tns="http://example.com/customers"><tns:greeting>Hello, Zoé!</tns:greeting></tns:helloResponse>| |<tns:helloResponse xmlns:tns="http://example.com/customers"><tns:greeting>Hello, Zoé!</tns:greeting></tns:helloResponse>|
De plus, le message ISO-8859-1 est parti avec l'en-tête charset=utf-8. Écrivez le message sans déclaration d'encodage (UTF-8 avec Java 21).Moreover, the ISO-8859-1 message left with the charset=utf-8 header. Write the message without an encoding declaration (UTF-8 with Java 21).
En SOAP 1.1, l'en-tête SOAPAction part sans les guillemets que prévoit la norme (SOAPAction: urn:getCustomer). Notre service l'a accepté ; certains services les exigent. Action SOAP "\"urn:hello\"" a donné SOAPAction: "urn:hello".In SOAP 1.1, the SOAPAction header leaves without the quotes that the standard expects (SOAPAction: urn:getCustomer). Our service accepted it; some services require them. SOAP Action "\"urn:hello\"" gave SOAPAction: "urn:hello".
Une enveloppe SOAP 1.1 envoyée avec SOAP 1.2 est partie sous le type application/soap+xml : c'est notre service qui l'a refusée, par une faute dans Fault. Le composant ne signale rien : vérifiez que l'espace de noms de l'enveloppe et la version choisie concordent.A SOAP 1.1 envelope sent with SOAP 1.2 left with the application/soap+xml type: our service rejected it, with a fault in Fault. The component reports nothing: check that the namespace of the envelope and the chosen version match.
tWebService · appeler une opération décrite par un WSDL, sans écrire le messagecall an operation described by a WSDL, without writing the messagetWebServiceInput · appeler une opération à paramètres simplescall an operation with simple parameterstESBConsumer · client SOAP de la famille ESBSOAP client of the ESB familytHttpRequest · requête HTTP quelconqueany HTTP requesttExtractXMLField · découper Body ou Faultsplit Body or FaulttSetProxy · régler le proxy de la JVMset the proxy of the JVMtSetKeystore · magasins de certificats du jobcertificate stores of the jobtSetKerberosConfiguration · sujet Kerberos de Utiliser KerberosKerberos subject of Use Kerberos