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.