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çõesEventos |
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
- 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.
- 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 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.
- 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ê 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:
- 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.
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:
- No IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objeto/ROS/Classe de
Documento ou subclasse em que 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 você importou.
- 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:
- No IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/ROS/Classe de
Pasta ou subclasse em que 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, 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 IBM Administration
Console for Content Platform Engine, acesse a pasta em que
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, 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:
- No IBM Administration
Console for Content Platform Engine, acesse
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 importada.
- 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 IBM Administration
Console for Content Platform Engine, acesse
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 importada.
- 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 IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/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 importada.
- 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:
- No IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/PRO-FPOS/Outras
Classes/Pasta/Pasta RM/Classe de Pastas 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 os acionadores de eventos Arquivar e Atualizar.
- Selecione a ação de evento importada.
- 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 IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/FPOS PRO/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 importada.
- 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 IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/FPOS PRO/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 importada.
- 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 IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/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 importada.
- 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:
- No IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/<FPOS>/Outras Classes/Pasta/Pasta
RM/Categoria 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 arquivo.
- Selecione a ação de evento importada.
- 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 IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/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 importada.
- 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:
- No IBM Administration
Console for Content Platform Engine, acesse
Armazenamentos de Objetos/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 importada.
- 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.