Tworzenie i przechowywanie skryptów

W skrócie

Dowiedz się, jak tworzyć, organizować i przechowywać skrypty w Altium Designer — od konfiguracji projektu skryptowego po zarządzanie rewizjami w połączonym obszarze roboczym. W tym artykule wyjaśniamy, czym są moduły i formularze skryptowe, jak skrypty współdzielą zmienne i procedury w ramach projektu oraz jak projekty globalne zapewniają dostęp do skryptów w kolejnych sesjach. Czytaj dalej, aby sprawniej zarządzać skryptami w Altium Designer.

- 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.
Zagłęb się w temat dzięki AI:
 

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.
Po utworzeniu nowego projektu skryptowego dodaj do niego nowy skrypt.

Użyj File » Save Project As, aby zapisać projekt pod wybraną nazwą. Podobnie użyj File » Save As, aby zapisać nowy skrypt i nadać mu nazwę.

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.
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.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:

  1. 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.
  2. 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).

    Jeśli element nie ma zaplanowanej rewizji, pliki zostaną przesłane do następnej zaplanowanej rewizji, utworzonej na bieżąco w trakcie przesyłania.

    Wskazywanie pliku projektu skryptowego do przesłania do docelowego elementu skryptu.
    Wskazywanie pliku projektu skryptowego do przesłania do docelowego elementu skryptu.

  3. 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.
    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.
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.

Kliknięcie prawym przyciskiem myszy wpisu najwyższego poziomu samego skryptu obszaru roboczego umożliwia edycję jego najnowszej rewizji.

Dostęp do polecenia uruchamiającego bezpośrednią edycję istniejącej rewizji skryptu.
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.

Aby otworzyć plik projektu przechowywany w rewizji skryptu obszaru roboczego lub jeden z powiązanych plików źródłowych, zaznacz ten plik na karcie widoku Details danej rewizji w panelu Explorer, a następnie kliknij prawym przyciskiem myszy i wybierz polecenie Open z menu kontekstowego. Projekt (wraz ze wszystkimi plikami źródłowymi) lub wybrane pliki źródłowe (jako niezależne dokumenty) zostaną otwarte w Altium Designer.

Skrypt z Workspace może być używany pośrednio jako część rewizji elementu preferencji projektowych — po zainstalowaniu go wraz z opublikowanymi preferencjami na stronie System skryptowy – Projekty globalne w oknie dialogowym Preferences — w co najmniej jednej zdefiniowanej Environment Configurations. Konfiguracja środowiska służy do ograniczenia środowiska pracy projektanta wyłącznie do elementów projektowych zatwierdzonych przez firmę. Konfiguracje środowiska są definiowane i przechowywane w Team Configuration Center — usłudze udostępnianej przez Workspace. Po połączeniu z Workspace i wybraniu, w stosownych przypadkach, jednej z dostępnych konfiguracji środowiska program Altium Designer zostanie skonfigurowany pod kątem używanych preferencji. Jeśli w wybranej konfiguracji środowiska zdefiniowano rewizję elementu preferencji projektowych, zostanie ona zastosowana od razu. Jeśli w wybranej, obowiązującej konfiguracji środowiska nie określono rewizji elementu preferencji projektowych, preferencje nadal będzie można definiować ręcznie. Innymi słowy, można ręcznie użyć ponownie rewizji elementu preferencji projektowych lub skorzystać z lokalnie zapisanego pliku preferencji. Więcej informacji można znaleźć w sekcji Environment Configuration Management (Altium 365 Workspace, Enterprise Server Workspace). Informacje o zapisywaniu preferencji projektowych w połączonym Workspace można znaleźć na stronie Dostęp do preferencji systemowych, ich definiowanie i zarządzanie nimi.

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

Odwołania do Workspace utworzone w preferencjach przez zainstalowany projekt skryptu z Workspace są zachowywane, a zatem zostaną uwzględnione, jeśli bieżący zestaw preferencji również zostanie zapisany w Workspace. Ponowne użycie rewizji utworzonego w ten sposób elementu preferencji projektowych automatycznie udostępni więc powiązany skrypt z Workspace. Informacje o zapisywaniu preferencji projektowych w połączonym Workspace można znaleźć na stronie Dostęp do preferencji systemowych, ich definiowanie i zarządzanie nimi.
AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Nav
Contents
Dostępność funkcji

Dostępne funkcje zależą od tego, z którego rozwiązania Altium korzystasz – Altium Develop, Altium Agile Teams, Altium Agile Enterprise lub Altium Designer (w ramach aktywnej subskrypcji terminowej).

Jeśli opisana funkcja nie jest widoczna w Twoim oprogramowaniu, skontaktuj się z działem sprzedaży Altium, aby dowiedzieć się więcej.

Starsza dokumentacja

Dokumentacja Altium Designer nie jest już wersjonowana. Jeśli potrzebujesz dostępu do dokumentacji dla starszych wersji Altium Designer, odwiedź sekcję Starsza dokumentacja na stronie Inne instalatory.

Contents