IBM Enterprise Records, Versão 5.1.2    

Rotinas de tratamento de eventos

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ções
Eventos 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:
  1. 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.
  2. Execute os scripts de importação adequados para criar as acções de evento que pretende utilizar.
    1. Faça clique com o botão direito do rato no objecto de destino do IBM Enterprise Records.
    2. Seleccione Importar tudo.
    3. 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.
    4. No campo de caminho de conteúdo externo, avance até à pasta ~\Events\lib.
    5. 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:

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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/ROS/classe de documento ou subclasse onde pretende criar a subscrição.
  2. Faça clique com o botão direito do rato na classe e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Dar entrada.
  6. No ecrã para especificar a acção de evento, seleccione a acção de evento que importou.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/ROS/classe de pasta ou subclasse onde pretende criar a subscrição.
  2. Faça clique com o botão direito do rato na classe e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Arquivar.
  6. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda à pasta onde pretende criar a subscrição.
  2. Faça clique com o botão direito do rato na pasta e seleccione Nova subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Aceite a predefinição.
  5. Seleccione o activador de eventos de ficheiro.
  6. No ecrã para especificar a acção de evento, seleccione o evento RMAutoDeclare.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/ROS/classe de documento ou subclasse.
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Actualizar.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/ROS/classe de documento ou subclasse.
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Actualizar.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/FPOS/Other Classes/CustomObject/RM System class.
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Criação.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/Record Folder class.
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione os activadores de evento Arquivar e Actualizar.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/PRO FPOS/Other Classes/Folder/RM Folder/Volume class.
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione os activadores de evento Arquivar e Actualizar.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/PRO-FPOS/Document Class/Record class.
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Actualizar.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/FPOS/Document Class/Record class.
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione os activadores de evento Actualizar e Dar entrada.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record Category
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Arquivar.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/FPOS/Other Classes/Folder/RM Folder/Volume
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Arquivar.
  6. Seleccione a acção de evento importada.
  7. 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:
  1. Na IBM Administration Console for Content Platform Engine, aceda a Object Stores/FPOS/Other Classes/Folder/RM Folder/Physical Container/Box
  2. Faça clique com o botão direito do rato e seleccione Adicionar subscrição.
  3. Especifique um nome exclusivo e uma descrição para a subscrição.
  4. Seleccione o selector de opção Aplicável a todas as instâncias.
  5. No ecrã para especificar activadores, seleccione o activador de evento Arquivar.
  6. Seleccione a acção de evento importada.
  7. 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.



Comentários

Última actualização: Novembro de 2013
work_with_event_handlers.htm

© Copyright IBM Corp. 2013