Acerca de la creación de una conexión de datos con un archivo WSDL

Un servicio Web, según lo expresa el documento de Lenguaje de descripción de servicios Web (WSDL), describe una serie de operaciones. Para cada operación, el archivo WSDL puede definir un mensaje de entrada, un mensaje de salida o ambos. Los mensajes de entrada se envían a un servidor. El servidor puede responder con un mensaje de salida. Se pueden crear y enlazar campos en el diseño de formulario a uno o varios servicios Web. El archivo WSDL muestra la descripción de los datos. La descripción de los datos se utiliza para crear la conexión de datos WSDL.

La conexión de datos WSDL es diferente a otro tipo de conexión de datos. Una operación del servicio Web se asemeja a una llamada a una función con parámetros de entrada o salida, o ambos. Un campo o campos particulares pueden ser el origen del mensaje de entrada y el destino del mensaje de salida.

Al utilizar Designer y las conexiones de datos WSDL, se pueden realizar las siguientes tareas:

  • Enlazar una o varias operaciones dentro de uno o más servicios Web.

  • Adjuntar campos, subformularios y grupos de exclusión para la ejecución de una operación de servicio Web mediante un suceso clic de un botón.

  • Ejecutar una operación del servicio Web desde cualquier suceso mediante una secuencia de comandos.

  • Activar el acceso de la secuencia de comandos a todos los elementos devueltos del servicio Web aunque dichos elementos estén enlazados a los campos.

  • Utilizar la comunicación de estilo SOAP 1.1 (enlaces SOAP y transporte HTTP/HTTPS).

  • Intercambiar datos con un servicio Web empleando los formatos de intercambio doc/literal.

  • Escribir secuencias de comandos para el cliente utilizando Acrobat SOAP JavaScript Object (compatible con RPC/codificado).

Estas funciones no son compatibles:

  • Algunas funciones de esquema XML

  • Los protocolos como SMTP, FTP, entre otros, como transporte subyacente para SOAP

  • Elementos de tipo extensible

  • Descubrimiento del servicio Web que utiliza el servidor UDDI

  • Mensajes SOAP codificados en Llamada a procedimiento remoto (RPC, del inglés Remote Procedure Call)

  • Utilización de enlaces HTTP POST y GET WSDL

Puede crear una conexión de datos mediante un documento WSDL en un servidor Web seguro, que requiere autenticación de cliente HTTP/HTTPS para controlar el acceso o bien autenticación de nivel de mensaje para solicitar un servicio Web o ambas.

La autenticación HTTP/HTTPS tiene lugar en la capa de transporte donde se requiere verificación de cliente para acceder al documento WSDL y para conectarse a un servicio Web seguro. La autenticación HTTP/HTTPS acepta el nombre de usuario y la contraseña, el compendio de nombre de usuario y contraseña y el certificado de cliente como autenticación aceptable:

  • La autenticación de nombre de usuario y contraseña proporciona una verificación de acceso básico que muestra al usuario un cuadro de diálogo de inicio de sesión. La combinación de nombre de usuario y contraseña al servidor se envía como texto sin codificar y no se divide con guiones antes de enviarse al servidor.

  • La autenticación de compendio de nombre de usuario y contraseña proporciona una verificación mejorada que muestra al usuario un cuadro de diálogo de inicio de sesión. Sin embargo, el nombre de usuario y la contraseña tienen valores hash antes de enviarse al servidor.

    Nota: el cuadro de diálogo de inicio de sesión indica el nombre del servidor y el territorio al que el usuario intenta conectarse. Debido a que existen varios territorios configurados en un servidor particular, esta información puede permitir al usuario determinar los credenciales que precisa para iniciar sesión.
  • La autenticación de certificado de cliente proporciona verificación de ID digital que muestra un cuadro de diálogo Seleccionar ID digital con los ID digitales disponibles donde se selecciona el ID digital correcto para enviarlo al servidor para su autenticación.

    Nota: para poder utilizar la autenticación de certificado de cliente, es preciso tener disponible un ID digital disponible en el almacén de certificados de Windows o en el almacén de archivos de ID digitales de Designer, listo para su uso cuando se cree una conexión de datos WSDL. Consulte Importación de ID digitales.

La autenticación de nivel de mensaje tiene lugar en la capa de mensaje SOAP (Protocolo simple de acceso a objetos) donde la verificación de cliente requiere un distintivo de seguridad (incluido en el encabezado de mensaje SOAP) para conectarse a un servicio Web seguro. La capa de nivel de mensaje acepta autenticación de nombre de usuario y contraseña que muestra al usuario un cuadro de diálogo de inicio de sesión. Acrobat 9.0 o posterior, admite autenticación de nivel de mensaje de nombre de usuario y contraseña.

Cuando cree una conexión de datos WSDL segura, indique (opcionalmente) el tipo de credenciales para aceptar autenticación HTTP/HTTPS y de nivel de mensaje. Las credenciales para la autenticación HTTP/HTTPS se envían como parte del encabezado de protocolo HTTP/HTTPS. Las credenciales de la capa de mensaje (SOAP) se utilizan para crear un distintivo de seguridad (que se incluye en encabezado de mensaje SOAP.) Tenga en cuenta que debe especificar el tipo de credenciales que se van a aceptar cuando tenga un flujo de trabajo de servidor donde el servidor deberá proporcionar los credenciales sin interacción del usuario.

Nota: si intenta conectarse a un archivo WSDL en el repositorio Workbench, es posible que aparezca un error que indica que el archivo no se puede cargar. Primero debe abrir el archivo WSDL en Workbench para crear la conexión de datos.