View Categories

Akcje używane w obiegu

Każdy proces zawiera Aktywności, Bramki i Ścieżki. Dla każdej Aktywności i Bramki należy skonfigurować działanie. Jest to wbudowana czynność, która ma być wykonywana podczas wykonywania etapu procesu. Mamy do wyboru zestaw aktywności. Każda z nich musi być skonfigurowana w rozwijanym menu Ustawienia aktywności znajdującym się w zakładce Ogólne.

Aktywność użytkownika #

To najczęściej używane działanie. Gdy uczestnik w procesie ma wykonać aktywność, wybiera się właśnie je. Możesz również zmienić wartość pola w tym działaniu.

Wykonawcy działania: użytkownik musi dodać co najmniej jednego użytkownika jako wykonawcę aktywności.

Dostępne opcje (możemy dodać więcej niż jeden warunek z operatorami oraz/lub):

  • Osoba, która uruchomiła obieg.
  • Użytkownik – konkretny użytkownik według nazwy z listy użytkowników.
  • Wszyscy z grupy – działanie musi być przetworzone przez wszystkich użytkowników z wybranego działu, określoną grupę użytkowników lub wszystkich w firmie.
  • Ktokolwiek z grupy – działanie musi być przetworzone przez co najmniej jednego użytkownika z wybranego działu, określoną grupę użytkowników lub wszystkich w firmie. Pierwszy użytkownik, który wykona akcję, kończy etap procesu.
  • Wszyscy z pola – działanie musi być przetworzone przez wszystkich użytkowników z pola w formularzu zawierającym użytkowników.
  • Ktokolwiek z pola – działanie musi być przetworzone przez co najmniej jednego użytkownika z pola w formularzu zawierającym użytkowników.

Użyj elektronicznego podpisu – zdecyduj, czy w tym kroku użyć podpisu elektronicznego.

Wyślij maila – wybierz, czy chcesz wysłać powiadomienie e-mail do wykonawców aktywności.

Pokaż powiadomienie – wybierz, czy chcesz wysłać powiadomienie systemowe do wykonawców aktywności.

Zmień wartość pola – jest to dodatkowa opcja zmiany wartości pola w dokumencie w tym samym czasie, co wykonywana akcja użytkownika. Działa to tak samo jak ustawienia w akcji Zmień wartość pola.

Stwórz dokument #

To działanie służy do utworzenia nowego dokumentu lub skopiowania istniejącego dokumentu do nowego.

Tryb działania – wybierz, jak chcesz utworzyć nowy dokument. Możesz utworzyć pusty dokument i ustawić wartość każdego atrybutu (opcja Stwórz nowy dokument) lub zduplikować/skopiować istniejący dokument (na którym działa proces) i zmodyfikować wybrane atrybuty (opcja Stwórz na podstawie dokumentu z procesu)

Wybierz formularz – użytkownik musi wybrać formularz dokumentu do utworzenia nowego dokumentu.

Pola dokumentu – wybieramy pola, których wartość chcemy ustawić podczas tworzenia nowego dokumentu. Gdy pole jest wybrane jest, ustawiamy kartę Wartość.

Dla pól typu rozwijanego:

  • Ustaw – system ustawia nową wartość pola na podstawie dostępnej opcji, takiej jak lista lub słownik.
  • Wyczyść – system usuwa wartość pola.
  • Dopasuj – system kopiuje wartość z powiązanego pola ustawionego z pól dokumentu lub pól systemowych, takich jak identyfikator użytkownika i dane użytkownika.

Dla pól typu daty:

  • Wartość – system ustawia nową wartość pola w formacie daty.
  • Funkcja – pozwala ustawić tryb przesunięcia. Gdy ustawiono na Aktualny dzień, przesunięcie jest stosowane do daty. Gdy ustawiono na Aktualną godzinę, przesunięcie jest stosowane do godziny. Używamy wartości dziesiętnej do zdefiniowania przesunięcia daty/czasu. Wartość dodatnia oznacza przesunięcie w przyszłość, wartość ujemna oznacza przesunięcie w przeszłość, wartość zero oznacza bieżącą datę/czas.

Dla pól typu tekst/liczba całkowita:

  • Wartość – system ustawia nową wartość pola na podstawie treści dynamicznej lub wartości wprowadzonej przez użytkownika.

Proces do uruchomienia – użytkownik może wybrać proces z listy, który ma być automatycznie uruchomiony podczas tworzenia dokumentu.

Zmień wartość pola #

Ta akcja służy do zmiany wartości pola w dokumencie.

Dokument – określa, który dokument zostanie zmieniony. Opcje to:

  • Dokument, na którym zostanie uruchomiony obieg – zostanie zmieniony dokument, na którym działa proces.
  • Dokument z atrybutu – dokument z listy opartej na bieżącym formularzu. Używane do zmiany wartości pól w dokumencie wskazanym przez atrybut (np. rozwijane menu) na formularzu, na którym działa proces.
  • Dokumenty z innej aktywności – dokumenty utworzone wcześniej w procesie.
  • Dokument z konfiguracji – dokument z listy formularzy konfiguracyjnych w aplikacji

Zmień wartość pola – wybieramy pola, których wartość chcemy zmienić. Po wyborze pola ustawiamy kartę Wartość.

Dla pól typu rozwijane menu:

  • Ustaw – system ustawia nową wartość pola na podstawie dostępnej opcji, takiej jak lista lub słownik.
  • Wyczyść – system usuwa wartość pola.
  • Dopasuj – system kopiuje wartość z powiązanego pola ustawionego z pól dokumentu lub pól systemowych, takich jak identyfikator użytkownika i szczegóły użytkownika.

Dla pól typu data:

  • Wartość – system ustawia nową wartość pola w formacie daty.
  • Funkcja – pozwala ustawić tryb przesunięcia. Gdy ustawione na Bieżący dzień, przesunięcie jest stosowane do daty. Gdy ustawione na Bieżącą godzinę, przesunięcie jest stosowane do godziny. Używamy wartości dziesiętnej do zdefiniowania przesunięcia daty/godziny. Wartość dodatnia oznacza przesunięcie w przyszłość, wartość ujemna oznacza przesunięcie w przeszłość, wartość zero oznacza bieżącą datę/czas.
  • Dynamiczna wartość.

Dla pól typu tekst/liczba całkowita:

  • Wartość – system ustawia nową wartość pola na podstawie dynamicznej zawartości lub wartości wprowadzonej przez użytkownika.

Dla pól typu załącznik:

  • Ustaw – system ustawia nową wartość pola na podstawie dostępnej opcji, takiej jak lista lub słownik.
  • Wyczyść – system usuwa wartość pola.
  • Dopasuj – system kopiuje wartość z powiązanego pola ustawionego z pól dokumentu lub pól systemowych, takich jak identyfikator użytkownika i szczegóły użytkownika.
  • Dodaj – system dodaje wartość do już istniejącej listy wartości.

Wybieramy również źródło, z którego będziemy pobierać załącznik (inne pole załączników) oraz tryb wskazujący, który załącznik z listy ma być użyty (Pierwszy, Ostatni). Dla opcji SQL możemy również wybrać nową nazwę pliku za pomocą pola Nazwa pliku.

Jako dodatkową funkcję akcji na kroku obiegu możliwa jest zmiana wartości pól na ścieżkach w zakładce Ustawienia ścieżki.

Utwórz lub zaktualizuj #

To działanie ma być używane, gdy chcemy, aby system sprawdził listę dokumentów i jednocześnie zaktualizował rekordy, jeśli istnieją, i utworzył nowe, jeśli nie istnieją na liście.

Aby go użyć, wybieramy listę dokumentów, filtrujemy ją według określonego warunku (w tym przykładzie – tylko dokumenty z Kodem = USD) i określamy pola do zaktualizowania lub utworzenia. W tym przykładzie system najpierw sprawdzi, czy istnieje waluta o kodzie USA, a następnie utworzy ją lub zaktualizuje istniejącą.

Usuń dokument #

Ta akcja służy do usuwania dokumentu w trakcie procesu lub tworzenia specjalnego przycisku do usuwania dokumentu. W ustawieniach wybieramy spośród 3 opcji. Proces może usunąć:

  • Dokument na którym zostanie uruchomiony obieg – dokument, nad którym aktualnie pracujemy, zostanie usunięty.
  • Dokument z atrybutu – dokument z listy opartej na atrybucie bieżącego formularza.
  • Dokument z innej aktywności – dokument utworzony w procesie.
  • Dokument z konfiguracji – dokument z listy formularzy konfiguracyjnych w aplikacji.

Pole wyboru Trwale usuń dokument, daje użytkownikowi możliwość permanentnego usunięcia dokumentu (zaznaczone) lub przeniesienia go do kosza na 30 dni (niezaznaczone).

Zauważ, że gdy usuwasz bieżący dokument tą akcją, nie można wykonać żadnych następnych akcji na tym dokumencie, ponieważ został on usunięty. Po wykonaniu tej akcji widok dokumentu pozostanie taki sam, chociaż został usunięty. Dopiero kolejne wejście w ten dokument nie będzie możliwe.

Zmień uprawnienia #

Używamy tej akcji do zmiany uprawnień w trakcie procesu, wskazując źródło (Użytkownik, Grupy lub pole na formularzu), a następnie Atrybut z tego źródła. Po czym decydujemy o Typie uprawnienia (Odczyt, Edycja, Usuwanie).

Tryb zmiany uprawnień:

  • Dodaj uprawnienia – dodaj uprawnienia do dokumentu.
  • Usuń uprawnienia – usuń uprawnienia z dokumentu.
  • Nadpisz uprawnienia – usuń wszystkie uprawnienia i dodaj wybrane uprawnienia.
  • Usuń wszystko – usuń wszystkie uprawnienia z wybranego obszaru.

Widok formularza nowego dokumentu #

Ta akcja jest dostępna do użycia tylko na pierwszym kroku procesu. Ustawia widok formularza na początku procesu. W ustawieniach możemy wybrać, które atrybuty z danego formularza mają być widoczne, edytowalne lub wymagane.

Widok formularza po zakończeniu procesu #

Ta akcja jest dostępna do użycia tylko na ostatnim kroku procesu. Ustawia widok formularza na końcu procesu. W ustawieniach możemy wybrać, które atrybuty z danego formularza mają być widoczne, edytowalne lub wymagane.

Pętla #

W programowaniu komputerowym pętla to sekwencja instrukcji powtarzanych do czasu, aż zostanie spełniony określony warunek. Zazwyczaj wykonuje się pewien proces, na przykład pobiera element danych, zmienia go, a następnie sprawdza się pewien warunek, na przykład czy licznik osiągnął określoną liczbę.

Pętla w Navigator365 jest bardziej złożonym typem działania, ponieważ składa się z dwóch wzajemnie powiązanych warstw. Pierwszą warstwę możemy ustawić w ustawieniach aktywności.

Aby ustawić źródło danych, należy wspomnieć o polu lub zmiennej z sekcji wspomnianej pod znakiem @. Działa to podobnie jak pętla for-each, którą można znaleźć w wielu językach programowania. Typ pętli for-each to instrukcja sterująca, przeszukująca elementy w kolekcji. Dostępne są trzy opcje:

Listy – przeszukiwana kolekcja to lista dokumentów. Pętla będzie sprawdzać każdy element z wymienionej listy. Lista ta może być dodatkowo ograniczona za pomocą konfiguracji standardowego filtra.

Formularze – jeśli formularz, z którego pochodzi proces, ma pole Lista atrybutów, pętla będzie iterować po każdym elemencie z tej listy.

Zmienna Json – pętla będzie przeszukiwać kolekcję przypisaną do zmiennej typu JSON. Zmienną tę można wskazać za pomocą rozwijanej listy Zmienna, która pojawi się po wybraniu odpowiedniej opcji. Dodatkowo można wskazać właściwość przechowującą kolekcję danych, używając węzła JSON listy z kolekcją danych.

Druga warstwa może być otwarta za pomocą strzałki wskazującej na prawy dolny róg ikony na diagramie procesu. Przełączanie między warstwami jest możliwe za pomocą nienazwanej listy widocznej w prawym górnym rogu okna tworzenia procesu.

Druga warstwa to dodatkowy proces zawierający akcję lub zestaw akcji, które zostaną wykonane dla każdego elementu kolekcji osiągniętej przez pętlę. Ustawienia są podobne do typowych ustawień akcji. Możesz użyć danych z dokumentu, w którym znajduje się krok pętli i użyć ich na przykład w dokumencie utworzonym przez akcję z omawianej warstwy. Te zmienne są oznaczone ikoną zaokrąglonej strzałki i mogą być odwoływane za pomocą wzmianek (mentions). Przykładowe użycie tej funkcjonalności jest opisane przy scenariuszu tworzenia dokumentów w pętli na podstawie pliku excel tutaj.

Bramka logiczna XOR #

Jest to specjalne działanie, które implementuje funkcję boolowską. Można w niej wybrać tylko jedną ścieżkę. W zależności od spełnienia warunków prawdy lub fałszu proces zostanie skierowany na odpowiednią drogę. Aby ułatwić tworzenie bramki logicznej, dobrze jest skonfigurować inne elementy procesu, a następnie wrócić do kroku z bramką logiczną. W ten sposób zostaną utworzone ścieżki i wystarczy tylko przypisać niezbędne warunki.

Pod listą pól aktywności pojawi się lista elementów. Znajdą się na niej Nazwa ścieżki, Następna aktywność i specjalne pole zawierające konfigurację warunków wyboru drogi do następnej ścieżki. Liczba wierszy na tej liście zależy od liczby ścieżek wychodzących z bramki logicznej.

Konfigurowanie warunków przechodzenia do określonej ścieżki działa podobnie jak konfigurowanie filtrów na listach. Możesz dowiedzieć się więcej na ten temat w tym artykule. W zależności od tego, który warunek jest spełniony, proces podejmie właściwą ścieżkę.

Bramka logiczna OR #

Jest to specjalne działanie, które implementuje funkcję boolowską, w której więcej niż jedna ścieżka może być wybrana. Konfiguracja jest podobna do działania Bramki logicznej XOR.

Czekaj na warunek #

Ten typ aktywności służy do wstrzymywania procesu i kierowania go do ścieżki po spełnieniu określonych warunków. Możliwe jest posiadanie wielu dostępnych ścieżek, z których każda ma inne warunki do spełnienia. Funkcja ta wykracza poza zwykłe oczekiwanie na akcję i tworzy skrzyżowanie procesów z różnymi ścieżkami. Może istnieć więcej niż jeden warunek dla każdej ścieżki przy użyciu ORAZ (oba muszą być spełnione) i LUB (tylko jeden musi być spełniony, aby kontynuować).

Warunki ustawiamy na podstawie pól formularza i typowych operatorów. Ważne jest, aby wiedzieć, że robi się to w sekcji Nazwa ścieżki, a nie w zakładce Ustawienia aktywności. Więcej o ustawianiu filtrów można przeczytać tutaj.

System sprawdza ten warunek co minutę.

Czekaj na określony czas #

To automatyczna akcja, która zatrzymuje proces na wybrany czas (określony w sekundach, minutach lub godzinach). W tym przykładzie proces jest zatrzymany na 24 godziny.

Generowanie pliku PDF #

Akcja służy do tworzenia pliku PDF na podstawie szablonu i danych z pól dokumentu. Więcej informacji na temat tworzenia szablonów w Wordzie można znaleźć tutaj.

Dodaj szablon – musisz przygotować dokument Word zawierający szablon dla dokumentu PDF.

Dodaj pliki – tutaj możesz dodać taki dokument z dysku twardego.

Pobierz z formularza – możesz przypisać kod na szablonie do określonego pola na formularzu dokumentu. Wartość z tego pola zostanie wstawiona do nowego pliku PDF. Zamiast pola formularza użytkownik może utworzyć wyrażenie SQL.

Dodaj pole – możesz dodać dodatkowe pole do użycia na kodach w szablonie.

Zapisz plik wynikowy jako załącznik – wygenerowany plik można przechowywać w atrybucie Załącznik. Tutaj możesz wybrać, który atrybut załącznika użyć do przechowywania wygenerowanych plików PDF.

Zapisz w zmiennej globalnej – dokument jest zapisywany w Zmiennych procesowych do późniejszego wykorzystania, np. wysyłania wiadomości e-mail z załącznikami.

Pobierz w przeglądarce – zaznacz, aby pobrać plik wynikowy w przeglądarce. Plik zostanie automatycznie pobrany zamiast być zapisanym w zmiennych lub załącznikach.

Typ pliku wyjściowego – wybierz między formatem PDF a Word.

Nazwa pliku wyjściowego – wprowadź nazwę pliku PDF lub użyj treści dynamicznej.

Dodaj załącznik #

Plik jest zapisywany w Zmiennych procesowych do późniejszego wykorzystania, np. wysyłania wiadomości e-mail z załącznikami.

Nazwa pliku – nazwa pliku załącznika. Gdy nie ma ustawionej wartości, nazwa pliku źródłowego zostanie użyta jako nazwa nowego pliku.

Zmienna – zmienna procesowa do przechowywania pobranych danych.

Pole – pole widoku formularza.

Pobierz załącznik #

Dokument jest pobierany z zapisanych dokumentów w Zmiennych procesowych.

Przekształć załącznik #

Akcja jest używana do modyfikowania plików przechowywanych w atrybucie załączników. Użytkownik podaje źródło, atrybut, w którym załączniki są przechowywane i decyduje o typie pobierania (Pierwszy, Ostatni, Wszystkie). Dostępne opcje modyfikacji pliku to:

  • Konwertuj obraz na plik PDF.
  • Usuń podpisy cyfrowe – usuwanie podpisu cyfrowego z pliku PDF nie jest łatwe, więc ta akcja może go usunąć z wcześniej podpisanego pliku i przygotować go do zmian i nowego podpisu.
  • Zmień rozmiar – może zmniejszyć obraz za pomocą prostego kroku, aby nadać nową szerokość obrazu.
  • Zmień nazwę pliku – może zmienić nazwę pliku, z możliwością użycia danych z formularza lub zmiennych środowiskowych.

Import z Excela #

Ta akcja umożliwia użytkownikowi wydobycie danych z plików Excel i wykorzystanie ich w procesie. Dobrym przykładem jest tworzenie dokumentów Kontrahenta dla każdego wiersza pliku Excela oraz wydobycie danych z kolumn do określonych pól na formularzu.

Aby poprawnie skorzystać z tej akcji wymagana jest sekwencja kilku kroków. Pierwszym krokiem jest akcja Import z Excela, w której użytkownik dodaje plik Excel bezpośrednio lub wskazuje pole załącznika na formularzu. System na tym etapie tylko odczytuje plik i udostępnia dane do wykorzystania w następnych krokach.

Następnie użytkownik tworzy akcję Pętla, w której jako źródło danych powinien zostać wybrany plik Excela z poprzedniego kroku. W tym celu należy wspomnieć (@) krok i plik Excela, tak jak na poniższym ekranie.

W ostatnim kroku użytkownik wybiera akcję (np. Stwórz dokument), aby wykorzystać dane z pliku Excel. W tym przykładzie krok Tworzenie kontrahenta stworzy dokumenty dla każdego wiersza w pliku Excel i wypełni je danymi pobranymi z kolumn. Aby przypisać poprawnie dane z kolumn do Pól formularza można po prostu wspomnieć (@) nazwę kolumny w pliku Excel (dane z pętli) i dopasować ją do pola na utworzonym dokumencie.

Wyślij maila

Akcja służy do wysyłania wiadomości e-mail z systemu. W ustawieniach aktywności mamy 2 zakładki do skonfigurowania.

Karta Wiadomość:

Tutaj mamy kilka typowych danych używanych przy tworzeniu e-maili.

Do – dodajemy dynamiczne treści na podstawie pól formularza i identyfikatorów systemowych.

Kopia – dodajemy dynamiczne treści na podstawie pól formularza i identyfikatorów systemowych.

Temat – dodajemy dynamiczne treści na podstawie pól formularza i identyfikatorów systemowych.

Treść – dodajemy dynamiczne treści na podstawie pól formularza i identyfikatorów systemowych.

Dodaj załączniki – możemy dodać załącznik z karty Zmienne procesowe. Aby móc skorzystać z tej opcji, musimy dodać kilka zmiennych typu „plik” do karty Zmienne procesowe w głównych ustawieniach procesu.

Konfiguracja serwera: #

Tutaj mamy konfigurację dla serwera wychodzącego poczty e-mail. Możesz wybrać istniejącą konfigurację (poprzez wybranie jej nazwy) lub wybrać opcję Inne, aby ręcznie skonfigurować serwer. Jeśli nie wiesz, który serwer wybrać lub nie znasz parametrów serwera, zapytaj administratora systemu.

Wybierz konfigurację konta pocztowego – Użytkownik wybiera wcześniej skonfigurowaną usługę pocztową lub ustawia dedykowany serwer, podając:

  • Nazwę użytkownika SMTP
  • Hasło SMTP
  • Port SMTP
  • Adres serwera SMTP
  • Użyj szyfrowania TLS

Pobierz maile: #

Akcja służy do pobierania e-maili z dedykowanego konta pocztowego. Mamy tylko 1 kartę do konfiguracji, która polega na wybraniu konta pocztowego. Lista dostępnych kont pocztowych pochodzi z ustawień Kont pocztowych ustawionych w aplikacji Systemowej.

W przypadku potrzeby jednorazowego konta e-mailowego, lista niezbędnych pól powinna być dodana do formularza. Dzięki temu użytkownik może skonfigurować konto e-mailowe, podając nazwę użytkownika IMAP, hasło IMAP, adres serwera IMAP i port IMAP, używając szyfrowania TLS (pole wyboru) oraz określając, ile dni wiadomości chciałby wykorzystać (1 oznacza od północy wczoraj).

Później można korzystać z danych z e-maili, takich jak Do, Od czy Temat i używać wartości do tworzenia nowych dokumentów w pętli iterującej po pobranych e-mailach.

Slack: #

Akcja służy do wysyłania alertów na kanał Slacka. W ustawieniach aktywności mamy 2 karty do konfiguracji. Adres URL webhooka to przychodzący adres URL webhooka utworzony w aplikacji Slack. Instrukcja jak utworzyć taki weebhook jes tzamieszczona na stronie dokumentacji Slacka tutaj. Wiadomość może być standardową wiadomością tekstową w polu lub polem wspomnianym (@) w naszym formularzu. Aby wspomnieć pole zawierające wiadomość w formularzu, użyj @.

Teams: #

Akcja służy do wysyłania powiadomień na kanał MS Teams. W ustawieniach aktywności mamy 2 karty do konfiguracji. Adres URL webhooka to przychodzący adres URL webhooka utworzony w aplikacji Teams. Wiadomość może być standardową wiadomością tekstową w polu lub polem wspomnianym (@) w naszym formularzu. Aby wspomnieć pole zawierające wiadomość, użyj @.

Eksportuj użytkownika do domeny #

W ustawieniach aktywności mamy 2 karty do konfiguracji:

Konfiguracja domeny – wprowadź nazwę domeny, kontener, nazwę użytkownika (Login użytkownika, który ma uprawnienia do dodawania użytkowników do domeny) oraz hasło.

Konfiguracja konta użytkownika – wprowadź nazwę użytkownika, hasło (jeśli hasło w tym polu jest puste, użytkownik zostanie poproszony o utworzenie hasła przy pierwszym logowaniu), imię, nazwisko oraz e-mail użytkownika.

Wyślij ponownie email aktywacyjny #

Gdy tworzysz nowe konto użytkownika w systemie, zwykle system wysyła e-mail w celu potwierdzenia konta. Jeśli coś pójdzie nie tak, na przykład e-mail zostanie utracony, a użytkownik nie będzie mógł zalogować się do systemu, możesz ponownie wysłać e-mail potwierdzający za pomocą tej akcji.

Wprowadź użytkownika – to ID dokumentu użytkownika, który zostanie użyty do ponownego wysłania e-maila aktywującego konto.

Uruchom proces #

Użytkownicy mogą wybrać proces z listy do automatycznego rozpoczęcia. Istnieje możliwość, by uruchomić proces na bieżącym dokumencie, powiązanym dokumencie z formularza lub dokumencie utworzonym w ramach tego procesu wcześniej (dokument z innej aktywności). Wybór dostępnych procesów jest ograniczony do procesów aplikacji oraz innych procesów o dostępności ustawionej na publiczną lub współdzieloną z tą aplikacją.

Przenieś do aktywności #

Ta akcja służy do przejścia pomiędzy krokami w procesie. Obecne kroki oczekiwania zostaną zakończone, a proces będzie kontynuowany od wybranego kroku lub zakończy się, jeśli został wybrany krok końcowy. Użytkownik wybiera proces i określony krok, do którego chce przenieść obieg. Może go przenieść do kroku w:

  • Bieżącym dokumencie – dokumencie, na którym działa proces.
  • Powiązanym dokumencie – dokumencie z listy opartym na atrybucie (np. Lista rozwijana) w bieżącym dokumencie, na którym działa proces.
  • Dokumencie z innej aktywności – dokumencie utworzonym wcześniej w ramach procesu.

Dodaj zastępstwo #

Ta akcja dodaje rolę zastępstwa dla użytkownika w systemie. Gdy zastępstwo jest włączone, dokumenty oczekujące w procesie dla danego użytkownika będą również widoczne dla innego użytkownika, dla którego dodano zastępstwo. Ma to pomóc w zarządzaniu nieobecnościami. Podczas dodawania użytkownika i dat można odwołać się do pól z formularza np. formularza nieobecności.

Zmień zmienną procesową #

Ta akcja umożliwia zmianę zmiennej podczas procesu. Ważne jest zauważenie, że akcja działa tylko i można ją ustawić, gdy co najmniej jedna zmienna w procesie jest zdefiniowana wcześniej. Aby ustawić akcję, wybieramy tylko zmienną i określamy nową wartość. Wartość można wprowadzić bezpośrednio lub poprzez odwołanie do innego pola lub zmiennej.

Przekieruj do URL #

Docelowy adres URL po wykonaniu akcji. Wprowadź adres URL lub użyj dynamicznej zawartości.

 

Wywołaj REST API #

To jedna z najtrudniejszych do skonfigurowania akcji. Jeśli zamierzasz jej używać, musisz zrozumieć, jaka stoi za nią technologia. W skrócie, REST API to styl architektury oprogramowania, który opisuje interfejs między systemami w architekturze klient-serwer przez Internet.

Aby użyć tej akcji, musisz skonfigurować metodę, adres URL usługi i autoryzację. Ponadto, musisz przygotować format JSON (JavaScript Object Notation) z parametrami wywołania usługi. Dane, które uzyskasz lub zmienisz po wywołaniu, zależą od konkretnego interfejsu API.

W ustawieniach aktywności mamy 2 karty do konfiguracji:

Konfiguracja żądania

Metoda żądania HTTP – wybierz metodę spośród PUT, POST, DELETE, PATCH lub GET.

GET – ta metoda służy do żądania danych z określonego źródła. Po wybraniu tej metody wprowadź adres URL usługi API w polu, które pojawi się poniżej (Adres URL). Możesz użyć wzmianek (@), aby wybrać wartości dynamiczne dla swojego linku. Jest to przydatne, gdy adres URL usługi API wymaga określonego identyfikatora obiektu. Wynik zapytania API można zapisać w zmiennej globalnej. Można ją wybrać z listy Zapisz w zmiennej globalnej. Domyślnie ta lista jest pusta. Aby pojawiły się na niej wartości, należy utworzyć zmienną globalną w zakładce Zmienne procesowe i wybrać odpowiedni typ danych. Więcej informacji na temat zmiennych globalnych można znaleźć w tym artykule.

DELETE – ta metoda służy do usuwania określonego zasobu. Konfiguracja dla tej metody jest podobna do metody GET, wyjaśnionej powyżej.

POST – ta metoda służy do wysyłania danych do serwera w celu utworzenia/aktualizacji zasobu. Po wybraniu tej metody wprowadź adres URL usługi API w polu, które pojawi się poniżej (Adres URL). Możesz użyć wzmianek (@) do wyboru dynamicznych wartości dla swojego łącza. Następnie możesz wybrać między dwoma sposobami dostarczenia treści (lista typów zawartości).

Pierwsza opcja to Json (tekst). Gdy wybierzesz tę opcję, możesz wprowadzić żądanie w formacie JSON w polu Zawartość JSON, które pojawi się poniżej. Możesz użyć wzmianek do wyboru dynamicznych wartości dla swojego żądania JSON. Druga opcja Json (twórca) aktywuje pole Szablon do wypełnienia. Gdy raz wprowadzisz szablon (przykładową odpowiedź dla naszego zapytania z adresu URL usługi), użytkownik może nacisnąć przycisk Pobierz z szablonu. Spowoduje to utworzenie wzmianek do pól obiektów i wartości wymaganych do przygotowania żądania JSON. Muszą one pasować do danych, których oczekuje interfejs API. Wynik zapytania API można przechować w zmiennej globalnej. Możesz ją wybrać z listy Zapisz w zmiennej globalnej. Domyślnie lista jest pusta. Aby wartości pojawiły się w niej, musisz utworzyć zmienną globalną w zakładce Zmienne procesowe i wybrać odpowiedni typ danych.

PUT – ta metoda służy do wysyłania danych do serwera w celu utworzenia/aktualizacji zasobu. Różnica między metodami POST a PUT polega na tym, że żądania PUT są idempotentne. Oznacza to, że wielokrotne wywołanie tego samego żądania PUT zawsze da ten sam wynik. W przeciwieństwie do tego, wielokrotne wywołanie żądania POST ma skutek uboczny polegający na wielokrotnym utworzeniu tego samego zasobu. Konfiguracja dla tej metody jest podobna do metody POST, wyjaśnionej powyżej.

PATCH – ta metoda służy do stosowania częściowych modyfikacji zasobu. Konfiguracja dla tej metody jest podobna do metody POST, wyjaśnionej powyżej.

 Autoryzacja

Niezależnie od wybranej metody, ta karta będzie dostępna po prawej stronie karty Konfiguracja zapytania. Domyślnie pole Typ autoryzacji jest ustawione na BRAK.

Typ autoryzacji:

BRAK – ten typ autoryzacji powinien być wybrany, gdy wybrane API nie wymaga poświadczeń do pomyślnego wykonania.

Podstawowy – ten typ autoryzacji powinien być wybrany, gdy wybrane API wymaga nazwy użytkownika i hasła do pomyślnego wykonania.

Token – to najbardziej zaawansowana forma poświadczeń. Możesz albo wprowadzić token ręcznie, albo wzmiankować go z innego miejsca w systemie, gdzie jest bezpiecznie przechowywany pod atrybutem typu Hasło API (po wybraniu Pobierz z API). Jeśli wybierzesz drugą opcję, dodatkowe pola pojawią się w formularzu. Niezależnie od metody użytkownik musi zażądać lub wygenerować token ze źródłowej usługi API.

Wykonaj SQL

Wprowadź kod SQL za pomocą czystego zapytania SQL lub dodawania treści dynamicznych. Jest to opcja low-code dla zaawansowanych użytkowników, ponieważ baza danych Navigator365 może być dostępna, zmieniana i nawet usuwana z tej akcji.

Pobierz dane z bazy danych #

Ta akcja może pobierać określone dane z bazy danych SQL i zapisywać je jako zmienną procesową. Aby z niej skorzystać, najpierw musisz uzyskać ciąg połączenia do wymaganej bazy danych. Poproś administratorów systemu serwerowego o te szczegóły. Ponieważ jest to opcja Low-Code, użytkownik/administrator musi mieć dostęp do SQL Server Management Studio. Wartości takie jak Nazwa serwera i Nazwa bazy danych można znaleźć w eksploratorze obiektów bazy danych w zakładce Właściwości i Połączenie. Możesz użyć tych danych do utworzenia ciągu połączenia. Można również uzyskać wymagany ciąg połączenia z pliku web.config w katalogu głównym Twojej aplikacji internetowej.

Ciągi połączeń składają się z kilku par klucz-wartość, które dostarczają informacji o sposobie połączenia z bazą danych SQL. Najczęstsze to Serwer, Baza danych, ID użytkownika i Hasło w przypadku standardowego połączenia zabezpieczeń. Jednak nie zaleca się przechowywania haseł bezpośrednio we właściwościach akcji. Dla zaufanych połączeń, takich jak Twoja baza danych Navigator365 oparta na Twoim serwerze, używamy DataSource, Database, Integrated Security i TrustServerCertificate. Przykład połączenia z własną bazą danych: Data Source=.;Database=fructon_nav_365;Integrated Security=True;TrustServerCertificate=True.

W poleceniu SQL musimy wprowadzić zapytanie napisane w języku SQL. Dobrą praktyką jest najpierw przetestowanie go w SQL Server Management Studio. Na koniec wybieramy zmienną, do której mają być zapisane dane dla przyszłego wykorzystania.

 

Scal JSON #

Ta akcja umożliwia manipulowanie plikami JSON. Gdy korzystasz z wywołania REST API do integracji dwóch systemów, często otrzymujesz dane w formacie JSON z jednego systemu i zmieniasz je w drugim systemie. Na przykład dodaj wpis do listy i zwróć go do pierwszego systemu.

Ta akcja pozwala na scalenie dwóch JSON-ów, dzięki czemu możesz przygotować dane w Navigator365, połączyć je z danymi pobranymi z innego systemu, a następnie przesłać z powrotem.

 

Akcja ma 4 opcje łączenia JSON z różnymi rezultatami:

Dołącz WSZYSTKIE wartości – łączy tablice. Tworzy nowy JSON zawierający wszystkie elementy z obu plików w kolejności ich pojawienia się.

Dołącz wartości, pomijając zduplikowane – łącze tablice, pomijając istniejące elementy, aby uniknąć duplikatów.

Zamień wszystkie wartości – całkowicie zastępuje wszystkie elementy tablicy nowymi wartościami.

Zamień wartości z zachowaniem kolejności – łączy elementy tablicy na podstawie indeksu. Stosuje niestandardową logikę opartą na określonym kluczu lub właściwości.

Wersje systemu

Become a partner