Actividad Solicitud SOAP API en Jitterbit Studio

Introducción

Una actividad Solicitud SOAP API, usando su conexión API preconfigurada, recupera datos cuando es llamada por una API personalizada de API Manager y está pensada para usarse como destino para consumir datos en una operación.

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

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

• Tipos de API de API Manager

• Configuración de API personalizada

• Crear una API personalizada simple

Crear una actividad Solicitud SOAP API

Se crea una instancia de una actividad Solicitud SOAP API desde la conexión API preconfigurada usando su tipo de actividad Solicitud SOAP.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

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

• El lienzo de diseño (consulta Menú de acciones de componentes en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (consulta Menú de acciones de componentes en Pestaña Componentes del panel del proyecto).

Configurar una actividad Solicitud SOAP API

Sigue estos pasos para configurar una actividad Solicitud SOAP API:

• Paso 1: Ingresa un nombre y especifica la configuración
  Proporciona un nombre para la actividad y selecciona el método a usar para cargar el esquema WSDL.

• Paso 2: Revisa los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta generados desde el punto de conexión.

Paso 1: Ingresa un nombre y especifica la configuración

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

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

• Cargar URL, Cargar archivo o Seleccionar existente: Usa el botón de opción para seleccionar la fuente del archivo WSDL a cargar o reutilizar. Se pueden cargar archivos de hasta 5 MB de tamaño.

  • Cargar URL: Ingresa la URL del archivo WSDL en el cuadro de texto y luego haz clic en Cargar. La URL debe ser accesible sin autenticación. Si la URL requiere autenticación o no devuelve un archivo WSDL válido, Studio muestra un error al cargar (consulta Requisitos de carga de WSDL). Si cargas un WSDL con el mismo nombre que uno existente, consulta Posibles errores más adelante en esta página.

  • Cargar archivo: Haz clic en Examinar (ubicado a la derecha) para buscar localmente un archivo WSDL o ZIP. Un archivo ZIP puede contener archivos XSD de los que depende el WSDL. Si el archivo ZIP contiene más de un archivo WSDL, selecciona el WSDL raíz cuando se le solicite. Luego haz clic en Cargar. Si la carga muestra un error de validación, consulta Requisitos de carga de WSDL.

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

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

• Servicio y Vinculación: Por defecto, estos campos se completan automáticamente según el WSDL y puerto proporcionados y no se pueden editar.

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

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

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

• Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide confirmar que deseas descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran los esquemas de solicitud o respuesta generados a partir del punto de conexión:

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

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

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

• Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide confirmar que deseas descartar los cambios.

Posibles errores

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

No se puede cargar el WSDL

Cuando se reemplaza un WSDL cargando uno nuevo con el mismo nombre usando Cargar URL o Cargar archivo, y las operaciones del WSDL de reemplazo no tienen los mismos nombres que los utilizados por las actividades existentes, o si las operaciones WSDL en uso faltan en el WSDL de reemplazo, puede ocurrir este error:

Para resolver, asegúrate de que las operaciones WSDL tengan los mismos nombres que las que actualmente están en uso por las actividades existentes.

Error en la implementación

Cuando implementas una operación cuyo archivo WSDL de la actividad Solicitud SOAP ha sido reemplazado, puedes recibir este error:

Error en la implementación - Error de cliente: No hay ningún archivo cargado con ruta de cliente ... Actualiza a Studio 8.4.0 o superior e implementa el proyecto nuevamente.

Para resolver, sigue estos pasos:

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

2. En el paso 1, vuelve a seleccionar el archivo WSDL a utilizar para la actividad y luego haz clic en Siguiente.

3. En el paso 2, haz clic en Finalizado.

4. Implementa la operación.

Si en su lugar recibes Error en la implementación - Error interno: Sin WSDL con localizador, consulta Error de implementación SOAP: "Sin WSDL con localizador" en la guía de solución de problemas de Connector.

Próximos pasos

Después de configurar una actividad SOAP Request de API, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar los parámetros de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

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

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

• Patrón de archivo
• Patrón de transformación
• Patrón de archivo de dos destinos (solo como primer origen)
• Patrón de archivo HTTP de dos destinos (solo como primer origen)
• Patrón de dos transformaciones (solo como primer origen)

Cuando esté listo, implementa la operación y valida el comportamiento verificando los registros de operación.

Configurar una API personalizada de API Manager

Una vez que la operación esté configurada e implementada, configura una API personalizada mediante API Manager.