W poprzednim odcinku opisałem co to jest Dispatch jak go zainstalować i zaktualizować. Zgodnie z planem dziś będziemy pisać pierwszy skrypt Dispatch. Jednak najpierw jako swoisty wstęp, przedstawię opis interfejsu.
Dodawanie nowych skryptów odbywa się przez „Zarządzanie działaniami”. Do tego okna można dostać się na kilka sposobów. Nie mnie jest decydować, który ze sposobów będzie najwygodniejszy w jakiej sytuacji więc przedstawię je po krótce poniżej:
Sposób 1
Otwieramy moduł administracyjny, rozwijamy gałązkę „Dodatki” i klikamy prawym przyciskiem myszy na Dispatch. Następnie wybieramy „Otwórz”.
Następnie po lewej stronie na dole klikamy „Zarządzanie działaniami”
Sposób 2
Otwieramy moduł administracyjny, rozwijamy gałązkę „Dodatki” i klikamy prawym przyciskiem myszy na Dispatch. Następnie wybieramy „Zarządzanie działaniami”
Sposób 3
Będąc w widoku lokalnym rozwijamy górne menu „Narzędzia” i klikamy w „Zarządzanie działaniami”.
Niezależnie, który sposób wybraliśmy pokaże się okienko zadań Dispatch
1. Lista działań Dispatch, tu będą wylistowane wszystkie nasze skrypty,
2. Przycisk „Dodaj” pozwala dodać nowy skrypt,
3. Przycisk „Edycja” pozwala zmieniać już istniejący skrypt,
4. Przycisk „Usuń” pozwoli nam wykasować skrypt z listy,
5. Przycisk „Załaduj” pozwala wczytać skrypt zapisany na dysku,
6. Przycisk „Zapisz” pozwala na zapisanie pliku na dysku. Należy pamiętać, że skrypty Dispatch nie są kopiowane razem z ustawieniami przechowalni ani z eksportem z modułu administracji a są przechowywane w bazie danych. Ich kopia zapasowa robi się więc razem z kopią bazy ale żeby mieć je pod ręką warto raz na jakiś czas zapisać je na dysk. Możemy zapisywać pojedyncze skrypty osobno lub też zapisać je wszystkie do jednego, wspólnego pliku. Plik z zapisanymi skryptami Dispatch ma rozszerzenie ACN – prawdopodobnie od angielskiego słowa action.
7. Przycisk „Kopiuj” pozwala na utworzenie kopii w pamięci,
8. Przycisk „Wklej” pozwala na wklejenie na listę skryptu z pamięci. Warto zauważyć, że można kopiować skrypty pomiędzy przechowalniami a nawet serwerami. Pozwala to np. na pisanie i testowanie skryptów na lokalnym komputerze a później na łatwe przeniesienie na środowisko produkcyjne.
9. Przycisk OK zamyka okienko zadań Dispatch z zapisaniem listy działań do bazy danych,
10. Przycisk Anuluj zamyka okienko nie zapisując listy działań do bazy danych,
11. Przycisk pomocy – przenosi nas do pliku lb strony internetowej pomocy
Po kliknięciu „Dodaj” pokaże się okienko edycji poleceń:
1. Nazwa skryptu. Będzie wyświetlany na liście skryptów w głównym okienku zadań,
2. Opis skryptu. Będzie wyświetlany na liście skryptów w głównym okienku zadań,
3. Polecenie menu. Najczęściej skrypty uruchamiamy z menu kontekstowego w widoku lokalnym EPDM. Ponieważ zazwyczaj z czasem przybywa ich aby nie zaczerniać całego menu możemy je grupować w podmenu. Służy do tego znak backslash „\”. Możemy również tworzyć bardziej zagłębione struktury podmenu. Skrypt z załączonego obrazka będzie mógł być uruchomiony z menu kontekstowego z podmenu „Akademia Dispatch”:
4. Polecenie menu. Gdy pole zaznaczenia (Checkbox) jest zaznaczone dane polecenie będzie widoczne w menu kontekstowym,
5. W trakcie przejścia stanu. Możemy uruchamiać nasz skrypt automatycznie podczas przejścia ze stanu do stanu WorkFlow*,
6. W trakcie wyewidencjonowania. Możemy uruchamiać nasz skrypt automatycznie podczas operacji ewidencjonowania pliku*
7. W trakcie dodawania. Możemy uruchamiać nasz skrypt automatycznie podczas dodawania pliku do systemu EPDM*
8. Wcięło
9. Okno poleceń. Tu będzie podgląd wszystkich poleceń dodanych do skryptu,
10. Przycisk „Dodaj” pozwala na dodanie kolejnego polecenia do skryptu,
11. Przycisk „Usuń” pozwala na usuwanie poleceń ze skryptu. Można usuwać polecenia hurtowo, zaznaczając kilka trzymając przycisk CTRL (Control) lub przycisk SHIFT,
12. Przycisk „Edycja” pozwala na edytowanie wybranego polecenia,
13. Przycisk „Przenieś do góry” pozwala na przesunięcie wybranego polecenia o jedną linię do góry. Polecenia wykonywane są w kolejności i dlatego ważne jest, w której linii znajduje się jakie polecenie,
14. Przycisk „Przenieś w dół” to samo co pkt. 13 tyle, że na odwrót,
15. Przycisk „Zmienne” wywołuje okienko dialogowe konfiguracji zmiennych. Szczegóły poniżej,
16. Przycisk „OK” zamyka okienko edycji skryptu i zapisuje stan do bazy danych,
17. Przycisk „Anuluj” zamyka okienko edycji skryptu ale nie zapisuje stanu do bazy danych,
18. Przycisk „Pomoc” przekierowuje nas do pliku lub strony internetowej pomocy.
1. Lista zmiennych. Tu możemy podglądać nazwę zmiennej, typ oraz jej wartość,
2. Przycisk „Dodaj” pozwala dodać nową zmienną,
3. Przycisk „Usuń” pozwala usunąć zmienną,
4. W tym polu wpisujemy nazwę zmiennej,
5. Z tej listy wybieramy typ zmiennej.,
6. W to pole wpisujemy wartość zmiennej,
7. Przycisk ten pozwala powiązać wartość zmiennej z wartością innej zmiennej, zmiennymi systemowymi, operacjami na ciągach znaków, operacjami arytmetycznymi, właściwościami pliku,
8. Przycisk „OK” zamyka okienko zmiennych i zapisuje stan do bazy danych,
9. Przycisk „Anuluj” zamyka okienko i nie zapisuje stanu do bazy danych,
10. Przycisk przywołania pomocy.
Po tym nieco przydługim wstępie przechodzimy do pisania naszego pierwszego skryptu.
Założenia:
Skrypt ma wyświetlić komunikat, w którym pokaże napis „Hello CNS” oraz ścieżkę wybranego pliku wraz z jego nazwą. Skrypt ma być uruchamiany z menu kontekstowego.
Ponieważ obraz mówi tysiącem słów poniżej krótki filmik, który pokazuje jak dodać i skonfigurować nasz pierwszy skrypt:
Plik skryptu do pobrania:
Podsumowanie:
W dzisiejszym odcinku poznaliśmy podstawowe okienka dodatku Dispatch oraz napisaliśmy pierwszy skrypt. W kolejnym odcinku Akademii Dispatch napiszemy skrypt, który będzie uzupełniał kartę danych pliku o wartość ze słownika. Dodatkowo skrypt będzie możliwy do uruchomienia tylko dla wybranych użytkowników.
