Tworzenie i przechowywanie skryptów

Skrypty Altium Designer są zwykle tworzone i przechowywane w projekcie skryptów (*.PrjScr), ale mogą być dodawane lub przechowywane w dowolnym typie projektu.

Aby rozpocząć pisanie skryptów, zacznij od utworzenia nowego projektu skryptów i dodania do niego plików skryptów.

Tworzenie projektów skryptów i skryptów

Projekt skryptów pomaga zarządzać skryptami i można go utworzyć, wybierając File » New » Script » Script Project z menu głównego.

Nowy projekt (Script_Project1.PrjScr) do przechowywania skryptów zostanie wyświetlony w panelu Projects.

Aby dodać nowy skrypt do projektu, kliknij prawym przyciskiem myszy nazwę projektu i wybierz Add New to Project z menu kontekstowego.

Po utworzeniu nowego projektu skryptów dodaj do niego nowy skrypt.

Podczas tworzenia nowego skryptu dostępne są dwa typy skryptów do wyboru, w zależności od wymagań projektu – Script Units oraz Script Forms.

Typy skryptów

Script Units

Script Unit to dokument skryptu o określonej składni języka, na przykład DelphiScript.

Script Unit z kodem skryptu.

Script Forms

Script Form to okno, które może zawierać różne kontrolki, takie jak przyciski, pola memo i listy, które mogą mieć procedury obsługi zdarzeń. W edytorze Script Form ma dwa widoki, wybierane za pomocą kart Code i Form, co widać na dole dokumentu skryptu pokazanego poniżej.

Script Form z otwartymi kartami Code i Form.

Zależności skryptów w projekcie

Gdy w projekcie znajduje się wiele skryptów, każdy skrypt (używający tego samego zestawu językowego) w tym projekcie ma dostęp do zmiennych globalnych i procedur. W praktyce wszystkie skrypty w projekcie są „widoczne”, więc procedura w jednym skrypcie może wywołać inną procedurę w innym skrypcie w ramach tego samego projektu skryptów.

Ważne jest, aby procedury i zmienne globalne w skryptach w tym samym projekcie miały unikatowe nazwy. Jednym z podejść jest przeniesienie wszystkich wspólnych procedur/funkcji używanych w różnych skryptach do jednego nowego skryptu w tym samym projekcie. Umożliwia to łatwe ponowne wykorzystanie procedur i funkcji z tego nowego wspólnego skryptu w różnych projektach skryptów.

► Zobacz Writing Scripts, aby poznać przykład wywołania procedury z innego skryptu.

Przesyłanie projektu skryptów do połączonego Workspace

Altium Designer, w połączeniu z Twoim połączonym Workspace, umożliwia tworzenie i zarządzanie skryptami w Workspace. Takie skrypty są tworzone bezpośrednio w Workspace, a odpowiedni projekt skryptów (*.PrjScr) jest przesyłany do rewizji docelowego Workspace Scripts. Proces wygląda następująco:

1. Utwórz nowy Script Item w połączonym Workspace, używając panelu Explorer. Zobacz stronę Creating & Editing Content, aby dowiedzieć się więcej o tworzeniu Itemów w Workspace.

2. Kliknij prawym przyciskiem myszy wymagany Script Item w panelu Explorer i wybierz polecenie Upload z menu kontekstowego. Pojawi się standardowe okno dialogowe systemu Windows Open, w którym można wskazać wymagany plik projektu skryptów (*.PrjScr).

   Jeśli Item nie ma zaplanowanej rewizji, przesłanie nastąpi do następnej zaplanowanej rewizji, utworzonej „w locie” w ramach procesu przesyłania.

   
   Wskazywanie pliku projektu skryptów do przesłania do docelowego Script Item.

3. Po wybraniu żądanego pliku kontynuuj przesyłanie, klikając przycisk Open. Plik projektu wraz ze wszystkimi plikami w tym samym folderze zostaną przesłane do rewizji i będą dostępne na karcie widoku aspektu Details dla tej rewizji w panelu Explorer.

   
   Przesłany projekt wraz ze wszystkimi plikami w tym samym folderze jest wyświetlany na karcie widoku aspektu Details dla rewizji Script Item.

Alternatywnie projekt skryptów można przesłać do nowego Workspace Script, przeciągając wybrany plik projektu skryptów i powiązane pliki źródłowe z folderu źródłowego w Eksploratorze Windows i upuszczając je do wymaganego folderu w panelu Explorer. Pojawi się okno dialogowe Create New Item, a przeciągnięte pliki zostaną wyświetlone w obszarze Sources. Name Itemu będzie stanowić nazwy plików wraz z rozszerzeniami (wpisy będą rozdzielone średnikiem). Description będzie w formacie Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (wpisy będą rozdzielone średnikiem). Zmień je w razie potrzeby. Item ID będzie zgodne ze schematem nazewnictwa Itemów zdefiniowanym na poziomie folderu. Jeśli folder nie ma zdefiniowanego schematu nazewnictwa, nazewnictwo będzie zgodne ze schematem $CONTENT_TYPE_CODE-{000000}.

Przesyłanie projektu skryptów i powiązanych plików do początkowej rewizji nowo utworzonego Workspace Script metodą przeciągnij i upuść.

Edycja Workspace Script

Na dowolnym etapie możesz wrócić do dowolnej rewizji Workspace Script i edytować ją bezpośrednio. Kliknij prawym przyciskiem myszy rewizję w panelu Explorer i wybierz polecenie Edit z menu kontekstowego. Spowoduje to otwarcie tej rewizji w Altium Designer, gdzie można ją edytować zgodnie z potrzebami, a następnie zapisać z powrotem do Workspace jako następną rewizję, używając polecenia Save to server (skrót: Ctrl+Alt+S) – dostępnego z menu kontekstowego po kliknięciu prawym przyciskiem myszy wpisu projektu w panelu Projects.

Dostęp do polecenia uruchamiającego bezpośrednią edycję istniejącej rewizji skryptu.

Jeśli musisz zmienić projekt lub powiązane źródła przechowywane w Workspace Script i masz zaktualizowane pliki źródłowe, możesz przesłać te pliki do tego Workspace Script – nowe pliki zostaną zapisane w następnej rewizji tego Workspace Script.

Global Projects

Projekty skryptów można instalować za pomocą funkcji Global Projects, aby były wstępnie ładowane i dostępne przy uruchamianiu oprogramowania. Zmienne globalne i procedury z tych skryptów są dostępne do użycia w innych otwartych projektach skryptów.

Aby uczynić projekt skryptów globalnym, przejdź do strony Scripting System - Global Projects poprzez okno dialogowe Preferences. Użyj przycisku Install , aby przejść do projektu i wybrać go z pliku lub z Workspace. Powtórz ten proces dla wszystkich projektów skryptów, które chcesz udostępnić globalnie.

Zainstalowany projekt Workspace Script będzie dostępny w Altium Designer zawsze, gdy użytkownik jest połączony z Workspace. Zwróć uwagę, że zainstalowany projekt Workspace Script jest wyświetlany według swojej lokalizacji lub „ścieżki” w strukturze folderów Workspace oraz identyfikatora Workspace Script zawierającego dane projektu skryptów.

Użyj Scripting System – Global Projects z okna dialogowego Preferences, aby zainstalować skrypty.

Global Projects umożliwiają skryptom z lokalnego projektu tego samego typu korzystanie z procedur z zainstalowanych globalnych projektów skryptów. Gdy zostanie uruchomione okno dialogowe Select item to Run (File » Run Script), zainstalowane projekty skryptów pojawią się wraz z innymi projektami skryptów aktualnie otwartymi w panelu Projects .