Korzystanie z procedury obsługi dla produktu FileNet Content Manager

Przegląd

Procedura obsługi zdarzeń jest przeznaczona dla produktu IBM FileNet Content Manager 5.1.

Obsługiwane zdarzenia

Poniższa tabela zawiera wszystkie zdarzenia systemu ECM obsługiwane przez IBM BPM oraz odpowiadające im zdarzenia produktu FileNet Content Manager. Tabelę można wykorzystać do identyfikowania zdarzeń produktu FileNet Content Manager, które należy zasubskrybować, oraz nazw używanych w komponencie Process Designer w celu zidentyfikowania tych samych zdarzeń w produkcie IBM BPM.

Definiowanie procesu do używania zdarzeń systemu ECM

Kopiowanie procedury obsługi zdarzeń na serwer FileNet Content Manager

Tworzenie dokumentu z informacjami o połączeniu

Informacje o połączeniu, których procedura obsługi zdarzeń systemu ECM wymaga do nawiązywania połączenia z systemem IBM BPM, są przechowywane w postaci dokumentu w repozytorium produktu FileNet Content Manager. Aby utworzyć dokument z informacjami o połączeniu, wykonaj następujące kroki:

1. Utwórz plik właściwości na serwerze FileNet Content Manager.
   Wskazówka: jeśli wymagane jest wiele subskrypcji, które powiadamiają o zdarzeniach różne serwery IBM BPM, należy utworzyć po jednym pliku właściwości dla każdego serwera IBM BPM. Mimo iż plikowi właściwości można nadać dowolną nazwę, sensownym rozwiązaniem jest uwzględnienie nazwy serwera w nazwie pliku właściwości, na przykład serwer_bpm_1.properties.
   • Jeśli na serwerze aplikacji, na którym działa produkt FileNet Content Manager, dostępny jest odpowiedni alias uwierzytelniania J2C, można zdefiniować plik właściwości połączenia tak, aby wykorzystywał ten alias uwierzytelniania. Na przykład:

     bpm.server.authalias=zasięg/mój_alias_uwierzytelniania
     bpm.server.uri=http\://nazwa_serwera_BPM\:9080

     Gdzie zasięg jest zasięgiem aliasu uwierzytelniania mój_alias_uwierzytelniania, a nazwa_serwera_BPM jest nazwą hosta lub adresem IP serwera IBM BPM, na przykład bpm1.example.com.
   • Jeśli alias uwierzytelniania nie będzie wykorzystywany, plik właściwości połączenia z serwerem musi określać odpowiednią nazwę użytkownika produktu IBM BPM i jego hasło. Na przykład:

     bpm.server.username=użytkownik_produktu_BPM
     bpm.server.password=hasło_użytkownika_produktu_BPM
     bpm.server.uri=http\://nazwa_serwera_BPM\:9080

     Gdzie użytkownik_produktu_BPM jest identyfikatorem użytkownika, który jest autoryzowany na potrzeby dostępu do produktu IBM BPM, hasło_użytkownika_produktu_BPM jest hasłem dla tego identyfikatora użytkownika, a nazwa_serwera_BPM jest nazwą hosta lub adresem IP serwera IBM BPM, na przykład bpm1.example.com.
2. Zapisz plik właściwości w systemie ECM. Istnieje kilka sposobów, z których można skorzystać w celu zapisania pliku właściwości. Do zapisania pliku właściwości można na przykład skorzystać z portalu Workplace XT. W tym celu należy wykonać następujące czynności:
   1. Za pomocą przeglądarki zaloguj się do portalu Workplace XT pod adresem URL http://nazwa_hosta_serwera_FileNet:port/WorkplaceXT.
   2. Wybierz składnicę obiektów, w której ma zostać zapisany plik konfiguracyjny. Domyślne składnice obiektów to DESIGN i TARGET. Wybierz tę samą składnicę obiektów, w której znajduje się rozwiązanie przypadku.
   3. Rozwiń składnicę obiektów, a następnie dodaj nowy folder lub wybierz odpowiedni istniejący folder, w którym ma zostać zapisany plik właściwości.
   4. Kliknij działanie lub ikonę Dodaj dokument....
   5. Kliknij opcję Wybierz plik. Znajdź plik właściwości w lokalnym systemie plików, wybierz ten plik i kliknij przycisk OK, a następnie przycisk Dalej.
   6. Kliknij przycisk OK, a następnie opcję Dodaj.
3. Zanotuj identyfikator dokumentu dla pliku właściwości. Jeśli na przykład używany jest portal Workplace XT, wykonaj następujące działania.
   1. Kliknij prawym przyciskiem myszy nazwę zapisanego pliku właściwości, na przykład bpmserver1.properties i wybierz opcję Właściwości.
   2. Zanotuj identyfikator dokumentu albo zaznacz ten identyfikator i skopiuj do schowka lub pliku tekstowego.
      Zapamiętaj: ten identyfikator dokumentu należy podać później, podczas konfigurowania powiązania procedury obsługi zdarzeń z subskrypcją zdarzenia.

Tworzenie subskrypcji i wiązanie jej z procedurą obsługi zdarzeń

Na tym etapie należy dodać subskrypcję zdarzeń, które mają być wysyłane do systemu IBM BPM.

1. Jeśli klasa dokumentu lub klasa folderu, dla której mają być odbierane powiadomienia o zdarzeniach, jeszcze nie istnieje, utwórz odpowiednią klasę, wykonując następujące czynności.
   1. Przy użyciu produktu FileNet Enterprise Manager rozwiń składnicę obiektów, w której znajduje się rozwiązanie przypadku. Na przykład: DESIGN lub TARGET.
   2. Aby utworzyć nową klasę, wykonaj jedną z następujących czynności.
      • Aby utworzyć nową klasę dokumentu, kliknij prawym przyciskiem myszy opcję Klasa dokumentu i wybierz opcję Nowa klasa.
      • Aby utworzyć nową klasę folderu, rozwiń sekcję Inne klasy, kliknij prawym przyciskiem myszy opcję Folder i wybierz opcję Nowa klasa.
   3. Wprowadź następujące wartości dla nowej klasy: Nazwa (na przykład aplikacje_ubezpieczen_na_zycie), Nazwa symboliczna i Opis.
      Zapamiętaj: podczas korzystania z elementu sterującego integracji treści w komponencie Process Designer należy zastosować tę nazwę klasy w polu Typ obiektu.
2. Dodaj subskrypcję klasy i powiąż ją z procedurą obsługi zdarzeń.
   1. W produkcie FileNet Enterprise Manager kliknij prawym przyciskiem myszy odpowiednią klasę dokumentu lub klasę folderu i wybierz opcję Dodaj subskrypcję.
   2. Wprowadź wartości pól Nazwa i Opis dla nowej subskrypcji i kliknij przycisk Dalej.
   3. Wskaż, że subskrypcja ma zastosowanie do wszystkich instancji klasy, a następnie kliknij przycisk Dalej.
   4. Dodaj wymagane zdarzenia z listy Dostępne zdarzenia do listy Zasubskrybowane zdarzenia. Wybierz kolejno wymagane zdarzenia i dodaj je do listy Zasubskrybowane zdarzenia, klikając opcję Dodaj. Kiedy wszystkie wymagane zdarzenia znajdą się już na liście Zasubskrybowane zdarzenia, kliknij przycisk Dalej.
   5. Jeśli utworzono już działanie zdarzenia dla procedury obsługi zdarzeń BpmEventHandler, wybierz je przy użyciu rozwijanej listy, a następnie kliknij przycisk Dalej. W przeciwnym razie utwórz nowe działanie zdarzenia dla procedury obsługi zdarzeń BpmEventHandler, wykonując następujące czynności:
      1. Kliknij opcję Nowe, wprowadź odpowiednią nazwę zdarzenia działania, na przykład BpmEventHandler, a następnie kliknij przycisk Dalej.
      2. W polu Nazwa klasy Java procedury obsługi wprowadź wartość com.ibm.bpm.integration.filenet.BPMEventHandler, wybierz opcję Konfiguruj moduł kodu, a następnie kliknij przycisk Dalej.
      3. Kliknij opcję Przeglądaj/dodaj, aby znaleźć plik JAR procedury obsługi zdarzeń filenet-bpm-event-handler-51.jar, który został skopiowany z serwera IBM BPM, a następnie kliknij przycisk Dalej i przycisk Zakończ.
      4. Sprawdź, czy zaznaczone jest nowo utworzone działanie zdarzenia, a następnie kliknij przycisk Dalej.
   6. Zaakceptuj ustawienia domyślne w oknie Określanie właściwości dodatkowych, klikając przycisk Dalej.
   7. Kliknij przycisk Zakończ, aby zakończyć tworzenie subskrypcji.
3. Ustaw właściwość Łańcuch użytkownika dla subskrypcji na wartość odpowiadającą identyfikatorowi dokumentu dla pliku właściwości.
   1. Z listy Nazwa subskrypcji wybierz subskrypcję, której nazwa została określona w kroku 2b.
   2. Kliknij opcję Właściwości.
   3. Na liście właściwości znajdź właściwość, dla której pole Nazwa właściwości ma wartość Łańcuch użytkownika.
   4. Kliknij przycisk ... i wprowadź (najlepiej kopiując i wklejając) wartość identyfikatora dokumentu dla pliku właściwości. Jest to łańcuch zapisany w kroku Tworzenie dokumentu z informacjami o połączeniu.
      Ważne: jeśli inne serwery IBM BPM powinny otrzymywać powiadomienia o zdarzeniach, należy mieć plik właściwości połączenia dla każdego serwera IBM BPM. Należy upewnić się, że podany został identyfikator dokumentu dla pliku właściwości połączenia z odpowiednim serwerem.
   5. Kliknij przycisk OK.
   6. Kliknij przycisk OK.
   Zapamiętaj: jeśli informacje o połączeniu w pliku właściwości będą w przyszłości modyfikowane, należy zmienić Łańcuch użytkownika tak, aby identyfikował nowy identyfikator dokumentu, ponieważ nowa wersja uzyska nowy identyfikator dokumentu.