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