Actividades SOAP

Introducción

Una actividad SOAP recupera datos de un extremo SOAP o los envía a este y está destinada a utilizarse como una fuente para proporcionar datos a una operación o como un destino para consumir datos en una operación. Las actividades específicas que están disponibles dependen de los métodos SOAP seleccionados durante la configuración de la conexión SOAP. Puede configurar tantas actividades SOAP como desee para cada conexión SOAP.

El uso que se le dé a la actividad como origen o destino en una operación depende del servicio web específico y de las estructuras de solicitud y respuesta, si están presentes. Para obtener más información sobre qué determina si una actividad se puede usar como origen o destino, consulte Partes de una operación en Creación y configuración de operaciones.

Crear una actividad SOAP

Una instancia de una actividad se crea a partir de una conexión utilizando un tipo de actividad.

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

Se puede editar una actividad existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).

Configurar una actividad SOAP

Siga estos pasos para configurar una actividad SOAP:

• Paso 1: Ingrese un nombre
• Paso 2: Revisar los esquemas de datos

Paso 1: Ingrese un nombre

• Nombre: Ingrese un nombre para identificar la actividad SOAP. Este campo se completa previamente con el nombre del método. Puede crear múltiples actividades utilizando el mismo método, pero el nombre debe ser único para cada actividad SOAP y no debe contener barras diagonales (/) o dos puntos (:).
• 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 almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado 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 solicitará que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

• Esquema de datos: Se muestran los esquemas de datos de la solicitud o la respuesta. Si la operación utiliza una transformación, los esquemas de datos se vuelven a mostrar más adelante durante la asignación de la transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

• Agregar complemento(s): Los complementos son aplicaciones proporcionadas por Jitterbit o por el usuario que amplían las capacidades nativas de Harmony. Para aplicar un complemento a la actividad, haga clic para expandir esta sección y seleccione la casilla de verificación junto al complemento que se utilizará. Para obtener instrucciones adicionales sobre el uso de complementos, incluidos detalles sobre cómo configurar las variables requeridas que utiliza el complemento, consulte Complementos agregados a una actividad.

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

• Terminado: 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 cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad SOAP, puede utilizarla dentro de una operación como se describe a continuación. También puede configurar la fragmentación de datos para dividir los datos en fragmentos más pequeños para su procesamiento. A continuación, también se describe un caso de uso especial sobre cómo manejar servicios SOAP que no requieren parámetros de solicitud.

Completar la operación

Después de configurar una actividad SOAP, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación de una operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Una vez que se ha creado una actividad SOAP, se puede acceder a las acciones del menú para esa actividad desde el panel del proyecto en las pestañas Flujos de trabajo o Componentes, y desde el tela de diseño. Consulte menú de acciones de la actividad para más detalles.

Las operaciones que utilizan actividades SOAP también pueden tener acciones de operación configuradas para activarse en caso de un error de SOAP (un error que resulta de un formato de mensaje incorrecto, procesamiento de encabezado o incompatibilidad). Las acciones de operación se pueden configurar para ejecutar una operación o enviar un correo después de que se produzca un error de SOAP. Para obtener instrucciones sobre cómo activar una acción en caso de un error de SOAP, consulte Acciones de operación.

Las operaciones que contienen una actividad SOAP solo pueden tener una actividad SOAP y no pueden contener ninguna NetSuite, Salesforce, Salesforce Service Cloud, SAP o ServiceMax actividades.

Cuando esté listo, desplegar y ejecute la operación y valide el comportamiento verificando los registros de operación.

Utilizado como fuente

Las actividades SOAP que se utilizan como fuente se pueden utilizar con estos patrones de operación:

• Patrón de Transformación
• Patrón de archivo de dos objetivos (como primera o segunda fuente)
• Patrón de archivo HTTP de dos destinos (solo como primera fuente)
• Patrón de dos transformaciones (como primera o segunda fuente)

Otros patrones no son válidos si se utilizan actividades SOAP como fuente.

Utilizado como objetivo

Las actividades SOAP que se utilizan como objetivo se pueden utilizar con estos patrones de operación:

• Patrón de Transformación
• Patrón de archivo de dos objetivos (solo como primer objetivo)
• Patrón de dos transformaciones (como primer o segundo objetivo)

Otros patrones no son válidos si se utilizan actividades SOAP como objetivo.

Normalmente, una operación que llama a un servicio web SOAP contiene dos transformaciones: la primera transforma los datos en una solicitud de servicio web y la segunda transforma los datos de una respuesta de servicio web a un sistema de destino. Este ejemplo utiliza una actividad SOAP en el patrón Two-transformation. En esta operación, una actividad de solicitud de API (Request) crea una estructura de solicitud que es recibida por la primera transformación (API a SOAP) y se pasa a una actividad SOAP (Verify Credit Card). La segunda transformación (SOAP a File Share) recibe la estructura de respuesta, que luego se escribe en un recurso compartido de archivos mediante una actividad de escritura de recurso compartido de archivos (Write Response):

Utilice fragmentación de datos

Muchas APIs de servicios web tienen limitaciones de tamaño. Si se encuentra con límites de registros impuestos por la API, puede utilizar la fragmentación de datos para dividir los datos de origen en varios fragmentos. Luego, la transformación se realiza en cada fragmento por separado, y cada fragmento de origen produce un fragmento de destino. Los fragmentos de destino resultantes se combinan para producir el destino final.

Para obtener instrucciones y prácticas recomendadas sobre el uso de la fragmentación de datos, consulte Opciones de operación.

Utilizar un servicio SOAP sin parámetros de solicitud

Los servicios web SOAP se utilizan comúnmente como el primer objetivo en el Patrón de Transformación de dos objetivos: una fuente proporciona la solicitud que el servicio web SOAP toma como entrada y luego el servicio genera una respuesta que se escribe en otro objetivo.

Sin embargo, algunos servicios web SOAP podrían no requerir que se proporcione nada en la solicitud más allá de simplemente solicitar el servicio. En este caso, el patrón aún requiere dos transformaciones, pero la estructura de la solicitud puede no tener ningún campo que requiera mapeo; en cambio, la estructura puede constar solo de nodos sin campos.

Esta operación utiliza el GetHolidaysAvailable método (en la actividad SOAP Get Holidays), que no requiere parámetros de solicitud:

Dentro de la transformación FTP a SOAP, podemos ver que todos los nodos están expandidos y no hay campos presentes:

El resultado es una transformación vacía sin ninguna asignación, lo cual es necesario para que la operación sea válida.