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 JavaScipt).

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

Edytor użyty w projekcie jest pełnoprawnym edytorem, co za tym idzie oferuje nam zestaw skrótów wspomagających pisanie. Lista najczęściej używanych skrótów klawiszowych:

• Ctrl + Shift + I - formatowanie kodu. Zawsze po napisaniu jakiegoś fragmentu warto go sformatować, zwiększa to czytelność oraz ułatwia pracę.

• Ctrl + Shift + O - skok do zmiennej/funkcji. Jest to wyszukiwanie na sterydach. W momencie, gdy skrypty urosną do rozmiarów, gdzie nie mieszczą się na jednej stronie, warto korzystać z takich skrótów, aby szybciej poruszać się po kodzie.

• Ctrl + Shift + K - usunięcie całej linii.

• Ctrl + F2 - wyszukanie i podmienienie konkretnego symbolu (nazwy funkcji, zmiennej).

• Ctrl + G - skok do linii.

• Ctrl + Shift + Alt + Strzałka w górę/dół - sklonowanie kursora na górze/dole.

• F1 - lista wszystkich dostępnych skrótów oraz opcji edytora.

Testy

Edytor posiada możliwość zdefiniowania scenariuszy testowych.

Błędy w trakcie uruchomienie 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