Creación de un servicio web

Puede crear un servicio web en IBM® Business Process Manager para exponerlo a los sistemas exteriores, de modo que puedan acceder a las funciones en una aplicación IBM BPM.

Acerca de esta tarea

Para proporciona un modo para que una aplicación o un sistema externo invoque IBM BPM, cree y publique un punto final de servicio web. El punto final de servicio web invoca una operación que llama a un servicio de IBM BPM concreto o a un conjunto de servicios.

Todas las operaciones que expone en un servicio web son operaciones de solicitud y respuesta. Incluso una operación vinculada a un servicio que no tiene salidas continúa siendo una operación de solicitud y respuesta que no tiene ninguna salida. Las operaciones unidireccionales no están soportadas.

Consejo: La dirección del punto final de un servicio web tiene el formato siguiente: http://nombre_host:puerto/[prefijo_personalizado/]teamworks/webservices/nombre_aplicación_proceso/[nombre_instantánea/]nombre_servicio_web.tws.

Si no especifica el nombre_instantánea en el URL de punto final, éste apunta a la instantánea de sugerencia para Process Center o a la instantánea predeterminada para Process Server.

Procedimiento

Abra una aplicación de proceso en Process Designer.
Seleccione el signo más junto a Servicios y seleccione Servicio web en la lista.
Asigne un nombre al nuevo servicio web. Se abre el editor de servicios web.

En la sección Comportamiento:

Si desea añadir la seguridad de nombre de usuario y contraseña a las operaciones, habilite Protegido.
El nombre de usuario y la contraseña se deben registrar en el servidor y el nombre de usuario debe tener al menos acceso de lectura a la aplicación de proceso. Tenga en cuenta que esta protección no se considera autenticación en el contexto de una transacción HTTP, de modo que al seleccionar Protegida no se muestra un ID de usuario y contraseña predeterminados.
Tenga en cuenta el URI de WSDL en la sección Comportamiento. Puede utilizar este URI para probar el servicio web expuesto.

Establezca el esquema utilizado para crear el espacio de nombres de destino para el servicio web en Esquema de espacio de nombres de destino. El espacio de nombres de destino depende del esquema que seleccione, del valor del espacio de nombres en los valores de aplicación de proceso o de kit de herramientas, y de la instantánea. Para obtener más información, consulte en la tabla siguiente las opciones de esquema.

Utilizar valores de aplicación de proceso o kit de herramientas (valor predeterminado): Utilizar el espacio de nombres de la sección Valores XML de la página Valores de aplicación de proceso y no incluir el nombre de instantánea. Esta es la configuración recomendada, ya que el espacio de nombres de destino se mantiene coherente en varias instantáneas.
Importante: Si no se ha establecido el espacio de nombres de la aplicación de proceso, en su lugar, el esquema utiliza el host y el puerto de la máquina local y, si existe, el nombre de instantánea.
Utilizar nombre de instantánea: Utilice el nombre de instantánea y también el espacio de nombres de la sección Valores XML de la página Valores de aplicación de proceso. Esto significa que el valor del espacio de nombres de destino del cliente de servicio web tiene como destino una instantánea específica.
Importante: En las siguientes situaciones, el espacio de nombres del archivo WSDL (Web Services Description Language) cambia y debe obtener un nuevo archivo para mantener la coherencia entre el espacio de nombres que utiliza el cliente y el espacio de nombres del servidor:
- Cuando el espacio de nombres de aplicación no es coherente con el espacio de nombres del servidor.
- Cuando cambia el nombre de host y el puerto y el servicio web expuesto utiliza un objeto de negocio definido en el kit de herramientas de datos del sistema, el cual utiliza una especificación de nombre de host y puerto.
- Cuando crea una instantánea y cambia un servicio al servicio web expuesto en la nueva instantánea.
- Cuando cambia de una instantánea específica a la instantánea predeterminada o desde la instantánea predeterminada a una instantánea específica.
Recuerde: Las versiones de IBM BPM anteriores a la versión 8.0.1, de hecho, utilizan el esquema de nombre de la instantánea.
Personalizado: Utilice sólo el valor especificado en el campo Espacio de nombres de destino.

La tabla siguiente muestra el espacio de nombres de destino resultante, en función del valor que elija para el esquema, del valor del espacio de nombres para la aplicación de proceso, y de la ubicación en la que se ejecuta el servicio web.

Combinación	URI resultante
espacio de nombres de aplicación de proceso establecido en el valor `http://xyz` Esquema Utilizar aplicación de proceso o kit de herramientas	`http://xyz/nombre_servicio_web.tws`
espacio de nombres de aplicación de proceso establecido en el valor `http://xyz` Ejecutar en una instantánea que no es una instantánea de sugerencia ni predeterminada Esquema Utilizar instantánea	`http://xyz/snapshot/nombre_servicio_web.tws`
espacio de nombres de aplicación de proceso establecido en ningún valor Ejecutar en una instantánea de sugerencia o predeterminada Esquema Utilizar aplicación de proceso o kit de herramientas o esquema Utilizar instantánea	`http://host:puerto/teamworks/webservices/ proc_app/nombre_servicio_web.tws`
espacio de nombres de aplicación de proceso establecido en ningún valor Ejecutar en una instantánea que no es una instantánea de sugerencia ni predeterminada Esquema Utilizar aplicación de proceso o kit de herramientas o esquema Utilizar instantánea	`http://host:puerto/teamworks/webservices/ proc_app/snapshot/nombre_servicio_web.tws`
Esquema Utilizar personalizado	`http://custom_namespace`

Seleccione la versión de SOAP que desee utilizar.

Nota: La información de cabecera SOAP está disponible en las variables del sistema. La variable tw.system.soap.header.request se inicializa automáticamente para contener la lista de entradas de cabecera SOAP que se encuentra en el mensaje de solicitud de entrada. Puede incluir código JavaScript con su servicio web de entrada que accede a estas entradas de cabecera SOAP. También puede escribir código JavaScript que añade las entradas de cabecera SOAP a la variable del sistema tw.system.soap.header.response. Las entradas de cabecera SOAP contenidas en esta variable se añaden al mensaje de respuesta de salida.

Para cada función que desea que soporte el servicio web, añada una operación. En los detalles dela operación, asigne un nombre a la operación y conecte el flujo de servicios que proporciona la función a la operación. Para obtener más información acerca de los flujos de servicios y cómo crearlos, consulte Creación de un flujo de servicios.
Consejo: De forma predeterminada, la lista de servicios que puede conectar sólo contiene flujos de servicios. Si desea conectar un servicio creado en IBM BPM V8.5.7.0 o anterior, y no se ha convertido en un flujo de servicios, seleccione el recuadro de selección Mostrar servicios de herencia en la parte inferior de la lista de servicios. Lista de servicios conectables incluye ahora estos servicios. Se clasifican según su tipo. Estos servicios no se pueden editar en Process Designer de web. Si desea editarlo, debe abrirlo en el escritorio de Process Designer.
En la sección Política, especifique el conjunto de políticas de aplicación y, a continuación, especifique el enlace de políticas para el servicio web.
- Conjunto de políticas: Seleccione el conjunto de políticas de aplicación en la lista disponible en el servidor. Si no selecciona ningún conjunto de políticas, se elimina cualquier enlace de política existente.
  El conjunto de políticas contiene los valores de configuración y de seguridad. Para obtener información adicional acerca de los conjuntos de políticas, consulte el documento de IBM Redbook WebSphere Application Server Guía de servicios web. Algunos conjuntos de políticas de aplicación predeterminados incluye Valor predeterminado de WSHTTPS, Valor predeterminado de WSAddressing y Valor predeterminado de Nombre de usuario de WSSecurity. También puede crear conjuntos de políticas de aplicación en la consola de administración de WebSphere Application Server.
- Enlace de política: Después de seleccionar el conjunto de políticas, seleccione el enlace de política en la lista de enlaces del conjunto de políticas de proveedor general que está disponible en el servidor. El enlace de política no está disponible hasta que selecciona el conjunto de políticas al que se aplica el enlace.
  El enlace de políticas contiene parámetros de configuración específicos del sistema, tales como la información de nombre de usuario y contraseña. Los enlaces de conjunto de políticas incluye Ejemplo de proveedor y Ejemplo de proveedor V2. También puede crear enlaces de conjunto de políticas en la consola de administración de WebSphere Application Server.
Pulse Guardar o Finalizar edición.