Saltar al contenido

Actividad de solicitud SOAP de API

Introducción

Una actividad de API Solicitud SOAP, que utiliza su conexión API preconfigurada, recupera datos cuando los llama una API personalizada de API Manager y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

La actividad de API Solicitud SOAP solo se puede configurar mediante un esquema WSDL. Para interactuar con una conexión de API mediante un esquema JSON, XML, CSV o XSD, utilice una actividad de Solicitud de API que no sea SOAP ) en su lugar. Para interactuar con una conexión SOAP sin usar una API personalizada, utilice el conector SOAP.

Para obtener información sobre la relación entre las actividades del conector API y las APIs de API Manager, consulte estos recursos:

Crear una actividad de solicitud SOAP de API

Se crea una instancia de una actividad de API Solicitud SOAP a partir de la conexión API preconfigurada utilizando su tipo de actividad Solicitud SOAP.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño de tela de diseño o cópielo y péguelo en él. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad de API Solicitud SOAP existente desde estas ubicaciones:

Configurar una actividad de solicitud SOAP de API

Siga estos pasos para configurar una actividad de API Solicitud SOAP:

Paso 1: Ingrese un nombre y especifique la configuración

En este paso, asigne un nombre a la actividad y seleccione el método para cargar el esquema WSDL. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

Paso 1 de configuración de la actividad de solicitud SOAP de API

  • Nombre: Introduzca un nombre para identificar la actividad. El nombre debe ser único para cada actividad de API Solicitud SOAP y no debe contener barras diagonales. /o dos puntos :.

  • Subir URL, Subir archivo o Seleccionar existente: Use el botón de opción para seleccionar la fuente del archivo WSDL que desea subir o reutilizar. Se pueden subir archivos de hasta 5 MB.

    • Subir URL: Introduce la URL del archivo WSDL en el cuadro de texto y haz clic en Subir. La URL debe ser accesible sin autenticación; de lo contrario, recibirás un error en tiempo de ejecución. Si subes un WSDL con el mismo nombre que uno existente, consulta Posibles errores más adelante en esta página.

    • Subir archivo: Haga clic en Explorar (a la derecha) para buscar un archivo WSDL o ZIP. Si proporciona un archivo ZIP, debe contener un solo archivo WSDL (aunque puede contener cualquier archivo XSD del que dependa el WSDL). Luego, haga clic en Subir.

      Nota

      Cualquiera schemaLocation Debe resolverse a un archivo local mediante una referencia relativa. Esto suele significar que, en lugar de proporcionar una tupla como:

      xsi:schemaLocation='http://schemas.xmlsoap.org/wsdl/mime/ http://ws-i.org/profiles/basic/1.1/wsdlmime-2004-08-24.xsd'

      Usted proporcionaría:

      xsi:schemaLocation='http://schemas.xmlsoap.org/wsdl/mime/ wsdlmime-2004-08-24.xsd'

      En el ejemplo anterior, el archivo XSD wsdlmime-2004-08-24.xsd se encuentra en el mismo directorio o en una ruta relativa al WSDL que se está cargando.

    • Seleccionar existente: Utilice el menú desplegable para seleccionar un archivo WSDL existente que se haya utilizado previamente en el proyecto actual.

  • Puerto: Utilice el menú desplegable para seleccionar el puerto apropiado.

  • Servicio y enlace: De forma predeterminada, estos campos se completan automáticamente en función del WSDL y el puerto proporcionados y no se pueden editar.

  • Operación: Utilice el menú desplegable para seleccionar el método del WSDL proporcionado que desea ejecutar con esta actividad.

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo:

Paso 2 de configuración de la actividad de solicitud SOAP de API

  • Esquemas de datos: Se muestran los esquemas de solicitud y respuesta para esta actividad. Estos esquemas de datos, heredados por transformaciones adyacentes, se muestran nuevamente durante el mapeo de transformación.

  • Atrás: Haga clic para guardar temporalmente la configuración de este paso y volver al paso anterior.

  • Finalizado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Posibles errores

Las siguientes secciones abordan los errores que pueden ocurrir durante la configuración de la actividad.

No se puede cargar WSDL

Al reemplazar un WSDL volviendo a cargar uno con el mismo nombre mediante Cargar URL o Cargar archivo, y las operaciones del WSDL de reemplazo no tienen el mismo nombre que las que utilizan las actividades existentes, o si faltan operaciones WSDL en uso en el WSDL de reemplazo, puede ocurrir este error:

Este WSDL no se puede reemplazar porque faltan operaciones WSDL utilizadas por actividades existentes. Elimine estas actividades de la pestaña Componentes del panel del proyecto y vuelva a intentarlo.

Para resolverlo, asegúrese de que las operaciones WSDL tengan el mismo nombre que las que utilizan actualmente las actividades existentes.

No se pudo desplegar

Al desplegar una operación cuyo archivo WSDL de la actividad Solicitud SOAP ha sido reemplazado, es posible que reciba este error:

Error en la desplegar - Error del cliente: No hay ningún archivo cargado con la ruta del cliente... Actualice a Studio 8.4.0 o superior e desplegar el proyecto nuevamente.

Para resolverlo, siga estos pasos:

  1. Abra la actividad donde se ha reemplazado el archivo WSDL.

  2. En el paso 1, vuelva a seleccionar el archivo WSDL que se usará para la actividad y haga clic en Siguiente.

  3. En el paso 2, haga clic en Finalizar.

  4. Desplegar la operación.

Próximos pasos

Después de configurar una actividad de API Solicitud SOAP, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de la operación, lo que incluye la posibilidad de encadenar operaciones que se encuentren en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para más detalles, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades de API Solicitud SOAP se pueden usar como objetivo con estos patrones de operación:

Cuando esté listo, desplegar la operación y validar el comportamiento comprobando los registros de operación.

Nota

Las operaciones con una actividad de API Solicitud SOAP como su primer etapa de operación no se pueden ejecutar manualmente mediante las operación Desplegar y ejecutar o Ejecutar. En cambio, estas operaciones requieren datos que se proporcionan al realizar una llamada a la API mediante una API personalizada creada a través del API Manager. Se puede llamar a una API desde una aplicación o, si la API admite GET, puede pegar la URL en un navegador web para consumir la API manualmente.

Importante

De forma predeterminada, las operaciones exitosas configuradas para una API personalizada no están incluidos en los registros de operación a menos que una de estas configuraciones esté habilitada:

Las operaciones fallidas se incluyen en los registros de operación independientemente de si las configuraciones anteriores están habilitadas o no.

Configurar una API personalizada de API Manager

Una vez configurada e implementada la operación, configurar una API personalizada usando API Manager.

Nota

Después de haber configurado una API personalizada para llamar a una operación de Integration Studio, no puede eliminar la operación sin eliminar la API o cambiar la configuración de la API para que ya no llame a la operación.