Instrukcja tworzenia źródeł danych w systemie - https://docs.plusworkflow.pl/confluence/pages/viewpage.action?pageId=13272439 |
Wtyczka zawiera implementację źródeł danych automatyzujących działania w przeglądarce internetowej.
Za pomocą opisywanych źródeł danych można automatyzować działania i przekazywać dane pomiędzy systemem PlusWorkflow oraz przeglądarką internetową.
Źródło opiera się o język skryptowy narzędzia Selenium IDE - side. Selenium IDE tutorial - https://www.youtube.com/watch?v=m4KpTvEz3vg Nagrane scenariusze w postaci plików .side można importować do źródła za pomocą przycisku Importuj .side w sekcji Opcje. Istnieje również możliwość wyeksportowania pliku .side z istniejącego źródła za pomocą przycisku Eksportuj .side w sekcji opcje |
Przeglądarka domyślnie uruchamiana jest w trybie headless. Aby otwierać przeglądarkę w trybie okienkowym należy dodać do argumentów sterownika wartość - headless=false |
Opis konfiguracji:
| Nazwa parametru | Opis parametru | Wymagalność |
|---|---|---|
| Początkowy URL | Adres URL, który zostanie otwarty w przeglądarce na początku wykonania skryptu | Wymagany |
| Domyślny timeout | Czas przez jaki sterownik będzie czekał na pojawienie się elementu na stronie. Po tym czasie wyrzucony zostanie błąd | Wymagany |
| Argumenty sterownika | Dodatkowe argumenty, które zostaną przekazane do sterownika przeglądarki. Lista dostępnych argumentów: https://peter.sh/experiments/chromium-command-line-switches/ | Opcjonalny |
| Dodaj ścieżkę wykonania do parametrów wyjściowych | Dodaje parametr wyjściowy zawierający ścieżkę na dysku serwera, w której zachowane są dane o wykonaniu źródła takie jak wynik wykonywania skryptu czy zapisane screeny | - |
| Pokaż komentarze | Odkrywa i ukrywa komentarze do poszczególnych komend | - |
| Command | Komenda Selenium IDE, która ma zostać wykonana przez sterownik przeglądarki Lista dostępnych komend: link | Wymagany |
| Target | Pierwszy argument komendy Selenium IDE | Wymagany |
| Value | Drugi argument komendy Selenium IDE | Wymagany |
| Komentarz | Pole niewymagane. Pozwala na opisanie danego kroku wykonywania | Wymagany |
| [Parametry wejściowe] Id | Id parametrów wejściowych | Wymagany |
| [Parametry wejściowe] Nazwa | Nazwa parametrów wejściowych | Wymagany |
| [Parametry wejściowe] Typ | Typ parametrów wejściowych | Wymagany |
| [Parametry wyjściowe] Id | Id parametrów wyjściowych | Wymagany |
| [Parametry wyjściowe] Nazwa | Nazwa parametrów wyjściowych | Wymagany |
| [Parametry wyjściowe] Typ | Typ parametrów wyjściowych | Wymagany |
Istnieje również możliwość użycia dodatkowej komendy capture entire page screenshot w celu uzyskania zrzutu całej wyrenderowanej strony w formacie obrazu PNG.
W polu target należy podać nazwę pliku, w którym zapisany zostanie zrzut. Plik ten znajdzie się w katalogu wykonania źródła, do którego ścieżkę możemy uzyskać zaznaczając w konfiguracji źródła "Dodaj ścieżkę wykonania do parametrów wyjściowych". |
Przykłady konfiguracji:
| Konfiguracja źródła | Wynik wywołania | Opis |
|---|---|---|
|  | Źródło odczytuje nazwy oraz opisy procesów znajdujących się liście zalogowanego użytkownika. Dodatkowo wypisuję ścieżkę wykonania źródła. |
