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. 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:
- 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.
- 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. 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 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:
- 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 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ę:
- 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ę.
- 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, 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 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ę.
- 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, 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 IBM Administration
Console for Content Platform Engine 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, 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 IBM Administration
Console for Content Platform Engine 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 IBM Administration
Console for Content Platform Engine 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 IBM Administration
Console for Content Platform Engine przejdź do klasy Składnice
obiektów/FPOS/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 IBM Administration
Console for Content Platform Engine przejdź do klasy Składnice
obiektów/PRO-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 IBM Administration
Console for Content Platform Engine przejdź do klasy Składnice
obiektów/PRO 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 IBM Administration
Console for Content Platform Engine 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 IBM Administration
Console for Content Platform Engine 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. 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:
- W IBM Administration
Console for Content Platform Engine 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 IBM Administration
Console for Content Platform Engine 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 IBM Administration
Console for Content Platform Engine 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 FileNet P8.