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 efectua
uma operação específica (como, por exemplo, arquivar ou dar entrada do documento numa
pasta) num documento existente num armazenamento de objectos de registo (ROS), o
IBM Enterprise
Records cria automaticamente o registo
electrónico correspondente num armazenamento de objectos do plano de ficheiros (FPOS)
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 irá actualizar o documento quando
a propriedade correspondente do registo for 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, estes eventos de exemplo determinam quando deve eliminar o
contentor. Estes eventos de exemplo também garantem que a agenda de eliminação não irá
eliminar um contentor quando os registos tiverem sido declarados ou obtidos
recentemente.
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 para a classe Volume ou Caixa, sendo necessário 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 de um registo para
a 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, se a propagação for de registo para
pasta, o IBM Enterprise
Records actualiza a segurança
da pasta se a segurança do registo for superior à da respectiva 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 de registos com um nível de segurança baixo para o nível de segurança mais elevado das respectivas pastas ascendentes.
A definição na Configuração do sistema para os FPOS de PRO controla
a forma como a segurança é propagada. Esta propagação pode ser de pasta para registo,
de registo para pasta, ambas, ou poderá não ser permitida qualquer 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
detalhes sobre a descrição da substituição, bem com a 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.
Para criar acções de evento:
- Copie a pasta na raiz do CD,
~CDRoot\RecordsManager.<platform>\Events, para o servidor
antes de executar a IBM Administration
Console for Content Platform Engine. 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. 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, é apresentada uma mensagem a confirmar a importação. A acção de evento pode
ser criada sob a pasta Acção de evento do armazenamento de objectos. Os módulos do
código são criados na pasta Módulo de código.
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 do Workplace, do Workplace XT ou da IBM Administration
Console for Content Platform Engine. Após editar o ficheiro, dê entrada do mesmo. Para obter mais informações, consulte o tópico "Configurar a declaração automática dos
registos". No ficheiro RMSendEmailOnSupercede, os comentários
antes da linha que pretende modificar são claros: 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
Para criar a subscrição:
- Na IBM Administration
Console for Content Platform Engine, 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 que
importou.
- No ecrã para especificar propriedades adicionais, desmarque a caixa de verificação
Síncrono, seleccione ou desmarque a caixa de verificação
Incluir subclasses, conforme apropriado para cada evento, e
termine o assistente.
Para subscrever a classe ou subclasse Pasta:
- Na IBM Administration
Console for Content Platform Engine, 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, seleccione ou
desmarque a caixa de verificação Incluir subclasses, conforme
apropriado, e termine o assistente.
Para
subscrever uma pasta específica no ROS:
- Na IBM Administration
Console for Content Platform Engine, 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, 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:
- Na IBM Administration
Console for Content Platform Engine, 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 respectivo documento de origem:
- Na IBM Administration
Console for Content Platform Engine, 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:
- Na IBM Administration
Console for Content Platform Engine, 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 para a classe Pasta de registos:
- Na IBM Administration
Console for Content Platform Engine, 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:
- Na IBM Administration
Console for Content Platform Engine, 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:
- Na IBM Administration
Console for Content Platform Engine, 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 para o evento RMSendEmailOnSupercede:
- Na IBM Administration
Console for Content Platform Engine, 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, é necessário activar o evento já existente. Para activar o evento existente:
- Na IBM Administration
Console for Content Platform Engine, 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.
Para subscrever o evento para a classe Categoria de registo:
- Na IBM Administration
Console for Content Platform Engine, 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:
- Na IBM Administration
Console for Content Platform Engine, 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 para a classe Caixa:
- Na IBM Administration
Console for Content Platform Engine, 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 FileNet P8.