Adición de la definición de suceso al catálogo de sucesos

Se pueden añadir sucesos recién creados al catálogo de sucesos.

Por qué y cuándo realizar esta tarea

Después de crear una nueva definición de suceso y rellenarla con las descripciones de propiedades y descripciones de elementos de datos ampliados, puede añadirla al catálogo de sucesos. Una vez añadida una definición de suceso al catálogo de sucesos no se puede modificar pero se puede sustituir.
Nota: Si se habilita la seguridad WebSphere, el ID de usuario debe correlacionarse con el rol de catalogAdministrator para añadir definiciones de sucesos al catálogo de sucesos.

Pasos para realizar esta tarea

Para añadir la definición de suceso al catálogo de sucesos utilice el método addEventDefinition.
boolean result
= eventCatalog.addEventDefinition(definición, sustituir)
Los parámetros de este método son los siguientes:
definición
La definición de suceso que desea añadir. Esta debe ser una instancia de EventDefinition válida.
sustituir
Valor booleano que indica si la definición de suceso especificada sustituye a la definición de suceso existente con el mismo nombre.

Si el parámetro sustituir es false, el nombre de la definición de suceso especificada no debe coincidir con el nombre de ninguna definición de suceso existente en el catálogo. Si es así, se generará una excepción EventDefinitionExistsException.

Si el parámetro sustituir es true, la nueva definición de suceso sustituye a cualquier definición de suceso con el mismo nombre que ya esté en el catálogo. No obstante, para preservar la jerarquía de herencia, la nueva definición de suceso debe asignar un nombre al mismo padre que la definición de suceso antigua; de lo contrario, se generará una excepción ParentNotValidException.

Resultado

El booleano devuelto indica si se ha sustituido una definición de suceso existente. Esta es igual a true, sólo si sustituir es igual a true y se ha sustituido la definición de suceso por la nueva definición.

Para cada definición de suceso que se añada al catálogo de sucesos, el catálogo de sucesos envía un suceso al servidor de sucesos notificando a los consumidores de sucesos que se ha producido este cambio. Consulte Notificación de cambios.
Nota: Si intenta añadir una definición de suceso que viole las reglas de herencia, se genera una excepción InheritanceNotValidException y la definición de suceso no se añade al catálogo. Esto puede suceder, si una nueva definición de suceso altera temporalmente las descripciones de elementos de datos ampliados y de propiedades heredadas de formas que no son válidas, o bien, si la sustitución de una definición de suceso existente hace que los descendientes alteren temporalmente las descripciones heredadas de formas que no sean válidas. Para obtener más información, consulte Herencia de catálogos de sucesos.

Condiciones de uso |


(c) Copyright IBM Corporation 2005, 2006.
Este centro de información está basado en tecnología Eclipse (http://www.eclipse.org)