IBM Enterprise Records, Verze 5.1.+            

Práce s obslužnými rutinami událostí

Produkt IBM® Enterprise Records poskytuje následující ukázkové události pro datové modely Base, DoD a PRO.

Ukázky můžete upravovat podle potřeb. Přečtěte si soubor README ve v softwarovém balíku ve složce Events (události).

Tabulka 1. Události a popisy
Události Popis
RMAutoDeclare

Umožňuje konfigurovat automatickou deklaraci záznamů. Když uživatel provádí určitou operaci (jako je vrácení nebo založení do složky) s dokumentem v úložišti objektů záznamů (ROS), potom produkt IBM Enterprise Records automaticky vytvoří odpovídající elektronický záznam v konkrétním úložišti objektů plánu souborů (FPOS). Ukázkovou událost lze rovněž konfigurovat tak, aby deklarovala každý dokument, který náleží k určité třídě dokumentů, pokud jej uživatel vrátí.

Ukázková událost podporuje pouze neklasifikovanou deklaraci elektronických záznamů. Tato událost musí být konfigurována tak, aby používala asynchronní a NIKOLI synchronní události.

RMAutoSynchronizeProperties

Synchronizuje vlastnosti záznamů a jejich přidružené dokumenty. Pokud například uživatel aktualizuje hodnotu vlastnosti záznamu, produkt IBM Enterprise Records aktualizuje také odpovídající hodnotu vlastnosti v přidružených dokumentech.

Tato ukázková událost funguje u vlastností, které využívají stejný symbolický název. Lze synchronizovat z dokumentu na záznam nebo ze záznamu na dokument, nikoli však oběma směry. Při synchronizaci ze záznamu do dokumentu aplikace IBM Enterprise Records aktualizuje dokument, když dojde k aktualizaci odpovídající vlastnosti záznamu.

Tato událost také mezi úložišti objektů synchronizuje aliasy vlastností, a to ze záznamu na dokument, nebo z dokumentu na záznam, nikoli však oběma směry.

RMUpdateDateDeclared

RMLastRetrievalOfRecord

Tyto ukázkové události společně určují, kdy se má odebrat kontejner, respektive zajišťují, aby nedošlo k plánovanému odebrání kontejneru, ve kterém byly v poslední době deklarovány nebo načteny záznamy.

Produkt IBM Enterprise Records použije tuto ukázkovou událost u tříd Svazek a Pole a nastaví datum poslední deklarace nadřízené složky, když uživatel deklaruje záznam.

V datovém modelu PRO provede aplikaceIBM Enterprise Records automatický odběr události RMUpdateDateDeclared u třídy Svazek nebo Pole a vy musíte pouze tuto událost povolit. V jiných datových modelech je třeba událost RMUpdateDateDeclared vytvořit spuštěním skriptu importu a nastavit odběr třídy Svazek nebo Pole.

Událost RMLastRetrievalOfRecord nastaví datum poslední kontroly obsahu záznamu podle vlastnosti složky LastRetrievalofRecord.

RMSecurityPropagation

(Pouze datový model PRO) Pouze v datovém modelu PRO lze tuto ukázkovou událost použít k nastavení hodnoty značení vlastnosti Kategorie zabezpečení daného záznamu, svazku a složky záznamů (ale nikoli kategorie záznamů) na základě nejvyšší úrovně přidružené entity.

Například při šíření ze záznamu do složky aktualizuje produkt IBM Enterprise Records zabezpečení nadřízené složky v případě, že zabezpečení záznamu je vyšší než zabezpečení jeho nadřízené složky. Jiné složky, do kterých je záznam založen, nejsou ovlivněny.

V případě šíření ze složky do záznamu aktualizuje produkt IBM Enterprise Records zabezpečení záznamů s nižší úrovní zabezpečení na nejvyšší úroveň zabezpečení jejich nadřízených složek.

Nastavení v konfiguraci systému úložiště FPOS v datovém modelu PRO řídí způsob šíření zabezpečení – ze složky do záznamu, ze záznamu do složky, obojí nebo bez povolení šíření.

RMSendEmailOnSupercede

Tato ukázková událost vyvolá odeslání e-mailu vždy, když je záznam nahrazen novou verzí. E-mailová zpráva obsahuje podrobnosti o popisu, datu a času nahrazujícího záznamu v okamžiku, kdy byl nahrazený. E-mail se odešle, pokud má kontejner plán odebrání, ve kterém je definovaný spouštěč založený na události nahrazení.

Omezení: Tato událost není podporována v prostředí JBoss nebo WebLogic.

Soubory JAR obslužných rutin ukázkových událostí produktu IBM Enterprise Records se ukládají jako kódové moduly v cílovém úložišti souborů. Výhodou je to, že obslužnou rutinu události můžete přidat nebo aktualizovat, a to vrácením nové verze bez restartování aplikačního serveru. Ukázkové události produktu IBM Enterprise Records se konfigurují následujícím způsobem:

Vytváření akcí událostí

Před zahájením tohoto postupu se ujistěte, že v kořenové složce úložiště objektů, ve kterém se chystáte vytvořit akce událostí, existuje složka s názvem CodeModules. Pokud taková složka neexistuje, vytvořte ji podle pokynů v tématu IBM FileNet P8 Platform Installation and Upgrade Guide.

  1. Zkopírujte složku v kořenu disku CD, ~CDRoot\RecordsManager.<platforma>\Events, na server, na kterém spouštíte produkt EM. Tato složka obsahuje skripty importu, soubory JAR a konfigurační soubory.
  2. Spuštěním příslušných skriptů importu vytvořte akce událostí, které chcete použít.
    1. Klepněte pravým tlačítkem myši na cílové úložiště objektů produktu IBM Enterprise Records.
    2. Vyberte položku Importovat vše.
    3. V dialogovém okně pomocníka s importem přejděte v poli Importovat soubor typu manifest na kartě Volby importu ke složce, kterou jste zkopírovali, a vyberte skript importu pro požadovanou událost. Každý soubor je pojmenován podle události. Například soubor importu pro událost RMAutoDeclare je pojmenován RMAutoDeclareImport.xml.
    4. V poli Cesta k externímu obsahu přejděte ke složce ~\Events\lib.
    5. Klepněte na tlačítko Importovat.

    Po dokončení importu by se měla zobrazit zpráva informující, že import byl úspěšný. Akce události by měla být vytvořena ve složce Akce události úložiště objektů a kódové moduly budou vytvořeny ve složce Kódový modul.

Úprava konfiguračních souborů

Události RMAutoDeclare a RMSendEmailOnSupercede mají své vlastní konfigurační soubory. Skript importu vytvoří tyto soubory v úložišti objektů:

Zapůjčte si konfigurační soubor z aplikace Workplace, z produktu Workplace XT nebo z produktu Enterprise Manager. Po úpravě jej vraťte. Viz Konfigurace autodeklarace záznamů. V případě souboru RMSendEmailOnSupercede jsou popisky před upravovanými řádky jasně srozumitelné (hostitel SMTP, číslo portu, e-mailové adresy odesílatele a příjemce).

Vytváření odběrů

Každá událost vyžaduje odběry jedné nebo více tříd.

Odběr události RMAutoDeclare

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/ROS/Třída dokumentu (nebo podtřída), ve které chcete vytvořit odběr.
  2. Klepněte na třídu pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Vrátit.
  6. Na obrazovce Určit akci události vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zrušte zaškrtnutí políčka Synchronní (doporučený postup) a zaškrtněte (nebo nezaškrtávejte) políčko Zahrnout podtřídy podle toho, co je vhodné pro každou událost a potom dokončete průvodce.

Chcete-li nastavit odběr třídy nebo podtřídy složky, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/ROS/Třída složky (nebo podtřída), ve které chcete vytvořit odběr.
  2. Klepněte na třídu pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Založit.
  6. Zrušte zaškrtnutí políčka Synchronní (doporučený postup) a podle potřeby zaškrtněte (nebo nezaškrtávejte) políčko Zahrnout podtřídy a dokončete průvodce.

Chcete-li nastavit odběr specifické složky v úložišti ROS, postupujte takto:

  1. V produktu Enterprise Manager přejděte ke složce, ve které chcete vytvořit odběr.
  2. Klepněte na složku pravým tlačítkem myši a vyberte položku Nový odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Přijměte výchozí hodnotu.
  5. Vyberte spouštěč události Založit.
  6. Na obrazovce Určit akci události vyberte událost RMAutoDeclare.
  7. Na obrazovce Určit další vlastnosti zrušte zaškrtnutí políčka Synchronní (doporučený postup), potvrďte zbývající výchozí nastavení a dokončete průvodce.

Odběr události RMAutoSynchronizeProperties

Odběrem události RMAutoSynchronizeProperties synchronizujete vlastnosti ze zdrojového dokumentu na jeho záznam, nebo ze záznamu na jeho zdrojový dokument.

Nepokoušejte se o synchronizaci oběma směry. Tato událost musí být nakonfigurována tak, aby používala synchronní události.

Chcete-li synchronizovat ze zdrojového dokumentu na jeho záznam, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/ROS/Třída dokumentu (nebo podtřída).
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Aktualizovat.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zaškrtněte políčko Synchronní, ale nezaškrtávejte políčko Zahrnout podtřídy a dokončete průvodce.

Chcete-li synchronizovat ze záznamu na jeho zdrojový dokument, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/ROS/Třída dokumentu (nebo podtřída).
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Aktualizovat.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zaškrtněte políčko Synchronní, ale nezaškrtávejte políčko Zahrnout podtřídy a dokončete průvodce.

Odběr události RMLastRetrievalOfRecord

Chcete-li nastavit odběr události RMLastRetrievalOfRecord, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/FPOS/Další třídy/CustomObject/Třída Systém RM.
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Vytvořit.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zrušte zaškrtnutí políčka Zahrnout podtřídy, zaškrtněte políčko Synchronní a dokončete průvodce.

Odběr události RMSecurityPropagation (pouze PRO)

Odběr této události můžete vytvořit pro třídu Složka záznamů, třídu Svazek nebo třídu Záznam.

Chcete-li nastavit odběr události u třídy Složka záznamů, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/PRO-FPOS/Další třídy/Složka/Složka RM/Třída Složka záznamů.
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěče události Založit a Aktualizovat.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zrušte zaškrtnutí políčka Zahrnout podtřídy a dokončete průvodce.

Chcete-li nastavit odběr události u třídy Svazek, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/PRO FPOS/Další třídy/Složka/Složka RM/Třída Svazek.
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěče události Založit a Aktualizovat.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zrušte zaškrtnutí políčka Zahrnout podtřídy a dokončete průvodce.

Chcete-li nastavit odběr události u třídy Záznam, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/PRO-FPOS/Třída dokumentu/Třída záznamu.
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Aktualizovat.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zaškrtněte políčko Zahrnout podtřídy a dokončete průvodce.

Odběr události RMSendEmailOnSupercede

Chcete-li nastavit odběr události RMSendEmailOnSupercede, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/FPOS/Třída dokumentu/Třída záznamu.
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěče události Aktualizovat a Vrátit.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zaškrtněte políčko Zahrnout podtřídy a dokončete průvodce.

Odběr události RMUpdateDateDeclared

U datového modelu PRO je třeba povolit již existující událost, a to následujícím způsobem:

U datových modelů DoD a Base nastavte odběr u třídy Kategorie záznamu, Svazek a Pole po vytvoření události.

Chcete-li nastavit odběr události u třídy Kategorie záznamu, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/<FPOS>/Další třídy/Složka/Složka RM/Kategorie záznamu.
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Založit.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zrušte zaškrtnutí políčka Zahrnout podtřídy a dokončete průvodce.

Chcete-li nastavit odběr události u třídy Svazek, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/FPOS/Další třídy/Složka/Složka RM/Svazek.
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Založit.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zrušte zaškrtnutí políčka Zahrnout podtřídy a dokončete průvodce.

Chcete-li nastavit odběr události u třídy Pole, postupujte takto:

  1. V produktu Enterprise Manager přejděte k položce Úložiště objektů/FPOS/Další třídy/Složka/Složka RM/Fyzický kontejner/Pole.
  2. Klepněte pravým tlačítkem myši a vyberte položku Přidat odběr.
  3. Zadejte pro odběr jedinečný název a popis.
  4. Vyberte přepínač Použít u všech instancí.
  5. Na obrazovce Určit spouštěče vyberte spouštěč události Založit.
  6. Vyberte akci události, kterou jste importovali.
  7. Na obrazovce Určit další vlastnosti zrušte zaškrtnutí políčka Zahrnout podtřídy a dokončete průvodce.

Informace o přizpůsobení událostí naleznete v softwarovém balíčku P8.



Zpětná vazba

Poslední aktualizace: Srpen 2011


© Copyright IBM Corp. 2011.
Toto Informační centrum využívá technologii Eclipse. (http://www.eclipse.org)