Co to jest akcja?
Akcja jest to predefiniowane, wydzielone działanie, wykonujące konkretną czynność, np. Zmień wartość pola, Wygeneruj dokument lub Nadaj uprawnienia. Zestaw standardowych akcji dostarcza producent systemu a użytkownik projektujący aplikacje może ich użyć w swoich aplikacjach. Siłą akcji jest to, że można je w dowolny sposób łączyć w całe procesy. Dzięki temu elastyczność systemu drastycznie wzrasta. Akcja może być podpięta pod przycisk na formularzu lub też być częścią procedury obiegu – na przykład można w łatwy sposób spowodować wygenerowanie dokumentu w konkretnym kroku procedury. Lista dostępnych akcji znajduje się na nońcu tego artykułu.
Konfiguracja akcji
Akcje zaczynamy tworzyć tak jak zwykłą procedurę obiegu. Możemy do standardowego obiegu dodać pojedyncze akcje lub ich sekwencje lub też stworzyć obieg składający się z samych akcji. Akcja może też być podpięta pod przycisk na formularzu i wywoływana w dowolnym momencie przez użytkownika. Jeżeli wykonujemy typową akcję którą chcemy podpiąć pod przycisk można zaznaczyć opcję Tryb akcji. W tym trybie wykonanie działań będzie zawsze automatyczne (bez interakcji użytkownika). Prostsza też będzie konfiguracja działania. Dzięki takiemu ustawieniu obiegi złożone z samych akcji można w łatwy sposób odfiltrować spośród wszystkich procesów.
Następnie należy skonfigurować działanie – tak jak w tradycyjnym procesie obiegu. W trybie akcji mamy do wyboru mniej opcji, na przykład możemy tylko wykonywać automatycznie akcje.
Jeżeli jednak zdecydowaliśmy się na użycie akcji w ramach standardowego obiegu, konfiguracja działania nie zmieni się. Trzeba skonfigurować wszystkie elementy tak jak przy działaniu które nie zawiera akcji. Po skonfigurowaniu i zapisaniu działania możemy przystąpić do konfiguracji akcji. Sekcja dotycząca akcji znajduje się na dole formularza działania.
Kluczowe elementem jest skonfigurowanie akcji. Do wyboru mamy dwa tryby:
Wyrażenie – w tym trybie akcja jest po prostu zapytaniem SQL które zostanie wykonane przez system
Akcja z listy – w tym trybie do wyboru mamy predefiniowane akcje dostarczone z systemem lub przez innych wykonawców.
Wybór akcji
Po wybraniu drugiej opcji pojawi się kolejna lista na której wybieramy akcje. W jednym działaniu możemy wybrać tylko jedną akcję. Jeżeli potrzebujemy wykonać kilka akcji jedna po drugiej to po prostu dodajemy kolejne działania z kolejnymi akcjami.
Po wybraniu akcji pojawi się formularz do jej skonfigurowania. Wygląd formularza zależy od typu akcji. Opisy konfiguracji poszczególnych akcji wraz z widokami formularz konfiguracji są dostępne w osobnych artykułach do których odnośniki znajdują się na początku tego artykułu. Poniżej przykładowy wygląd konfiguracji akcji tworzenia dokumentu: 
Po skonfigurowaniu akcji można zapisać obieg.
Ostatnim elementem konfiguracji akcji jest podpięcie akcji do typu dokumentu. Jeżeli stworzyliśmy standardową procedurę obiegu to należy postępować tak, jak ze zwykłymi procedurami. Opis konfiguracji domyślnej procedury obiegu dla typu dokumentu znajduje się w artykule Tworzenie procedury obiegu.
Podpinanie akcji pod przycisk na formularzu
Jeżeli chcemy uruchamiać akcje przez przycisk na formularzu należy dodać taki przycisk i skonfigurować go jak każdy inny atrybut. Więcej o konfiguracji formularza można znaleźć w artykułach: Tworzenie formularzy oraz Atrybuty i standardowe pola wbudowane Ostatnią czynnością jest podpięcie pod przycisk zdefiniowanej wcześniej akcji:
Należy wybrać działanie po naciśnięciu – Uruchom obieg – i wskazać utworzony obieg. W ten sposób można podpinać tylko obiegi, które mają zaznaczoną opcję Tryb akcji.
Dostępne akcje
Aktualnie w systemie NAVIGATOR dostępne są następujące zestawy akcji:
- Akcje systemowe: Dokumenty
- Utwórz nowy – tworzy nowy dokument o zadanym typie
- Utwórz nowe na podstawie plików – tworzy nowy dokument na podstawie plików. Działanie akcji podobne jest do działania hotfolderu
- Zmień wartość pól – pozwala na zmianę wartości pola
- Usuń – usuwa dokument
- Archiwizuj – przenosi dokument do archiwum
- Wycofaj z archiwum – wycofaj dokument z archiwum
- Akcje systemowe: Zadanie
- Utwórz nowe – tworzy nowe zadanie (tabela Ta)
- Zmień wartośc pól – pozwala na zmianę wartości pola na formularzu zadania
- Usuń – usuwa zadanie
- Akcje systemowe: Kontrahent
- Uzupełnij dane na podstawie GUS – akcja pobiera dane z GUS na podstawie NIP i uzupełnia pola na formularzu kontrahenta
- Zmień wartość pól – pozwala na zmianę wartości pola
- Zmień wartość pól na podstawie dokumentu – akcja pozwala na uzupełnienie pól na formularzu kontrahenta na podstawie innego dokumentu (dokument z tabeli Do)
- Zweryfikuj rachunek bankowy – Akcja sprawdza, czy podany rachunek bankowy znajduje się na białej liście
- Zweryfikuj status VAT – weryfikacja statusu VAT dla podmiotów z Polski
- Zweryfikuj status VAT-EU – weryfikacja statusu VAT dla podmiotów europejskich
- Zwertyfikuj wszystkie statusy VAT – weryfikacja statusów VAT (polski i europejski)
- Akcje systemowe: Pola
- Kopiuj dane między dokumentami – akcja pozwala na kopiowanie wartości pomiędzy polami różnych dokumentów.
- Akcje systemowe: Relacje
- Dodaj – akcja tworzy relację między obiektami (dokumenty, zadania, maile itp)
- Usuń – akcja usuwa relację między obiektami
- Akcje systemowe: Uprawnienia
- Dodaj – akcja pozwala na dodanie uprawnień dla użytkownika, stanowiska lub grupy
- Nadpisz – akcja nadpisuje uprawnienia
- Usuń – akcja usuwa uprawnienia dla użytkownika, grupy lub stanowiska
- Akcje systemowe: Wydruk
- Drukuj na podstawie szablonu – akcja pozwala wygenerować dokument (załącznik w formacie doc lub pdf) na podstawie szablonu Word
- Akcje systemowe: Poczta
- Kopiuj załącznik do innego obiektu – akcja pozwala skopiować załącznik do innego obiektu (dokumentu, zadania itp)
- Odpowiedz – akcja wysyła odpowiedź na mail
- Przekaż – akcja przekazuje mail do innego adresata
- Synchronizuj skrzynkę – akcja wywołuje synchronizację skrzynki
- Wyślij – akcja wysyła mail
- Wyślij zgodnie ze schematem powiadomień – akcja wysyła mail. W akcji można podać schemat powiadomień który umożliwia lepszą konfigurację wyglądu wysyłanej wiadomości.
- Zmień wartość pól – akcja pozwala zmienić wartość pola
- Akcje systemowe: Workflow
- Poczekaj – zawiesza wykonanie procesu do wskazanej w konfiguracji daty
- Poczekaj na status obiektu – zawiesza wykonanie procesu do momentu aż wskazany w konfiguracji obiekt osiągnie wskazany stan
- Poczekaj na status obiegu – zawiesza wykonanie procesu do momentu aż wskazany w konfiguracji obieg osiągnie wskazany stan
- Start – uruchamia wskazany proces
- Zakończ – kończy aktualnie uruchomiony proces na wskazanym obiekcie
- Akcje systemowe: Słownik
- Utwórz nowy element słownika – akcja tworzy nowy element we wskazanym słowniku
- Integracja z KSeF
- Wyślij fakturę – akcja wysyła fakturę do KSeF na podstawie formularza
- Wyślij fakturę z załącznika – akcja wysyła do KSeF fakturę zapisaną jako XML w załączniku
- Pobierz UPO – pobranie potwierdzenia wysłanai faktury
- Pobierz z UPO datę przesłania – pobranie daty przesłania z potwierdzenia
- Pobierz z UPO datę przyjęcia – pobranie daty przyjęcia z potwierdzenia
- Pobierz z UPO numer KSeF – pobranie numeru KSeF wysłanej faktury z potwierdzenia
- Pobierz faktury – pobranie nowych faktur z systemu SKeF
- Integracja z e-Doręczeniami
- Pobierz wiadomości – pobiera wiadomości ze skrzynki e-Doręczeń
- Wyślij wiadomość – wysyła wiadomość na skrzynkę e-doręczeń
- Odczytaj wiadomość – odczytuje wskazaną wiadomość. Jeżeli pobierzemy wiadomości z parametrem Odczytaj wiadomość ustawionym na Nie to wywołanie tej akcji ustawi status na przeczytaną, pobierze treść wiadomości oraz załączniki
- Pobierz potwierdzenie – pobiera potwierdzenie dla wskazanej wiadomości
- Szukaj adresu – wyszukuje adres skrzynki e-Doręczeń na podstawie numeru NIP
- Pobierz status – pobiera status wskazanej wiadomości
Pod powyższymi odnośnikami znajdują się opisy konfiguracji poszczególnych akcji.