Table Excerpt | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Polish | ||||
---|---|---|---|---|
Wtyczka zawiera implementację źródeł danychoperujących na protokole SOAPautomatyzujących działania w przeglądarce internetowej.Za pomocą opisywanych źródeł danych można odczytywać automatyzować działania i przekazywać dane pomiędzy systemem PlusWorkflow a zewnętrznymi webservice'ami SOAP. Źródło umożliwia parsowanie plików WSDL. Zostało to opisane tutaj. Info | | |||
|
Info |
---|
Źródło opiera się o język skryptowy narzędzia Selenium IDE - side. Selenium IDE tutorial - https://www.tutorialspointyoutube.com/soap/index.htm |
Info | ||
---|---|---|
| ||
Przed przystąpieniem do konfiguracji źródła wymagana jest podstawowa znajomość Xpath. Możesz ją znaleźć np. tutaj - https://www.tutorialspoint.com/xpath/index.htm |
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 |
Info |
---|
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ść | ||
---|---|---|---|---|
Autoryzacja | Schemat autoryzacji żądania. Jeśli żądany endpoint nie wymaga autoryzacji pole należy zostawić puste. Opis definiowania szablonów autoryzacji znajduje się TUTAJ. | Opcjonalny | ||
Endpoint URL | Adres URL endpointu, do którego wysłane zostanie żądanie. | Wymagany | ||
Target namespace | Logiczna przestrzeń nazw dla informacji o usłudze. | Wymagany | ||
Request message | Zawartość wiadomości SOAP.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 parametru wejściowegoparametrów wejściowych | Wymagany | ||
[Parametry wejściowe] Nazwa | Nazwa | parametru wejściowegoparametrów wejściowych | Wymagany | |
[Parametry wejściowe] Typ | Typ parametrów wejściowych | Wymagany | ||
[Parametry wyjściowe] Id | Id | parametru wyjściowegoparametrów wyjściowych | Wymagany | |
[Parametry wyjściowe] Nazwa | Nazwa | parametru wyjściowegoparametrów wyjściowych | Wymagany | |
[Parametry wyjściowe] Typ | Typ | parametru wyjściowego [string;integer;foat;boolean;date;datetime]parametrów wyjściowych | Wymagany | |
[Parametry wyjściowe] Xpath | Xpath wskazujący na dane, które zostaną pobrane z odpowiedzi service'u SOAP. | Wymagany |
Info |
---|
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 wysyła zapytanie do systemu PlusWorkflow o istniejące domeny. |
Ź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. |
Warning | ||
---|---|---|
| ||
1. Używanie kolejnych poleceń w skrypcie w parametrze Commands po komendzie close, które powoduje zamknięcie sesji przeglądarki w ramach wykonywanej konfiguracji .side Selenium. Gdy sesja choć raz zostanie zamknięta, próba wykonania kolejnych poleceń zakończy się błędem. |
Mapowanie danych
Wartości parametrów wejściowych mogą zostać wstrzyknięte do skryptu za pomocą tagu: ${param_id}. Takim znacznikiem można posłużyć się również w kroku "execute script".
Przykład logowania do PWFL:
Do parametrów wyjściowych wypisać można wartości wszystkich zmiennych istniejących w kontekście wykonania skryptu. Zmienne te można utworzyć np. poprzez krok "store value" (opisany w dokumentacji Selenium IDE - zapisuje wartość elementów HTML typu input, textarea itp. do zmiennej) lub "execute script" gdzie należy zwrócić wartość do zmiennej:
Spowoduje to zapisanie tablicy wartości całkowitych do zmiennej o nazwie numbers. Taką zmienną istniejącą w skrypcie można zamapować na parametr wyjściowy źródła o takim samym ID jak nazwa zmiennej:
Dla parametrów wyjściowych należy podać ogólny typ zmiennej - tablice są wykrywane automatycznie.
Info |
---|
Wartości typu date oraz datetime należy zwrócić ze źródła w postaci stringów o formatach odpowiednio: yyyy-MM-dd oraz yyyy-MM-dd hh:mm:ss. Jeśli na stronie, z której pobieramy dane daty zapisane są w innym formacie można je sparsować w JS (krok "execute script") do typu Date() a następnie wypisać jako string przy pomocy: date - new Date().toISOString().substring(0,10) datetime - new Date().toISOString().split("T").join(" ").split(".")[0] |
Info |
---|
Wynik wykonania źródła domyślnie cache'owany jest przez 1 minutę. |
Funkcje
Wtyczka udostępnia dwie funkcje:
- RPA.getExecutionZipPath
- RPA.getScreensPath
Funkcje jako parametr przyjmują ścieżkę do rezultatu wykonania źródła, którą można uzyskać poprzez zaznaczenie parametru "Dodaj ścieżkę wykonania do parametrów wyjściowych" .
Funkcja RPA.getExecutionZipPath zwraca pełną ścieżkę do pliku .zip, zawierającego pełne informacje o wykonaniu skryptu oraz wszystkie wykonane zrzuty ekranu podczas wykonywania skryptu.
Funkcja RPA.getScreensPath zwraca pełną ścieżkę do pliku .pdf, zawierającego wszystkie wykonane zrzuty ekranu podczas wykonywania skryptu.
English |
---|
|
Hide If | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
|