O IBM®
Enterprise Records fornece os eventos de
exemplo seguintes para os modelos de dados Base, DoD, e PRO.
Pode personalizar os exemplos conforme necessário. Consulte o ficheiro Readme na pasta
Eventos no pacote de software.
Tabela 1. Eventos e descriçõesEventos |
Descrição |
RMAutoDeclare |
Configura declaração automática de registos. Quando um utilizador realiza uma
operação específica (como por exemplo, dar entrada ou arquivar numa pasta) num documento
num armazenamento de objectos de registos (ROS, Records Object Store), o
IBM Enterprise
Records cria automaticamente um registo
electrónico correspondente num armazenamento de objectos de plano de ficheiros (FPOS, File
Plan Object Store) específico. Também pode configurar este evento de exemplo para declarar todos os
documentos pertencentes a uma classe de documento específica, quando um utilizador dá
entrada do documento.
O evento de exemplo suporta a declaração não classificada de
apenas registos electrónicos. Este evento tem de ser configurado para utilizar eventos
assíncronos e NÃO síncronos.
|
RMAutoSynchronizeProperties |
Sincroniza as propriedades dos registos e dos respectivos documentos associados. Por exemplo, quando um utilizador actualiza um valor de propriedade de um registo, o
IBM Enterprise
Records também actualiza o valor da
propriedade correspondente nos documentos associados.
Este evento de exemplo
funciona para propriedades que utilizam o mesmo nome simbólico.
Pode criar uma sincronização de documento para registo ou de registo para documento, mas não ambos.
Se sincronizar de registo para documento, o
IBM Enterprise
Records actualiza o documento quando a
propriedade correspondente do registo é actualizada.
Este evento também
sincroniza nomes alternativos de propriedades entre armazenamentos de objectos de registo
para documento ou de documento para registo, mas não ambos.
|
RMUpdateDateDeclared RMLastRetrievalOfRecord
|
Em conjunto, este eventos de exemplo determinam quando eliminar o contentor, ou
certifique-se que uma agenda de eliminação não elimina um contentor em que os registos
tenham sido recentemente declarados ou obtidos.
O
IBM Enterprise
Records aplica este evento de exemplo às
classes Volume e Caixa e defini a Data da última declaração na pasta ascendente quando
um utilizador declara um registo.
Para o modelo de dados PRO, o
IBM Enterprise
Records subscreve automaticamente o evento
RMUpdateDateDeclared na classe Volume ou Caixa, e terá apenas de activar o evento. Para os outros modelos de dados, é necessário executar o script de importação para criar
o evento RMUpdateDateDeclared e subscrever a classe Volume ou Caixa.
RMLastRetrievalOfRecord define a data da última revisão do conteúdo do registos para a
respectiva propriedade LastRetrievalofRecord da pasta.
|
RMSecurityPropagation |
(Apenas para PRO) Utilizado apenas para o modelo de dados PRO, este evento de
exemplo define o valor de marcação da propriedade Categoria de segurança do registo,
volume e pasta de registos (mas não categoria de registo), com base no nível mais elevado
de uma entidade associada.
Por exemplo, quando a propagação for efectuada de
registo para pasta, o IBM Enterprise
Records actualiza a
segurança da pasta ascendente se a segurança do registo for mais elevada do que a segurança da pasta ascendente.
Outras pastas em que o registo está arquivado não são afectadas.
Quando a
propagação é efectuada de pasta para registo, o
IBM Enterprise
Records actualiza a segurança dos registos
com um nível de segurança inferior para o nível de segurança mais elevado das pastas
ascendentes
A definição na configuração de sistema dos FPOS de PRO controla a forma
de propagação da segurança; de pasta para registo, de registo para pasta, ambos ou sem
propagação.
|
RMSendEmailOnSupercede |
Este evento de exemplo envia uma mensagem de correio electrónica sempre que um
registo é substituído por uma nova versão. A mensagem de correio electrónico contém os
detalhes sobre a descrição do registo substituído, data e hora da substituição. A
mensagem de correio electrónico é enviada quando o contentor tem uma agenda de eliminação
que define um activador com base num evento de substituição.
Restrição: Este evento não é
suportado em JBoss ou WebLogic.
|
Os ficheiros jar da rotina de tratamento de eventos de exemplo do
IBM Enterprise
Records são armazenados como módulos de
código no armazenamento de objectos de destino. A vantagem é que pode adicionar ou
actualizar a rotina de tratamento de eventos dando entrada de uma nova versão sem reiniciar o servidor da aplicação.
A configuração dos eventos de exemplo do IBM
Enterprise Records é efectuada do seguinte modo:
Criar acções de evento
Antes de iniciar este procedimento,
certifique-se de que a pasta com o nome CodeModules existe na pasta raiz do armazenamento
de objectos em que as acções de evento serão criadas. Se essa pasta não existir, siga as
instruções no IBM FileNet P8 Platform Installation
and Upgrade Guide para criar a pasta.
- Copie a pasta na raiz do CD, ~CDRoot\RecordsManager.<platform>\Events,
para o servidor antes de executar o EM. Esta pasta contém os scripts de importação, os
ficheiros JAR e os ficheiros de configuração.
- Execute os scripts de importação adequados para criar as acções de evento que pretende utilizar.
- Faça clique com o botão direito do rato no objecto de destino do
IBM Enterprise
Records.
- Seleccione Importar tudo.
- Na caixa de diálogo de ajuda de importação, no separador de opções de importação, campo
de importação de ficheiro de diagnóstico, aceda à pasta copiada e seleccione o
script de importação para o evento requerido. Cada ficheiro tem o nome do evento.
Por exemplo, o ficheiro de importação do evento RMAutoDeclare tem o nome RMAutoDeclareImport.xml.
- No campo de caminho de conteúdo externo, avance até à pasta ~\Events\lib.
- Faça clique em Importar.
Quando a importação
terminar, deverá ser apresentada uma mensagem a confirmar a importação. A acção de evento
deverá ser criada na pasta de acção de evento do armazenamento de objectos e os módulos de código serão criados na pasta respectiva.
Personalizar ficheiros de configuração
Os eventos RMAutoDeclare
e RMSendEmailOnSupercede têm ficheiros de configuração próprios.
O script de importação cria os ficheiros no armazenamento de objectos:
- O ficheiro de configuração de RMAutoDeclare é
RMAutoDeclare.properties na pasta Root Folder\RM
Samples.
- O ficheiro de configuração de RMSendEmailOnSupercede é
RMSendEmailOnSupercede.properties na mesma pasta Root
Folder\RM Samples.
Dê saída do ficheiro de configuração a partir
do Workplace, do
Workplace XT ou do
Enterprise Manager. Após editar o ficheiro, dê entrada do mesmo. Consulte o tópico Configurar a declaração automática dos registos.
No ficheiro RMSendEmailOnSupercede, os comentários antes da
linha que modificar são explicativos (sistema central SMTP, número de porta, endereços de
correio electrónico do remetente e destinatário).
Criar subscrições
Para cada evento são necessárias subscrições em uma ou mais classes.
Subscrição no evento RMAutoDeclare
- No Enterprise Manager, aceda a Object
Stores/ROS/classe de documento ou
subclasse onde pretende criar a subscrição.
- Faça clique com o botão direito do rato na classe e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Dar entrada.
- No ecrã para especificar a acção de evento, seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Síncrono, conforme recomendado, e marque ou desmarque a caixa de
selecção Incluir subclasses, conforme apropriado, para cada evento
e termine o assistente.
Para subscrever a classe ou subclasse Pasta
- No Enterprise Manager, aceda a Object
Stores/ROS/classe de pasta ou subclasse
onde pretende criar a subscrição.
- Faça clique com o botão direito do rato na classe e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Arquivar.
- Desmarque a caixa de verificação Síncrono, conforme
recomendado, e marque ou desmarque a caixa de verificação Incluir
subclasses e termine o assistente.
Para
subscrever uma pasta específica no ROS:
- No Enterprise Manager, aceda à pasta onde pretende
criar a subscrição.
- Faça clique com o botão direito do rato na pasta e seleccione Nova
subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Aceite a predefinição.
- Seleccione o activador de eventos de ficheiro.
- No ecrã para especificar a acção de evento, seleccione o evento RMAutoDeclare.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Síncrono, conforme recomendado, aceite as restantes predefinições
e termine o assistente.
Subscrição no evento RMAutoSynchronizeProperties
Subscrever o
evento RMAutoSynchronizeProperties sincroniza as propriedade do documento de origem para
o registo respectivo, ou do registo para o documento de origem.
Não tente
sincronizar em ambas as direcções.
Este evento tem de ser configurado para utilizar eventos síncronos.
Para sincronizar do documento de origem para o registo:
- No Enterprise Manager, aceda a Object
Stores/ROS/classe de documento ou subclasse.
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Actualizar.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, seleccione a caixa de verificação
Síncrono, mas desmarque a caixa de verificação Incluir
subclasses e termine o assistente.
Para sincronizar do registo
para o documento de origem
- No Enterprise Manager, aceda a Object
Stores/ROS/classe de documento ou subclasse.
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Actualizar.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, seleccione a caixa de verificação
Síncrono, mas desmarque a caixa de verificação Incluir
subclasses e termine o assistente.
Subscrição no evento RMLastRetrievalOfRecord
Para subscrever o evento RMLastRetrievalOfRecord:
- No Enterprise Manager, aceda a Object
Stores/FPOS/Other Classes/CustomObject/RM System class.
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Criação.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Incluir subclasses, seleccione a caixa de verificação
Síncrono e termine o assistente.
Subscrição no evento RMSecurityPropagation (Apenas para PRO)
Pode criar uma subscrição para este evento para a classe Pasta de registo, Volume ou Registo.
Para subscrever o evento na classe Pasta de registo
- No Enterprise Manager, aceda a
Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/Record
Folder class.
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione os activadores de evento Arquivar e Actualizar.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Incluir subclasses e termine o assistente.
Para subscrever o evento na classe Volume:
- No Enterprise Manager, aceda a Object
Stores/PRO FPOS/Other Classes/Folder/RM Folder/Volume class.
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione os activadores de evento Arquivar e Actualizar.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Incluir subclasses e termine o assistente.
Para subscrever o evento para a classe Registo:
- No Enterprise Manager, aceda a
Object Stores/PRO-FPOS/Document Class/Record
class.
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Actualizar.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, seleccione a caixa de verificação
Incluir subclasses e termine o assistente.
Subscrição no evento RMSendEmailOnSupercede
Para subscrever o
evento RMSendEmailOnSupercede
- No Enterprise Manager, aceda a
Object Stores/FPOS/Document Class/Record class.
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione os activadores de evento Actualizar e Dar entrada.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, seleccione a caixa de verificação
Incluir subclasses e termine o assistente.
Subscrição no evento RMUpdateDateDeclared
Para o modelo de
dados PRO, tem de activar o evento já existente, do seguinte modo:
- No Enterprise Manager, aceda à pasta
Object Stores/FPOS/Events/Event Action.
- Faça clique com o botão direito do rato em UpdateDateDeclared.
- Faça clique em Activar.
Nos modelos de dados DoD e
Base, subscreva as classes Categoria de registo, Volume e Caixa depois de criar o evento.
Subscreva o evento na classe Categoria de registo
- No Enterprise Manager, aceda a
Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record
Category
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Arquivar.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Incluir subclasses e termine o assistente.
Para subscrever o evento na classe Volume:
- No Enterprise Manager, aceda a
Object Stores/FPOS/Other Classes/Folder/RM
Folder/Volume
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Arquivar.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Incluir subclasses e termine o assistente.
Para subscrever o evento na classe Caixa
- No Enterprise Manager, aceda a
Object Stores/FPOS/Other Classes/Folder/RM Folder/Physical
Container/Box
- Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
- Especifique um nome exclusivo e uma descrição para a subscrição.
- Seleccione o selector de opção Aplicável a todas as instâncias.
- No ecrã para especificar activadores, seleccione o activador de evento Arquivar.
- Seleccione a acção de evento importada.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Incluir subclasses e termine o assistente.
Para obter mais informações sobre a personalização de eventos, consulte o pacote de software do P8.