Przejdź do treści

Akcje warunkowe

Akcje warunkowe sterują dalszym przebiegiem obiegu, powtarzają wskazane działania albo wstrzymują proces. Do tej grupy należą bramki logiczne, pętla oraz aktywności oczekiwania.

Po dodaniu elementu do diagramu wybierz typ aktywności i uzupełnij jego konfigurację. Sposób wyboru aktywności pokazano na poniższym filmie.


Ustawienia wybranej aktywności są dostępne w zakładce Ogólne. W przypadku bramek i aktywności oczekiwania część warunków konfiguruje się bezpośrednio na wychodzących ścieżkach.

Bramka logiczna XOR

Bramka logiczna XOR kieruje proces tylko jedną z wychodzących ścieżek. Wybrana zostaje ścieżka, której warunki są spełnione.

Najpierw połącz bramkę z kolejnymi aktywnościami na diagramie. Dla każdej wychodzącej ścieżki pojawią się pola Nazwa ścieżki, Kolejna aktywność oraz konfiguracja warunków. Liczba pozycji zależy od liczby ścieżek wychodzących z bramki.

Warunki ścieżki konfiguruje się tak samo jak filtry na listach. Szczegóły opisano w artykule Tworzenie filtrów na listach. W zależności od tego, który warunek jest spełniony, proces podejmie właściwą ścieżkę.

Warunki mogą odwoływać się do danych formularza, zmiennych środowiskowych, wyników wcześniejszych akcji oraz formularzy konfiguracyjnych. Wybierz źródło z drzewa wzmianek; wynik akcji musi być dostępny przed dojściem procesu do bramki.

Jeśli żaden warunek nie jest spełniony, proces się kończy.

Bramka logiczna OR

Bramka logiczna OR może skierować proces do więcej niż jednej ścieżki. Proces przejdzie każdą ścieżką, której warunki są spełnione. Konfiguracja ścieżek i warunków jest taka sama jak w bramce XOR.

Bramka OR nie łączy uruchomionych ścieżek z powrotem. Jeśli proces ma poczekać, aż wszystkie ścieżki się zakończą, użyj bramki logicznej AND.

Bramka logiczna AND

Bramka logiczna AND uruchamia kilka gałęzi procesu jednocześnie i czeka, aż wszystkie się zakończą. Dopiero wtedy proces przechodzi dalej. Przykład: wniosek trafia równocześnie do opinii prawnej, IT i finansowej, a decyzja zapada po zebraniu wszystkich opinii.

              ┌→ Opinia prawna ─────┐
Wniosek → AND ┼→ Opinia IT ─────────┼→ AND → Decyzja
              └→ Opinia finansowa ──┘

Bramki AND występują w parach i tworzą blok:

  • bramka otwierająca blok ma co najmniej dwie ścieżki wychodzące; każda z nich rozpoczyna jedną gałąź,
  • bramka zamykająca blok ma co najmniej dwie ścieżki wchodzące i jedną wychodzącą; spotykają się w niej wszystkie gałęzie bloku.

Rolę bramki system rozpoznaje po połączeniach na diagramie. Bramki nie mają dodatkowych ustawień.

Bramka OR i aktywność Czekaj zamiast bramki AND

Równoległych ścieżek nie należy budować bramką OR zakończoną aktywnością Czekaj na spełnienie warunku. Bramka OR nie ma złączenia, więc takie rozwiązanie nie czeka poprawnie na wszystkie ścieżki.

Gałęzie warunkowe

Ścieżki wychodzące z bramki otwierającej mogą mieć warunki, konfigurowane tak samo jak w bramce XOR. Ścieżka bez warunku zawsze uruchamia swoją gałąź. Gałąź, której warunek nie jest spełniony, nie zostaje uruchomiona, a bramka zamykająca na nią nie czeka. Jeśli żaden warunek nie jest spełniony, proces przechodzi od razu za bramkę zamykającą.

Ścieżka wychodząca z bramki zamykającej nie może mieć warunku.

Reguły bloku

System sprawdza budowę bloku przy zapisie procesu:

  • każda gałąź musi dojść do bramki zamykającej swojego bloku; w gałęzi nie można użyć aktywności Koniec ani Przejdź do działania i nie można wrócić przed bramkę otwierającą,
  • gałęzie łączą się tylko w bramce zamykającej i nie mogą prowadzić do wspólnej aktywności przed nią,
  • do bloku wchodzi się tylko przez bramkę otwierającą; ścieżka spoza bloku ani aktywność Przejdź do działania nie mogą prowadzić do jego środka ani do bramki zamykającej,
  • bramka AND nie może znajdować się wewnątrz pętli,
  • wewnątrz bloku bramka logiczna OR, Czekaj na spełnienie warunku i Czekaj określony czas mogą mieć tylko jedną ścieżkę wychodzącą; do wyboru jednej z kilku ścieżek użyj bramki XOR, a do kilku równoległych ścieżek zagnieżdżonego bloku AND.

Bloki można zagnieżdżać: gałąź może zawierać kolejny blok AND z własną bramką otwierającą i zamykającą.

Odrzucenie w jednej z gałęzi

Odrzucenie w gałęzi nie zatrzymuje pozostałych gałęzi. Jeśli wynik którejś z nich ma zakończyć proces, sprawdź go za bramką zamykającą, np. bramką XOR, i dopiero stamtąd poprowadź proces do aktywności Koniec.

Działanie w trakcie procesu

  • Gałęzie działają niezależnie. Zadania z różnych gałęzi są dostępne jednocześnie, a kolejność ich wykonania nie ma znaczenia.
  • Jeśli w gałęzi żaden warunek bramki XOR lub OR nie jest spełniony, gałąź się kończy, tak jak poza blokiem kończy się proces. Bramka zamykająca traktuje taką gałąź jak zakończoną.
  • Błąd aktywności w gałęzi, która nie ma ścieżki błędu, kończy cały proces ze statusem Zakończony błędem.
  • Status procesu pokazuje, na co czekają gałęzie: Oczekuje na działanie użytkownika, jeśli choć jedna gałąź czeka na użytkownika, albo Oczekuje, jeśli gałęzie czekają tylko na spełnienie warunku lub upływ czasu.
  • Jeśli aktywność użytkownika w gałęzi nie ma wykonawców, wcześniejsza decyzja nie jest cofana. Zadanie pojawi się po uzupełnieniu pola lub grupy, z której pochodzą wykonawcy, a użytkownik, który podjął wcześniejszą decyzję, zobaczy komunikat o braku wykonawców.
  • Powrót przed bramkę otwierającą po przejściu bloku, np. ścieżką „Ponowna opinia”, uruchamia blok od nowa. Warunki ścieżek są sprawdzane ponownie, a bramka zamykająca czeka na nowe gałęzie.
  • Jeśli proces dojdzie do bramki otwierającej ponownie, zanim blok się zakończy, np. dwiema spełnionymi ścieżkami bramki OR, blok nie uruchamia się drugi raz.

Cofanie kroków w bloku

  • Kroku wewnątrz bloku nie można cofnąć. Przycisk Cofnij krok nie jest wtedy dostępny, ponieważ cofnięcie usunęłoby też kroki pozostałych gałęzi.
  • Decyzję podjętą przed bramką otwierającą można cofnąć, dopóki żadna gałąź nie wykonała kroku. Cofnięcie anuluje wtedy cały blok.
  • Jeśli walidacja ścieżki w gałęzi się nie powiedzie, cofana jest tylko ta decyzja. Pozostałe gałęzie działają dalej.

Zmiana bloku w działającym procesie

Zmiana bloku AND, np. dodanie lub usunięcie gałęzi albo przeniesienie bramek, może sprawić, że obiegi będące w środku bloku nie przejdą przez bramkę zamykającą. Zmieniaj blok, gdy żaden obieg nie jest w jego środku.

Przykład

Proces opiniowania wniosku:

  1. Wniosek – aktywność użytkownika; po zatwierdzeniu proces przechodzi do bramki otwierającej.
  2. Bramka otwierająca uruchamia trzy gałęzie: Opinia prawna, Opinia IT i Opinia finansowa. Ścieżka do opinii IT może mieć warunek, np. tylko dla wniosków dotyczących sprzętu.
  3. Każda opinia to aktywność użytkownika z jedną ścieżką do bramki zamykającej.
  4. Za bramką zamykającą aktywność Decyzja ma ścieżki Zatwierdź, Odrzuć oraz Ponowna opinia. Ta ostatnia wraca do bramki otwierającej i uruchamia wszystkie opinie od nowa.

Pętla

Pętla wykonuje zestaw działań dla każdego elementu wskazanego źródła danych albo zadaną liczbę razy. Źródło pętli wybiera się w konfiguracji aktywności, wskazując pole lub zmienną z listy dostępnej pod przyciskiem @. Można również wpisać liczbę lub wyrażenie.

Źródła pętli

Pętla obsługuje następujące rodzaje źródeł:

Listy – kolekcją iterowaną przez pętlę jest lista dokumentów. Pętla wykona działania dla każdego elementu zwróconego przez listę. Wynik listy może być dodatkowo ograniczony przez standardową konfigurację filtrów.

Ustawienia listy mogą wpływać na sposób działania pętli:

  • Lista w trybie drzewa
    Jeśli lista ma włączony tryb drzewa i zastosowany jest filtr ograniczający dokumenty, pętla iteruje po ścieżce od dokumentu nadrzędnego do znalezionego dokumentu.

  • Lista z grupowaniem lub agregacją
    Pętla iteruje po wynikach widocznych na liście po zastosowaniu grupowania, czyli po wierszach grup, a nie po pojedynczych dokumentach źródłowych.

Ograniczenia dla list grupowanych

Dla list z grupowaniem lub agregacją nie można jednoznacznie wskazać dokumentu z pętli, ponieważ jeden wiersz grupy może reprezentować wiele dokumentów.

W związku z tym:

  • w aktywnościach pracujących na dokumencie nie będzie dostępna opcja Dokument z pętli,
  • dostępne mentionsy będą ograniczone do danych widocznych w wyniku listy, np. kolumn grupujących i agregowanych,
  • mentionsy z formularza dokumentu źródłowego nie będą dostępne dla elementu pętli.

Lista elementów – jeśli formularz ma atrybut Lista elementów, pętla wykona działania dla każdego wiersza tej listy.

Pole wielokrotnego wyboru – dla pól Wielokrotny wybór i Lista rozwijana wielokrotnego wyboru pętla wykona działania osobno dla każdej wybranej wartości.

Pliki – źródłem może być pole Załączniki albo zmienna procesowa zawierająca wiele plików. Każda iteracja dotyczy jednego pliku. Dla pliku dostępne są jego nazwa, rozszerzenie i hash SHA.

Podpisy pliku – w pętli zagnieżdżonej w pętli po plikach źródłem może być węzeł Podpisy, widoczny pod pętlą po plikach przy wyborze źródła. Pętla wykona działania dla każdego podpisu w kolejności dat podpisu. Dla podpisu dostępne są podpisujący, data podpisu (czas ze znacznika czasu, jeśli podpis go zawiera), rodzaj podpisu oraz informacja, czy treść pliku nie zmieniła się po podpisaniu (Nienaruszony). Rodzaj ma postać kodu: Qualified (podpis kwalifikowany), QualifiedSeal (pieczęć kwalifikowana), TrustedProfile (Profil Zaufany), DocuSign lub Other (inny). Opis rodzajów podpisów zawiera atrybut Załączniki.

Komentarze – źródłem może być pole Komentarze. Pętla wykona działania dla każdego komentarza w kolejności dat utworzenia. Dla komentarza dostępne są jego ID, treść, autor (ID użytkownika), data utworzenia i data modyfikacji. Pozostałe dane autora można pobrać aktywnością Pobierz dokument, filtrując listę użytkowników po ID autora.

Import z Excela – źródłem może być wynik wcześniejszej aktywności Importuj z Excela. Pętla wykona działania dla każdego wiersza wybranego arkusza.

Wiadomości e-mail – źródłem może być wynik aktywności Pobierz maile. Pętla wykona działania dla każdej pobranej wiadomości. Załączniki bieżącej wiadomości mogą być źródłem pętli zagnieżdżonej.

Zmienna JSON – pętla iteruje po kolekcji zapisanej w zmiennej typu JSON lub zwróconej przez inną aktywność. Jako źródło można wskazać całą kolekcję albo jej zagnieżdżoną właściwość.

Liczba lub wyrażenie – pętla może wykonać działania określoną liczbę razy. Źródłem może być:

  • liczba całkowita wpisana bezpośrednio, np. 5,
  • mention zwracający liczbę całkowitą, np. pole formularza lub zmienna procesowa,
  • wyrażenie zwracające liczbę całkowitą, również wyrażenie SQL, np. 2 + 3 albo SELECT COUNT(*) FROM ....

Wartość null, 0 lub liczba ujemna kończy aktywność pętli poprawnie, bez wykonywania działań z jej wnętrza. Wartość niecałkowita, tekst lub błędne wyrażenie kończy aktywność błędem.

Konfiguracja działań wewnątrz pętli

Źródło danych ustawia się na głównej warstwie aktywności. Działania wykonywane w każdej iteracji konfiguruje się na warstwie wewnętrznej pętli. Aby ją otworzyć, kliknij strzałkę w prawym dolnym rogu symbolu pętli na diagramie. Między warstwami można przełączać się selektorem widocznym w prawym górnym rogu edytora procesu.

Na warstwie wewnętrznej dodaj aktywność lub ciąg aktywności, które mają zostać wykonane w każdej iteracji. Można w nich używać danych dokumentu źródłowego oraz danych aktualnie przetwarzanego elementu. Dane elementu są dostępne w drzewie mentionów pod nazwą pętli i oznaczone ikoną zaokrąglonej strzałki.

Przykład tworzenia dokumentów w pętli na podstawie wierszy arkusza opisano w sekcji Importuj z Excela.

Ograniczenia działań w pętli

Wewnątrz pętli nie można umieszczać aktywności użytkownika ani aktywności Czekaj na spełnienie warunku i Czekaj określony czas. Można zagnieździć jedną dodatkową pętlę, ale nie można umieścić kolejnej pętli wewnątrz już zagnieżdżonej pętli.

Przerwij pętlę

Aktywność Przerwij pętlę pozwala zakończyć pętlę przed przetworzeniem wszystkich elementów źródła. Można ją umieścić wyłącznie wewnątrz pętli. Nie wymaga dodatkowej konfiguracji.

Po wykonaniu aktywności system:

  • pomija pozostałe działania w bieżącej iteracji,
  • nie uruchamia kolejnych iteracji,
  • kontynuuje proces od następnej aktywności znajdującej się za pętlą.

Aktywność można umieścić na ścieżce wychodzącej z bramki logicznej, aby przerwać pętlę tylko po spełnieniu określonego warunku. W przypadku pętli zagnieżdżonych przerwana zostanie pętla, wewnątrz której bezpośrednio znajduje się aktywność Przerwij pętlę. Pętla nadrzędna będzie kontynuowana.

Zmienne kontekstowe pętli

W aktywnościach umieszczonych wewnątrz pętli dostępne są dodatkowe mentionsy:

  • Numer iteracji – zwraca indeks aktualnie wykonywanej iteracji. Numerowanie zaczyna się od 0, dlatego dla pętli wykonującej się pięć razy kolejne wartości to 0, 1, 2, 3 i 4.
  • Liczba elementów – zwraca całkowitą liczbę elementów źródła ustaloną przed rozpoczęciem pętli. Dla pętli po liczbie jest to obliczona liczba powtórzeń.

Oba mentionsy zwracają liczby całkowite i można ich używać w polach obsługujących mentiony lub wyrażenia. W przypadku pętli zagnieżdżonych każda pętla udostępnia własny numer iteracji i liczbę elementów pod swoją nazwą.

Czekaj na spełnienie warunku

Aktywność wstrzymuje proces do momentu spełnienia warunku przypisanego do jednej z wychodzących ścieżek. Każda ścieżka może mieć niezależny zestaw warunków. W jednym zestawie można łączyć warunki operatorami ORAZ i LUB.

Warunki tworzy się na podstawie pól formularza i dostępnych operatorów. Konfiguruje się je na wychodzących ścieżkach, a nie w ustawieniach samej aktywności. Szczegóły opisano w artykule Tworzenie filtrów na listach.

System sprawdza warunki raz na minutę.

Czekaj określony czas

Aktywność automatycznie wstrzymuje proces na wskazany czas, określony w sekundach, minutach lub godzinach. W pokazanym przykładzie proces jest zatrzymany na 24 godziny.