IBM® Enterprise Records poskytuje nasledujúce vzorové udalosti pre dátové modely Base, DoD a PRO.
Vzorky môžete podľa potreby upraviť. Pozrite si súbor readme v priečinku Events v softvérovom balíku.
Tabuľka 1. Udalosti a popisyUdalosti |
Popis |
RMAutoDeclare |
Nakonfiguruje automatickú deklaráciu záznamov. Keď užívateľ vykonáva konkrétnu operáciu (napríklad prihlásenie alebo zaradenie do priečinka) na dokumente v sklade objektov záznamov (ROS), IBM Enterprise Records automaticky vytvorí príslušný elektronický záznam v konkrétnom sklade objektov plánu súborov (FPOS). Túto vzorovú udalosť môžete nakonfigurovať na deklarovanie každého dokumentu, ktorý bude patriť do konkrétnej triedy dokumentu, keď užívateľ prihlási dokument.
Vzorová udalosť podporuje len neklasifikovanú deklaráciu elektronického záznamu. Táto udalosť musí byť nakonfigurovaná na používanie asynchrónnych a NIE synchrónnych udalostí.
|
RMAutoSynchronizeProperties |
Zosynchronizuje vlastnosti záznamov a ich priradených dokumentov. Napríklad, keď užívateľ zaktualizuje hodnotu vlastnosti záznamu, IBM Enterprise Records zaktualizuje príslušnú hodnotu vlastnosti aj v priradených dokumentoch.
Táto vzorová udalosť funguje pre vlastnosti, ktoré používajú rovnaký symbolický názov. Synchronizovať môžete z dokumentu do záznamu alebo zo záznamu do dokumentu, ale nie oboje. Ak synchronizujete zo záznamu do dokumentu, IBM Enterprise Records zaktualizuje tento dokument pri aktualizácii príslušnej vlastnosti záznamu.
Táto udalosť synchronizuje aj aliasy vlastností v rámci skladov objektov buď zo záznamu do dokumentu alebo z dokumentu do záznamu, nie však oboje.
|
RMUpdateDateDeclared RMLastRetrievalOfRecord
|
Spolu tieto vzorové udalosti určujú, kedy má byť kontajner zlikvidovaný. Tieto vzorové udalosti tiež zabezpečujú, že plán dostupnosti nezlikviduje kontajner, v ktorom sú záznamy aktuálne deklarované alebo načítané.
IBM Enterprise Records použije túto vzorovú udalosť na triedach Volume a Box a nastaví Date Last Declaration na rodičovskom priečinku, keď užívateľ zadeklaruje záznam.
Pre dátový model PRO IBM Enterprise Records automaticky zaregistruje udalosť RMUpdateDateDeclared pre triedu Volume alebo Box a vy musíte túto udalosť povoliť. Pre ostatné dátové modely musíte spustiť importovací skript, aby ste mohli vytvoriť udalosť RMUpdateDateDeclared a zaregistrovať sa pre triedu Volume alebo Box.
RMLastRetrievalOfRecord nastavuje dátum poslednej kontroly obsahu záznamu na vlastnosť LastRetrievalofRecord priečinka.
|
RMSecurityPropagation |
(Len PRO) Táto vzorová udalosť sa používa len pre dátový model PRO a nastavuje hodnotu označenia vlastnosti Security Category záznamu, zväzku a priečinka záznamov (ale nie kategórie záznamov) na základe najvyššej úrovne priradenej entity.
Napríklad,
keď ide o propagáciu zo záznamu do priečinka, IBM Enterprise Records zaktualizuje bezpečnosť rodičovského priečinka, ak je bezpečnosť záznamu vyššia ako bezpečnosť jeho rodičovského priečinka. Ostatné priečinky, v ktorých je záznam zaradený, nie sú ovplyvnené.
Keď ide o propagáciu z priečinka do záznamu, IBM Enterprise Records zaktualizuje bezpečnosť záznamov na nízkej úrovni bezpečnosti na najvyššiu úroveň bezpečnosti ich rodičovských priečinkov.
Nastavenie v konfigurácii systému pre PRO FPOS určuje, ako má byť bezpečnosť propagovaná. Táto propagácia môže byť z priečinka do záznamu, zo záznamu do priečinka, oboje alebo nie je povolená žiadna propagácia.
|
RMSendEmailOnSupercede |
Táto vzorová udalosť má za následok poslanie e-mailu vždy, keď je záznam nahradený novou verziou. E-mailová správa obsahuje podrobnosti o popise nahradenia a dátum a čas nahradenia. Tento e-mail sa posiela v prípade, keď má kontajner plán dostupnosti, ktorý definuje spúšťač na základe udalosti nahradenia.
Obmedzenie: Táto udalosť nie je podporovaná v JBoss ani vo WebLogic.
|
Súbory JAR obslužného programu vzorových udalostí IBM Enterprise Records sa ukladajú ako moduly kódu do cieľového skladu objektov. Výhodou je, že obslužný program udalostí môžete pridať alebo zaktualizovať prihlásením novej verzie bez reštartovania aplikačného servera.
Konfigurácia vzorových udalostí IBM Enterprise Records je nasledovné:
Vytvorenie akcií udalostí
Pred spustením tejto procedúry sa presvedčte, že priečinok s názvom CodeModules existuje pod koreňovým priečinkom skladu objektov, v ktorom sa chystáte vytvoriť akcie udalostí. Ak takýto priečinok neexistuje, vytvorte ho podľa pokynov uvedených v IBM FileNet P8 Platform Installation and Upgrade Guide.
Ak chcete vytvoriť akcie udalostí, postupujte takto:
- Tento priečinok skopírujte pod koreňom CD ~CDRoot\RecordsManager.<platform>\Events na server, na ktorom používate IBM Administration
Console for Content Platform Engine. Tento priečinok obsahuje importovacie skripty, súbory JAR a konfiguračné súbory.
- Spustením príslušných importovacích skriptov vytvorte akcie udalostí, ktoré chcete použiť.
- Kliknite pravým tlačidlom myši na cieľový sklad objektov IBM Enterprise Records.
- Vyberte Import All.
- V dialógovom okne Import Helper, záložka Import Options, pole Import Manifest File prejdite do priečinka, ktorý ste skopírovali. Vyberte importovací skript pre požadovanú udalosť. Každý súbor je pomenovaný po udalosti. Napríklad, súbor importu pre udalosť RMAutoDeclare má názov RMAutoDeclareImport.xml.
- V poli External Content Path prejdite do priečinka ~\Events\lib.
- Kliknite na Import.
Po dokončení importu uvidíte správu "Import Success". Akciu udalosti môžete vytvoriť pod priečinkom Event Action skladu objektov. Moduly kódu sú vytvárané v priečinku Code Module.
Prispôsobenie konfiguračných súborov
Udalosti RMAutoDeclare a RMSendEmailOnSupercede majú svoje vlastné konfiguračné súbory.
Importovací skript vytvorí tieto súbory v sklade objektov:
- Konfiguračný súbor udalosti RMAutoDeclare bude RMAutoDeclare.properties pod priečinkom Root Folder\RM Samples.
- Konfiguračný súbor udalosti RMSendEmailOnSupercede bude RMSendEmailOnSupercede.properties pod tým istým priečinkom Root Folder\RM Samples.
Odhláste konfiguračný súbor buď z Workplace alebo z Workplace XT alebo z IBM Administration
Console for Content Platform Engine. Po úprave ho prihláste. Bližšie informácie nájdete v téme o konfigurácii automatickej deklarácie záznamov. Pre súbor RMSendEmailOnSupercede sú komentáre, predchádzajúce riadku, ktorý upravíte, samovysvetľujúce: hostiteľ SMTP, číslo portu a e-mailové adresy odosielateľa a príjemcu.
Vytvorenie registrácií
Každá udalosť vyžaduje registráciu pre jednu alebo viac tried.
Registrácia pre udalosť RMAutoDeclare
Ak chcete vytvoriť registráciu, postupujte takto:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/ROS/Document class alebo podtriedy, kde chcete vytvoriť registráciu.
- Kliknite pravým tlačidlom myši na triedu a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti Check In.
- Na obrazovke Specify Event Action vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties zrušte označenie zaškrtávacieho
políčka Synchronous, podľa potreby označte alebo
zrušte označenie zaškrtávacieho políčka Include Subclasses pre
každú udalosť a dokončite sprievodcu.
Ak sa chcete zaregistrovať pre triedu alebo podtriedu priečinka, postupujte takto:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/ROS/Folder class alebo podtriedy, kde chcete vytvoriť registráciu.
- Kliknite pravým tlačidlom myši na triedu a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti súboru.
- Zrušte označenie zaškrtávacieho políčka Synchronous, podľa potreby označte alebo zrušte označenie zaškrtávacieho políčka
Include Subclasses a dokončite sprievodcu.
Ak sa chcete zaregistrovať pre konkrétny priečinok v ROS:
- V IBM Administration
Console for Content Platform Engine prejdite do priečinka, kde chcete vytvoriť registráciu.
- Kliknite pravým tlačidlom myši na priečinok a vyberte New Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Akceptujte predvolené nastavenie.
- Vyberte spúšťač udalosti File.
- Na obrazovke Specify Event Action vyberte udalosť RMAutoDeclare.
- Na obrazovke Specify Additional Properties zrušte označenie zaškrtávacieho políčka Synchronous, akceptujte zvyšok predvolených nastavení a dokončite sprievodcu.
Registrácia pre udalosť RMAutoSynchronizeProperties
Registrácia pre udalosť RMAutoSynchronizeProperties synchronizuje vlastnosti zo zdrojového dokumentu do jeho záznamu alebo zo záznamu do jeho zdrojového dokumentu.
Nepokúšajte sa o obojsmernú synchronizáciu. Táto udalosť musí byť nakonfigurovaná na používanie synchrónnych udalostí.
Ak chcete synchronizovať zo zdrojového dokumentu do jeho záznamu:
- V IBM Administration
Console for Content Platform Engine prejdite na Object Stores/ROS/Document class alebo na podtriedy.
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti aktualizácie.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties označte začiarkavacie políčko Synchronous, ale vymažte označenie začiarkavacie políčko Include Subclasses a dokončite sprievodcu.
Ak chcete vykonať synchronizáciu zo záznamu do jeho zdrojového dokumentu, postupujte takto:
- V IBM Administration
Console for Content Platform Engine prejdite na Object Stores/ROS/Document class alebo na podtriedy.
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti aktualizácie.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties označte začiarkavacie políčko Synchronous, ale vymažte označenie začiarkavacie políčko Include Subclasses a dokončite sprievodcu.
Registrácia pre udalosť RMLastRetrievalOfRecord
Ak sa chcete zaregistrovať pre udalosť RMLastRetrievalOfRecord:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/FPOS/Other Classes/CustomObject/RM System class.
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti Creation.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties zrušte označenie zaškrtávacieho políčka Include Subclasses, označte zaškrtávacie políčko Synchronous a dokončite sprievodcu.
Registrácia pre udalosť RMSecurityPropagation (Len pre PRO)
Môžete vytvoriť registráciu na odber tejto udalosti pre triedu Record Folder, triedu Volume alebo triedu Record.
Ak sa chcete zaregistrovať pre udalosť pre triedu Record Folder, postupujte takto:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/Record Folder class.
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťače udalostí File a Update.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties zrušte označenie zaškrtávacieho políčka Include Subclasses a dokončite sprievodcu.
Ak sa chcete zaregistrovať na odber udalosti pre triedu Volume:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/PRO FPOS/Other Classes/Folder/RM Folder/Volume class.
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťače udalostí File a Update.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties vymažte označenie začiarkavacieho políčka Include Subclasses a dokončite sprievodcu.
Ak sa chcete zaregistrovať na odber udalosti pre triedu Record:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/PRO-FPOS/Document Class/Record class.
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti aktualizácie.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties označte začiarkavacieho políčka Include Subclasses a dokončite sprievodcu.
Registrácia pre udalosť RMSendEmailOnSupercede
Ak sa chcete zaregistrovať pre udalosť RMSendEmailOnSupercede, postupujte takto:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/FPOS/Document Class/Record class.
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalostí Update a Checkin.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties označte začiarkavacieho políčka Include Subclasses a dokončite sprievodcu.
Registrácia pre udalosť RMUpdateDateDeclared
Pre dátový model PRO musíte povoliť už existujúcu udalosť. Ak chcete povoliť existujúcu udalosť, postupujte takto:
- V IBM Administration
Console for Content Platform Engine prejdite do priečinka Object Stores/FPOS/Events/Event Action.
- Kliknite pravým tlačidlom myši na UpdateDateDeclared.
- Kliknite na Enable.
Pre dátové modely DoD a Base sa po vytvorení udalosti zaregistrujte pre triedy Record Category, Volume a Box.
Ak sa chcete zaregistrovať pre udalosť pre triedu Record Category, postupujte takto:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record Category
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti súboru.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties zrušte označenie zaškrtávacieho políčka Include Subclasses a dokončite sprievodcu.
Ak sa chcete zaregistrovať na odber udalosti pre triedu Volume:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/FPOS/Other Classes/Folder/RM Folder/Volume
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti súboru.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties vymažte označenie začiarkavacieho políčka Include Subclasses a dokončite sprievodcu.
Ak sa chcete zaregistrovať pre udalosť pre triedu Box, postupujte takto:
- V IBM Administration
Console for Content Platform Engine prejdite do Object Stores/FPOS/Other Classes/Folder/RM Folder/Physical Container/Box
- Kliknite pravým tlačidlom myši a vyberte Add Subscription.
- Zadajte jedinečný názov a popis predplatného.
- Vyberte prepínač Applies to all instances.
- Na obrazovke Specify Triggers vyberte spúšťač udalosti súboru.
- Vyberte akciu udalosti, ktorú ste naimportovali.
- Na obrazovke Specify Additional Properties vymažte označenie začiarkavacieho políčka Include Subclasses a dokončite sprievodcu.
Informácie o prispôsobovaní udalostí nájdete v softvérovom balíku FileNet P8.