IBM Enterprise Records, Versión 5.1.2    

**Manejadores de sucesos

IBM® Enterprise Records proporciona los siguientes eventos de muestra para los modelos de datos Base, DoD, y PRO.

Puede personalizar las muestras según resulte necesario. **Consulte el archivo léame en la carpeta Eventos en el paquete de software.

Tabla 1. Eventos y descripciones
Eventos Descripción
RMAutoDeclare

Configura la declaración automática de los registros. **Cuando un usuario realiza una operación específica (como integrar o archivar en una carpeta) en un documento en un Almacén de objetos de registro (ROS), IBM Enterprise Records crea de forma automática un registro electrónico correspondiente en un almacén de objetos del plan de archivos específico (FPOS). También puede configurar este evento de muestra para declarar cada documento que pertenezca a una determinada clase cuando un usuario incorpore el documento.

El evento de muestra solo admite la declaración de registro electrónico sin clasificar. Este evento debe configurarse para utilizar eventos síncronos y NO síncronos.

RMAutoSynchronizeProperties

Sincroniza las propiedades de los registros y de sus documentos asociados. Por ejemplo, cuando un usuario actualiza un valor de propiedad de un registro, IBM Enterprise Records actualiza el valor de propiedad correspondiente en los documentos asociados también.

Este evento de muestra funciona con las propiedades que utilizan el mismo nombre simbólico. Puede sincronizar desde un documento a un registro o desde un registro a un documento, pero no ambos. **Si sincroniza desde el registro a un documento, IBM Enterprise Records actualiza el documento cuando se actualiza la propiedad correspondiente del registro.

Este evento también sincroniza los alias de propiedad en los almacenes de objetos, desde registro a documento o desde documento a registro, pero no ambos.

RMUpdateDateDeclared

RMLastRetrievalOfRecord

**Juntos, estos eventos de muestra determinan cuándo eliminar el contenedor. **Estos eventos de muestra también garantizan que un programa de disposición no elimine un contenedor en donde se han declarado o recuperado recientemente los registros.

IBM Enterprise Records aplica este evento de muestra a las clases Volumen y Caja y establece la Fecha de última declaración en la carpeta padre cuando un usuario declara un registro.

**Para el modelo de datos PRO, IBM Enterprise Records suscribe de forma automática el evento RMUpdateDateDeclared a la clase Volumen o Caja y solo tendrá que habilitar el evento. En los demás modelos de datos, debe ejecutar el script de importación para crear el evento RMUpdateDateDeclared y suscribirse a la clase Volumen o Caja.

**RMLastRetrievalOfRecord establece la fecha de la última revisión del contenido de un registro en la propiedad LastRetrievalofRecord de la carpeta.

RMSecurityPropagation

(Solo PRO) Se utiliza solo con el modelo de datos PRO, este evento de muestra establece el valor de marca de la propiedad de categoría de seguridad del registro, del volumen y de la carpeta de registros, (pero no de la categoría de registro) en función del nivel más alto de una entidad asociada.

**Por ejemplo, cuando la propagación es desde el registro a la carpeta, IBM Enterprise Records actualiza la seguridad de la carpeta principal si la seguridad del registro es más alta que la de su carpeta padre. Las demás carpetas en las que esté archivado el registro no se verán afectadas.

Cuando la propagación es de carpeta a registro, IBM Enterprise Records actualiza la seguridad de los registros en un nivel de seguridad más bajo al nivel de seguridad más alto de sus carpetas padre.

**El valor en la Configuración del sistema para el PRO FPOS controla la forma en que se propaga la seguridad. **Esta propagación puede ser desde la carpeta al registro, del registro a la carpeta, ambos o no se permite la propagación.

RMSendEmailOnSupercede

Este evento de muestra hace que se envíe un correo electrónico cada vez que un registro es reemplazado por una nueva versión. **El mensaje de correo electrónico contiene los detalles sobre la descripción del reemplazo y la fecha y hora en que se produjo el reemplazo. **El correo electrónico se envía cuando el contenedor tiene el programa de disposición que define un activador con base en un evento de reemplazo.

Restricción: Este evento no es compatible con JBoss o WebLogic.

IBM Enterprise Records **los archivos JARD del manejador de eventos se almacenan como módulos de códigos en el almacén de objetos de destino. La ventaja es que puede añadir o actualizar el manejador de eventos incorporando una nueva versión en lugar de tener que reiniciar el servidor de aplicaciones. La configuración de los eventos de muestra de IBM Enterprise Records es como sigue:

Crear acciones de evento

Antes de iniciar este procedimiento, asegúrese de que existe la carpeta denominada CodeModules en la carpeta raíz del almacén de objetos donde está a punto de crear las acciones de evento. Si no existe la carpeta, siga las instrucciones incluidas en IBM FileNet P8 Platform Installation and Upgrade Guide para crearla.

Para crear acciones de suceso:
  1. **Copie la carpeta en la raíz CD, ~CDRoot\RecordsManager.<platform>\Events, al servidor en donde ejecuta IBM Administration Console for Content Platform Engine. Esta carpeta contiene los scripts de importación, los archivos JAR, y los archivos de configuración.
  2. Ejecute los scripts de importación pertinentes para crear las acciones de evento que desea utilizar.
    1. Pulse con el botón derecho del ratón sobre el almacén de objetos de destino de IBM Enterprise Records.
    2. Seleccione Importar todo.
    3. **En el diálogo Ayudante de importaciones, pestaña Opciones de importación, campo Importar archivo de manifiesto, vaya a la carpeta que copió. **Seleccione el script de importación del evento requerido. Cada archivo se nombra en función del evento. Por ejemplo, el archivo de importación del evento RMAutoDeclare se denomina RMAutoDeclareImport.xml.
    4. En el campo Ruta de contenido externo, examine la carpeta ~\Events\lib.
    5. Pulse Importar.

    **Después de completar la importación, verá un mensaje "Importación satisfactoria". **La acción del evento se puede crearen la carpeta Acción de eventos en el almacén de objetos. **Los módulos de código se crean en la carpeta Módulo de códigos.

Personalizar archivos de configuración

Los eventos RMAutoDeclare y RMSendEmailOnSupercede tienen sus propios archivos de configuración. El script de importación crea los archivos en el almacén de objetos:

Extraiga el archivo de configuración de Workplace , Workplace XT o IBM Administration Console for Content Platform Engine. Tras editarlo, incorpórelo. **Para obtener más información, consulte la autodeclaración de configuración del tema de registros. **Para el archivo RMSendEmailOnSupercede, los comentarios que anteceden la línea que modifica se explican por sí solos: SMTP host, número de puerto, direcciones de correo electrónico del emisor y receptor.

Crear suscripciones

Cada evento requiere suscripciones a una o más clases.

Suscripción al evento RMAutoDeclare

Para crear la suscripción:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/ROS/Document class o subclase donde desea crear la suscripción.
  2. Pulse con el botón derecho del ratón sobre la clase y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Incorporar.
  6. **En la pantalla Especificar acción de evento, seleccione la acción de evento que importó.
  7. **En la pantalla Especificar propiedades adicionales, desmarque la casilla de verificación Síncrono, marque o desmarque la casilla de verificación Incluir subclases según corresponda para cada evento y complete el asistente.
Para suscribirse a la clase o subclase Carpeta:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/ROS/Folder class o la subclase en donde desee crear la suscripción.
  2. Pulse con el botón derecho del ratón sobre la clase y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Archivar.
  6. **Desmarque la casilla de verificación Síncrono, marque o desmarque la casilla de verificación Incluir subclases correspondiente y complete el asistente.
Para suscribirse a una carpeta específica del ROS:
  1. En IBM Administration Console for Content Platform Engine, vaya a la carpeta donde desea crear la suscripción.
  2. Pulse con el botón derecho del ratón sobre la carpeta y seleccione Nueva suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Acepte el valor predeterminado.
  5. Seleccione el activador de evento Archivar.
  6. En la pantalla Especificar acción de evento, seleccione el evento RMAutoDeclare.
  7. **En la pantalla Especificar propiedades adicionales, desmarque la casilla de verificación Síncrono, acepte el resto de los valores predeterminados y complete el asistente.

Suscripción al evento RMAutoSynchronizeProperties

La suscripción al evento RMAutoSynchronizeProperties sincroniza las propiedades desde el documento de origen a su registro o desde el registro a su documento de origen.

No intente sincronizar en ambas direcciones. Este evento debe configurarse para utilizar eventos síncronos.

Para sincronizar desde el documento de origen a su registro:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/ROS/Document class o subclase.
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Actualizar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, seleccione la casilla de verificación Síncrono, pero deje sin activar la casilla Incluir subclases y complete el asistente.
Para sincronizar desde el registro a su documento de origen:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/ROS/Document class o subclase.
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Actualizar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, seleccione la casilla de verificación Síncrono, pero deje sin activar la casilla Incluir subclases y complete el asistente.

Suscripción al evento RMLastRetrievalOfRecord

Para suscribirse al evento RMLastRetrievalOfRecord:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/FPOS/Other Classes/CustomObject/RM System class.
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Creación.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, deje sin seleccionar la casilla de verificación Incluir subclases, active la casilla Síncrono y complete el asistente.

Suscripción al evento RMSecurityPropagation (solo para PRO)

Puede crear una suscripción a este evento para las clases Carpeta de registros, Volumen o Registro.

Para suscribirse al suceso de la clase carpeta de registro:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/Record Folder class.
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione los activadores de eventos Archivar y Actualizar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, deje sin seleccionar la casilla de verificación Incluir subclases y complete el asistente.
Para suscribirse al evento de la clase Volumen:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/PRO FPOS/Other Classes/Folder/RM Folder/Volume class.
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione los activadores de eventos Archivar y Actualizar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, deje sin seleccionar la casilla de verificación Incluir subclases y complete el asistente.
Para suscribirse al evento de la clase Registro:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/PRO-FPOS/Document Class/Record class.
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Actualizar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, deje sin seleccionar la casilla de verificación Incluir subclases y complete el asistente.

Suscripción al evento RMSendEmailOnSupercede

Para suscribirse al suceso RMSendEmailOnSupercede:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/FPOS/Document Class/Record class.
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Actualizar e Incorporar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, deje sin seleccionar la casilla de verificación Incluir subclases y complete el asistente.

Suscripción al evento RMUpdateDateDeclared

Para el modelo de datos PRO, tendrá que habilitar el suceso ya existente. Para habilitar los sucesos existentes:
  • **En IBM Administration Console for Content Platform Engine, vaya a la carpeta Object Stores/FPOS/Events/Event Action.
  • Pulse con el botón derecho del ratón sobre UpdateDateDeclared.
  • Haga clic en Habilitar.

En los modelos de datos DoD y Base, suscríbase a las clases Categoría de registro, Volumen, y Caja después de crear el evento.

Para suscribisrse al suceso de la clase categoría de registro:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record Category
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Archivar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, deje sin seleccionar la casilla de verificación Incluir subclases y complete el asistente.
Para suscribirse al evento de la clase Volumen:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/FPOS/Other Classes/Folder/RM Folder/Volume
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Archivar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, deje sin seleccionar la casilla de verificación Incluir subclases y complete el asistente.
Para suscribirse al suceso de la clase Box:
  1. **En IBM Administration Console for Content Platform Engine, vaya a Object Stores/FPOS/Other Classes/Folder/RM Folder/Physical Container/Box
  2. Pulse con el botón derecho del ratón y seleccione Agregar suscripción.
  3. Especifique un nombre exclusivo y una descripción para la suscripción.
  4. Active el botón de selección Se aplica a todas las instancias.
  5. En la pantalla Especificar activadores, seleccione el activador de eventos Archivar.
  6. Seleccione la acción de suceso que importó.
  7. En la pantalla Especificar propiedades adicionales, deje sin seleccionar la casilla de verificación Incluir subclases y complete el asistente.

**Para obtener información sobre la personalización de eventos, consulte el paquete de software de FileNet P8.



Comentarios

Última actualización: Noviembre 2013
work_with_event_handlers.htm

© Copyright IBM Corp. 2013