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.

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

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

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.