Conexión SOAP

Introducción

Una conexión SOAP se configura mediante el conector SOAP, lo que permite establecer el acceso a un servicio web SOAP. Una vez establecida la conexión, se pueden configurar una o más actividades SOAP asociadas a esa conexión para que se utilicen como origen para proporcionar datos a una operación o como destino para consumir datos en una operación.

Crear o editar una conexión SOAP

Se crea una nueva conexión SOAP utilizando el conector SOAP desde una de estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).

Se puede editar una conexión SOAP existente desde estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes 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 conexión SOAP

La configuración de una conexión SOAP incluye estos campos:

• Nombre del Extremo: Ingrese un nombre utilizado para identificar la conexión SOAP. El nombre debe ser único para cada conexión SOAP y no debe contener barras diagonales (/) o dos puntos (:) Este nombre también se utiliza para identificar el extremo SOAP, que hace referencia tanto a una conexión específica como a sus actividades.

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

  • Subir URL: Ingrese la URL del archivo WSDL en el cuadro de texto y luego haga clic en el botón Subir. La URL debe ser accesible sin autenticación o recibirá un error. Si va a subir un WSDL con el mismo nombre que un WSDL existente, consulte Reemplazo de un WSDL subido más adelante en esta página.

  • Cargar archivo: Use el botón Explorar a la derecha para buscar un archivo WSDL o ZIP. Si proporciona un archivo ZIP, debe contener un solo archivo WSDL, aunque también puede contener cualquier archivo XSD del que dependa el WSDL. Luego haga clic en el botón Cargar. Si carga un WSDL con el mismo nombre que un WSDL existente, consulte Reemplazo de un WSDL cargado más adelante en esta página.

    Nota

    Cualquiera schemaLocation debe resolverse en un archivo local mediante una referencia relativa. Esto generalmente significa que en lugar de proporcionar una tupla como esta:

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

    En lugar de eso, deberías proporcionar esto:

    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.

• URL del servicio web: Ingrese una URL válida para el servicio web. De manera predeterminada, este campo se completa con la URL del WSDL.

• Servicio y Enlace: De forma predeterminada, estos campos se completan automáticamente según el WSDL y el puerto proporcionados y no se pueden editar.

• Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

  

  • Habilitar codificación de contenido: Si se selecciona, el encabezado Accept-Encoding se envía con la codificación compatible con Harmony. Actualmente, se admite Gzip.

  • Habilitar codificación de transferencia fragmentada: Si se selecciona, se envía el encabezado Transfer-Encoding: chunked. Utilice esta opción si está transfiriendo grandes conjuntos de datos.

  • Enviar Expect: 100-continue: Si se selecciona, se envía el encabezado Expect: 100-continue. Con esta opción, no se envían datos hasta que el servidor HTTP haya validado los encabezados. Utilice esta opción si va a enviar grandes cantidades de datos pero no desea utilizar la codificación de transferencia fragmentada.

  • Permitir cifrados débiles: Seleccione esta casilla de verificación para comunicarse con servidores HTTP que utilizan cifrados débiles (DES/3DES y RC4).

  • Establecer Accept-Encoding en Gzip: Seleccionado de manera predeterminada, esto le indica al servidor HTTP que Harmony puede aceptar una respuesta comprimida con Gzip. A cambio, Harmony sigue el estándar RFC 1952 y descomprime automáticamente las respuestas HTTP con Gzip. Si el servidor no usa Gzip, Harmony ve que la respuesta no está comprimida y la maneja como de costumbre.

    Nota

    Esta configuración no está relacionada con el conector Gzip.

  • Versión SSL: Utilice el menú desplegable para seleccionar una versión SSL específica si el servidor HTTP lo requiere.

  • Encabezados de solicitud: Cualquier texto ingresado en este cuadro se envía como un encabezado HTTP. Especifique cada encabezado en una línea a menos que el encabezado esté envuelto de acuerdo con el estándar HTTP. Este campo también admite el uso de variables globales, variables del proyecto y variables Jitterbit reemplazando las variables entre corchetes [ ] con sus valores.

• Nombre de usuario y Contraseña: Si corresponde, ingrese un nombre de usuario y una contraseña que permitan el acceso al WSDL. Deje estos campos en blanco si no se requiere ningún nombre de usuario o contraseña.

  De manera predeterminada, Harmony negocia con el extremo para determinar qué métodos de autenticación son compatibles y utiliza las credenciales proporcionadas en uno de los protocolos. Harmony admite estas opciones de autenticación HTTP:

  • HTTP básico
  • Resumen HTTP
  • Resumen HTTP con autenticación con una versión de IE

• Certificado: Utilice el menú desplegable para seleccionar un certificado disponible para autenticarse con el servidor HTTP. Puede administrar los certificados SSL del lado del cliente desde la Management Console en Personalizaciones > Certificados de cliente.

• Retry: Funcional solo cuando se usa un ambiente asociado con un grupo de agentes privados, esta configuración se usa para reintentar una solicitud cuando un extremo SOAP devuelve uno de estos códigos de estado: 500, 501, 502, 503, o 504.

  Para que esta configuración surta efecto, los agentes privados deben tener la versión 10.29 o posterior. Con versiones anteriores de agentes, esta configuración se ignora.

  Seleccione la casilla de verificación Reintentar para expandir opciones de configuración adicionales:

  

  • Intervalo de reintento (segundos): Ingrese la cantidad de segundos (máximo de 5 segundos) a esperar entre el reenvío de una solicitud al extremo SOAP.

  • Máximo de reintentos: Ingrese la cantidad de veces (máximo de 5 reintentos) que se reenviará una solicitud al extremo SOAP. Si la solicitud sigue fallando después de la cantidad máxima de reintentos, se devolverá una excepción con un mensaje de error en el registro de operación. Además, el agente privado registrará cada reintento en el jitterbit.log archivo de registro.

    Cada reintento se trata como parte de la misma ejecución de la operación, donde solo aparece un único registro en el registro de operación. Cualquier acción de operación configurados para ejecutar operaciones abajo en la cadena se activan según el estado final de la operación después de volver a intentarlo hasta el número máximo de reintentos.

  Nota

  Estas configuraciones anulan las variables Jitterbit jitterbit.web_service_call.retry_wait_seconds y jitterbit.web_service_call.number_of_retries si se establecen dichas variables.

• Seleccionar métodos: Seleccione cualquier método que desee que esté disponible para usar como origen o destino en la operación.

  Nota

  Los métodos seleccionados previamente que actualmente están en uso por las actividades SOAP configuradas no se pueden eliminar.

• Actividad seleccionada y Nombre para mostrar: A medida que selecciona los métodos anteriores, se agregan a la tabla a continuación, que muestra cada método seleccionado que se representará como un bloque de actividad bajo la conexión SOAP en la paleta de componentes. Para editar un Nombre para mostrar, haga clic en el ícono de edición e ingrese el nombre de la actividad deseada.

  Nota

  No se pueden eliminar las actividades seleccionadas previamente que actualmente están configuradas como un componente del proyecto.

• Prueba: Haga clic para verificar la conexión utilizando la configuración proporcionada.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le solicitará que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje te pedirá que confirmes que deseas eliminar la conexión.

Reemplazo de un WSDL cargado

Si reemplaza un WSDL volviendo a cargar uno con el mismo nombre mediante Upload URL o Upload File, sus operaciones WSDL deben tener el mismo nombre que las que están actualmente en uso por las actividades existentes. Si no tienen el mismo nombre o si faltan operaciones WSDL en uso en el WSDL de reemplazo, un mensaje de error le indica que primero elimine esas actividades:

Si se cumplen los criterios de reemplazo de WSDL descritos anteriormente, un mensaje de confirmación enumera las actividades que pueden verse afectadas por el reemplazo del WSDL para revisar las transformaciones adyacentes en busca de posibles errores de mapeo. Al confirmarse el mensaje, el WSDL se reemplazará en todas las ubicaciones donde se use durante el proyecto:

Próximos pasos

Una vez creada una conexión SOAP, se puede acceder a las acciones del menú para esa conexión desde la pestaña Componentes del panel del proyecto. Consulte menú de acciones de conexión para más detalles.

Una vez configurada una conexión SOAP, puede configurar una o más actividades SOAP asociadas con esa conexión para que se utilicen como origen (para proporcionar datos dentro de una operación) o como destino (para consumir datos dentro de una operación).

Utilice el menú desplegable Mostrar para filtrar por Extremos y, a continuación, haga clic en el bloque de conexión SOAP para mostrar las actividades que están disponibles para usarse con una conexión SOAP:

Las actividades que se muestran corresponden con los métodos que se seleccionaron durante la configuración de la conexión SOAP.

Para obtener más información, consulte Actividades SOAP.