Orígenes de datos desde servicios web SOAP/xml

Orígenes de datos desde servicios web SOAP/xml

Resumen

El conector a servicios web SOAP/xml permite recolectar datos desde un servicio SOAP, o configurar acciones de escritura, para luego crear vistas de datos y exponerlas en métodos de su API. Admite SOAP 1.1 y SOAP 1.2, importa la operación desde el WSDL y acepta autenticación con credenciales o con certificado (mTLS).

Antes de comenzar

  • Tenga a mano la URL del servicio y su WSDL. En general se obtiene agregando ?wsdl al endpoint.
  • Sepa qué versión de SOAP usa el servicio: el WSDL la declara en el binding. SOAP 1.1 envía text/xml con la cabecera SOAPAction; SOAP 1.2 envía application/soap+xml.

Configurar la solicitud

Elegir el tipo de origen y la versión

Desde Orígenes de datos > Nuevo origen de datos, elija Desde servicio web y luego la pestaña SOAP/XML. A la izquierda de la URL está el selector de versión, SOAP 1.1 o SOAP 1.2; elija la que declara el WSDL. Ingrese la URL del endpoint.

Importar desde WSDL

Haga clic en Importar desde WSDL y elija cómo entregarlo: Usar url, Pegar XML o Subir archivo (.xml o .wsdl). La plataforma completa la operación y los parámetros. Importar body hace lo mismo a partir de un sobre SOAP de ejemplo.

Operación

En la pestaña Operación complete, si no los importó:

  • Método: el nombre de la operación, la etiqueta que va dentro de Body.
  • Espacio de nombres: el xmlns del método.
  • SOAPAction: el valor que exige el servicio en SOAP 1.1; en SOAP 1.2 suele quedar vacío.

Parámetros

Son las etiquetas dentro del método: el nombre de la etiqueta es el nombre del parámetro y su contenido, el valor. Puede marcarlos como editables para exponerlos en el método de la API, o dejarlos fijos. Para un parámetro que contiene una lista de valores, ingrese la etiqueta superior como nombre y los valores con la estructura LIST({"VALOR1","VALOR2"}).

Pestaña Parámetros de la solicitud SOAP con un parámetro editable

Autorización

Si el servicio pide credenciales, marque Agregue credenciales para autenticarse al servicio web e ingrese usuario y contraseña, respetando mayúsculas y minúsculas. Si el servicio exige certificado de cliente, marque mTLS / Certificado SSL, elija el Protocolo TLS (TLS v1.2 por defecto) y cargue la Llave PKCS12 con su contraseña. Tenga en cuenta que algunos servicios SOAP esperan el usuario y la contraseña como parámetros de la operación, no como credenciales HTTP.

Pestaña Autorización con las credenciales del servicio web

Procesar la respuesta

Probar

Haga clic en Probar. La respuesta tiene que ser un XML válido. Por defecto la tabla se toma del elemento NewDataSet; si el servicio devuelve otra estructura, indique la ruta.

Ruta a los datos

Indique con XPath el nodo que contiene las filas, por ejemplo /bookstore/book. Cada nodo hijo se convierte en una fila y sus elementos, en columnas. Con Previsualizar confirma que la tabla es la esperada antes de continuar.

Resultado esperado

Al guardar, el origen queda en estado Borrador con la operación, los parámetros y la autorización configurados. Al crear una vista sobre él, los parámetros editables aparecen como parámetros de la vista y del método.

Errores frecuentes

  • El servicio responde un Fault de versión: la versión elegida no coincide con el binding del WSDL. Cambie entre SOAP 1.1 y SOAP 1.2.
  • La respuesta llega pero la tabla queda vacía: los datos no están en NewDataSet. Complete la ruta a los datos con XPath.
  • 401 o 403 al probar: credenciales incorrectas, o el servicio las espera como parámetros de la operación.

Artículos relacionados