IBM Enterprise Records, Versão 5.1.2    

Manipuladores de Eventos

O IBM® Enterprise Records fornece os seguintes eventos de amostra para os modelos de dados Base, DoD e PRO.

É possível customizar as amostras conforme necessário. Consulte o arquivo Leia-me na pasta Eventos do pacote de software.

Tabela 1. Eventos e Descrições
Eventos Descrição
RMAutoDeclare

Configura a declaração automática de registros. Quando um usuário executa uma operação específica (como check-in ou arquivo em uma pasta) em um documento em um Records Object Store (ROS), o IBM Enterprise Records cria automaticamente um registro eletrônico correspondente em um armazenamento de objetos de plano de arquivos (FPOS) específico. Também é possível configurar esse evento de amostra para declarar cada documento que pertence a uma classe de documento específica quando um usuário efetua o registro de entrada do documento.

O evento de amostra suporta apenas a declaração não classificada do registro eletrônico. Este evento deve ser configurado para usar eventos assíncronos e NÃO síncronos.

RMAutoSynchronizeProperties

Sincroniza as propriedades dos registros e seus documentos associados. Por exemplo, quando um usuário atualiza um valor da propriedade de um registro, o IBM Enterprise Records atualiza o valor da propriedade correspondente nos documentos associados também.

Este evento de amostra funciona para propriedades que usam o mesmo nome simbólico. É possível sincronizar a partir do documento para registro ou a partir do registro para o documento, mas não ambos. Se você sincroniza do registro para o documento, o IBM Enterprise Records atualiza o documento quando a propriedade correspondente do registro for atualizada.

Este evento também sincroniza aliases de propriedades nos armazenamentos de objetos, seja a partir do registro para o documento ou a partir do documento para o registro, mas não ambos.

RMUpdateDateDeclared

RMLastRetrievalOfRecord

Juntos, esses eventos de amostra determinam quando descartar o contêiner. Os eventos de amostra também asseguram que um planejamento de disposição não descarte um contêiner no qual registros são declarados ou recuperados recentemente.

O IBM Enterprise Records aplica este evento de amostra às classes Volume e Caixa e configura a Data da Última Declaração na pasta-pai quando um usuário declara um registro.

Para o modelo de dados PRO, o IBM Enterprise Records assina automaticamente o evento RMUpdateDateDeclared para a classe Volume ou Caixa, e é necessário ativar o evento. Para os outros modelos de dados, você deve executar o script de importação para criar o evento RMUpdateDateDeclared e assinar para a classe Volume ou Caixa.

RMLastRetrievalOfRecord configura a data da última revisão do conteúdo de um registro para a propriedade LastRetrievalofRecord da pasta.

RMSecurityPropagation

(PRO Apenas) Usado apenas para o modelo de dados PRO, este evento de amostra configura o valor de marcação da propriedade Categoria de Segurança do registro, volume e pasta de registro (mas não da categoria de registro) com base no mais alto nível de uma entidade associada.

Por exemplo, quando a propagação é do registro para a pasta, o IBM Enterprise Records atualiza a segurança da pasta-pai caso a segurança do registro seja superior à da pasta-pai. Outras pastas nas quais o registro é arquivado não são afetadas.

Quando a propagação é da pasta para o registro, o IBM Enterprise Records atualiza a segurança dos registros em um nível de segurança mais baixo para o nível de segurança mais alto de suas pastas-pai.

A definição na Configuração do Sistema para o FPOS do PRO controla como a segurança é propagada. Essa propagação pode ser de pasta para registro, de registro para pasta, ambas ou nenhuma propagação permitida.

RMSendEmailOnSupercede

Este evento de amostra faz com que um e-mail seja enviado toda vez que um registro é substituído por uma nova versão. O email contém os detalhes sobre a descrição da suplantação, além da data e hora. O email é enviado quando o contêiner tem um planejamento de disposição que define um acionador baseado em um evento de suplantação.

Restrição: Este evento não é suportado no JBoss ou WebLogic.

Arquivos JAR do manipulador de eventos de amostra do IBM Enterprise Records são armazenados como módulos de código no armazenamento de objeto de destino. A vantagem é que você pode incluir ou atualizar o manipulador de eventos ao efetuar o registro de entrada de uma nova versão sem reiniciar o servidor de aplicativos. Configurando os eventos de amostra do IBM Enterprise Records conforme a seguir:

Criar Ações de Evento

Ante de iniciar este procedimento, certifique-se de que a pasta denominada CodeModules exista sob a pasta-raiz do armazenamento de objetos no qual você está prestes a criar ações de evento. Se esta pasta não existir, siga as instruções no IBM FileNet P8 Platform Installation and Upgrade Guide para criá-la.

Para criar ações de evento
  1. Copie a pasta sob a raiz do CD, ~CDRoot\RecordsManager.<platform>\Events, no servidor onde você executa IBM Administration Console for Content Platform Engine. Esta pasta contém os scripts de importação, arquivos JAR e arquivos de configuração.
  2. Execute os scripts de importação apropriados para criar ações de evento que deseja usar.
    1. Clique com o botão direito do mouse no armazenamento de objetos do IBM Enterprise Records de destino.
    2. Selecione Importar Tudo.
    3. No diálogo Importar Auxiliar, guia Opções de Importação, campo Importar Arquivo de Manifesto, navegue para a pasta copiada. Selecione o script de importação para o evento requerido. Cada arquivo é denominado após o evento. Por exemplo, o arquivo de importação para o evento RMAutoDeclare é denominado RMAutoDeclareImport.xml.
    4. No campo Caminho do Conteúdo Externo, navegue até a pasta ~\Events\lib.
    5. Clique em Importar.

    Após a importação ser concluída, você verá uma mensagem "Importação com Sucesso". A ação de evento pode ser criada sob a pasta Ação de Evento do armazenamento de objeto. Os módulos de código são criados na pasta Módulo de Código.

Customizar Arquivos de Configuração

Os eventos RMAutoDeclare e RMSendEmailOnSupercede possuem seus próprios arquivos de configuração. O script de importação cria os arquivos no armazenamento de objetos:

Verifique o arquivo de registro em Workplace ou Workplace XT ou IBM Administration Console for Content Platform Engine. Após editar, efetue o seu registro de entrada. Para obter mais informações, consulte o tópico sobre configuração de autodeclaração de registros. Para o arquivo RMSendEmailOnSupercede, os comentários que precedem a linha que você modifica são autoexplicativos: host SMTP, número da porta, endereços do remetente e do destinatário.

Criar Assinaturas

Cada evento requer assinaturas para uma ou mais classes.

Assinatura para o Evento RMAutoDeclare

Para criar a assinatura:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objeto/ROS/Classe de Documento ou subclasse em que deseja criar a assinatura.
  2. Clique com o botão direito do mouse na classe e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especificar Acionadores, selecione o acionador de evento Registro de Entrada.
  6. Na tela Especificar Ação de Evento, selecione a ação de evento que você importou.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Síncrono, marque ou limpe a caixa de seleção Incluir Subclasses conforme apropriado para cada evento e conclua o assistente.
Para assinar a classe ou subclasse de pastas:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/ROS/Classe de Pasta ou subclasse em que deseja criar a assinatura.
  2. Clique com o botão direito do mouse na classe e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especifique Acionadores, selecione o Ativador de evento de arquivo.
  6. Limpe a caixa de seleção Síncrono, marque ou limpe a caixa de seleção Incluir Subclasses conforme apropriado e conclua o assistente.
Para assinar uma pasta específica no ROS:
  1. No IBM Administration Console for Content Platform Engine, acesse a pasta em que deseja criar a assinatura.
  2. Clique com o botão direito do mouse na pasta e selecione Nova Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Aceite o padrão.
  5. Selecione o acionador de eventos Arquivar.
  6. Na tela Especificar Ação de Evento, selecione o evento RMAutoDeclare.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Síncrono, aceite o restante das configurações padrão e conclua o assistente.

Assinatura para o Evento RMAutoSynchronizeProperties

Assinar o evento RMAutoSynchronizeProperties sincroniza as propriedades do documento de origem com seu registro, ou do registro para seu documento de origem.

Não tente sincronizar em ambas as direções. Este evento deve ser configurado para usar eventos síncronos.

Para sincronizar do documento de origem para seu registro:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objeto/ROS/Classe de Documento ou subclasse.
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especifique Acionadores, selecione o Ativador de evento de atualização.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, selecione a caixa de seleção Síncrono, mas limpe a caixa de seleção Incluir Subclasses e conclua o assistente.
Para sincronizar do registro para seu documento de origem:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objeto/ROS/Classe de Documento ou subclasse.
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especifique Acionadores, selecione o Ativador de evento de atualização.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, selecione a caixa de seleção Síncrono, mas limpe a caixa de seleção Incluir Subclasses e conclua o assistente.

Assinatura para o Evento RMLastRetrievalOfRecord

Para assinar o evento RMLastRetrievalOfRecord:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/FPOS/Outras Classes/CustomObject/Classe do Sistema RM.
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especificar Acionadores, selecione o acionador de eventos Criação.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Incluir Subclasses, selecione a caixa de seleção Síncrono e conclua o assistente.

Assinatura para o Evento RMSecurityPropagation (Apenas para PRO)

É possível criar uma assinatura para este evento para a classe Pasta de Registro, a classe Volume ou a classe Registro.

Para assinar o evento para a classe Registro de Pastas:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/PRO-FPOS/Outras Classes/Pasta/Pasta RM/Classe de Pastas de Registro.
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especificar Acionadores, selecione os acionadores de eventos Arquivar e Atualizar.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Incluir Subclasses e conclua o assistente.
Para assinar o evento para a classe Volume:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/FPOS PRO/Outras Classes/Pasta/Pasta RM/Classe de Volume.
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especificar Acionadores, selecione os acionadores de eventos Arquivar e Atualizar.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Incluir Subclasses e conclua o assistente.
Para assinar o evento para a classe Registro:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/FPOS PRO/Classe de Documento/Classe de Registro.
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especifique Acionadores, selecione o Ativador de evento de atualização.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, selecione a caixa de seleção Incluir Subclasses e conclua o assistente.

Assinatura para o Evento RMSendEmailOnSupercede

Para assinar o evento RMSendEmailOnSupercede:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/FPOS/Classe de Documento/Classe de Registro.
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especificar Acionadores, selecione o acionador de evento Atualizar e Efetuar o Registro de Entrada.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, selecione a caixa de seleção Incluir Subclasses e conclua o assistente.

Assinatura para o Evento RMUpdateDateDeclared

Para o modelo de dados PRO, é necessário ativar o evento já existente. Para ativar o evento existente:
  • No IBM Administration Console for Content Platform Engine, acesse a pasta Armazenamentos de Objetos/FPOS/Eventos/Ação de Evento.
  • Clique com o botão direito do mouse em UpdateDateDeclared.
  • Clique em Ativar.

Para os modelos de dados DoD e Base, assine para as classes Categoria de Registro, Volume e Caixa após criar o evento.

Para assinar o evento para a classe Categoria de Registro:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/<FPOS>/Outras Classes/Pasta/Pasta RM/Categoria de Registro
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especifique Acionadores, selecione o Ativador de evento de arquivo.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Incluir Subclasses e conclua o assistente.
Para assinar o evento para a classe Volume:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/FPOS/Outras Classes/Pasta/Pasta RM/Volume
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especifique Acionadores, selecione o Ativador de evento de arquivo.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Incluir Subclasses e conclua o assistente.
Para assinar o evento para a classe Caixa:
  1. No IBM Administration Console for Content Platform Engine, acesse Armazenamentos de Objetos/FPOS/Outras Classes/Pasta/Pasta RM/Contêiner Físico/Caixa
  2. Clique com o botão direito do mouse e selecione Incluir Assinatura.
  3. Especifique um nome único e uma descrição a assinatura.
  4. Selecione o botão de opções Aplica para todas as instâncias.
  5. Na tela Especifique Acionadores, selecione o Ativador de evento de arquivo.
  6. Selecione a ação de evento importada.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Incluir Subclasses e conclua o assistente.

Para obter informações sobre como customizar eventos, consulte o pacote do software FileNet P8.



Feedback

Última atualização: novembro de 2013
work_with_event_handlers.htm

© Copyright IBM Corporation 2013