REST Web API w Blue Prism
![rest api blue prism](https://robotyzuj.pl/wp-content/uploads/2020/01/rest-api-blue-prism.png)
Blue Prism posiada specjalne ustawienia ułatwiające prace z Web API. W tym wpisie dowiesz się jak przesłać parametry do service’u i obsłużyć jego odpowiedź.
Przed rozpoczęciem konfiguracji w Blue Prism stwórzmy testowy REST service. Przejdźmy w tym celu na stronę https://app.fakejson.com/
Tu możemy przetestować nasz web service. Wymaga on przesłania JSONa zawierającego token oraz danych, jakie chcemy pobrać. W naszym przypadku będzie to imię oraz email.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/fakejson.png)
Teraz możemy przejść do obsługi service’u w Blue Prism.
Konfiguracja Web API Services
W celu skonfigurowania połączenia przechodzimy do zakładki Settings/Objects/Web API Services i klikamy Add Service. Jako url do service’u podajemy adres https://app.fakejson.com/
![](https://robotyzuj.pl/wp-content/uploads/2020/01/webapi1-1024x546.png)
Zwykle service’y są zabezpieczone. Aby przesłać dane uwierzytelniające wchodzimy do Common Authentication i wybieramy typ nieuwierzytelnienia. Dane uwierzytelniające umieszczamy wcześniej z sekcji Settings/Security/Credentials. Nasz testowy service jest publicznie dostępny, więc możemy pominąć konfigurację uwierzytelniania.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-10.png)
Następnie definiujemy naszą akcję odpowiedzialną za pobranie danych. Moją akcję nazwałem “Query”.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-2.png)
Teraz możemy przejść do jej parametrów, gdzie utworzymy zmienną dla tokena.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-3.png)
Następnie przechodzimy do definicji naszego Requestu. Będzie ona niemal identyczna jak request, który widzimy w app.fakejson.com/. Jedyną różnicą będzie parametryzaja tokena. Dlatego jego nazwę podajemy w nawiasach kwadratowych. Właściwy url naszego service’u to https://app.fakejson.com/q, więc jak URL Path podajemy /q.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-7.png)
W opcjach Headers podajemy Content-Type = application/json
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-6.png)
Nasz obiekt jest juz gotowy do użycia w Procesie. Stwórzmy zatem nowy proces i przetestujmy zapytanie do webservice’u. W parametrze token podajemy wartość tokena ze strony app.fakejson.com. Jako parametr wyjściowy potrzebujemy Response Content.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-8.png)
Po wykonaniu worklfow dostajemy odpowiedź z weservice’u.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-9.png)
Odpowiedź można zamienić na kolekcję używając obiektu Utility – JSON lub skorzystać z możliwości konfiguracji naszego obiektu Web API i dodać parametry wyjściowe. W tym celu przechodzimy do zakładki Response.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-11.png)
Teraz nasze parametry wyjściowe będą widoczne w Procesie.
![](https://robotyzuj.pl/wp-content/uploads/2020/01/image-12.png)
To już wszystko co chciałem przekazać w tym wpisie. Mam nadzieję, że wpis okazał się pomocny. Temat Web API nie został tu oczywiście wyczerpany. Wadą pokazanego rozwiązania jest statyczny JSON wysyłany do API. Konfiguracja Web API w Blue Prism pozwala obsłużyć również dynamicznie budowane zapytanie, ale zostawię to na osobny wpis.