Configuración de un componente Integración de servicio web en el Process Designer de escritorio (en desuso)

Utilice un componente de integración de servicio web para invocar un servicio web que está alojado externamente. Puede configurar las propiedades de WSDL, información de cabecera SOAP, autenticación, firma y propiedades de cifrado para la integración de servicio web.

1. En Process Designer, cree un servicio de integración para la aplicación de proceso.
2. Arrastre un componente de integración de servicio web desde la paleta hasta el diagrama y pulse en el componente para abrir las propiedades.
3. Especifique la ubicación y propiedades del archivo WSDL de servicio web pulsando sobre la pestaña de propiedades Implementación. Seleccione el Sistema de descubrimiento que desee en la lista desplegable. Tiene dos opciones, que se describen en este paso y el paso siguiente. A partir de valores de aplicación de proceso significa que selecciona una configuración de entre las configuraciones de servidor de servicios web, tal como muestran los subpasos siguientes.
   1. En el campo Servicio web, seleccione el servicio web de entre los servicios web disponibles. Si no hay ningún servicio web disponible, pulse Utilizar el editor de valores de aplicación de proceso para añadir un servidor. A continuación, configure un servidor de tipo de servicio web con un URL de WSDL, que hace referencia a un servicio web.
   2. Seleccione la operación que desee utilizar en el campo Operaciones.
   3. Seleccione la versión del protocolo SOAP para el servicio web.
   4. Extraiga las variables de entrada y de salida del archivo WSDL que sean necesarias para el servicio web pulsando Generar tipos.
      Nota: Si ya existe un objeto de negocio que representa a un tipo descubierto en la jerarquía de las dependencias de kit de herramientas (dependencias directas o kits de herramientas dependientes de kits de herramientas), no se vuelve a crear. Sin embargo, para hacer referencia a ese objeto de negocio, una aplicación o un kit de herramientas debe tener una dependencia directa en la instantánea del kit de herramientas que contiene el objeto de negocio. Debe añadir la dependencia directa, si no existe.
      Puede correlacionar las variables de entrada y de salida de dos formas. En la vista Propiedades, seleccione la pestaña Correlación de datos y pulse el icono "Correlación automática de parámetros de entrada (o de salida) del conector de servicio web". Puede también crear manualmente las variables utilizando las funciones del panel Variables. A continuación, puede correlacionar estas variables con los parámetros de entrada y salida del servicio web en la sección Correlación de datos.
      Si el componente de integración de servicios web llama a un servicio web de entrada que se crea en IBM BPM, debe generar de nuevo los tipos en los casos siguientes.

      • El servicio web de entrada utiliza un objeto de negocio que está definido en el Kit de herramientas de datos del sistema. El espacio de nombres de este objeto de negocio utiliza un nombre de host y una especificación de puerto. Los tipos deben generarse de nuevo para los objetos de negocio (tipos complejos) si se cambia el nombre de host o el puerto del servicio web de entrada en esta situación.
      • El campo Esquema del espacio de nombres de destino se cambia por el valor Por nombre de instantánea. El espacio de nombres del archivo WSDL utiliza el nombre de instantánea una vez que haya seleccionado esta opción. Debe generar los tipos otra vez para los objetos de negocio (tipos complejos) cada vez que cree una instantánea para el servicio web de entrada.
4. Proporcionar configuración en línea es la otra opción para el campo Sistema de descubrimiento. Le permite especificar su propia configuración de servicio web, como se muestra en los subpasos siguientes.
   1. Especifique un valor en el campo URI de WSDL. Puede especificar un URL o utilizar el Explorador de registros para descubrirlo.
      1. Pulse Examinar para iniciar el Explorador de registros y, a continuación, seleccione el tipo de registro de la lista.
      2. Seleccione un URL de registro o especifique uno nuevo.
      3. +Para servicios web protegidos, habilite el recuadro de selección Está protegido y proporcione el nombre de usuario y contraseña y, a continuación, pulse Siguiente.
      4. Especifique el nombre del servicio web y pulse Buscar servicios. Puede incluir caracteres comodín en el nombre; para un registro UDDI, utilice un signo de porcentaje (%), para un registro de servicio de WebSphere y registro de repositorio utilice un asterisco (*).
      5. Seleccione un servicio web, pulse Siguiente para ver información detallada y, a continuación, pulse Finalizar.
      Si utiliza el Explorador de registros, los campos URL de WSDL, WSDL protegido, Nombre de usuario y Contraseña se rellenan automáticamente. Si especifica el URL manualmente, también de debe proporcionar la información adicional sobre el archivo WSDL si es necesario.
   2. Pulse Descubrir para buscar el archivo WSDL y obtener la lista de operaciones. A continuación, seleccione una operación en la lista.
   3. Seleccione la versión del protocolo SOAP para el servicio web.
   4. Opcional: Especifique que el URL de la dirección de punto final se puede alterar temporalmente y proporcione una dirección de punto final alternativa.

      Puede ser conveniente especificar una dirección de punto final alternativa. Por ejemplo, si tiene puntos finales diferentes para los entornos de desarrollo, prueba, transferencia y producción. Si el entorno de producción no tiene acceso directo a Internet y las solicitudes se direccionan a través de un servidor proxy o pasarela, esta alternativa es también útil.

      Puede especificar la nueva dirección como un valor de serie, por ejemplo, https://provider.com/services/myService, o como una expresión JavaScript incluida en <#...#>.

   5. Extraiga las variables de entrada y de salida del archivo WSDL que sean necesarias para el servicio web pulsando Generar tipos.
      Nota: Si ya existe un objeto de negocio que representa a un tipo descubierto en la jerarquía de las dependencias de kit de herramientas (dependencias directas o kits de herramientas dependientes de kits de herramientas), no se vuelve a crear. Sin embargo, para hacer referencia a ese objeto de negocio, una aplicación o un kit de herramientas debe tener una dependencia directa en la instantánea del kit de herramientas que contiene el objeto de negocio. Debe añadir la dependencia directa, si no existe.
      Puede correlacionar las variables de entrada y de salida de dos formas. En la vista Propiedades, seleccione la pestaña Correlación de datos y pulse el icono "Correlación automática de parámetros de entrada (o de salida) del conector de servicio web". Puede también crear manualmente las variables utilizando las funciones del panel Variables. A continuación, puede correlacionar estas variables con los parámetros de entrada y salida del servicio web en la sección Correlación de datos.
      Si el componente de integración de servicios web llama a un servicio web de entrada que se crea en IBM BPM, debe generar de nuevo los tipos en los casos siguientes.

      • El servicio web de entrada utiliza un objeto de negocio que está definido en el Kit de herramientas de datos del sistema. El espacio de nombres de este objeto de negocio utiliza un nombre de host y una especificación de puerto. Los tipos deben generarse de nuevo para los objetos de negocio (tipos complejos) si se cambia el nombre de host o el puerto del servicio web de entrada en esta situación.
      • El campo Esquema del espacio de nombres de destino se cambia por el valor Por nombre de instantánea. El espacio de nombres del archivo WSDL utiliza el nombre de instantánea una vez que haya seleccionado esta opción. Debe generar los tipos otra vez para los objetos de negocio (tipos complejos) cada vez que cree una instantánea para el servicio web de entrada.
5. Opcional: Añada una cabecera SOAP creando una nueva variable en la pestaña Variables de tipo SOAPHeader o SOAPHeaders, y a continuación correlacione dicha variable en la pestaña Correlación de datos en Propiedades. Para obtener instrucciones detalladas, consulte Creación de cabeceras SOAP implícitas para integraciones de servicios web de salida. Puede añadir una cabecera SOAP a una solicitud SOAP, por ejemplo, para pasar información de contexto adicional al servicio web.

   También puede añadir cabeceras SOAP utilizando la pestaña Cabeceras. Este método de adición de cabeceras está en desuso. Sin embargo, si ha definido la cabecera SOAP en la sección de cabecera de un componente de integración de servicio web, utilice el mismo tipo que está definido en el archivo WSDL, o bien utilice el tipo básico XSD (definición de esquema XML). De lo contrario, no podrá correlacionar automáticamente la variable de la cabecera SOAP ni cambiar sus valores desde la sección de correlaciones de datos.

6. Pulse la pestaña Seguridad en propiedades. Especifique el tipo de seguridad seleccionando Utilizar seguridad básica o Utilizar conjunto de políticas.
   1. Si selecciona Utilizar seguridad básica, especifique los conjuntos de políticas que son utilizados por el servicio web, y proporcione el nombre de usuario y la contraseña. Especifique los valores de certificado, cifrado y firma para la aplicación cliente y el servidor de servicios web. Estos valores aseguran la integridad y confidencialidad de los mensajes que se intercambian con el servicio web.
   2. Si selecciona Utilizar conjunto de políticas, seleccione el conjunto de políticas y el enlace de política en las listas desplegables.

      Conjunto de políticas: especifica el nombre del conjunto de políticas de aplicación. Pulse Seleccionar para elegir el conjunto de políticas. La lista que verá depende de las políticas disponibles en el servidor. Algunos conjuntos de políticas de aplicación predeterminados incluyen: predeterminado de WSHTTPS, predeterminado de WSAddressing y predeterminado Nombre de usuario de WSSecurity. También puede crear conjuntos de políticas de aplicación adicionales en la consola de administración de WebSphere Application Server. Si deselecciona un conjunto de políticas también elimina el enlace de política. Hallará más información sobre conjuntos de políticas en el IBM Redbook WebSphere Application Server Web Services Guide.

      Enlace de política: especifica el nombre del enlace de conjunto de políticas de cliente general, que contiene parámetros de configuración específicos del sistema como información de usuario y de contraseña. Pulse Seleccionar para elegir el enlace de política. La lista que verá depende de los enlaces de conjunto de políticas disponibles en el servidor. Los enlaces de conjunto de políticas predeterminados incluyen: Ejemplo de cliente y Ejemplo de cliente V2. También puede crear enlaces de conjunto de políticas adicionales en la consola de administración de WebSphere Application Server. Si se deselecciona se elimina el enlace de política.

7. Configure las correlaciones de entrada y de salida para los parámetros del archivo WSDL pulsando la pestaña de propiedades Correlación de datos.