IBM Enterprise Records, wersja 5.1.2    

Procedury 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. Jeśli 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 kartoteki akt (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 (jeśli 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. Te przykładowe zdarzenia zapewniają również, że harmonogram rozporządzania nie rozporządza kontenera zawierającego akta ostatnio 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 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, o ile 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 PRO FPOS kontroluje sposób propagacji zabezpieczeń. Propagacja może przebiegać z folderu do akt, z akt do folderu, w obydwu kierunkach lub może być niedozwolona.

RMSendEmailOnSupercede

To zdarzenie przykładowe powoduje wysłanie wiadomości e-mail przy każdej okazji zastąpienia akt przez nową wersję. Komunikat e-mail zawiera szczegóły dotyczące opisu oraz datę i godzinę zastąpienia. 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.

Aby utworzyć czynności zdarzenia:
  1. Skopiuj folder z katalogu głównego dysku CD ~CDRoot\RecordsManager.<platform>\Events na serwer, na którym uruchomiono IBM Administration Console for Content Platform Engine. 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. 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 wyświetlany jest komunikat z informacją o pomyślnym zakończeniu importu. Czynność zdarzenia można utworzyć w folderze Czynność zdarzenia składnicy obiektów. Moduły kodu są tworzone w folderze Moduł kodu.

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 IBM Administration Console for Content Platform Engine. Po edycji zwróć/wprowadź plik. Więcej informacji zawiera temat dotyczący konfigurowania automatycznego deklarowania akt. W przypadku pliku RMSendEmailOnSupercede komentarze poprzedzające modyfikowany wiersz są oczywiste: host SMTP, numer portu, adresy e-mail nadawcy i odbiorcy.

Tworzenie subskrypcji

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

Subskrypcja zdarzenia RMAutoDeclare

Aby utworzyć subskrypcję:
  1. W IBM Administration Console for Content Platform Engine 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, 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 IBM Administration Console for Content Platform Engine 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, 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 IBM Administration Console for Content Platform Engine 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, 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 IBM Administration Console for Content Platform Engine 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 IBM Administration Console for Content Platform Engine 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 IBM Administration Console for Content Platform Engine przejdź do klasy Składnice obiektów/FPOS/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 IBM Administration Console for Content Platform Engine przejdź do klasy Składnice obiektów/PRO-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 IBM Administration Console for Content Platform Engine przejdź do klasy Składnice obiektów/PRO 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 IBM Administration Console for Content Platform Engine 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 IBM Administration Console for Content Platform Engine 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. Aby aktywować istniejące już zdarzenie:
  • W IBM Administration Console for Content Platform Engine przejdź do folderu Składnice obiektów/FPOS/Zdarzenia/Czynność zdarzenia.
  • Kliknij prawym przyciskiem myszy UpdateDateDeclared.
  • Kliknij opcję Włącz.

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

Aby zasubskrybować zdarzenie dla klasy Kategoria akt:
  1. W IBM Administration Console for Content Platform Engine 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 IBM Administration Console for Content Platform Engine 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 IBM Administration Console for Content Platform Engine 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 FileNet P8.



Opinia

Ostatnia aktualizacja: Listopad 2013
work_with_event_handlers.htm

© Copyright IBM Corp. 2013