IBM Enterprise Records, Versão 5.1.+            

Trabalhando com 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 no 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 registro de entrada ou arquivo em uma pasta) em um documento em um Armazenamento de Objetos de Registros (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ê sincronizar a partir 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 ou garantem que um planejamento da disposição não descarta um contêiner no qual os registros foram recentemente declarados ou recuperados.

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 subscreve o evento RMUpdateDateDeclared automaticamente à classe Volume ou Caixa e você só precisa 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 sua 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 for de registro para pasta, o IBM Enterprise Records atualiza a segurança da pasta-pai se a segurança do registro for superior que a de sua pasta-pai. Outras pastas nas quais o registro é arquivado não são afetadas.

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

A configuração na Configuração do Sistema para o FPOS PRO controla como a segurança é propagada — da pasta para o registro, do registro para a pasta, ambos ou sem permissão de propagação.

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. A mensagem de e-mail contém os detalhes sobre a descrição do registro de substituição, a data e o horário que ele foi substituído. O e-mail é enviado quando o contêiner possui o planejamento da disposição que define um acionador com base em um evento de substituição.

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

Os arquivos jar do manipulador de eventos de amostra do IBM Enterprise Records são armazenados como módulos de código no armazenamento de objetos 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.

  1. Copie a pasta sob a raiz do CD, ~CDRoot\RecordsManager.<platform>\Events, para o servidor no qual o EM é executado. 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 Auxiliar de Importação, guia Opções de Importação, campo Importar Arquivo de Manifesto, navegue até a pasta copiada e selecione o script de importação para o evento necessário. 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ê deve visualizar uma mensagem "Sucesso na Importação". A ação de evento deve ser criada sob a pasta Ação de Evento do armazenamento de objetos e os módulos de código serã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:

Efetue o registro de saída do arquivo de configuração, seja do Workplace ou do Workplace XT ou Enterprise Manager. Após editar, efetue o seu registro de entrada. Consulte o Configurando Declaração Automática de Registros. Para o arquivo RMSendEmailOnSupercede, os comentários precedendo a linha modificada são óbvios (host SMTP, número da porta, endereços de e-mail do emissor e receptor).

Criar Assinaturas

Cada evento requer assinaturas para uma ou mais classes.

Assinatura para o Evento RMAutoDeclare

  1. No Enterprise Manager, navegue até Armazenamentos de Objeto/ROS/Classe de documento ou subclasse na qual você 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 importou.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Síncrono, conforme recomendado, e 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 Pasta

  1. No Enterprise Manager, navegue até Armazenamentos de Objeto/ROS/Classe de pastas ou subclasse na qual você 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, conforme recomendado, e 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 Enterprise Manager, navegue até a pasta na qual 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, conforme recomendado, e aceite o resto 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 Enterprise Manager, navegue até 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 que você importou.
  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 Enterprise Manager, navegue até 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 que você importou.
  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 Enterprise Manager, navegue até Armazenamentos de Objeto/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 que você importou.
  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 Pasta de Registro

  1. No Enterprise Manager, navegue até Armazenamentos de Objeto/PRO-FPOS/Outras Classes/Pasta/Pasta RM/Classe de pastas do 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 que você importou.
  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 Enterprise Manager, navegue até Armazenamentos de Objeto/PRO FPOS/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 que você importou.
  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 Enterprise Manager, navegue até Armazenamentos de Objeto/PRO-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 Especifique Acionadores, selecione o Ativador de evento de atualização.
  6. Selecione a ação de evento que você importou.
  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 Enterprise Manager, navegue até Armazenamentos de Objeto/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 que você importou.
  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, é preciso ativar o evento já existente, conforme a seguir:

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

Assine para o evento para a classe Categoria de Registro

  1. No Enterprise Manager, navegue até Armazenamentos de Objeto/<FPOS>/Outras Classes/Pasta/Pasta RM/Categoria do 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 que você importou.
  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 Enterprise Manager, navegue até Armazenamentos de Objeto/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 que você importou.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Incluir Subclasses e conclua o assistente.

Para assinar para o evento para a classe Caixa

  1. No Enterprise Manager, navegue até Armazenamentos de Objeto/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 que você importou.
  7. Na tela Especificar Propriedades Adicionais, limpe a caixa de seleção Incluir Subclasses e conclua o assistente.

Para obter informações sobre a customização de eventos, consulte o pacote de software P8.



Feedback

Última atualização: Agosto 2011


© Copyright IBM Corporation 2011.
Este centro de informações é desenvolvido com tecnologia Eclipse. (http://www.eclipse.org)