Conexión SOAP

Introducción

Una conexión SOAP, creada mediante el conector SOAP, establece conexiones mediante el Protocolo Simple de Acceso a Objetos (SOAP). Una vez configurada una conexión, se pueden crear instancias de actividades SOAP asociadas a ella para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (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).
• La página Extremos globales (consulte Crear un extremo global en Extremos globales).

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ña Componentes del panel Proyecto).
• La página Extremos globales (consulte Editar un extremo global en Extremos globales)

Configurar una conexión SOAP

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión SOAP.

• Nombre de la conexión: Introduzca un nombre 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 que desea subir o reutilizar. Se pueden subir archivos de hasta 5 MB.

  • Subir URL: Introduzca la URL del archivo WSDL en el cuadro de texto y haga clic en el botón Subir. La URL debe ser accesible sin autenticación; de lo contrario, recibirá un error. Si sube un WSDL con el mismo nombre que uno existente, consulte Reemplazar un WSDL subido más adelante en esta página.

  • Subir archivo: Haga clic en Explorar para seleccionar un archivo WSDL o ZIP. Un archivo ZIP debe contener un archivo WSDL y puede incluir archivos XSD de los que depende el WSDL. A continuación, haga clic en Subir. Para subir un WSDL con el mismo nombre que uno existente, consulte Reemplazar un WSDL subido abajo.

    Nota

    Cualquiera schemaLocation Debe apuntar a un archivo local mediante una referencia relativa. Esto suele significar 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'

     Esto debe incluirse en su lugar:
    

    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: Elija entre los archivos WSDL utilizados previamente en el proyecto actual.

• Puerto: Seleccione el puerto apropiado en el menú desplegable.

  Nota

  Al editar una conexión, este campo se deshabilita si ya tiene actividades para el extremo en uso.

  URL del servicio web: Introduzca la URL del servicio web. Por defecto, este campo se rellena con la URL del WSDL.

• Servicio y Enlace: Estos campos se completan automáticamente en función del WSDL y el puerto y no se pueden editar.

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

  

  • Habilitar codificación de contenido: Cuando se selecciona, envía el encabezado Accept-Encoding con codificación compatible con Harmony (actualmente Gzip).

  • Habilitar codificación de transferencia fragmentada: Al seleccionar esta opción, se envía el encabezado_Transfer-Encoding: chunked_. Esto resulta útil al transferir grandes conjuntos de datos.

  • Enviar Expect: 100-continue: Al seleccionar esta opción, se envía el encabezado_Expect: 100-continue_. Esto garantiza que el servidor HTTP valide los encabezados antes de enviar cualquier dato. Resulta útil para enviar grandes cantidades de datos sin codificación de transferencia fragmentada.

  • Permitir cifrados débiles: Seleccione esta opción para comunicarse con servidores HTTP utilizando cifrados débiles (DES/3DES y RC4).

  • Establecer Accept-Encoding en Gzip: Seleccionado por defecto, esto indica al servidor HTTP que Harmony puede aceptar respuestas comprimidas con Gzip. Harmony sigue el estándar RFC 1952 y descomprime automáticamente las respuestas HTTP con Gzip. Si el servidor no usa Gzip, Harmony detecta que la respuesta no está comprimida y la procesa con normalidad.

    Nota

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

  • Versión SSL: Seleccione una versión SSL específica si el servidor HTTP lo requiere.

  • Encabezados de solicitud: Introduzca los encabezado HTTP, cada uno en su propia línea, a menos que se ajusten según los estándares HTTP. Este campo admite variables globales, variables del proyecto y variables de Jitterbit utilizando corchetes [ ].

• Nombre de usuario y Contraseña: Introduzca las credenciales para acceder al WSDL, si es necesario. Déjelo en blanco si no se requiere autenticación.

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

  • HTTP básico
  • Resumen HTTP
  • Resumen HTTP con autenticación con un toque de IE

Certificado: Seleccione un certificado para autenticarse con el servidor HTTP. Puede administrar los certificados SSL del lado del cliente desde la Management Console en Personalizaciones > Certificados de cliente.

• Reintentar: Esta configuración solo funciona en ambientes que utilizan un grupo de agentes privados. Reintenta las solicitudes cuando un extremo SOAP devuelve estos códigos de estado: 500, 501, 502, 503, o 504.

  Los agentes privados deben tener la versión 10.29 o posterior para que esta función funcione. Las versiones anteriores de los agentes ignoran esta configuración.

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

  

  • Intervalo de reintento (segundos): Ingrese cuánto tiempo esperar (máximo 5 segundos) entre intentos de reintento.

  • Máximo de reintentos: Ingrese cuántas veces (máximo 5) se debe reintentar la solicitud. Si la solicitud sigue fallando después de todos los reintentos, se mostrará una excepción en el registro de operación. El agente privado también registra cada reintento en el jitterbit.log archivo.

    Todos los reintentos cuentan como parte de la misma ejecución de operación, con un solo registro en el registro de operación. Cualquier acción de operación para las operaciones abajo en la cadena que se activan en función del estado final después de todos los reintentos.

  Nota

  Estas configuraciones anulan las variables de Jitterbit jitterbit.web_service_call.retry_wait_seconds y jitterbit.web_service_call.number_of_retries Si esas variables están configuradas.

• Seleccionar métodos: Seleccione los métodos que desee que estén disponibles como origen o destino en las operaciones.

  Nota

  No se pueden eliminar métodos seleccionados previamente que ya estén en uso por las actividades SOAP.

• Actividad seleccionada y Nombre para mostrar: Al seleccionar los métodos arriba, se añaden a la tabla a continuación, mostrando 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 icono de edición. e introduce un nuevo nombre.

  Nota

  Las actividades previamente seleccionadas que estén configuradas como componentes del proyecto no se pueden eliminar.

• Prueba: Haga clic para verificar la conexión con 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 cerrarla sin guardar. Un mensaje le pedirá que confirme que desea descartar los cambios.

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

Reemplazar un WSDL cargado

Al reemplazar un WSDL cargando uno con el mismo nombre, sus operaciones WSDL deben tener el mismo nombre que las que estén utilizando las actividades existentes. Si no tienen el mismo nombre o si faltan operaciones WSDL en uso en el WSDL de reemplazo, el siguiente mensaje de error le indica que primero elimine esas actividades y enumera las que deben eliminarse:

Tras la eliminación, el siguiente mensaje de confirmación enumera las actividades que podrían verse afectadas por el reemplazo del WSDL para revisar las transformaciones adyacentes en busca de posibles errores de mapeo. Tras la confirmación del mensaje, el WSDL se reemplazará en todas las ubicaciones donde se utilice en el proyecto:

Próximos pasos

Las acciones de menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Después de configurar una conexión SOAP, puede configurar una o más actividades SOAP asociadas con esa conexión para usarlas como origen para proporcionar datos a una operación o como destino para consumir datos en una operación, o puede usar la conexión SOAP en un secuencia de comandos.

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