Przejdź do treści

Akcje systemowe

Akcja systemowa to gotowa czynność Navigatora, np. utworzenie dokumentu, wysłanie e-maila albo nadanie uprawnień. Akcję wstawiasz do kroku procedury obiegu, a krok wykonuje ją bez udziału użytkownika. Z tego artykułu dowiesz się, gdzie można użyć akcji, jak podać jej parametry i jak działają różne tryby wykonania.

Gdzie używa się akcji

Miejsce Kiedy akcja się wykonuje
Krok procedury obiegu, sekcja Akcje Po zatwierdzeniu kroku. Krok z wykonaniem automatycznym zatwierdza się sam, więc akcja wykona się, gdy obieg do niego dojdzie.
Procedura w Trybie akcji Po kliknięciu przycisku menu, przycisku na formularzu albo przycisku z ustawień typu dokumentu, który uruchamia tę procedurę. Procedura może też działać według harmonogramu.
Przycisk na formularzu, zakładka Warunki, sekcja Akcje Po kliknięciu przycisku (patrz Warunki).
Przycisk na formularzu z działaniem Uruchom akcję Po kliknięciu przycisku. Ta opcja obsługuje tylko akcje przycisku, czyli Dane wrażliwe.

Procedura w trybie akcji składa się zwykle z samych kroków automatycznych. Opis trybu i harmonogramu znajdziesz w artykule Tworzenie procedury obiegu.

Akcja w kroku procedury

  1. Otwórz krok procedury w trybie edycji (patrz Ustawienia działania).
  2. W sekcji Akcje, w polu Definicja, wybierz Akcja z listy. Opcja Wyrażenie zamiast akcji wykonuje zapytanie SQL.
  3. W polu Akcja wybierz akcję. Lista pokazuje grupę i nazwę akcji, np. „Dokument: Utwórz nowy”.
  4. Uzupełnij Parametry. Nad parametrami jest opis akcji, a po najechaniu na nazwę parametru zobaczysz podpowiedź.
  5. Zapisz krok.

Jeden krok wykonuje jedną akcję. Kilka akcji ustawiasz w kolejnych krokach, które idą jeden po drugim.

Wartości parametrów

Wartość parametru wybierasz z listy w polu albo wpisujesz.

Rodzaj wartości Opis
Pole formularza Pole typu dokumentu, którego dotyczy procedura. Akcja weźmie jego wartość z obiektu, na którym działa obieg.
Pole systemowe Wartość z kontekstu obiegu (patrz tabela niżej).
Pozycja z listy Dla parametrów z własną listą, np. typ dokumentu, tabela, Tak albo Nie.
Stała Wpisany tekst albo liczba, np. ID konkretnego użytkownika.
Zapytanie SQL W parametrach z edytorem SQL, np. w wartościach pól albo temacie e-maila. Zapytanie zwraca jedną wartość: kolumnę VALUE albo pierwszą kolumnę wyniku.

Parametr, który przyjmuje kilka obiektów, np. kilka dokumentów albo adresów e-mail, przyjmie pole z wieloma wartościami albo wartości rozdzielone średnikiem.

Pola systemowe:

Pole systemowe Wartość
Id dokumentu ID obiektu, na którym działa obieg: dokumentu, zadania, wiadomości e-mail itp.
Id użytkownika Osoba, która zatwierdziła krok albo kliknęła przycisk.
Id działania obiegu Bieżący krok w obiegu. Potrzebują go akcje, które wstrzymują obieg, np. Poczekaj.
Id obiegu Bieżący obieg.
Id procedury, Id kroku procedury Procedura i krok w jej definicji.
Id załączników Załączniki obiektu, na którym działa obieg.
Id firmy Firma wybrana w przełączniku firm w nagłówku. Przy wykonaniu w tle jest pusta.

Parametr Użytkownik, który ma prawie każda akcja, decyduje, kto zostanie zapisany jako osoba wprowadzająca zmianę. Zwykle wskazuje się w nim pole systemowe Id użytkownika. Pusty parametr oznacza zwykle administratora systemu (użytkownika o ID 1).

Zachowaj ID w

Akcje, które coś tworzą, mają parametr Zachowaj ID w. Wskazujesz w nim pole formularza, do którego akcja wpisze ID nowego obiektu, np. utworzonego dokumentu. W kolejnych krokach użyjesz tego pola jako wartości parametru, np. żeby zmienić pola nowego dokumentu albo dołączyć do niego wydruk. Pole może być niewidoczne, ale musi być aktywne na typie dokumentu.

Tryby wykonania

Większość akcji wykonuje się od razu, w chwili zatwierdzenia kroku. Niektóre działają inaczej:

Tryb Akcje Działanie
Wykonanie opóźnione Uprawnienie, Wydruk Pod polem Akcja pojawia się opcja Wykonanie opóźnione. Zaznaczona przesuwa akcję na koniec przetwarzania obiegu, np. po odświeżeniu uprawnień. Odznaczona wykonuje akcję od razu. Gdy opcja nie była ustawiana, akcja jest opóźniona.
Wykonanie w tle Dokument: Utwórz nowe na podstawie plików Akcja działa w tle, a obieg przechodzi dalej, gdy się skończy.
Oczekiwanie Obieg: Poczekaj, Poczekaj na status obiektu, Poczekaj na status obiegu, Plik: Udostępnij za pomocą OneDrive Krok czeka, aż spełni się warunek akcji. Navigator sprawdza czekające kroki mniej więcej co minutę i sam zatwierdza krok.

Komunikaty

Akcja, która nie może się wykonać, np. z powodu pustego wymaganego parametru, przerywa zatwierdzanie kroku i pokazuje komunikat. Niektóre akcje, np. Komunikat albo weryfikacja rachunku bankowego, pokazują też komunikat po udanym wykonaniu.

Dostępne akcje

Grupa Akcje
Dokument Utwórz nowy, Utwórz nowe na podstawie plików, Zmień wartość pól, Usuń, Archiwizuj, Wycofaj z archiwum
Pole Kopiuj dane między obiektami
Zadanie Utwórz nowe, Zmień wartość pól, Usuń
Relacja Dodaj, Usuń
Plik Przekształć w PDF, Scal pliki PDF, Kopiuj załączniki, Sprawdź liczbę załączników, Udostępnij za pomocą OneDrive, Oblicz skrót pliku
Wydruk Drukuj na podstawie szablonu
Kontrahent Uzupełnij dane na podstawie GUS, Zweryfikuj rachunek bankowy, Zweryfikuj status VAT, Zweryfikuj status VAT-UE, Zweryfikuj wszystkie statusy VAT, Zmień wartość pól, Zmień wartość pól na podstawie dokumentu
Uprawnienie Dodaj, Usuń, Nadpisz
Obieg Start, Zakończ, Poczekaj, Poczekaj na status obiektu, Poczekaj na status obiegu
Słownik Utwórz nowy element słownika
Listy Eksportuj do Excela
Komunikat Ustaw komunikat
Dane wrażliwe Szyfruj, Odszyfruj, Usuń
Poczta Wyślij, Odpowiedz, Przekaż, Wyślij zgodnie ze schematem powiadomienia, Kopiuj załączniki do powiązanego obiektu, Synchronizuj skrzynkę, Zmień wartość pól, Pobierz załączniki
KSeF Wysyłanie i pobieranie faktur w Krajowym Systemie e-Faktur
e-Doręczenia Wysyłanie i odbieranie pism w e-Doręczeniach

Własne akcje można dodać rozszerzeniem .NET (patrz Rozszerzenia .NET).