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 opisyZdarzenia |
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.
- 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.
- Uruchom odpowiednie skrypty importu, aby utworzyć czynności zdarzeń, których zamierzasz użyć.
- Kliknij prawym przyciskiem myszy docelową składnicę obiektów IBM Enterprise
Records.
- Wybierz opcję Importuj wszystkie.
- 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.
- Z pola ścieżki do treści zewnętrznej przejdź do folderu ~\Events\lib.
- 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:
- Plik konfiguracyjny RMAutoDeclare ma nazwę RMAutoDeclare.properties i znajduje się w folderze
Root Folder\RM Samples.
- Plik konfiguracyjny RMSendEmailOnSupercede ma nazwę RMSendEmailOnSupercede.properties i znajduje się w
tym samym folderze Root Folder\RM Samples.
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
- W Enterprise Manager przejdź do klasy
Składnice obiektów/Moduł ROS/Klasa dokumentu lub podklasy, w której
zamierzasz utworzyć subskrypcję.
- Kliknij prawym przyciskiem myszy klasę i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia Wprowadź/zwróć.
- Na ekranie określania czynności zdarzenia wybierz zaimportowaną czynność.
- 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
- W Enterprise Manager przejdź do klasy Składnice obiektów/Moduł
ROS/Klasa folderu lub podklasy, w której zamierzasz utworzyć subskrypcję.
- Kliknij prawym przyciskiem myszy klasę i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania.
- 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:
- W Enterprise Manager przejdź do folderu, w którym zamierzasz utworzyć subskrypcję.
- Kliknij prawym przyciskiem myszy i wybierz opcję Nowa subskrybcja.
- Określ unikalną nazwę i opis subskrybcji.
- Zaakceptuj opcję domyślną.
- Wybierz wyzwalacz zdarzenia umieszczania.
- Na ekranie określania czynności zdarzenia wybierz zdarzenie RMAutoDeclare.
- 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:
- W Enterprise Manager przejdź do klasy Składnice obiektów/Moduł
ROS/Klasa dokumentu lub podklasy.
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia aktualizacji.
- Wybierz zaimportowaną czynność zdarzenia.
- 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
- W Enterprise Manager przejdź do klasy Składnice obiektów/Moduł
ROS/Klasa dokumentu lub podklasy.
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia aktualizacji.
- Wybierz zaimportowaną czynność zdarzenia.
- 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:
- W Enterprise Manager przejdź do klasy Składnice
obiektówFPOS/Inne klasy/Obiekt definiowany/System RM.
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia tworzenia.
- Wybierz zaimportowaną czynność zdarzenia.
- 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
- W Enterprise Manager przejdź do klasy Składnice
obiektówPRO-FPOS/Inne klasy/Folder/Folder RM/Folder akt.
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania i aktualizacji.
- Wybierz zaimportowaną czynność zdarzenia.
- 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
- W Enterprise Manager przejdź do klasy Składnice
obiektówPRO FPOS/Inne klasy//Folder/Folder RM/Wolumin.
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania i aktualizacji.
- Wybierz zaimportowaną czynność zdarzenia.
- 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
- W Enterprise Manager przejdź do klasy
Składnice obiektów/PRO-FPOS/Klasa dokumentu/Klasa akt.
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia aktualizacji.
- Wybierz zaimportowaną czynność zdarzenia.
- 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
- W Enterprise Manager przejdź do klasy Składnice
obiektów/FPOS/Klasa dokumentu/Klasa akt.
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia aktualizacji i wprowadzania/zwracania.
- Wybierz zaimportowaną czynność zdarzenia.
- 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 Enterprise Manager 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.
Zasubskrybuj zdarzenie dla klasy Kategoria akt
- W Enterprise Manager przejdź do Składnice
obiektów/<FPOS>/Inne klasy/Folder/Folder RM/Kategoria akt
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania.
- Wybierz zaimportowaną czynność zdarzenia.
- 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
- W Enterprise Manager przejdź do Składnice
obiektów/FPOS/Inne klasy/Folder/Folder RM/Wolumin
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania.
- Wybierz zaimportowaną czynność zdarzenia.
- 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
- W Enterprise Manager przejdź do Składnice
obiektów/FPOS/Inne klasy/Folder/Folder RM/Kontener fizyczny/Pudełko
- Kliknij prawym przyciskiem myszy i wybierz opcję Dodaj subskrybcję.
- Określ unikalną nazwę i opis subskrybcji.
- Wybierz przełącznik Dotyczy wszystkich instancji.
- Na ekranie określania wyzwalaczy wybierz wyzwalacz zdarzenia umieszczania.
- Wybierz zaimportowaną czynność zdarzenia.
- 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.