Tworzenie i przechowywanie skryptów
W skrócie
- Twórz i zapisuj projekty skryptowe oraz dowiedz się, kiedy korzystać z modułów, a kiedy z formularzy skryptowych.
- Przesyłaj projekty skryptowe do połączonego obszaru roboczego, edytuj przechowywane w nim skrypty i zapisuj nowe rewizje.
- Instaluj lokalne projekty skryptowe lub projekty z obszaru roboczego jako projekty globalne, aby udostępniać ich procedury innym projektom skryptowym.
Skrypty Altium Designer są zwykle tworzone i przechowywane w projekcie skryptowym (*.PrjScr), ale można je dodawać do projektów dowolnego typu lub w nich przechowywać.
Aby rozpocząć pisanie skryptów, utwórz nowy projekt skryptowy i dodaj do niego pliki skryptów.
Tworzenie projektów skryptowych i skryptów
Projekt skryptowy ułatwia zarządzanie skryptami. Aby go utworzyć, wybierz File » New » Script » Script Project z menu głównego.
Nowy projekt (Script_Project1.PrjScr) do przechowywania skryptów pojawi się 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 skryptowego dodaj do niego nowy skrypt.
Podczas tworzenia nowego skryptu możesz wybrać jeden z dwóch typów, zależnie od wymagań projektu — moduł skryptowy lub formularz skryptowy.
Typy skryptów
Moduły skryptowe
Moduł skryptowy to dokument skryptu napisany zgodnie ze składnią określonego języka, na przykład DelphiScript.

Moduł skryptowy z kodem skryptu.
Formularze skryptowe
Formularz skryptowy to okno, które może zawierać różne kontrolki, takie jak przyciski, wielowierszowe pola tekstowe i pola list, do których można przypisać procedury obsługi zdarzeń. W edytorze formularz skryptowy ma dwa widoki, wybierane za pomocą kart Code i Form, widocznych u dołu przedstawionego poniżej dokumentu skryptu.
Formularz skryptowy z otwartymi kartami Code i Form.
Powiązania między skryptami w projekcie
Gdy projekt zawiera wiele skryptów, każdy skrypt w tym projekcie (korzystający z tego samego języka) ma dostęp do zmiennych globalnych i procedur. Wszystkie skrypty w projekcie są w praktyce wzajemnie „widoczne”, więc procedura w jednym skrypcie może wywołać procedurę z innego skryptu w tym samym projekcie skryptowym.
Ważne jest, aby nazwy procedur i zmiennych globalnych w skryptach należących do tego samego projektu były unikatowe. Jednym z rozwiązań jest przeniesienie wszystkich wspólnych procedur i funkcji używanych w różnych skryptach do jednego nowego skryptu w tym samym projekcie. Pozwala to łatwo wykorzystywać procedury i funkcje z tego wspólnego skryptu w różnych projektach skryptowych.
► Przykład wywołania procedury z innego skryptu znajdziesz w sekcji Pisanie skryptów.
Przesyłanie projektu skryptowego do połączonego obszaru roboczego
Altium Designer w połączeniu z obszarem roboczym umożliwia tworzenie skryptów obszaru roboczego i zarządzanie nimi. Takie skrypty są tworzone bezpośrednio w obszarze roboczym, a odpowiedni projekt skryptowy (*.PrjScr) jest przesyłany do rewizji docelowego skryptu obszaru roboczego. Proces przebiega następująco:
- Utwórz nowy element skryptu w połączonym obszarze roboczym za pomocą panelu Explorer. Więcej informacji o tworzeniu elementów w obszarze roboczym znajdziesz na stronie Tworzenie i edytowanie zawartości.
-
Kliknij prawym przyciskiem myszy odpowiedni element skryptu w panelu Explorer i wybierz polecenie Upload z menu kontekstowego. Pojawi się standardowe okno dialogowe systemu Windows Open, w którym możesz odszukać wymagany plik projektu skryptowego (
*.PrjScr).
Wskazywanie pliku projektu skryptowego do przesłania do docelowego elementu skryptu. -
Po wybraniu odpowiedniego pliku kliknij przycisk Open, aby rozpocząć przesyłanie. Plik projektu wraz ze wszystkimi plikami w tym samym folderze zostanie przesłany do rewizji i będzie dostępny na karcie widoku Details tej rewizji w panelu Explorer.

Przesłany projekt wraz ze wszystkimi plikami z tego samego folderu jest widoczny na karcie widoku Details rewizji elementu skryptu.
Projekt skryptowy można również przesłać do nowego skryptu obszaru roboczego, przeciągając wybrany plik projektu skryptowego i powiązane pliki źródłowe z folderu źródłowego w Eksploratorze Windows do odpowiedniego folderu w panelu Explorer. Pojawi się okno dialogowe Create New Item, a przeciągnięte pliki zostaną wyświetlone w sekcji Sources. Pole Name elementu będzie zawierać nazwy plików wraz z rozszerzeniami (wpisy będą oddzielone średnikami). Pole Description będzie miało format Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (wpisy będą oddzielone średnikami). W razie potrzeby zmień te wartości. Wartość Item ID będzie zgodna ze schematem nazewnictwa elementów zdefiniowanym na poziomie folderu. Jeśli dla folderu nie zdefiniowano schematu nazewnictwa, zostanie zastosowany schemat $CONTENT_TYPE_CODE-{000000}.

Przesyłanie projektu skryptowego i powiązanych plików do początkowej rewizji nowo utworzonego skryptu obszaru roboczego metodą przeciągania i upuszczania.
Edytowanie skryptu obszaru roboczego
W dowolnym momencie możesz wrócić do dowolnej rewizji skryptu obszaru roboczego i bezpośrednio ją edytować. 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 w obszarze roboczym jako kolejną rewizję za pomocą polecenia Save to server (skrót: Ctrl+Alt+S) — dostępnego w menu kontekstowym wyświetlanym 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 chcesz zmienić projekt lub powiązane pliki źródłowe przechowywane w skrypcie obszaru roboczego i masz zaktualizowane pliki źródłowe, możesz przesłać je do tego skryptu — nowe pliki zostaną zapisane w jego kolejnej rewizji.
Projekty globalne
Projekty skryptów można instalować za pomocą funkcji Global Projects, tak aby były wstępnie wczytywane i dostępne po uruchomieniu oprogramowania. Zmienne globalne i procedury z tych skryptów są dostępne do użycia w innych otwartych projektach skryptów.
Aby ustawić projekt skryptu jako globalny, przejdź do strony System skryptowy – Projekty globalne w oknie dialogowym Preferences. Użyj przycisku Install , aby znaleźć i wybrać projekt z pliku lub z Workspace. Powtórz ten proces dla wszystkich projektów skryptów, które mają być dostępne globalnie.
Zainstalowany projekt skryptu z Workspace będzie dostępny w Altium Designer zawsze, gdy użytkownik będzie połączony z Workspace. Należy pamiętać, że zainstalowany projekt skryptu z Workspace jest wyświetlany wraz z jego lokalizacją, czyli „ścieżką” w strukturze folderów Workspace, oraz identyfikatorem skryptu z Workspace zawierającego dane projektu skryptu.

Aby zainstalować skrypty, użyj Scripting System – Global Projects w oknie dialogowym Preferences.
Projekty globalne umożliwiają skryptom z lokalnego projektu tego samego typu korzystanie z procedur zainstalowanych globalnych projektów skryptów. Po otwarciu okna dialogowego Select item to Run (File » Run Script) zainstalowane projekty skryptów pojawią się wraz z innymi projektami skryptów aktualnie otwartymi w panelu Projects .