Make: Własna aplikacja

0:00Cześć! W tej lekcji przeprowadzę Cię przez proces

0:02projektowania własnego modułu w Integromacie czy też własnej aplikacji, która będzie

0:06wykorzystywać przygotowane przez nas scenariusze.

0:09Tak jak powiedziałem, tego typu

0:10wykorzystanie własnych modułów w Integromacie pozwoli Ci na lepsze organizowanie

0:14automatyzacji poprzez wykorzystanie takich pojedynczych scenariuszy, które będą

0:18odpowiedzialne za realizowanie konkretnych akcji.

0:21Czyli zamiast na przestrzeni scenariuszy

0:23powtarzać wykonanie zestawu akcji, które mamy tutaj zdefiniowane.

0:27Będziemy mogli odwołać się do modułu i przekazać do niego odpowiednie parametry.

0:32W rezultacie otrzymamy z niego odpowiedź,

0:34która będzie tak naprawdę odpowiedzią zwróconą przez ten scenariusz.

0:38Zatem w przypadku takich scenariuszy

0:39musimy tak naprawdę zadbać wyłącznie o to, aby rozpoczynały się od webhook'a i

0:43tym samym mogły przyjmować określone przez nas dane.

0:46A następnie taki scenariusz musi kończyć

0:48się webhook'iem, a konkretnie odpowiedzią, która zostanie wysłana w formacie JSON.

0:53Coś takiego robiliśmy już wielokrotnie,

0:55więc jak zapewne pamiętasz, musimy tutaj ustawić odpowiednie nagłówki

0:58sygnalizujące, że będziemy odpowiadać tutaj obiektem JSON, a następnie

1:02musimy przekazać sam obiekt JSON, który w tym przypadku będzie zawierał

1:06adres URL do screenshot'a wygenerowanego przez EasyBanner.

1:10Jeżeli teraz uruchomię sobie ten moduł, za chwilę uzyskam dostęp do tej właściwości i

1:14rzeczywiście będę mógł ją przekazać do naszego obiektu.

1:17Jeżeli teraz skopiuję sobie adres naszego webhook'a, a następnie uruchomię

1:21scenariusz i wywołam go z poziomu Isomni, no to jak się pewnie domyślasz nasz scenariusz

1:26wykona się, a my w odpowiedzi otrzymamy link kierujący nas do obrazka

1:31zawierającego zrzut ekranu strony zautomatyzowani.

1:34Oczywiście nam będzie zależało na tym, aby móc na ten webhook przekazać dodatkowy obiekt JSON,

1:40który będzie zawierał adres strony, której screenshot chcemy wykonać.

1:44Zatem jeżeli raz jeszcze wykonam ten webhook,

1:46a następnie wrócę do naszego scenariusza, no to jak się pewnie domyślasz

1:50otrzymamy tutaj adres URL, który będziemy mogli przekazać do EasyBanner.

1:55A w rezultacie otrzymamy tutaj zrzut ekranu tej konkretnej strony.

1:59Także doszliśmy tutaj do miejsca, w którym nasz scenariusz przyjmuje dynamiczne dane,

2:03robi coś z nimi, a następnie odsyła nam rezultat.

2:07I dokładnie w ten sam sposób musi zachowywać się każdy scenariusz, który

2:10projektujesz na potrzeby wykorzystania we własnej aplikacji Integromat'u.

2:15Teraz będziemy mogli zaprojektować tą

2:16aplikację i zrobić to w taki sposób, aby wymagała od nas podania adresu URL oraz w

2:22odpowiedzi zwracała adres do zrzutu ekranu.

2:25No to, aby stworzyć aplikację pamiętaj o

2:27przejściu do zakładki My Apps, a następnie wybraniu opcji Create a new App.

2:32Tutaj musimy podać jej nazwę i załóżmy, że będzie to Screenshot Artist.

2:36Jeżeli chodzi o jej etykietę, będziemy

2:38mogli tutaj dodać spację i jeżeli chodzi o opis zostawimy go pusty.

2:42Następnie możemy tutaj podać kolor, który

2:44będzie wykorzystywany m.in. na liście modułów, a następnie możemy ustawić

2:48język oraz kraje, w których ta aplikacja miałaby być dostępna.

2:52W naszym przypadku jednak nie ma to

2:54żadnego znaczenia, ponieważ aplikacja będzie przeznaczona tylko dla nas.

2:57Dalszym krokiem będzie wgranie tutaj

2:59logotypów i logotyp możemy sobie przygotować np.

3:02w Figmie ustawiając rozmiar obrazka na 512/512

3:05a następnie możemy tutaj podać screenshot Artist.

3:10W tym momencie możemy wyeksportować ten plik i wgrać go do Integromat'u.

3:14Tutaj tylko dodam, że możesz przygotować dwie wersje logotypu i ta pierwsza różni

3:18się od drugiej tym, że w jej przypadku jakiekolwiek kolory, które się na niej

3:22znajdują zostaną zamienione na kolor biały.

3:25Natomiast poniżej możemy umieścić kolorowe logo, w przypadku którego takich

3:29ograniczeń już nie ma. W naszym przypadku w związku z tym, że eksportowałem grafikę,

3:33która nie posiada tła, nawet po przekonwertowaniu kolorów, wszystko będzie w porządku.

3:38Tutaj jeszcze przy próbie zapisania tego

3:40modułu zauważyłem, że tak naprawdę musimy tutaj wykorzystać małe litery.

3:44Po poprawieniu tej nazwy możemy zapisać

3:46nasz moduł i już po chwili będzie dostępny tutaj na naszej liście. Tutaj

3:50jeżeli chodzi o podstawowe ustawienia

3:52naszego modułu to będzie adres naszego webhook'a.

3:55Następnie nasze zadanie będzie polegało na tym, aby utworzyć nowy moduł, który w tym

4:00przypadku będzie akcją typu create, ponieważ tak naprawdę tutaj tworzymy coś

4:04nowego i w tym przypadku jest to zrzut ekranu.

4:07Następnie musimy podać etykietę oraz opis

4:10i na tym etapie nasz moduł jest utworzony.

4:12I mało tego, jeżeli teraz przejdziemy do

4:14tworzenia nowego scenariusza, to na liście modułów jest on już tutaj dostępny, a

4:18wewnątrz jego oczywiście dostępna jest nasza akcja.

4:21No i tutaj widzimy, że ta akcja wymaga od

4:23nas podania jakiś parametrów, natomiast tak naprawdę ich nie potrzebujemy, a one

4:27same pojawiły się tutaj dlatego, że domyślnie Inegromat dodaje takie dwa pola.

4:31Nam jednak one nie będą potrzebne, ponieważ tak naprawdę będzie nas

4:35interesował parametr URL, który chcemy przekazać na nasz webhook.

4:38I tutaj po wprowadzeniu zmian pamiętaj proszę, aby wcisnąć tą dyskietkę, aby

4:42zapisać zmiany i w momencie gdy wszystko się tutaj zgadza zmiany zostaną zatwierdzone.

4:47Jeżeli teraz odświeżamy sobie nasz scenariusz,

4:49to zobaczymy, że wewnątrz naszej akcji zniknęły te dwa pola, które mieliśmy

4:53wcześniej i faktycznie pojawił się tutaj adres URL.

4:56Jeżeli teraz uzupełnimy to pole, a następnie spróbujemy wykonać

5:00ten moduł, to oczywiście otrzymamy błąd

5:02informujący nas o tym, że podana strona nie istnieje.

5:05Wynika to z faktu, że oczywiście w tym miejscu mamy tutaj błędny adres URL.

5:10W naszym przypadku umieszczamy tutaj slash.

5:12Ze względu na to, że w podstawowych

5:13ustawieniach tego modułu podaliśmy tutaj adres naszego webhook'a.

5:17Jeżeli teraz zadbamy tylko o to, aby jako

5:20payload naszego zapytania przekazać parametr URL i możemy się do niego odwołać

5:25jak widzisz wykorzystując obiekt zawierający informacje o parametrach, informacja na

5:29temat adresu e-mail nie jest nam już tutaj potrzebna.

5:32I oczywiście jeszcze tutaj upewniamy się, że mamy zapytanie typu POST.

5:36Jeżeli teraz zapiszę zmiany, a następnie

5:38odświeżę nasz scenariusz, to tym razem jego wykonanie powinno się powieść.

5:43Tak się jednak nie stało ze względu na to,

5:45że nasz poprzedni scenariusz zwrócił wartość tekstową zamiast obiektu.

5:49To jest oczywiście prawdą ze względu na to, że w ogóle go nie aktywowaliśmy.

5:52Jeżeli to teraz zrobię, a następnie wrócę do mojego scenariusza i ponownie wykonam

5:57ten moduł, to tym razem już wszystko pójdzie w porządku.

6:00Okazuje się, że już po chwili rzeczywiście otrzymaliśmy tutaj odpowiedź w postaci

6:05adresu URL zawierający zrzuty ekranu strony zautomatyzowani.pl.

6:09Oznacza to mniej więcej tyle, że jesteśmy

6:11w stanie już wykorzystywać ten moduł, kiedy tylko potrzebujemy.

6:14Oczywiście też nic nie stoi na

6:16przeszkodzie, aby dodać do niego kolejne parametry w postaci np.

6:19wartości liczbowej zawierającej informacje

6:23na temat szerokości wykonanego zrzutu ekranu oraz jego wysokości.

6:27Dodatkowo chcemy ułatwić sobie tutaj

6:29pracę, więc ustawiamy szerokość na 1920 oraz domyślną wysokość na 1080.

6:36I teraz po zapisaniu zmian i swoją drogą

6:38nie musiałem wciskać dyskietki tylko wybrałem skrót klawiszowy Command S.

6:42Do tego aby zapisać zmiany, to tak naprawdę

6:44nasze nowe parametry będą już widoczne w naszym module.

6:47Różnica jednak będzie polegała na tym, że jeżeli uruchomimy sobie rozszerzenie Inegromat'u

6:52to zobaczymy, że w momencie wykonywania tego modułu tak naprawdę przekazujemy

6:57tutaj wyłącznie informacje na temat adresu URL.

7:00Dzieje się tak dlatego, że nie zdefiniowaliśmy w zakładce komunikacji

7:04dodatkowych parametrów dotyczących szerokości oraz oczywiście wysokości.

7:08I teraz po aktualizacji naszego modułu

7:10możemy wykonać go raz jeszcze i tym razem zobaczymy, że faktycznie nasz

7:14payload zawiera nie tylko adres URL, ale

7:17również przekazane wartości dotyczące wysokości oraz szerokości zrzutu ekranu.

7:21No i teraz tak naprawdę nasz moduł jest tutaj już w pełni gotowy.

7:25Natomiast teraz warto zadać sobie pytanie

7:27co się stanie w sytuacji, gdy podamy tutaj błędny adres URL.

7:30W takiej sytuacji EasyBanner zwraca błąd

7:33informujący nas o tym, że podany adres URL nie jest poprawny.

7:36Jednak w tej sytuacji otrzymaliśmy tutaj po prostu błąd 500 i żadnej dodatkowej

7:41informacji na temat tego, z jakim błędem mamy do czynienia.

7:44Problem, jaki tutaj mamy leży w

7:45scenariuszu, który wykorzystywany jest przez nasz moduł.

7:49Mianowicie musimy tutaj dodać error handler

7:51którego zadaniem będzie zwrócenie odpowiedniego statusu odpowiedzi.

7:55Mianowicie tutaj ponownie wykorzystujemy opcję webhook response.

7:59Z tą różnicą, że tutaj będziemy definiować

8:01jakiego rodzaju błąd zostanie zwrócony do naszego modułu.

8:05Teraz tylko testowo uruchomię nasz scenariusz, a następnie wykonam nasz

8:08moduł, aby uruchomić ten błąd i zobaczymy, że faktycznie mamy tutaj do czynienia z

8:13błędem, który zawiera tutaj konkretną informację.

8:16Jeżeli teraz przekażemy sobie odpowiedni kod statusu i w tym przypadku będzie to

8:20status bad request, czyli błędne zapytania, będziemy w stanie dodatkowo

8:25zwrócić tutaj obiekt JSON zawierający właściwość error, którego

8:29wartość zostanie ustawiona na wiadomość zawierającą informację o błędzie.

8:33No i tutaj jeszcze musimy oczywiście ustawić odpowiedni nagłówek content type

8:38wskazujący na to, że wysyłamy obiekt JSON.

8:41I teraz, po zapisaniu tych zmian oraz zapisaniu scenariusza oraz wykonaniu raz

8:45jeszcze naszego modułu otrzymamy tutaj informacja o błędzie 400.

8:49Natomiast nie posiadamy tutaj żadnej szczegółowe informacje na temat błędu.

8:53Wynika to z faktu, że do głównych ustawień

8:55naszego modułu możemy w zakładce Base dodać strukturę obiektu odpowiedzi.

9:00W naszym przypadku ta odpowiedź będzie zawierała dwie właściwości.

9:03Pierwszą z nich będzie output

9:05ustawiona na zmienną body, zamkniętą oczywiście w cudzysłowie, a następnie

9:10będziemy mieć tutaj właściwość error, która będzie ustawiona na obiekt

9:13zawierający właściwość message ustawioną na body.error.

9:18Ustawiając to w ten sposób, jeżeli teraz

9:20wykonamy ponownie nasz moduł, przy czym pamiętamy o odświeżeniu naszego

9:24scenariusza, to okaże się, że otrzymaliśmy jasną informację na temat tego, jaki błąd

9:29tutaj wystąpił i w tym przypadku jest to niewłaściwy adres URL.

9:33oczywiście przypominam o tym, że tutaj również możemy dodać error handler i w

9:37jakiś sposób zareagować na to, co ma się wydarzyć z naszym scenariuszem.

9:41Na koniec dnia jednak doszliśmy do

9:43sytuacji, w której nasz moduł działa i posiadamy tutaj odpowiednie właściwości,

9:47które możemy wykorzystać i jednocześnie zyskaliśmy ogromną elastyczność w

9:51kontekście organizacji naszych scenariuszy.

9:54Przypominam, że jeżeli jesteś programistą

9:56lub przynajmniej dobrze orientujesz się w temacie pracy z API.

9:59To nic nie stoi na przeszkodzie, aby tworzyć

10:01właśnie takie moduły w Integromacie, które opierają się o istniejące API.

10:06Oczywiście w tym wszystkim, bez względu na

10:08to, czy programujesz czy też nie, zachęcam Cię do tego, aby zapoznać się z

10:11dokumentacją Integromat'u dotyczącą tworzenia własnych aplikacji.

10:15Przykładowo to co może Cię zainteresować to możliwość dodawania listy parametrów.

10:20Tak jak widzisz, możemy tutaj skonfigurować nasz moduł tak, żeby zamiast

10:24pytać nas o konkretne wartości umożliwiał nam wybieranie ich z listy.

10:28Wystarczy tutaj ustawić właściwość type na select, a następnie podać właściwość

10:33option wskazującą na albo tablicę, albo tak zwany parametr RPC.

10:38Jeżeli chodzi o RPC to również mamy tutaj

10:41informację pochodzącą z dokumentacji o tym, w jaki sposób możemy je tworzyć.

10:46Konkretnie wystarczy, że przejdziemy do głównych ustawień naszej aplikacji, a

10:49następnie w zakładce zdalnych procedur utworzymy nową.

10:53Której wystarczy nadać nazwę etykiety oraz ewentualnie połączenie, natomiast tutaj

10:57musimy podać adres URL, z którego będziemy pobierać dane oraz upewnić się, że

11:02struktura odpowiedzi jest dokładnie taka jak zwracamy z naszego modułu, czyli w tym

11:06przypadku nasz obiekt odpowiedzi musi zawierać właściwość users, natomiast

11:10pojedynczy obiekt użytkownika powinien zawierać właściwość name oraz id.

11:15Ale oczywiście to wszystko możemy dostosować do naszych potrzeb.

11:18Ostatecznie sam wykorzystałem takie zdalne procedury do tego, aby pobierać informacje

11:23na temat użytkowników bezpośrednio z mojej aplikacji.

11:26No i teraz, aby skorzystać z takiej

11:28procedury wystarczy wykorzystać jej nazwę i zapisać ją w następujący sposób.

11:33Tutaj tylko chciałbym podkreślić, że wykorzystanie takich procedur jest

11:36raczej tematem zaawansowanym, ale tylko sygnalizuję Ci ich obecność.

11:40Najczęściej przy konfiguracji własnych modułów będziesz przechodzić przez

11:43konfigurację, którą pokazałem Ci do tej pory.

11:46W tym momencie więc chyba nie pozostaje mi nic innego jak zachęcić Cię do tego, aby

11:50skonfigurować własny moduł w Integromacie oraz zaprosić do pozostałych materiałów.