IBM Enterprise Records, Version 5.1.+            

Arbeta med händelsehanterare

IBM® Enterprise Records innehåller följande exempelhändelser för bas-, DoD och PRO-datamodeller.

Du kan anpassa exemplen efter behov. Se Readme-filen i mappen Events i programpaketet.

Tabell 1. Händelser och beskrivningar
Händelser Beskrivning
RMAutoDeclare

Konfigurerar autodeklaration av poster. När en användare utför en viss åtgärd (t.ex. checkar in eller arkiverar i en mapp) för ett dokument i ett ROS (Records Object Store), skapar IBM Enterprise Records automatiskt en motsvarande elektronisk post i ett visst FPOS (File Plan Object Store). Du kan också konfigurera exempelhändelsen att deklarera varje dokument som tillhör en viss dokumentklass när en användare checkar in dokumentet.

Exempelhändelsen hanterar endast oklassificerade deklarationer av elektroniska poster. Händelsen måste konfigureras att använda asynkrona, INTE synkrona, händelser.

RMAutoSynchronizeProperties

Synkroniserar egenskaperna för poster och deras tillhörande dokument. Exempel: Om en användare uppdaterar ett egenskapsvärde för en post, uppdaterar IBM Enterprise Records motsvarande egenskapsvärde även i de tillhörande dokumenten.

Denna exempelhändelse fungerar för egenskaper som använder samma symboliska namn. Du kan synkronisera från dokument till post eller från post till dokument, men inte bådadera. Om du synkroniserar från post till dokument, uppdaterar IBM Enterprise Records dokumentet när postens motsvarande egenskap uppdateras.

Denna händelse synkroniserar även egenskapsalias i objektlagren, antingen från post till dokument, eller från dokument till post, men inte bådadera.

RMUpdateDateDeclared

RMLastRetrievalOfRecord

Tillsammans bestämmer dessa exempelhändelser när behållaren ska avvecklas, eller säkerställer att avvecklingsschemat inte avvecklar en behållare där poster nyligen har deklarerats eller hämtats.

IBM Enterprise Records tillämpar exempelhändelsen på klasserna Volume och Box och ställer in datum för senaste deklaration för den överordnade mappen när en användare deklarerar en post.

För PRO-datamodellen prenumererar IBM Enterprise Records automatiskt på händelsen RMUpdateDateDeclared för klassen Volume eller Box och du behöver bara aktivera händelsen. För andra datamodeller måste du köra importskriptet för att skapa händelsen RMUpdateDateDeclared och prenumerera på klassen Volume eller Box.

RMLastRetrievalOfRecord ställer in datumet för den senaste granskningen av en posts innehåll enligt mappens egenskap LastRetrievalofRecord.

RMSecurityPropagation

(Endast PRO) Används enbart för PRO-datamodellen. Exempelhändelsen ställer in märkningsvärdet för egenskapen Security Category för posten, volymen och postmappen (men inte för postkategorin) baserat på den högsta nivån för en tillhörande entitet.

Exempel: När spridningen sker från post till mapp uppdaterar IBM Enterprise Records säkerheten för den överordnade mappen om postens säkerhet är högre än mappens. Andra mappar där posten är arkiveras påverkas inte.

Om spridningen sker från mapp till post uppdaterar IBM Enterprise Records säkerheten för poster med en lägre säkerhetsnivå än den högsta säkerhetsnivån för deras överordnade mappar

Inställningen i systemkonfigurationen för PRO FPOS styr hur säkerheten sprids — från mapp till post, från post till mapp, bådadera eller att ingen spridning tillåts.

RMSendEmailOnSupercede

Denna exempelhändelse gör att ett e-postmeddelande skickas varje gång en post ersätts av en ny version. E-postmeddelandet innehåller detaljer som den ersatta postens beskrivning, datum och tidpunkt då den ersattes. E-postmeddelandet skickas när behållaren har ett avvecklingsschema som definierar en utlösare som bygger på ersättningshändelsen.

Begränsning: Händelsen hanteras inte i JBoss och WebLogic.

JAR-filer för IBM Enterprise Records-exempelhändelsehanteraren är lagrade som kodmoduler i målobjektlagret. Fördelen är att du kan lägga till eller uppdatera händelsehanteraren genom att checka in en ny version utan att starta om programservern. Konfigurera IBM Enterprise Records-exempelhändelser på följande sätt:

Skapa händelseåtgärder

Innan du startar proceduren bör du kontrollera att mappen CodeModules finns under objektlagrets rotmapp där du ska skapa händelseåtgärder. Om det inte finns någon sådan mapp följer du instruktionerna i IBM FileNet P8 Platform Installation and Upgrade Guide och skapar mappen.

  1. Kopiera mappen under CD-roten ~CDRoot\RecordsManager.<plattform>\Events, till den server där du kör EM. Mappen innehåller importskript, JAR-filer och konfigurationsfiler.
  2. Skapa de händelseåtgärder du ska använda genom att köra lämpliga importskript.
    1. Högerklicka på IBM Enterprise Records-målobjektlagret.
    2. Välj Importera alla.
    3. I dialogrutan Import Helper, fliken Import Options, fältet Import Manifest File bläddrar du till den mapp som du kopierat och väljer importskript för den önskade händelsen. Varje fil är namngiven efter händelsen. Exempel: Importfilen för händelsen RMAutoDeclare heter RMAutoDeclareImport.xml.
    4. Bläddra till mappen ~\Events\lib i fältet External Content Path.
    5. Klicka på Import.

    När importen är klar får du ett meddelande om att importen lyckats. Händelseåtgärden ska skapas under objektlagrets mapp för händelseåtgärder, och kodmoduler kommer att skapas i kodmodulmappen.

Anpassa konfigurationsfiler

Händelserna RMAutoDeclare och RMSendEmailOnSupercede har egna konfigurationsfiler. Importskriptet skapar filerna i objektlagret:

Checka ut konfigurationsfilen från Workplace eller Workplace XT eller Enterprise Manager. Checka in filen igen när du är klar med redigeringen. Se Konfigurera autodeklaration av poster. För filen RMSendEmailOnSupercede är kommentarerna före den rad du ändrar självförklarande (SMTP-värd, portnummer, avsändarens och mottagarens e-postadresser).

Skapa prenumerationer

Varje händelse kräver prenumerationer på en eller flera klasser.

Prenumeration på händelsen RMAutoDeclare

  1. I Enterprise Manager, navigerar du till klassen Object Stores/ROS/Document eller den underordnade klass där du ska skapa prenumerationen.
  2. Högerklicka på klassen och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj Check In event trigger i fönstret Specify Triggers.
  6. I fönstret Specify Event Action väljer du den händelseåtgärd som du har importerat.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Synchronous (rekommenderat) och markerar eller avmarkerar kryssrutan Include Subclasses beroende på vad som passar för respektive händelse. Slutför sedan guiden.

Prenumerera på klassen Folder eller underordnad klass

  1. I Enterprise Manager navigerar du till mappklassen Object Stores/ROS/Folder eller till den underordnade klass där du ska skapa prenumerationen.
  2. Högerklicka på klassen och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj File event trigger i fönstret Specify Triggers.
  6. Avmarkera kryssrutan Synchronous (rekommendation) och markera eller avmarkera kryssrutan Include Subclasses beroende på vad som är lämpligt och slutför guiden.

Prenumerera på en viss mapp i ROS:

  1. I Enterprise Manager navigerar du till den mapp där du ska skapa prenumerationen.
  2. Högerklicka på mappen och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Acceptera standardvärdet.
  5. Välj File event trigger.
  6. Välj händelsen RMAutoDeclare i fönstret Specify Event Action.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Synchronous (rekommendation). Acceptera övriga standardinställningar och slutför guiden.

Prenumeration på händelsen RMAutoSynchronizeProperties

Prenumerationen på händelsen RMAutoSynchronizeProperties synkroniserar egenskaperna från källdokumentet till dess post, eller från posten till dess källdokument.

Försök inte synkronisera i båda riktningarna. Händelsen måste konfigureras att använda synkrona händelser.

Synkronisera från källdokumentet till dess post:

  1. I Enterprise Manager navigerar du till klassen Object Stores/ROS/Document eller till en underordnad klass.
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj Update event trigger i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties markerar du kryssrutan Synchronous men avmarkerar kryssrutan Include Subclasses. Slutför sedan guiden.

Synkronisera från posten till dess källdokument

  1. I Enterprise Manager navigerar du till klassen Object Stores/ROS/Document eller till en underordnad klass.
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj Update event trigger i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties markerar du kryssrutan Synchronous men avmarkerar kryssrutan Include Subclasses. Slutför sedan guiden.

Prenumeration på händelsen RMLastRetrievalOfRecord

Prenumerera på händelsen RMLastRetrievalOfRecord:

  1. I Enterprise Manager navigerar du till klassen Object Stores/FPOS/Other Classes/CustomObject/RM System.
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj Creation event trigger i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Include Subclasses, markerar kryssrutan Synchronous och slutför guiden.

Prenumeration på händelsen RMSecurityPropagation (endast PRO)

Du kan skapa en prenumeration på den här händelsen för klassen Record Folder, Volume eller Record.

Prenumerera på händelsen för klassen Record Folder

  1. I Enterprise Manager navigerar du till klassen Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/Record Folder.
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj File and Update event triggers i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Include Subclasses och slutför guiden.

Prenumerera på händelsen för klassen Volume:

  1. I Enterprise Manager navigerar du till klassen Object Stores/PRO FPOS/Other Classes/Folder/RM Folder/Volume.
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj File and Update event triggers i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Include Subclasses och slutför guiden.

Prenumerera på händelsen för klassen Record:

  1. I Enterprise Manager navigerar du till klassen Object Stores/PRO-FPOS/Document Class/Record.
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj Update event trigger i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties markerar du kryssrutan Include Subclasses och slutför guiden.

Prenumeration på händelsen RMSendEmailOnSupercede

Prenumerera på händelsen RMSendEmailOnSupercede

  1. I Enterprise Manager navigerar du till klassen Object Stores/FPOS/Document Class/Record.
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj Update and Checkin event trigger i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties markerar du kryssrutan Include Subclasses och slutför guiden.

Prenumeration på händelsen RMUpdateDateDeclared

För PRO-datamodellen måste du aktivera den redan befintliga händelsen:

För DoD- och basdatamodeller prenumererar du på klasserna Record Category, Volume och Box när du har skapat händelsen.

Prenumerera på händelsen för klassen Record Category

  1. I Enterprise Manager navigerar du till Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record Category
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj File event trigger i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Include Subclasses och slutför guiden.

Prenumerera på händelsen för klassen Volume:

  1. I Enterprise Manager navigerar du till Object Stores/FPOS/Other Classes/Folder/RM Folder/Volume
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj File event trigger i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Include Subclasses och slutför guiden.

Prenumerera på händelsen för klassen Box

  1. I Enterprise Manager navigerar du till Object Stores/FPOS/Other Classes/Folder/RM Folder/Physical Container/Box
  2. Högerklicka och välj Lägg till prenumeration.
  3. Ange ett unikt namn och en beskrivning för prenumerationen.
  4. Markera alternativknappen Applies to all instances.
  5. Välj File event trigger i fönstret Specify Triggers.
  6. Välj den händelseåtgärd du har importerat.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Include Subclasses och slutför guiden.

I P8-programpaketet finns mer information om att anpassa händelser.



Feedback

Senast uppdaterat: Augusti 2011


© Copyright IBM Corp 2011.
Detta Informationscenter bygger på Eclipse-teknik. (http://www.eclipse.org)