IBM Enterprise Records, wersja 5.1.+            

Praca z procedurami obsługi zdarzeń

Produkt IBM® Enterprise Records udostępnia następujące zdarzenia przykładowe dla modeli danych Base, DoD i PRO.

Przykłady można dowolnie dostosowywać. Informacje zawiera plik Readme w folderze Events w pakiecie oprogramowania.

Tabela 1. Zdarzenia i opisy
Zdarzenia Opis
RMAutoDeclare

Konfiguruje automatyczne deklarowanie akt. Gdy użytkownik wykona konkretną operację (np. taką jak wprowadzanie/zwracanie albo umieszczanie w folderze) względem dokumentu w składnicy obiektów akt (ROS), wówczas produkt IBM Enterprise Records automatycznie utworzy odpowiednie akta elektroniczne w konkretnej składnicy obiektów planu umieszczania w folderach (FPOS). To przykładowe zdarzenie można również skonfigurować w celu deklarowania każdego dokumentu, który należy do konkretnej klasy dokumentów (gdy użytkownik wprowadzi/zwróci dokument).

To zdarzenie przykładowe obsługuje wyłącznie deklarację niesklasyfikowaną akt elektronicznych. Jeśli planowane jest korzystanie ze zdarzeń asynchronicznych i niesynchronicznych, wówczas to zdarzenie należy skonfigurować.

RMAutoSynchronizeProperties

Synchronizuje właściwości akt i powiązane z nimi dokumenty. Na przykład: gdy użytkownik zaktualizuje wartość właściwości akt, wówczas produkt IBM Enterprise Records aktualizuje również wartość odpowiedniej właściwości w powiązanych dokumentach.

To zdarzenie przykładowe działa dla właściwości, które korzystają z tej samej nazwy symbolicznej. Możliwe jest przeprowadzenie synchronizacji z dokumentu do akt albo z akt do dokumentu (ale nie w obydwu kierunkach). W przypadku synchronizowania z akt do dokumentu produkt IBM Enterprise Records aktualizuje dokument razem z odpowiednią właściwością akt.

To zdarzenie synchronizuje również aliasy właściwości w składnicach obiektów z akt do dokumentu lub z dokumentu do akt (ale nie w obydwu kierunkach).

RMUpdateDateDeclared

RMLastRetrievalOfRecord

Razem te zdarzenia przykładowe określają czas rozporządzenia kontenera lub zapewniają, że harmonogram rozporządzania nie rozporządza kontenera zawierającego akta ostatnie zadeklarowane lub odczytane.

Produkt IBM Enterprise Records stosuje to przykładowe zdarzenie do klas Volume i Box i ustawia datę ostatniej deklaracji na folderze nadrzędnym, gdy użytkownik deklaruje akta.

Dla modelu danych PRO produkt IBM Enterprise Records automatycznie subskrypcje zdarzenie RMUpdateDateDeclared do klasy Volume lub Box, a użytkownik musi tylko aktywować to zdarzenie. Dla innych modeli danych należy uruchomić skrypt importowania w celu utworzenia zdarzenia RMUpdateDateDeclared i zasubskrybowania klasy Volume lub Box.

RMLastRetrievalOfRecord ustawia datę ostatniego przeglądu zawartości akt na właściwość LastRetrievalofRecord folderu.

RMSecurityPropagation

(Tylko model PRO) To zdarzenie, używane tylko dla modelu danych PRO, ustawia wartość oznaczenia właściwości kategorii zabezpieczeń akt, woluminu i folderu akt (ale nie kategorii akt) zgodnie z najwyższym poziomem powiązanego obiektu.

Na przykład: gdy propagacja przebiega z akt do folderu, wówczas IBM Enterprise Records aktualizuje zabezpieczenia folderu nadrzędnego, jeśli zabezpieczenia akt są bardziej restrykcyjne niż ich folderu nadrzędnego. Inne foldery, w których akta zostały umieszczone, pozostaną bez zmian.

Jeśli propagacja przebiega z folderu do akt, wówczas produkt IBM Enterprise Records aktualizuje zabezpieczenia akt z niższego poziomu zabezpieczeń do wyższego poziomu zabezpieczeń ich folderu nadrzędnego

To ustawienie w konfiguracji systemu dla FPOS PRO kontroluje sposób propagacji zabezpieczeń -- z folderu do akt, z akt do folderu, w obydwu kierunkach, lub bez propagacji.

RMSendEmailOnSupercede

To zdarzenie przykładowe powoduje wysłanie wiadomości e-mail przy każdej okazji zawieszenia akt przez nową wersję. Komunikat e-mail zawiera szczegóły dotyczące opisu, daty i godziny zawieszenia akt. Ta wiadomość e-mail jest wysyłana, jeśli kontener zawiera harmonogram rozporządzania, który definiuje wyzwalacz oparty na zdarzeniu zastąpienia.

Ograniczenie: To zdarzenie nie jest obsługiwane w JBoss ani WebLogic.

Pliki JAR przykładowej procedury obsługi zdarzeń aplikacji IBM Enterprise Records są przechowywane jako moduły kodu w docelowej składnicy obiektów. Zaletą jest to, że można dodać lub zaktualizować procedurę obsługi zdarzeń, wprowadzając/zwracając nową wersję bez konieczności restartu serwera aplikacji. Konfigurowanie zdarzeń przykładowych produktu IBM Enterprise Records przebiega w następujący sposób:

Tworzenie czynności zdarzeń

Przed rozpoczęciem tej procedury należy upewnić się, że folder o nazwie CodeModules istnieje w folderze głównym składnicy obiektów, w której zostaną utworzone czynności zdarzenia. Jeśli taki folder nie istnieje, wówczas należy wykonać instrukcje z publikacji IBM FileNet P8 Platform Installation and Upgrade Guide w celu utworzenia folderu.

  1. Skopiuj folder z katalogu głównego dysku CD ~CDRoot\RecordsManager.<platform>\Events na serwer, na którym uruchomiono EM. Ten folder zawiera skrypty importu, pliki JAR i pliki konfiguracyjne.
  2. Uruchom odpowiednie skrypty importu, aby utworzyć czynności zdarzeń, których zamierzasz użyć.
    1. Kliknij prawym przyciskiem myszy docelową składnicę obiektów IBM Enterprise Records.
    2. Wybierz opcję Importuj wszystkie.
    3. W oknie dialogowym pomocy do importu, na karcie opcji importu, w polu manifestu importu, przejdź do skopiowanego folderu i wybierz skrypt importu dla wymaganego zdarzenia. Każdy plik ma nazwę po zdarzeniu. Na przykład: plik importu dla zdarzenia RMAutoDeclare ma nazwę RMAutoDeclareImport.xml.
    4. Z pola ścieżki do treści zewnętrznej przejdź do folderu ~\Events\lib.
    5. Kliknij opcję Import.

    Po zakończeniu importu powinien pojawić się komunikat z informacją o pomyślnym zakończeniu importu. Czynność zdarzenia zostanie utworzona w folderze Event Action w składnicy obiektów, a moduły kodu zostaną utworzone w folderze Code Module.

Dostosowywanie plików konfiguracyjnych

Dla zdarzeń RMAutoDeclare i RMSendEmailOnSupercede istnieją osobne pliki konfiguracyjne. Skrypt importu tworzy te pliki w składnicy obiektów:

Pobierz plik konfiguracyjny z aplikacji Workplace, Workplace XT lub Enterprise Manager. Po edycji zwróć/wprowadź plik. Informacje zawiera sekcja Konfigurowanie automatycznego deklarowania akt. W przypadku pliku RMSendEmailOnSupercede komentarze poprzedzające modyfikowany wiersz są oczywiste (host SMTP, numer portu, adresy e-mail nadawca i odbiorcy).

Tworzenie subskrypcji

Każde zdarzenie wymaga subskrypcji do co najmniej jednej klasy.

Subskrypcja zdarzenia RMAutoDeclare

  1. W Enterprise Manager przejdź do klasy Składnice obiektów/Moduł ROS/Klasa dokumentu lub podklasy, w której zamierzasz utworzyć subskrypcję.
  2. Kliknij prawym przyciskiem myszy klasę i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia Wprowadź/zwróć.
  6. Na ekranie określania czynności zdarzenia wybierz zaimportowaną czynność.
  7. Na ekranie określania dodatkowych właściwości usuń zaznaczenie pola wyboru Synchroniczne (co jest zalecane), a następnie zaznacz lub usuń zaznaczenie pola wyboru Uwzględnij podklasy dla każdego zdarzenia, a następnie zakończ korzystanie z kreatora.

Aby zasubskrybować klasę lub podklasę Folder

  1. W Enterprise Manager przejdź do klasy Składnice obiektów/Moduł ROS/Klasa folderu lub podklasy, w której zamierzasz utworzyć subskrypcję.
  2. Kliknij prawym przyciskiem myszy klasę i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania.
  6. Usuń zaznaczenie pola wyboru Synchroniczne (co jest zalecane), a następnie zaznacz lub usuń zaznaczenie pola wyboru Uwzględnij podklasy dla każdego zdarzenia, a następnie zakończ korzystanie z kreatora.

Aby zasubskrybować konkretny folder w ROS:

  1. W Enterprise Manager przejdź do folderu, w którym zamierzasz utworzyć subskrypcję.
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Nowa subskrybcja.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Zaakceptuj opcję domyślną.
  5. Wybierz wyzwalacz zdarzenia umieszczania.
  6. Na ekranie określania czynności zdarzenia wybierz zdarzenie RMAutoDeclare.
  7. Na ekranie określania dodatkowych właściwości usuń zaznaczenie pola wyboru Synchroniczne (co jest zalecane), a następnie zaakceptuj pozostałe ustawienia domyślne i zakończ pracę kreatora.

Subskrypcja zdarzenia RMAutoSynchronizeProperties

Zasubskrybowanie zdarzenia RMAutoSynchronizeProperties powoduje synchronizację właściwości z dokumentu źródłowego do jego akt lub z akt do ich dokumentu źródłowego.

Nie należy podejmować prób synchronizowania w obydwu kierunkach. Jeśli planowane jest korzystanie ze zdarzeń synchronicznych, wówczas to zdarzenie należy skonfigurować.

Aby przeprowadzić synchronizację z dokumentu źródłowego do jego akt:

  1. W Enterprise Manager przejdź do klasy Składnice obiektów/Moduł ROS/Klasa dokumentu lub podklasy.
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia aktualizacji.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości zaznacz pole wyboru Synchroniczne, ale usuń zaznaczenie pola wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Aby przeprowadzić synchronizowanie z akt do dokumentu źródłowego

  1. W Enterprise Manager przejdź do klasy Składnice obiektów/Moduł ROS/Klasa dokumentu lub podklasy.
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia aktualizacji.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości zaznacz pole wyboru Synchroniczne, ale usuń zaznaczenie pola wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Subskrypcja zdarzenia RMLastRetrievalOfRecord

Aby zasubskrybować zdarzenie RMLastRetrievalOfRecord event:

  1. W Enterprise Manager przejdź do klasy Składnice obiektówFPOS/Inne klasy/Obiekt definiowany/System RM.
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia tworzenia.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości usuń zaznaczenie pola wyboru Uwzględnij podklasy, ale zaznacz pole wyboru Synchroniczne, a następnie zakończ korzystanie z kreatora.

Subskrypcja zdarzenia RMSecurityPropagation (tylko dla PRO)

Subskrybcję tego zdarzenia można utworzyć dla klasy Folder akt, klasy Wolumin lub klasy Akta.

Aby zasubskrybować zdarzenie dla klasy Folder akt

  1. W Enterprise Manager przejdź do klasy Składnice obiektówPRO-FPOS/Inne klasy/Folder/Folder RM/Folder akt.
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania i aktualizacji.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości usuń zaznaczenie pola wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Aby zasubskrybować zdarzenie dla klasy Wolumin

  1. W Enterprise Manager przejdź do klasy Składnice obiektówPRO FPOS/Inne klasy//Folder/Folder RM/Wolumin.
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania i aktualizacji.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości usuń zaznaczenie pola wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Aby zasubskrybować zdarzenie dla klasy Akta

  1. W Enterprise Manager przejdź do klasy Składnice obiektów/PRO-FPOS/Klasa dokumentu/Klasa akt.
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia aktualizacji.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości zaznacz pole wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Subskrypcja zdarzenia RMSendEmailOnSupercede

Aby zasubskrybować zdarzenie RMSendEmailOnSupercede

  1. W Enterprise Manager przejdź do klasy Składnice obiektów/FPOS/Klasa dokumentu/Klasa akt.
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia aktualizacji i wprowadzania/zwracania.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości zaznacz pole wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Subskrypcja zdarzenia RMUpdateDateDeclared

W przypadku modelu danych PRO należy aktywować istniejące już zdarzenie w następujący sposób:

W przypadku modeli danych DoD i Base należy zasubskrybować klasy Kategoria akt, Wolumin i Pole po utworzeniu zdarzenia.

Zasubskrybuj zdarzenie dla klasy Kategoria akt

  1. W Enterprise Manager przejdź do Składnice obiektów/<FPOS>/Inne klasy/Folder/Folder RM/Kategoria akt
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości usuń zaznaczenie pola wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Aby zasubskrybować zdarzenie dla klasy Wolumin

  1. W Enterprise Manager przejdź do Składnice obiektów/FPOS/Inne klasy/Folder/Folder RM/Wolumin
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości usuń zaznaczenie pola wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Aby zasubskrybować zdarzenie dla klasy Pole

  1. W Enterprise Manager przejdź do Składnice obiektów/FPOS/Inne klasy/Folder/Folder RM/Kontener fizyczny/Pudełko
  2. Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
  3. Określ unikalną nazwę i opis subskrybcji.
  4. Wybierz przełącznik Dotyczy wszystkich instancji.
  5. Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania.
  6. Wybierz zaimportowaną czynność zdarzenia.
  7. Na ekranie określania dodatkowych właściwości usuń zaznaczenie pola wyboru Uwzględnij podklasy, a następnie zakończ korzystanie z kreatora.

Informacje na temat dostosowywania zdarzeń zawiera pakiet oprogramowania P8.



Opinia

Ostatnia aktualizacja: sierpień 2011


© Copyright IBM Corp. 2011.
To Centrum informacyjne jest oparte na technologii Eclipse. (http://www.eclipse.org)