Zdarzenie początkowe dokumentu

Edycja w trybie z połączeniem

Początkowe zdarzenie dokumentu upraszcza uruchamianie procesu, który korzysta z informacji z systemu ECM.

Początkowe zdarzenie dokumentu może być używane do automatycznego uruchamiania procesu w momencie utworzenia dokumentu w systemie ECM.

Inną możliwością jest używanie początkowego zdarzenia dokumentu do uruchamiania instancji procesu z istniejącego dokumentu w systemie ECM.

Dlaczego należy używać zdarzenia początkowego dokumentu

Organizacje przechowują w systemach Enterprise Content Management (ECM) duże ilości informacji. Te informacje mają postać dokumentów, takich jak raporty, dokumenty prawne, faktury i oferty. Ponadto system ECM wykonuje zadania związane z zarządzaniem tymi dokumentami (np. określa, czy poszczególne dokumenty mogą zostać zaktualizowane lub usunięte).

Początkowego zdarzenia dokumentu można używać do automatycznego uruchamiania procesu w momencie utworzenia nowego dokumentu. Jest to przydatne, gdy proces jest powiązany z konkretnym typem dokumentu, takim jak roszczenie ubezpieczeniowe. Na przykład proces może obejmować zestaw działań używanych podczas sprawdzania roszczenia ubezpieczeniowego. Proces może zostać uruchomiony automatycznie przez początkowe zdarzenie dokumentu od razu po wprowadzeniu roszczenia ubezpieczeniowego.

Istnieje także możliwość używania początkowego zdarzenia dokumentu do uruchamiania instancji procesu z istniejącego dokumentu. Jest to przydatne, gdy jest konieczne wykonanie pewnych operacji, które są powiązane z dokumentem (np. wykonanie jego przeglądu przez zespół). Aby na przykład umożliwić zespołowi przejrzenie dokumentu, proces może definiować odpowiedni zestaw zadań równoległych lub sekwencyjnych. W takim przypadku proces można uruchomić z dokumentu w celu zainicjowania przeglądu zespołowego. Obecnie proces ten można uruchomić tylko w ten sposób, korzystając z interfejsu API REST procesu uruchamiania.

W jaki sposób utworzyć zdarzenie początkowe dokumentu

Początkowe zdarzenie dokumentu jest tworzone następująco:
  1. W definicji procesu wybierz istniejącą ikonę Zdarzenie początkowe lub dodaj ikonę Początkowe zdarzenie dokumentu z palety.
  2. W widoku Właściwości otwórz kartę Ogólne.
  3. Upewnij się, że w sekcji Zdarzenie początkowe wybrano opcję Dokument .
  4. W sekcji Właściwości zdarzenia wykonaj następujące kroki:
    1. W grupie przycisków Wyzwalacz wybierz opcję Utworzono dokument, aby automatycznie uruchomić proces po utworzeniu nowego dokumentu, lub wybierz opcję Uruchamiane z dokumentu, aby uruchomić instancję procesu z istniejącego dokumentu.
      Uwaga: Aby rozpocząć proces od zdarzenia uruchomienia dokumentu przy użyciu wyzwalacza Uruchamianie z dokumentu , proces musi być ujawniony w celu uruchomienia. Ponadto proces może zawierać maksymalnie jedno początkowe zdarzenie dokumentu z wyzwalaczem Uruchamiane z dokumentu.
    2. Z listy rozwijanej Źródło wybierz serwer. Serwery znajdujące się na liście to serwery ECM wymienione na stronie Ustawienia aplikacji procesu aplikacji procesu.
    3. Z listy rozwijanej Typ wybierz typ dokumentu. Wyświetlane są typy dokumentów dostępne w źródle.
    4. Aby dołączyć podtypy dokumentu, wybierz opcję Dołącz podtypy. Na przykład typ dokumentów medycznych może zawierać podtyp dokumentów stomatologicznych, który ma zostać dołączony.
  5. Otwórz kartę Odwzorowanie danych i odwzoruj właściwości typu dokumentu na zmienne procesu. Aby wyświetlić dodatkowe właściwości techniczne, które również można odwzorować, wybierz opcję +. Na przykład można wybrać właściwość wskazującą, kto utworzył dokument, i odwzorować tę właściwość na zmienną procesu.
  6. Kliknij Zapisz lub Zakończ edycję.
Uwaga: Aby w przypadku tworzenia nowego dokumentu w zewnętrznym systemie ECM użyć zdarzenia uruchomienia dokumentu do automatycznego uruchamiania procesu, należy w tym systemie skonfigurować procedurę obsługi zdarzeń, która wysyła zdarzenie Utworzone dla dokumentu. Więcej informacji zawiera sekcja Wykonywanie zadań administracyjnych dla zdarzeń przychodzących. Ponadto użytkownik, który jest zdefiniowany w definicji serwera, musi mieć odpowiednie uprawnienia, aby pobrać szczegółowe informacje dla tych dokumentów. Te szczegółowe informacje są używane do pobierania informacji wymaganych do odwzorowania danych. W przypadku zdarzeń treści, które mają być przetwarzane, użytkownik techniczny serwera ECM musi należeć do zespołu określonego dla opcji nadajniki zdarzeńzgodnie z opisem w sekcji Dodawanie serwera ECM (Enterprise Content Management).

Proces jest uruchamiany w domyślnym obrazie stanu aplikacji procesu. W produkcie Business Automation Studiobieżąca wersja jest wersją domyślną, chyba że inna wersja została jawnie skonfigurowana jako domyślna. Jeśli proces jest zdefiniowany w bibliotece narzędziowej, jest on uruchamiany tylko wtedy, gdy obraz stanu tej biblioteki narzędziowej jest przywoływany przez aplikację procesu. Jeśli wiele aplikacji procesu przywołuje tę samą bibliotekę narzędziową zawierającą proces z dokumentem uruchamiającym, uruchamianych jest wiele instancji procesu.

Początkowe zdarzenie dokumentu skonfigurowane w taki sposób, aby było uruchamiane przy tworzeniu dokumentu, nie będzie wyzwalane dla bieżącego (najnowszego) obrazu stanu aplikacji biblioteki narzędziowej. Jest to spowodowane faktem, że mechanizm sprawdza bieżący (najnowszy) obraz stanu aplikacji procesów i nie znajduje artefaktów w osieroconych bibliotekach narzędziowych. Aby przetestować to zdarzenie, aplikacja procesu musi obejmować obraz stanu biblioteki narzędziowej, która zawiera definicję zdarzenia.

Zmienna systemowa dokumentu uruchamiającego w języku JavaScript

Identyfikator dokumentu uruchamiającego jest dostępny w zmiennej systemowej języka JavaScript. W przypadku procesów i usług po stronie serwera należy użyć zmiennej tw.system.currentProcessInstance.startingDocumentId, aby zwrócić identyfikator. Można również użyć zmiennej tw.system.currentProcessInstance.startingDocumentServerName, aby zwrócić nazwę serwera dokumentu. Identyfikatora i nazwy serwera można użyć w działaniach, takich jak operacje w systemie ECM.

W przypadku usług personelu po stronie klienta należy użyć zmiennej tw.system.processInstance.startingDocumentId, aby zwrócić identyfikator. Należy użyć zmiennej tw.system.processInstance.startingDocumentServerName, aby zwrócić nazwę serwera dokumentu.