IBM Enterprise Records, Versão 5.1.+            

Trabalhar com 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 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.

  1. 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.
  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 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.
    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, 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:

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

  1. No Enterprise Manager, 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 importada.
  7. 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

  1. No Enterprise Manager, 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, 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:

  1. No Enterprise Manager, 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, 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:

  1. No Enterprise Manager, 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 documento de origem

  1. No Enterprise Manager, 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. No Enterprise Manager, 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 na classe Pasta de registo

  1. No Enterprise Manager, 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. No Enterprise Manager, 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. No Enterprise Manager, 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 o evento RMSendEmailOnSupercede

  1. No Enterprise Manager, 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, tem de activar o evento já existente, do seguinte modo:

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

  1. No Enterprise Manager, 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. No Enterprise Manager, 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 na classe Caixa

  1. No Enterprise Manager, 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 P8.



Comentários

Última actualização: Agosto de 2011


© Copyright IBM Corp. 2011.
Este Information Center é baseado na tecnologia Eclipse. (http://www.eclipse.org)