Interfaz de emisor de sucesos REST de IBM Business Monitor (Common Base Events) (en desuso)

El tipo XSD es una definición de esquema XML genérica. La información empresarial definida por la definición XSD se recibe en la API y se coloca en la ranura xs:any de un suceso Common Base Event y se reenvía a IBM Business Monitor. Las definiciones de componentes de sucesos que se crean en un modelo de supervisión para procesar estos sucesos siempre empiezan por cbe:CommonBaseEvent y navegan hasta el contenido que se coloca en la ranura xs:any de IBM Business Monitor. Para obtener un enlace directo con todos los recursos y métodos, consulte resumen breve.

URI de servicio de emisor de sucesos

https://{hostname}:{port}(WC_defaulthost_secure port)/rest/bpm/events

http://{hostname}:{port}(WC_defaulthost port)/rest/bpm/events

Puede desplegar varias copias del archivo EAR si desea utilizar más de un emisor. El archivo EmitterServices.ear está disponible en el directorio raíz_was/installableApps.wbm. Puede desplegar varias copias del servicio manualmente o utilizar el asistente de configuración. Si despliega varias copias, deberá proporcionar un nombre de aplicación exclusivo y una raíz de contexto exclusiva para cada copia, y deberá modificar la referencia de recursos de modo que contenga el nombre JNDI del emisor configurado que desee utilizar.

En un entorno de despliegue de red (ND), si el archivo EmitterServices.ear está instalado en un servidor o clúster distinto de la fábrica de emisores CEI, deberá establecer la entrada de recurso RESTEmitterFactory de modo que señale a la ubicación correcta de la fábrica de emisores. Puede configurar la fábrica de emisores para cada emisor durante el despliegue, o puede modificar las referencias de recursos en la aplicación IBM_WBM_REST_EMITTER_SERVICE. Puede realizar estos cambios desde la consola administrativa. Pulse Aplicaciones > Tipos de aplicación > WebSphere Enterprise Applications y pulse IBM_WBM_EMITTER_REST_SERVICES. En Referencias, pulse Referencias de recurso y realice los cambios. Guarde los cambios y reinicie la aplicación.

Si no utiliza el asistente de configuración para instalar los servicios de emisor, debe realizar algunos pasos adicionales en un entorno seguro. Tras desplegar EmitterServices.ear, deberá asignar la correlación de roles de seguridad apropiada. Para realizar los cambios, en la consola administrativa, pulse Aplicaciones > Tipos de aplicación > WebSphere Enterprise Applications y pulse IBM_WBM_EMITTER_REST_SERVICES. En Propiedades detalladas, pulse Seguridad de rol para la correlación de usuario/grupo.

Tipos de contenido

Utilización del tipo de contenido HTTP en solicitudes REST

Cuando un cliente envía una solicitud HTTP con carga útil, se debe establecer correctamente la cabecera del tipo de contenido HTTP para describir el formato de carga útil. Por tanto, los clientes deben ser explícitos y establecer el formato en text/xml o application/atom+xml, en función de si envían una carga útil individual directamente en el cuerpo de la solicitud HTTP o varias cargas útiles de suceso.

http://servidor_supervisión:puerto_servidor_supervisión/rest/bpm/events

https://servidor_supervisión:puerto_servidor_supervisión/rest/bpm/events

http://servidor_supervisión:puerto_servidor_supervisión/rest/bpm/events 

Puede buscar el URL JNDI en la aplicación del emisor para acceder a la dirección en la que está disponible el servicio del emisor. Este método de buscar la dirección web del servicio protege a la aplicación del emisor de los cambios en la dirección web. Se pueden añadir definiciones de URL a medida que se despliegan más copias del servicio de sucesos.

Tratamiento de errores

Para los errores reconocidos durante el proceso de una solicitud REST de IBM Business Monitor, se devuelve un código de estado HTTP apropiado ([RFC2616]) al cliente que efectúa la llamada (por ejemplo, 200 OK o 404 No encontrado; consulte las operaciones individuales para obtener detalles). Se proporciona información adicional según el tipo de error. Para las excepciones de IBM Business Monitor, se devuelve el correspondiente número de error y mensaje de error de IBM Business Monitor. Para los errores graves (código de estado HTTP 500 Error de servidor interno), se devuelven detalles adicionales del programador. Si es necesario, se pueden transmitir al personal de servicio de IBM.

Si se encuentran errores durante el proceso, IBM Business Monitor descartará el suceso, y el usuario deberá volver a enviarlo tras realizar las correcciones necesarias indicadas en la información de error que se devuelve. Puede plantearse utilizar el emisor de sucesos JMS, que deriva los sucesos con anomalía a una cola de errores cuando se encuentran errores durante la emisión de sucesos. Los sucesos no se descartan y pueden recuperarse para el procesamiento en la aplicación que emite los sucesos. Para obtener más información, consulte "Gestión de sucesos que el emisor de sucesos JMS no ha emitido" en los enlaces relacionados.

Referencias