Saltar al contenido principal

Llamada SOAP

Configuración actual de la tarea Llamada SOAP en el Diseñador de Flujos de Trabajo
  • Tipo de tarea: soap-call

Descripción​

La tarea "Llamada SOAP" permite ejecutar una solicitud a un servicio web basado en el protocolo SOAP. La tarea gestiona automáticamente la construcción del intervalo XML (Envelope) y el análisis de los mensajes de error (Fault) devueltos por el servidor.

Parámetros de Configuración​

  • Conexión SSL: Especifica si la llamada debe utilizar el protocolo SSL (si / no).
  • Proxy: Configuración para el enrutamiento de la llamada:
  • Configuración del Sistema: Utiliza las configuraciones proxy predeterminadas del sistema.
  • Sin Proxy: No se utiliza ningún proxy.
  • Proxy Personalizado: Permite la inserción de una dirección específica en el campo dedicado.
  • Endpoint: La URL completa del servicio web SOAP a consultar. (ej. https://www.dataaccess.com/webservicesserver/NumberConversion.wso).
  • Namespace: El URI del namespace XML a asociar al prefijo ns dentro del cuerpo de la solicitud. Inserir la declaración completa, incluyendo xmlns:ns= y el namespace entre comillas. (ej. xmlns:ns="http://www.dataaccess.com/webservicesserver/").
  • Header: Insertar la etiqueta <soap:Header> en el mensaje SOAP. Si no hay datos para incluir, usar <soap:Header/>. Si el servicio requiere información (ej. token de autorización), insertarla dentro de la etiqueta:
<soap:Header>
 <auth:Token>ABC123XYZ</auth:Token>
</soap:Header>```
  • Body: Insertar la etiqueta <soap:Body> que contiene los datos de la llamada (ej. <soap:Body><ns:Metodo>...</ns:Metodo></soap:Body>).

Notas Técnicas Importantes​

  • Envelope: No debe insertarse la etiqueta </soap:Envelope>. La tarea genera automáticamente el encabezado XML y la apertura/cierre del Envelope.
  • Content-Type: La tarea utiliza exclusivamente text/xml; charset=utf-8 como Content-Type predeterminado y no es modificable.

Parámetros de Salida​

La tarea expone los siguientes parámetros una vez recibida la respuesta del servidor:

  • result: Devuelve un mensaje de texto que describe el resultado de la operación.
  • response: Contiene el XML de respuesta completo enviado por el servidor en caso de éxito.
  • faultCode: Devuelve el código de error SOAP (ej. soap:Server o soap:Client) si la llamada falla.
  • faultString: Devuelve la descripción textual del error proporcionada por el servicio web.
  • exitStatus: Código de estado de la operación (0 indica éxito).
  • resultJson: Representación completa de la ejecución de la tarea en formato JSON.

Ejemplo resultJson​

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

Manejo de Errores​

En caso de error SOAP (presencia de un nodo <soap:Fault>), la tarea se marca como Failed. Los detalles del error se mapearán en los parámetros faultCode y faultString, facilitando el depuración o la gestión de ramas condicionales en el flujo de trabajo.