Edytor skryptów

Widok skryptu

W głównym widoku skryptu widoczna jest wybrana wersja skryptu. W panelu bocznym znajdują się przyciski umożliwiające wysunięcie panelu parametrów skryptu, testów jednostkowych oraz logów.

Przycisk uruchomienia skryptu znajduje się w zakładce Parametry.

Ilustracja 1. Widok skryptu z wysuniętym panelem "Parametry"

Edycja skryptu

Praca nad skryptem możliwa jest dzięki edytorowi Monaco (edytor wspiera język JavaScript).

Początkowo działa on w trybie read-only. Aby rozpocząć pracę należy kliknąć przycisk Edytuj skrypt znajdujący się na końcu paska nawigacyjnego.

Ilustracja 2. Karta skryptu

Instrukcja "jak pisać skrypt serwisy" znajduje się w Skrypty (scriptService) oraz Dobre praktyki ScriptCode.

Zmienne w ScriptCode w zakresie bloku

Platforma Eximee wymaga, aby zmienne w ScriptCode były zadeklarowane w zakresie bloku.

Brak deklaracji zmiennej spowoduje błąd skryptu.

Parametry

Modyfikacja parametrów również odbywa się w Monaco (edytor wspiera notacje JSON).

Przy pierwszym wejściu na niepusty skrypt parametry zostaną automatycznie wydedukowane (jeżeli jest to możliwe) z samej zawartości skryptu.

Pod edytorem znajduje się przycisk pozwalający na uruchomienie skryptu z parametrami podanymi w sekcji Dane testowe.

Ilustracja 3. Karta parametrów

Parametry uzupełnione w sekcji Dane testowe nie są częścią samego skryptu i nie zapiszą się w danej jego wersji!

Edycja wejść/wyjść

W tym miejscu możemy dodać lub usunąć wejścia/wyjścia skrypt serwisu.

Dodanie lub usunięcie wejścia spowoduje również aktualizację parametrów uruchomieniowych, więc po usunięciu parametru stracimy jego ewentualne mapowanie w miejscu podpięcia.

Ilustracja 4. Pola edycji wejść/wyjść

Wynik skryptu

W dolnej części ekranu pojawia się dodatkowe okno. Znajdziemy tam wszelkie informacje na temat uruchomionego skryptu:

1. Czas działania skryptu podany w ms.
2. Logi z wykonania skryptu w postaci:

   [CZAS_OPERACJI] [TYP_OPERACJI]: Tekst operacji

   Dla przykładu:

   [14:31:22,976] [GET_DATA]: Called getData("GesCustomComponent1","data") and resulted with data z cc

3. Wynik wołania skryptu (w panelu logów), czyli wszystkie wartości zdefiniowane jako wyjściowe (output) podczas tworzenia skrypt serwisu w postaci KLUCZ : WARTOŚĆ.

   

   Ilustracja 5. Karta wyniku skryptu

Edytor Monaco (skróty klawiszowe)

Edytor użyty w projekcie jest pełnoprawnym edytorem kodu, dzięki czemu oferuje wiele skrótów klawiszowych przyspieszających codzienną pracę.

Nawigacja i wyszukiwanie

Skrót	Opis
F1	Wyświetlenie listy wszystkich dostępnych poleceń i skrótów edytora.
Ctrl + F	Wyszukiwanie tekstu w aktualnym pliku.
Ctrl + H	Wyszukiwanie i podmiana tekstu.
Ctrl + Shift + O	Skok do zmiennej lub funkcji.
Ctrl + G	Skok do wskazanej linii.

Edycja kodu

Skrót	Opis
Ctrl + Z	Cofnięcie ostatniej zmiany.
Ctrl + Y	Ponowienie cofniętej zmiany.
Ctrl + C	Kopiowanie zaznaczonego tekstu.
Ctrl + V	Wklejenie skopiowanego tekstu.
Ctrl + X	Wycięcie zaznaczonego tekstu lub bieżącej linii.
Ctrl + Shift + I	Formatowanie kodu. Warto korzystać z tej opcji po większych zmianach w skrypcie.
Ctrl + Shift + K	Usunięcie bieżącej linii.
Alt + ↑	Przeniesienie aktualnej linii o jeden wiersz w górę.
Alt + ↓	Przeniesienie aktualnej linii o jeden wiersz w dół.

Wielokrotne kursory i jednoczesna edycja

Edytor Monaco umożliwia jednoczesną edycję wielu miejsc w kodzie. Funkcja jest szczególnie przydatna podczas modyfikacji nazw zmiennych, parametrów lub powtarzających się fragmentów skryptu.

Skrót	Opis
Alt + kliknięcie myszy	Dodanie dodatkowego kursora w wybranym miejscu.
Ctrl + D	Zaznaczenie kolejnego wystąpienia aktualnie zaznaczonego tekstu i dodanie kursora.
Ctrl + Shift + L	Zaznaczenie wszystkich wystąpień aktualnie zaznaczonego tekstu i dodanie kursorów we wszystkich miejscach wystąpienia.
Ctrl + F2	Dodanie kursora we wszystkich miejscach wystąpienia aktualnego wyrazu lub zaznaczenia.
Ctrl + Shift + Alt + ↑ / ↓	Dodanie kursora w linii powyżej lub poniżej aktualnej pozycji kursora.

Dodatkowe funkcje

Skrót	Opis
Ctrl + P	Eksport dokumentu skryptu do pliku PDF.

Film 1. Przykładowe użycie skrótu klawiszowego Ctrl + Shift + L w celu jednoczesnej zmiany nazwy wszystkich wystąpień zmiennej

Testy

Edytor posiada możliwość zdefiniowania scenariuszy testowych.

Błędy w trakcie uruchomienia testowego

Jeśli skrypt zawiera błędy, w trakcie uruchomienia testowego błąd taki zostanie odlogowany w konsoli pod edytorem. W komunikacie zawarty będzie powód i miejsce w kodzie wystąpienia błędu.

Ilustracja 6. Błąd wywołania testowego