IBM Enterprise Records, Versión 5.1.+            

Trabajar con manejadores de eventos

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 incluido en la carpeta Eventos dentro del 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 (incorporación o archivado en una carpeta) en un documento de un almacén de objetos de registro (ROS), IBM Enterprise Records crea automáticamente un registro correspondiente en un almacén de objetos de plan de archivos (FPOS) especificado. 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 un registro a un documento, IBM Enterprise Records actualiza el documento cuando e 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 debe eliminarse el contenedor o garantizan que un programa de disposición no eliminará el contenedor 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.

En 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 su 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 de registro a carpeta, IBM Enterprise Records actualiza la seguridad de la carpeta padre de seguridad si la seguridad del registro es mayor 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 de configuración del sistema del almacén de objetos de plan de archivos de PRO controla cómo se propaga la seguridad: de carpeta a registro, de registro a carpeta, ambos, o no se permite ninguna 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 el reemplazamiento de la descripción del registro, y la fecha y la hora en la que se produjo el reemplazo. Este correo electrónico se envía cuando el contenedor tiene un programa de disposición que define un activador en función del evento de reemplazo.

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

Los archivos JAR del manejador de eventos de muestra de IBM Enterprise Records se almacenan como módulos de código 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.

  1. Copie la carpeta en la raíz de CD, ~CDRoot\RecordsManager.<platforma>\Events, del servidor donde ejecute EM. 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 campo Importar archivo manifiesto de la ficha Opciones de importación del diálogo Ayudante de importación, vaya a la carpeta que ha copiado y seleccione el script de importación del evento necesario. 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.

    Una vez finalizada la importación, debe ver un mensaje indicándole que la importación ha sido satisfactoria. La acción de evento debe crearse en la carpeta de acción de evento del almacén de objetos y los módulos de código se crearán en la carpeta de módulo de código.

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 Enterprise Manager. Tras editarlo, incorpórelo. Consulte Configurar declaración automática de registros. En el archivo RMSendEmailOnSupercede, los comentarios que preceden a la línea que debe modificar son explicativos (host SMTP, número de puerto, direcciones de correo electrónico del emisor y del receptor).

Crear suscripciones

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

Suscripción al evento RMAutoDeclare

  1. En Enterprise Manager, vaya a Object Stores/ROS/clase Documento o subclase 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 Incorporar.
  6. En la pantalla Especificar acción de evento, seleccione la acción de evento que ha importado.
  7. En la pantalla Especificar propiedades adicionales, no seleccione la casilla de verificación Síncrono, como se recomienda, active o desactive la casilla Incluir subclases según corresponda para cada evento y complete el asistente.

Para suscribirse a la clase o subclase Carpeta

  1. En Enterprise Manager, vaya a Object Stores/ROS/clase Carpeta o subclase 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. No seleccione la casilla de verificación Síncrono, como se recomienda, active o desactive la casilla Incluir subclases según corresponda y complete el asistente.

Para suscribirse a una carpeta específica del ROS:

  1. En Enterprise Manager, vaya hasta 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, no seleccione la casilla de verificación Síncrono, como se recomienda, 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 Enterprise Manager, vaya a Object Stores/ROS/clase Documento 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 evento que ha importado.
  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 Enterprise Manager, vaya a Object Stores/ROS/clase Documento 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 evento que ha importado.
  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 Enterprise Manager, vaya a Object Stores/FPOS/Other Classes/CustomObject/clase Sistema de RM.
  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 evento que ha importado.
  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 evento de la clase Carpeta de registros:

  1. En Enterprise Manager, vaya a Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/clase Carpeta de registros.
  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 evento que ha importado.
  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 Enterprise Manager, vaya a Object Stores/PRO FPOS/Other Classes/Folder/RM Folder/clase Volumen.
  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 evento que ha importado.
  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 Enterprise Manager, vaya a Object Stores/PRO-FPOS/Document Class/clase Registro.
  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 evento que ha importado.
  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 evento RMSendEmailOnSupercede

  1. En Enterprise Manager, vaya a Object Stores/FPOS/Document Class/clase Registro.
  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 evento que ha importado.
  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 de PRO, tendrá que habilitar el evento ya existente, del siguiente modo:

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.

Suscríbase al evento de la clase Categoría de registro

  1. En Enterprise Manager, 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 evento que ha importado.
  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 Enterprise Manager, 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 evento que ha importado.
  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 Caja:

  1. En Enterprise Manager, 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 evento que ha importado.
  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 P8.



Feedback

Última actualización: Agosto de 2011


© Copyright IBM Corp. 2011.
Este centro de información se basa en la tecnología Eclipse. (http://www.eclipse.org)