Skip to main content

Chiamata SOAP

Chiamata SOAP | Sybot Documentation

Chiamata SOAP

  • Task type: soap-call

Descrizione​

Il task "Chiamata SOAP" permette di eseguire una richiesta a un servizio web basato sul protocollo SOAP. Il task gestisce automaticamente la costruzione dell'intervallo XML (Envelope) e il parsing dei messaggi di errore (Fault) restituiti dal server.

soap_call_v2_config.png

Parametri di Configurazione

  • Connessione SSL: Specifica se la chiamata deve utilizzare il protocollo SSL (si / no).
  • Proxy: Configurazione per l'instradamento della chiamata:
  • Impostazione di Sistema: Utilizza le impostazioni proxy predefinite del sistema.
  • No Proxy: Nessun proxy utilizzato.
  • Proxy Personalizzato: Consente l'inserimento di un indirizzo specifico nel campo dedicato.
  • Endpoint: L'URL completo del servizio web SOAP da interrogare. (es. https://www.dataaccess.com/webservicesserver/NumberConversion.wso).
  • Namespace: L'URI del namespace XML da associare al prefisso ns all'interno del corpo della richiesta. Inserire l’intera dichiarazione, inclusi xmlns:ns= e il namespace tra virgolette. (es. xmlns:ns="http://www.dataaccess.com/webservicesserver/").
  • Header: Inserire il tag <soap:Header> nel messaggio SOAP. Se non ci sono dati da includere, usare <soap:Header/>. Se il servizio richiede informazioni (es. token di autorizzazione), inserirle all’interno del tag:
<soap:Header>
 <auth:Token>ABC123XYZ</auth:Token>
</soap:Header>```
  • Body: Inserire il tag <soap:Body> contenente i dati della chiamata (es. <soap:Body><ns:Metodo>...</ns:Metodo></soap:Body>).

Note Tecniche Importanti​

  • Envelope: Non deve essere inserito il tag </soap:Envelope>. Il task genera automaticamente l'header XML e l'apertura/chiusura dell'Envelope.
  • Content-Type: Il task utilizza esclusivamente text/xml; charset=utf-8 come Content-Type predefinito e non è modificabile.

Parametri di Output

Il task espone i seguenti parametri una volta ricevuta la risposta dal server:

  • result: Restituisce un messaggio testuale che descrive l’esito dell’operazione.
  • response: Contiene l'intero XML di risposta inviato dal server in caso di successo.
  • faultCode: Restituisce il codice di errore SOAP (es. soap:Server o soap:Client) se la chiamata fallisce.
  • faultString: Restituisce la descrizione testuale dell'errore fornita dal servizio web.
  • exitStatus: Codice di stato dell'operazione (0 indica successo).
  • resultJson: Rappresentazione completa dell'esecuzione del task in formato JSON.

Esempio resultJson

{
 "id": 19213,
 "name": "SOAP Call",
 "type": "soap-call",
 "type_name": "Chiamata SOAP",
 "type_description": "Esegue una chiamata SOAP",
 "config": {
 "body": "<soap:Body>\n <ns:NumberToWords>...\n</soap:Body>",
 "header": "<soap:Header/>",
 "endpoint": "https://www.dataaccess.com/webservicesserver/NumberConversion.wso",
 "namespace": "xmlns:ns=\"http://www.dataaccess.com/webservicesserver/\"",
 "output_links": [
 {
 "to": "[TASK 1906_19203_1]",
 "from": "[TASK 1906_19213_40]",
 "text": "Condizione 39",
 "color": "green",
 "points": [...],
 "toPort": "left4",
 "fromPort": "port_1906_19213_1",
 "isTraversed": true
 }
 ],
 "ssl_connection": "no"
 },
 "run_info": {
 "run_id": 1486648,
 "status": "Completed",
 "run_result": "Success",
 "result_text": "Chiamata Soap eseguita con successo",
 "start_datetime": "2026-04-07 14:06:32",
 "end_datetime": "2026-04-07 14:06:32"
 },
 "output_parameters": {
 "response": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<soap:Envelope>...\n</soap:Envelope>",
 "exitStatus": "0",
 "faultCode": "",
 "faultString": ""
 }
}

Gestione degli Errori

In caso di errore SOAP (presenza di un nodo <soap:Fault>), il task viene marcato come Failed. I dettagli dell'errore verranno mappati nei parametri faultCode e faultString, facilitando il debug o la gestione di rami condizionali nel workflow.