ComposantsComponents

ComposantsComponents › Internet

tWebService

tWebService

Internet

Interroge un service web SOAP décrit par un WSDL et en lit le résultat. Son éditeur lit le WSDL, propose les ports et les opérations, puis relie les colonnes du flux entrant aux éléments de la requête et les éléments de la réponse aux colonnes du schéma de sortie : vous n'écrivez pas le message. À l'exécution, le job relit le WSDL et appelle le service avec Apache CXF 3.5.5. Pour écrire le message vous-même, prenez un tSOAP.Requests a SOAP web service described by a WSDL and reads its result. Its editor reads the WSDL, offers the ports and operations, then maps the columns of the incoming flow to the elements of the request and the elements of the response to the columns of the output schema: you do not write the message. At run time, the job reads the WSDL again and calls the service with Apache CXF 3.5.5. To write the message yourself, take a tSOAP.

EntréeInput

Un lien Main, facultatif : un appel par ligne. Sans lien, il commence le sous-job et fait un seul appel. Pas de lien Iterate.One Main link, optional: one call per row. Without a link, it starts the subjob and makes a single call. No Iterate link.

SortieOutput

Un lien Main (connecteur OUTPUT) : une ligne par appel, avec les colonnes du schéma de sortie. Les colonnes d'entrée ne sont pas transmises.One Main link (OUTPUT connector): one row per call, with the columns of the output schema. The input columns are not passed on.

Déclencheurs en sortieOutput triggers

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

UtilisationUsage

Un appel par ligneOne call per row

row1 (Main)row2 (Main)tFixedFlowInput_1tWebService_1tLogRow_1

Chaque ligne déclenche un appel ; ses colonnes remplissent les éléments de la requête (row1.id → parameters.id), et la réponse remplit les colonnes de la ligne de sortie.Each row triggers a call; its columns fill the elements of the request (row1.id → parameters.id), and the response fills the columns of the output row.

Un seul appelA single call

row1 (Main)tWebService_1tLogRow_1

Sans flux d'entrée, les expressions de la requête sont du Java libre : constantes, variables de contexte, globalMap.Without an incoming flow, the expressions of the request are free Java: constants, context variables, globalMap.

  1. Déposez le tWebService depuis la famille Internet de la palette et reliez-lui, au besoin, le flux d'entrée.Drop the tWebService from the Internet family of the palette and connect the input flow to it if needed.
  2. Ouvrez l'éditeur (Configuration de service › …), lisez le WSDL, choisissez le port et l'opération, puis faites les correspondances d'entrée et de sortie (voir L'éditeur).Open the editor (Service configuration › …), read the WSDL, choose the port and the operation, then make the input and output mappings (see The editor).
  3. Tracez le lien de sortie (clic droit › Ligne › Main) et réglez, dans l'onglet Composant, délais, authentification, proxy et Arrêter en cas d'erreur ; les certificats d'un service HTTPS se donnent de préférence par un tSetKeystore.Draw the output link (right-click › Row › Main) and set, in the Component tab, timeouts, authentication, proxy and Die on error; the certificates of an HTTPS service are best given through a tSetKeystore.

Paramètres simplesBasic settings

Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. L'adresse du WSDL, l'opération et les correspondances sont des paramètres cachés, écrits par l'éditeur (voir L'éditeur).Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The WSDL address, the operation and the mappings are hidden settings, written by the editor (see The editor).

ParamètreSetting DéfautDefault VisibleShown Description
Type de propriétéProperty TypePROPERTY Built-in ToujoursAlways Built-in, ou Référentiel pour reprendre une métadonnée de service web du projet.Built-in, or Repository to reuse a web service metadata of the project.
Configuration de serviceService configurationSERVICE_CONFIGURATION — ToujoursAlways Le bouton … ouvre l'éditeur du service.The … button opens the service editor.
Les liens de mapping s'affichent comme :Mapping links display as:MAPPING_DISPLAY Auto ToujoursAlways Auto, Courbes ou Lignes (rapide). Sans effet : ni le modèle du composant ni l'éditeur ne le lisent.Auto, Curves or Lines (fast). No effect: neither the template of the component nor the editor reads it.
Délai avant expiration de la connexion (secondes)Connection Time out (second)CONNECTION_TIMEOUT 20 ToujoursAlways En secondes, décimales permises (le code fait Double.valueOf(…) * 1000) ; vide : 20.In seconds, decimals allowed (the code does Double.valueOf(…) * 1000); empty: 20.
Délai avant réponse du serveur (en secondes)Receive Time out(second)RECEIVE_TIMEOUT 20 ToujoursAlways Attente maximale de la réponse. Dépassé : Could not receive Message. (exemple Délai de réponse).Longest wait for the response. Exceeded: Could not receive Message. (example Receive timeout).
Schéma d'entréeInput SchemaINPUT_SCHEMA videempty ToujoursAlways Colonnes du flux entrant, proposées à gauche de la correspondance d'entrée.Columns of the incoming flow, offered on the left of the input mapping.
Schéma de sortieOutput SchemaSCHEMA videempty ToujoursAlways Colonnes de la ligne de sortie, écrites par la correspondance de sortie. Chaque valeur est convertie depuis son texte selon le type de la colonne (ParserUtils.parseTo_…) ; une colonne Date utilise son modèle de date.Columns of the output row, written by the output mapping. Each value is converted from its text according to the type of the column (ParserUtils.parseTo_…); a Date column uses its date pattern.
Utiliser le NTLMUse NTLMUSE_NTLM NonNo ToujoursAlways Pose http.auth.ntlm.domain (si le domaine n'est pas vide), confie l'utilisateur et le mot de passe à Java et désactive l'envoi par morceaux. Le WSDL est alors lu sans les réglages de proxy ni d'authentification. Lu dans le modèle, non essayé (pas de serveur NTLM d'essai).Sets http.auth.ntlm.domain (if the domain is not empty), gives the user and the password to Java and turns chunked sending off. The WSDL is then read without the proxy and authentication settings. Read in the template, not tried (no test NTLM server).
DomaineDomainNTLM_DOMAIN "192.168.0.100" Utiliser le NTLM cochéUse NTLM checked Domaine Windows du compte.Windows domain of the account.
Authentification requise ?Need authentication?NEED_AUTH NonNo ToujoursAlways HTTP Basic, pour le WSDL (réponse à la demande du serveur) et pour les appels (en-tête envoyé d'emblée).HTTP Basic, for the WSDL (answer to the challenge of the server) and for the calls (header sent up front).
UtilisateurUsernameAUTH_USERNAME "username" Authentification requise ? ou Utiliser le NTLM cochéNeed authentication? or Use NTLM checked Compte sur le service.Account on the service.
Mot de passePasswordAUTH_PASSWORD "password" Authentification requise ? ou Utiliser le NTLM cochéNeed authentication? or Use NTLM checked Une valeur entre guillemets est chiffrée dans le code généré ; une expression est reprise telle quelle.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 Proxy HTTP propre au composant, pour le WSDL et les appels, avec son identifiant (voir Proxy authentifié).HTTP proxy of the component itself, for the WSDL and the calls, with its credentials (see Authenticated proxy).
Hôte du proxyProxy hostPROXY_HOST "127.0.0.1" Utiliser un proxy http cochéUse http proxy checked Nom ou adresse du proxy.Name or address of the proxy.
Port du proxyProxy portPROXY_PORT 8080 Utiliser un proxy http cochéUse http proxy checked Un entier (int).An integer (int).
Utilisateur(trice) du proxyProxy userPROXY_USERNAME "" Utiliser un proxy http cochéUse http proxy checked Compte du proxy ; vide, les appels portent quand même un en-tête Proxy-Authorization: Basic Og== (identifiant vide).Account of the proxy; empty, the calls still carry a Proxy-Authorization: Basic Og== header (empty credentials).
Mot de passe du proxyProxy passwordPROXY_PASSWORD "" Utiliser un proxy http cochéUse http proxy checked Mot de passe du proxy.Password of the proxy.
Serveur sécurisé avec SSL (utilisez le tSetKeystore plutôt que cette option)Trust server with SSL (Use tSetKeystore rather than this option)NEED_SSL_TO_TRUSTSERVER NonNo ToujoursAlways Pose javax.net.ssl.trustStore et son mot de passe pour toute la JVM, comme le conseille le libellé : un tSetKeystore fait la même chose de façon visible. D'après le modèle, le magasin de clés d'un tSetKeystore (javax.net.ssl.keyStore) sert aussi au composant, pour un certificat client (non essayé).Sets javax.net.ssl.trustStore and its password for the whole JVM, as the label advises: a tSetKeystore does the same visibly. According to the template, the key store of a tSetKeystore (javax.net.ssl.keyStore) is also used by the component, for a client certificate (not tried).
Fichier TrustStoreTrustStore fileSSL_TRUSTSERVER_TRUSTSTORE "C:/clientTrustStore.trustStore" Serveur sécurisé avec SSL cochéTrust server with SSL checked Magasin du certificat du serveur ; un JKS a été lu.Store of the certificate of the server; a JKS was read.
Mot de passe du TrustStoreTrustStore passwordSSL_TRUSTSERVER_PASSWORD "password" Serveur sécurisé avec SSL cochéTrust server with SSL checked Mot de passe du magasin.Password of the store.
Arrêter en cas d'erreurDie on errorDIE_ON_ERROR OuiYes ToujoursAlways Ne concerne que l'appel (faute SOAP, délai, connexion). Décochée, l'appel en échec donne une ligne aux colonnes nulles (voir Pièges). La lecture du WSDL, elle, est hors de cette reprise dans le modèle : elle arrête le job.Only concerns the call (SOAP fault, timeout, connection). Unchecked, the failed call gives a row with null columns (see Pitfalls). Reading the WSDL is outside that handling in the template: it stops the job.

Paramètres avancésAdvanced settings

ParamètreSetting DéfautDefault VisibleShown Description
Dossier temporaire (pour wsdl2java)Temporary folder (for wsdl2java)TMPPATH videempty ToujoursAlways Où le job copie le WSDL et ses schémas (wsdl<horodatage>…) ; vide : java.io.tmpdir. Les copies sont effacées à la fin de la JVM : aucune n'est restée après nos essais.Where the job copies the WSDL and its schemas (wsdl<timestamp>…); empty: java.io.tmpdir. The copies are deleted at the end of the JVM: none was left after our runs.

L'éditeurThe editor

Trois onglets. Les éléments de la requête et de la réponse s'écrivent en chemins : la partie du message (parameters), puis ses éléments (parameters.customer.name) ; un élément répété porte un indice (customer[*] pour tous, customer[0] pour le premier).Three tabs. The elements of the request and of the response are written as paths: the part of the message (parameters), then its elements (parameters.customer.name); a repeated element carries an index (customer[*] for all, customer[0] for the first one).

WSDL

L'emplacement du WSDL, en Java : "http://server.example.com/customers?wsdl", "C:/services/customers.wsdl" (bouton Parcourir) ou une variable de contexte. ⟳ (ou Entrée) lit le WSDL et ses imports ; le port et l'opération se choisissent dans les listes. Seules les opérations liées en SOAP 1.1 ou 1.2 sont proposées.The location of the WSDL, in Java: "http://server.example.com/customers?wsdl", "C:/services/customers.wsdl" (Browse button) or a context variable. ⟳ (or Enter) reads the WSDL and its imports; the port and the operation are chosen in the lists. Only the operations bound in SOAP 1.1 or 1.2 are offered.

Correspondance d'entréeInput mapping

À gauche les colonnes d'entrée, à droite Expression / Élément. L'opération choisie donne une ligne par partie (parameters) ; sélectionnez-la et ajoutez ses sous-éléments avec + (indice des tableaux réglable). Glissez une colonne sur l'expression (row1.id) ou écrivez du Java. Normaliser enveloppe l'expression dans normalize(…,";") : un texte découpé en liste, pour un élément répété. Auto map relie les colonnes de même nom.On the left the input columns, on the right Expression / Element. The chosen operation gives one row per part (parameters); select it and add its sub-elements with + (array index can be set). Drag a column onto the expression (row1.id) or write Java. Normalize wraps the expression in normalize(…,";"): a text split into a list, for a repeated element. Auto map connects the columns with the same name.

Correspondance de sortieOutput mapping

À gauche les éléments de la réponse retenus (+ pour en ajouter), à droite Expression / Colonne / Type. Créer le schéma d'après la réponse crée une colonne par élément simple de la réponse, typée d'après le WSDL (String pour un élément répété). Dénormaliser enveloppe l'expression dans denormalize(…,";") : une liste jointe en texte.On the left the response elements kept (+ to add some), on the right Expression / Column / Type. Create the schema from the response creates one column per simple element of the response, typed from the WSDL (String for a repeated element). Denormalize wraps the expression in denormalize(…,";"): a list joined into text.

Pour l'opération getCustomer du service d'essai, l'éditeur a écrit ces paramètres cachés (extrait) :For the getCustomer operation of the test service, the editor wrote these hidden settings (excerpt):

ENDPOINT     = "http://127.0.0.1:8186/customers?wsdl"
METHOD       = getCustomer(parameters):Customer
PORT_NAME    = CustomerPort
SERVICE_NAME = CustomerService
SERVICE_NS   = http://example.com/customers
INPUT_PARAMS  : row1.id → parameters.id
OUTPUT_PARAMS : parameters.customer.id → id, parameters.customer.name → name, parameters.customer.city → city

Lecture du WSDL par l'éditeurReading of the WSDL by the editor

À partir de Talaxie 9.0.7, l'éditeur lit le WSDL comme le Studio, avec les réglages de l'onglet Composant : Authentification requise ? (Basic, pas avec NTLM), Utiliser un proxy http et son compte, Sécuriser le serveur avec SSL (TrustStore JKS ou PKCS12 et son mot de passe). L'emplacement peut joindre chaînes et variables de contexte par + ("http://" + context.hote + "/customers?wsdl"), évaluées avec le contexte par défaut.From Talaxie 9.0.7, the editor reads the WSDL like the Studio, with the settings of the Component tab: Need authentication? (Basic, not with NTLM), Use http proxy and its account, Trust server with SSL (JKS or PKCS12 TrustStore and its password). The location can join strings and context variables with + ("http://" + context.host + "/customers?wsdl"), evaluated with the default context.

Jusqu'à Talaxie 9.0.6, l'éditeur lisait le WSDL sans ces réglages : un WSDL protégé par Basic donnait status code 401 ; un WSDL en HTTPS dont le certificat n'est pas reconnu par le système, invalid peer certificate ; une concaténation n'était pas évaluée. Parade pour ces versions : enregistrer le WSDL dans un fichier et donner ce fichier (exemple WSDL dans un fichier). Le job lui-même, à l'exécution, a toujours utilisé ces réglages.Up to Talaxie 9.0.6, the editor read the WSDL without these settings: a WSDL protected by Basic gave status code 401; an HTTPS WSDL whose certificate the system does not recognize, invalid peer certificate; a concatenation was not evaluated. Workaround for these versions: save the WSDL to a file and give that file (example WSDL in a file). The job itself, at run time, has always used these settings.

ExemplesExamples

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 ; son WSDL est à http://127.0.0.1:8186/customers?wsdl (opérations getCustomer, findCustomers, listNames, hello, add ; clients 1 à 3). Composants réglés par l'éditeur ; le tJava relié par On Subjob Ok affiche :Outputs copied from runs of the jobs (started from Talaxie, Java 21) against a test SOAP service installed on the machine; its WSDL is at http://127.0.0.1:8186/customers?wsdl (operations getCustomer, findCustomers, listNames, hello, add; customers 1 to 3). Components set with the editor; the tJava connected with On Subjob Ok prints:

System.out.println("tJava_1: NB_LINE = " + globalMap.get("tWebService_1_NB_LINE") + ", ERROR_MESSAGE = " + globalMap.get("tWebService_1_ERROR_MESSAGE"));

Un appel par ligneOne call per row

row1 (Main)row2 (Main)OnSubjobOktFixedFlowInput_1tWebService_1tLogRow_1tJava_1

Deux lignes, id = 1, 2 ; opération getCustomer, row1.id → parameters.id, schéma créé d'après la réponse (id Integer, name, city).Two rows, id = 1, 2; getCustomer operation, row1.id → parameters.id, schema created from the response (id Integer, name, city).

1|Ada Martin|Paris
2|Grace Petit|Lyon
tJava_1: NB_LINE = null, ERROR_MESSAGE = null

NB_LINE reste nul : voir Variables globales.NB_LINE stays null: see Global variables.

Deux paramètres, sans flux d'entréeTwo parameters, no incoming flow

Opération add, expressions 20 → parameters.a et 22 → parameters.b, colonne sum :add operation, expressions 20 → parameters.a and 22 → parameters.b, sum column:

42

Le job a d'abord lu le WSDL (GET /customers?wsdl), puis envoyé :The job first read the WSDL (GET /customers?wsdl), then sent:

POST /customers HTTP/1.1
Content-Type: text/xml; charset=UTF-8
Accept: */*
SOAPAction: "urn:add"
User-Agent: Apache-CXF/3.5.5
Cache-Control: no-cache
Pragma: no-cache
Host: 127.0.0.1:8186
Connection: keep-alive
Content-Length: 261

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><ns1:add xmlns:ns1="http://example.com/customers"><a xmlns="http://example.com/customers">20</a><b xmlns="http://example.com/customers">22</b></ns1:add></soap:Body></soap:Envelope>

Une réponse à éléments répétésA response with repeated elements

Opération findCustomers (une liste de clients), trois lignes, city = Paris, Lyon, Nantes. Schéma créé d'après la réponse : les chemins parameters.customer[*].id, …name, …city, en colonnes String.findCustomers operation (a list of customers), three rows, city = Paris, Lyon, Nantes. Schema created from the response: the paths parameters.customer[*].id, …name, …city, as String columns.

[1, 3]|[Ada Martin, Linus Morel]|[Paris, Paris]
[2]|[Grace Petit]|[Lyon]
||

Chaque colonne reçoit la liste des valeurs, affichée entre crochets. Nantes n'a aucun client : la ligne sort quand même, toutes colonnes nulles. Avec Dénormaliser, colonne names = denormalize(parameters.customer[*].name,";") (Paris, Lyon) :Each column receives the list of values, displayed in brackets. Nantes has no customer: the row still comes out, all columns null. With Denormalize, column names = denormalize(parameters.customer[*].name,";") (Paris, Lyon):

Ada Martin;Linus Morel
Grace Petit

Avec des indices, first = parameters.customer[0].name et second = parameters.customer[1].name (Paris) :With indexes, first = parameters.customer[0].name and second = parameters.customer[1].name (Paris):

Ada Martin|Linus Morel

Une ligne par appel, jamais une par élément : pour une ligne par client, découpez ensuite la liste dénormalisée (tNormalize).One row per call, never one per element: for one row per customer, split the denormalized list afterwards (tNormalize).

Une faute SOAPA SOAP fault

Trois lignes, id = 1, 99, 3 ; le client 99 est inconnu et le service répond par une faute. Arrêter en cas d'erreur cochée (défaut ; nom du job remplacé par MyJob, pile abrégée) :Three rows, id = 1, 99, 3; customer 99 is unknown and the service answers with a fault. Die on error checked (default; job name replaced with MyJob, shortened stack):

1|Ada Martin|Paris
Exception in component tWebService_1 (MyJob)
org.apache.cxf.binding.soap.SoapFault: Unknown customer 99
	at org.apache.cxf.binding.soap.interceptor.Soap11FaultInInterceptor.unmarshalFault(Soap11FaultInInterceptor.java:87)
	…

Le job s'arrête avec le code 1, la troisième ligne n'est pas appelée. Case décochée :The job stops with code 1, the third row is not called. Box unchecked:

1|Ada Martin|Paris
||
3|Linus Morel|Paris
tJava_1: NB_LINE = null, ERROR_MESSAGE = Unknown customer 99
Unknown customer 99

L'appel en échec donne une ligne aux colonnes nulles ; le message de la faute est écrit sur la sortie d'erreur sans retour à la ligne, si bien qu'il est apparu à la fin du job. ERROR_MESSAGE le garde. Le job se termine avec le code 0.The failed call gives a row with null columns; the message of the fault is written to the error output without a line break, so it appeared at the end of the job. ERROR_MESSAGE keeps it. The job ends with code 0.

Authentification BasicBasic authentication

WSDL http://127.0.0.1:8186/secure/customers?wsdl, protégé comme le service (demo / demo), une ligne id = 1 :WSDL http://127.0.0.1:8186/secure/customers?wsdl, protected like the service (demo / demo), one row id = 1:

1|Ada Martin|Paris
tJava_1: NB_LINE = null, ERROR_MESSAGE = null

Le WSDL a été demandé deux fois (401, puis avec Authorization) ; l'appel portait Authorization: Basic ZGVtbzpkZW1v d'emblée. Avec un mot de passe faux, le message trompe : la page d'erreur 401 a été lue comme un WSDL.The WSDL was requested twice (401, then with Authorization); the call carried Authorization: Basic ZGVtbzpkZW1v up front. With a wrong password, the message misleads: the 401 error page was read as a WSDL.

[Fatal Error] customers?wsdl:1:1: Contenu non autorisé dans le prologue.
Exception in component tWebService_1 (MyJob)
javax.wsdl.WSDLException: WSDLException: faultCode=PARSER_ERROR: Problem parsing 'http://127.0.0.1:8186/secure/customers?wsdl'.: org.xml.sax.SAXParseException: Contenu non autorisé dans le prologue.
	…

Délai de réponseReceive timeout

Opération hello avec le nom "slow", à laquelle le service d'essai répond au bout de 6 s ; Délai avant réponse du serveur 2 (pile abrégée) :hello operation with the name "slow", which the test service answers after 6 s; Receive Time out 2 (shortened stack):

Exception in component tWebService_1 (MyJob)
org.apache.cxf.interceptor.Fault: Could not receive Message.
	…
Caused by: java.net.SocketTimeoutException: SocketTimeoutException invoking http://127.0.0.1:8186/customers: Read timed out
	…

Proxy authentifiéAuthenticated proxy

Utiliser un proxy http : un proxy d'essai sur le poste qui exige proxyuser / proxypass. Opération hello avec "Ada" :Use http proxy: a test proxy on the machine that requires proxyuser / proxypass. hello operation with "Ada":

Hello, Ada!
tJava_1: NB_LINE = null, ERROR_MESSAGE = null

Journal du proxy : WSDL demandé deux fois (407, puis avec Proxy-Authorization: Basic cHJveHl1c2VyOnByb3h5cGFzcw==), appel envoyé avec cet en-tête d'emblée. Le job était lancé avec -Dhttp.nonProxyHosts=, Java ne passant pas par un proxy pour 127.* par défaut.Proxy log: WSDL requested twice (407, then with Proxy-Authorization: Basic cHJveHl1c2VyOnByb3h5cGFzcw==), call sent with that header up front. The job was started with -Dhttp.nonProxyHosts=, as Java does not go through a proxy for 127.* by default.

WSDL dans un fichier, HTTPSWSDL in a file, HTTPS

WSDL "C:/services/customers.wsdl" (copie locale, chemin remplacé ; le service reste celui de son soap:address), opération hello :WSDL "C:/services/customers.wsdl" (local copy, path replaced; the service stays the one of its soap:address), hello operation:

Hello, Ada!
tJava_1: NB_LINE = null, ERROR_MESSAGE = null

Même résultat avec le WSDL en HTTPS (https://127.0.0.1:8543/customers?wsdl, certificat d'essai) et Serveur sécurisé avec SSL réglé sur un TrustStore JKS qui le contient.Same result with the WSDL over HTTPS (https://127.0.0.1:8543/customers?wsdl, test certificate) and Trust server with SSL set to a JKS TrustStore that holds it.

Les erreursErrors

CasCaseMessageArrêter en cas d'erreur décochéeDie on error unchecked
Faute SOAPSOAP faultorg.apache.cxf.binding.soap.SoapFault: suivi du texte de la fauteorg.apache.cxf.binding.soap.SoapFault: followed by the text of the faultligne nulle, job continuenull row, job goes on
Délai de réponse dépasséReceive timeout exceededorg.apache.cxf.interceptor.Fault: Could not receive Message.de mêmethe same
Rien n'écoute à l'adresse du serviceNothing listens at the address of the serviceorg.apache.cxf.interceptor.Fault: Could not send Message., cause java.net.ConnectException: … Connection refused: getsockoptorg.apache.cxf.interceptor.Fault: Could not send Message., cause java.net.ConnectException: … Connection refused: getsockoptde mêmethe same
WSDL protégé, mot de passe fauxProtected WSDL, wrong passwordjavax.wsdl.WSDLException: WSDLException: faultCode=PARSER_ERROR: Problem parsing '…'arrêt du job : la lecture du WSDL n'est pas concernée par la casejob stops: reading the WSDL is not concerned by the box

Variables globalesGlobal variables

VariableTypeDescription
NB_LINEIntegerNombre de lignes. Déclarée par le composant mais jamais remplie par son modèle : elle valait null dans tous nos essais. Comptez les lignes du lien de sortie (tLogRow_1_NB_LINE, par exemple).Number of line. Declared by the component but never filled by its template: it was null in all our runs. Count the rows of the output link (tLogRow_1_NB_LINE, for example).
ERROR_MESSAGEStringMessage de la dernière erreur d'appel ; il reste après un appel suivant réussi.Message of the last call error; it stays after a following successful call.
((String) globalMap.get("tWebService_1_ERROR_MESSAGE"))

PiègesPitfalls

Une erreur ignorée donne une ligne videAn ignored error gives an empty row

Arrêter en cas d'erreur décochée, l'appel en échec produit quand même sa ligne de sortie, toutes colonnes nulles, sans rien qui la distingue d'une réponse vide. Testez une colonne obligatoire de la réponse (row2.id == null) ou ERROR_MESSAGE, ou laissez la case cochée et reprenez l'erreur par On Component Error.Die on error unchecked, the failed call still produces its output row, all columns null, with nothing to tell it from an empty response. Test a mandatory column of the response (row2.id == null) or ERROR_MESSAGE, or keep the box checked and take the error over with On Component Error.

Les colonnes d'entrée sont perduesThe input columns are lost

La ligne de sortie ne contient que le schéma de sortie, rempli par la réponse : l'id envoyé n'y est que si la réponse le renvoie. Pour garder une colonne d'entrée, faites passer le flux par un tMap avant l'appel et rapprochez ensuite, ou faites renvoyer la clé par le service.The output row only holds the output schema, filled by the response: the id sent is only there if the response returns it. To keep an input column, route the flow through a tMap before the call and join afterwards, or have the service return the key.

Le WSDL est relu à chaque exécutionThe WSDL is read at every run

Au début du composant, le job télécharge le WSDL puis prépare son client : il doit être joignable au moment du lancement, et un WSDL modifié change la requête sans que le job le sache. Une copie locale du WSDL fige le contrat ; l'adresse appelée reste celle de son soap:address.At the start of the component, the job downloads the WSDL then prepares its client: it must be reachable at launch time, and a changed WSDL changes the request without the job knowing. A local copy of the WSDL freezes the contract; the called address stays the one of its soap:address.

Le séparateur de normalize est une expression régulièreThe separator of normalize is a regular expression

normalize(row1.ids,";") découpe par String.split : un séparateur "|" ou "." se lit comme une expression régulière et découpe chaque caractère. Écrivez "\\|". denormalize joint, lui, avec le texte tel quel.normalize(row1.ids,";") splits with String.split: a "|" or "." separator is read as a regular expression and splits every character. Write "\\|". denormalize joins with the text as is.

Voir aussiSee also