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çõesEventos |
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.
- 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.
- Execute os scripts de importação apropriados para criar ações de
evento que deseja usar.
- Clique com o botão direito do mouse no armazenamento de objetos do
IBM Enterprise
Records de destino.
- Selecione Importar Tudo.
- 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.
- No campo Caminho do Conteúdo Externo, navegue até a pasta ~\Events\lib.
- 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:
- O arquivo de configuração RMAutoDeclare é RMAutoDeclare.properties
sob a pasta Root Folder\RM Samples.
- O arquivo de configuração RMSendEmailOnSupercede é
RMSendEmailOnSupercede.properties sob a mesma pasta
Root Folder\RM Samples.
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
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/ROS/Classe
de documento ou subclasse na qual você deseja criar a assinatura.
- Clique com o botão direito do mouse na classe e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especificar Acionadores, selecione o acionador de evento Registro de Entrada.
- Na tela Especificar Ação de Evento, selecione a ação de evento que importou.
- 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
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/ROS/Classe
de pastas ou subclasse na qual você deseja criar a assinatura.
- Clique com o botão direito do mouse na classe e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especifique Acionadores, selecione o Ativador de evento de arquivo.
- 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:
- No Enterprise Manager, navegue até a pasta na qual deseja criar a assinatura.
- Clique com o botão direito do mouse na pasta e selecione Nova Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Aceite o padrão.
- Selecione o acionador de eventos Arquivar.
- Na tela Especificar Ação de Evento, selecione o evento RMAutoDeclare.
- 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:
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/ROS/Classe
de documento ou subclasse.
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especifique Acionadores, selecione o Ativador de evento de atualização.
- Selecione a ação de evento que você importou.
- 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
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/ROS/Classe
de documento ou subclasse.
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especifique Acionadores, selecione o Ativador de evento de atualização.
- Selecione a ação de evento que você importou.
- 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:
- No Enterprise Manager, navegue
até Armazenamentos de Objeto/FPOS/Outras Classes/CustomObject/Classe do sistema RM.
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especificar Acionadores, selecione o acionador de eventos Criação.
- Selecione a ação de evento que você importou.
- 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
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/PRO-FPOS/Outras Classes/Pasta/Pasta
RM/Classe de pastas do registro.
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especificar Acionadores, selecione os acionadores de eventos Arquivar e Atualizar.
- Selecione a ação de evento que você importou.
- 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:
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/PRO FPOS/Outras Classes/Pasta/Pasta
RM/Classe de volume.
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especificar Acionadores, selecione os acionadores de eventos
Arquivar e Atualizar.
- Selecione a ação de evento que você importou.
- 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:
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/PRO-FPOS/Classe de documento/Classe de registro.
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especifique Acionadores, selecione o Ativador de evento de atualização.
- Selecione a ação de evento que você importou.
- 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
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/FPOS/Classe de documento/Classe de registro.
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especificar Acionadores, selecione o acionador de evento Atualizar e
Efetuar o Registro de Entrada.
- Selecione a ação de evento que você importou.
- 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:
- No Enterprise Manager, navegue até a pasta
Armazenamentos de Objeto/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.
Assine para o evento para a classe Categoria de Registro
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/<FPOS>/Outras Classes/Pasta/Pasta
RM/Categoria do Registro
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especifique Acionadores, selecione o Ativador de evento de arquivo.
- Selecione a ação de evento que você importou.
- 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:
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/FPOS/Outras Classes/Pasta/Pasta
RM/Volume
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especifique Acionadores, selecione o Ativador de evento de arquivo.
- Selecione a ação de evento que você importou.
- 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
- No Enterprise Manager, navegue até
Armazenamentos de Objeto/FPOS/Outras Classes/Pasta/Pasta
RM/Contêiner Físico/Caixa
- Clique com o botão direito do mouse e selecione Incluir Assinatura.
- Especifique um nome único e uma descrição a assinatura.
- Selecione o botão de opções Aplica para todas as instâncias.
- Na tela Especifique Acionadores, selecione o Ativador de evento de arquivo.
- Selecione a ação de evento que você importou.
- 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.