IBM Enterprise Records, version 5.1.2    

Händelsehanterare

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

Du kan anpassa exemplen efter behov. I readmefilen 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. Dessa exempelhändelser säkerställer också 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å RMUpdateDateDeclared-händelsen för Volume- eller Box-klassen och du behöver 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 sista granskningen av innehållet på en post på LastRetrievalofRecord-egenskapen för mappen.

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 postsäkerheten från en lägre säkerhetsnivå till den högsta säkerhetsnivån för deras överordnade mappar

Inställningen i systemkonfigurationen för PRO FPOS styr hur säkerheten sprids. Spridningen kan vara 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.

Skapa händelseåtgärder:
  1. Kopiera mappen under CD-roten ~CDRoot\RecordsManager.<plattform>\Events, till den server där du kör IBM Administration Console for Content Platform Engine. 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. Välj 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 kan skapas under mappen Event Action i objektlagret. Kodmodulerna skapas i mappen Code Module.

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 IBM Administration Console for Content Platform Engine. Checka in filen igen när du är klar med redigeringen. I ämnet om att konfigurera autodeklaration av poster finns mer information. 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

Skapa prenumerationen:
  1. I IBM Administration Console for Content Platform Engine, går 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. Välj händelsen RMAutoDeclare i fönstret Specify Event Action.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Synchronous och markerar eller avmarkerar kryssrutan Include Subclasses beroende på vad som är lämpligt för respektive händelsen. Slutför sedan guiden.
Prenumerera på klassen Mapp eller underordnad klass:
  1. I IBM Administration Console for Content Platform Engine går 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 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 IBM Administration Console for Content Platform Engine går 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, accepterar övriga standardinställning 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 IBM Administration Console for Content Platform Engine går 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 som du 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 IBM Administration Console for Content Platform Engine går 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 som du 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 IBM Administration Console for Content Platform Engine går 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 som du 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 Postmapp:
  1. I IBM Administration Console for Content Platform Engine går 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 som du 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 IBM Administration Console for Content Platform Engine går 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 som du 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 IBM Administration Console for Content Platform Engine går 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 som du 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 IBM Administration Console for Content Platform Engine går 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 som du 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 befintliga händelsen. Aktivera den befintliga händelsen:
  • I IBM Administration Console for Content Platform Engine går du till mappen Object Stores/FPOS/Events/Event Action.
  • Högerklicka på UpdateDateDeclared.
  • Klicka på Enable.

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 IBM Administration Console for Content Platform Engine går 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 som du 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 IBM Administration Console for Content Platform Engine går 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 som du 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 IBM Administration Console for Content Platform Engine går 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 som du importerat.
  7. I fönstret Specify Additional Properties avmarkerar du kryssrutan Include Subclasses och slutför guiden.

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



Feedback

Senast uppdaterat: November 2013
work_with_event_handlers.htm

© Copyright IBM Corp 2013