Tworzenie projektów i dokumentów

Punktem wyjścia dla każdego projektu tworzonego w Altium Designer jest projekt. Projekt Altium Designer gromadzi zestaw dokumentów projektowych, których wynik końcowy definiuje pojedynczą implementację tego, co zamierzasz stworzyć. Na przykład schematy i PCB w projekcie PCB obejmują zestaw plików wymaganych do wyprodukowania płytki drukowanej. Z kolei zestaw plików generowany w projekcie wiązki przewodów służy do zakupu i montażu wiązki, a pliki schematu logicznego i montażu fizycznego w projekcie wielopłytkowym generują zestaw plików do wytworzenia i złożenia kompletnego produktu z wieloma połączonymi PCB.

Zestaw dokumentów projektowych projektu można zebrać z dowolnego dostępnego źródła – lokalnego na komputerze lub innego – a plik projektu łączy je w spójny, ujednolicony projekt. Oprogramowanie wykorzystuje kompilację dynamiczną do tworzenia i zarządzania ujednoliconym modelem danych komponentów projektu oraz ich połączeń. Ten model danych może następnie służyć do propagowania zmian projektowych pomiędzy domenami projektu – na przykład do synchronizacji w celu rozwiązania różnic między dokumentami w domenach Schemat i PCB.

Dokumenty projektu mogą być tworzone i przechowywane w Twoim Altium Workspace, w systemie kontroli wersji lub lokalnie jako pliki w dostępnej sieci.

Poniższe sekcje opisują, jak utworzyć nowy projekt oraz jak dodać dokumenty projektowe do istniejącego projektu.

Tworzenie nowego projektu za pomocą okna dialogowego Create Project

Nowy projekt można utworzyć w Altium Designer za pomocą okna dialogowego Create Project (File » New » Project).

1. Na liście Locations wybierz pozycję odpowiadającą Twojemu Workspace (pojawi się pod zdefiniowaną dla niego nazwą) – aby widzieć tę opcję na liście, musisz być aktywnie połączony z Workspace. Będzie to serwer docelowy, w którym zostanie zapisany nowy projekt Workspace.

   W skrócie: zarządzanie projektami koncentruje się na bezpiecznym przechowywaniu i śledzeniu zmian w całym procesie projektowania oraz – ostatecznie – na przeprowadzeniu powstałego projektu do etapu wytworzenia fizycznego elementu, takiego jak zmontowana płytka PCB używana w produkcie końcowym. Aby spełnić te potrzeby, Altium Designer oferuje szereg podejść do zarządzania projektami, zapewniających rosnący poziom zaawansowania i możliwości, a jednocześnie upraszczających proces z perspektywy projektanta. Obejmują one przechowywanie i zarządzanie oparte na plikach lokalnych, podejścia oparte na lokalnym/zdalnym systemie kontroli wersji (VCS), aż po zaawansowaną i zalecaną formę, w której zarządzanie danymi projektowymi opiera się na możliwościach Workspace.

   Podłączony Workspace oraz jego wewnętrzna usługa VCS hostują i zarządzają projektami Altium Designer, a także zapewniają uproszczone operacje VCS, wbudowane możliwości współpracy projektowej, zaawansowane udostępnianie danych projektowych, śledzenie historii, zarządzanie cyklem życia i wiele więcej. Projekty zintegrowane z Workspace są dostępne bezpośrednio z Altium Designer, na przykład z panelu Projects, lub z poziomu samego Workspace poprzez interfejs w przeglądarce.

   Dzięki inteligencji wbudowanej w usługi dostarczane przez Workspace, zadania takie jak operacje VCS są uproszczone i zautomatyzowane, a dodatkowe funkcje współpracy projektowej, takie jak kontrola dostępu użytkowników (udostępnianie), komentowanie i historia, są dostępne bezpośrednio w Altium Designer. Efektem końcowym jest solidny i bezpieczny format oraz lokalizacja przechowywania projektu, które mogą stać się centralnym punktem współpracy nad projektem.

   Po połączeniu z Workspace, w którym aktywna jest co najmniej jedna definicja procesu dla motywu procesu Project Creations, możliwość utworzenia nowego projektu za pośrednictwem okna dialogowego gh the Create Project dialog  jest ograniczona wyłącznie do projektów typu Local i VCS. Zamiast tego tworzenie projektów opartych na Workspace podlega kontroli aktywnych definicji procesów. Dowiedz się więcej o Process-based Project Creation.

2. Na liście Project Type wybierz typ projektu, który chcesz utworzyć, oraz – w razie potrzeby – wybierz spośród dostępnych szablonów. Pozycja <Empty> utworzy „pusty” projekt bez początkowych dokumentów źródłowych.

   Dowiedz się więcej o Creating a Project Template.

3. Wprowadź Project Name oraz opcjonalnie Description projektu.

   Nazwa projektu powinna zaczynać się od  i może zawierać znaki A-Z, a-z lub 0-9. Dozwolone są podkreślenia, myślniki i spacje, przy czym spacje mogą występować tylko w środku nazwy (początkowe i końcowe spacje zostaną zignorowane). Nie można używać następujących słów: AUX, COM1-COM9, LPT1-LPT9, CON, NUL oraz PRN. Ponadto nazwa nie może zawierać następujących znaków: \ . / ? % * : | " < >.

Okno dialogowe Create Project zawiera dodatkowe opcje:

• Zaznacz opcję Version Control (domyślnie), aby narzucić projektowi wszystkie możliwości VCS, takie jak historia i zaawansowane możliwości udostępniania. Gdy opcja jest odznaczona, projekt jest przechowywany w Workspace i synchronizowany z kopią lokalną – jako projekt „lustrzany” w formacie Simple Sync.

  Opcja Version Control jest dostępna tylko po połączeniu z Altium 365 Workspace. Po połączeniu z Enterprise Server Workspace ta opcja jest w praktyce zawsze zaznaczona.

• Podczas tworzenia projektu typu PCB zaznacz opcję Constraint Management , aby zarządzać ograniczeniami projektowymi dla tego projektu za pomocą Constraint Manager. Gdy opcja jest wyłączona, dla tego projektu będzie używany system design rules.

  Opcja Constraint Management jest domyślnie włączona w oknie dialogowym Create Project, gdy opcja System.ConstraintManager jest włączona w oknie dialogowym Advanced Settings dialog.

• Po połączeniu z Enterprise Server Workspace menu rozwijane Repository (jeśli występuje) wyświetli wszystkie repozytoria projektowe zarządzane przez Version Control Service w Workspace, które zostały Ci udostępnione do użycia. Wybierz repozytorium, w którym mają zostać zapisane nowy projekt i jego pliki – domyślnie dostępne jest jedno repozytorium oparte na Git (Versioned Storage). Jeśli zostanie wybrane repozytorium typu SVN, dostępna jest dodatkowa opcja Repository Folder umożliwiająca wskazanie lub przeglądanie alternatywnego folderu docelowego w samym repozytorium.

  Menu rozwijane Repository jest wyświetlane tylko wtedy, gdy zaktualizowano Enterprise Server z wersji lub produktu serwerowego, w którym włączone było użycie repozytoriów SVN. W przeciwnym razie Enterprise Server udostępnia pojedyncze repozytorium projektowe oparte na Git, przeznaczone do przechowywania wszystkich projektów w Workspace, i w takim przypadku menu rozwijane Repository nie będzie wyświetlane.

  SVN nie jest obsługiwany w Altium On-Prem Enterprise Server począwszy od wersji 7.2. Aby uniknąć ograniczeń związanych z zarządzaniem projektem SVN, zaleca się migrację projektów SVN do wbudowanego repozytorium Git w Enterprise Server Workspace. Można to zrobić przed aktualizacją serwera, jak opisano here.

  Aby uzyskać więcej informacji o wycofaniu SVN w Altium On-Prem Enterprise Server, zapoznaj się z artykułem bazy wiedzy SVN Discontinuation with Altium On-Prem Enterprise Server 7.2.1 .

• Kliknij element sterujący Advanced, aby określić ścieżki folderów.

  • Użyj pola Folder, aby określić, gdzie ma zostać utworzony folder projektu – w strukturze folderów Workspace. Domyślna ścieżka dla nowych projektów jest określona na stronie Admin – Settings – Projects w interfejsie przeglądarkowym Workspace (domyślnie będzie to Projects\<ProjectName>). Kliknij przycisk , aby w razie potrzeby przejść do innego folderu Workspace i go wybrać.

    Jeśli użytkownik tworzący projekt w podłączonym Workspace nie ma uprawnień zapisu do domyślnego folderu projektów, system automatycznie utworzy specyficzną dla użytkownika strukturę Personal Folder  do przechowywania nowego projektu. Pojawia się ona jako folder najwyższego poziomu oparty na adresie e-mail członka (dla Altium 365 Workspace) lub nazwie użytkownika (dla Enterprise Server Workspace), z podfolderem My Projects  przechowującym projekty tego użytkownika. Struktura/hierarchia folderów jest dostępna wyłącznie dla zalogowanego użytkownika i administratorów – nie jest widoczna dla innych użytkowników. Dowiedz się więcej o Managing Project Creation Permissions  (Altium 365 Workspace, Enterprise Server Workspace).

  • Użyj pola Local Storage, aby określić, gdzie na dysku twardym będzie przechowywana lokalna wersja projektu. Domyślna lokalizacja jest zdefiniowana na stronie System – Default Locations w oknie dialogowym Preferences. Kliknij przycisk , aby w razie potrzeby przejść do innej lokalizacji folderu i ją wybrać. Jest to „roboczy” folder projektu oraz repozytorium local Git, do którego jest on zatwierdzany. Projekt jest ostatecznie – lub w momencie zatwierdzenia – wypychany do scentralizowanego repozytorium projektowego w Workspace (Versioned Storage), którym jest repozytorium remote Git.

   

• Użyj obszaru listy Parameters, aby dodawać lub usuwać niestandardowe pary parametrów Nazwa/Wartość, które są powiązane z projektem i zapisywane w Workspace. Użyj przycisku , aby dodać do listy nową parę Nazwa–Wartość, lub przycisku , aby usunąć wybraną parę. Pola Nazwa i Wartość pozwalają na maksymalnie 255 znaków. Podczas tworzenia projektu w Workspace te parametry projektu Workspace są zapisywane w Workspace wraz z nowym projektem jako parametry na poziomie projektu po stronie Workspace.

  Gdy w oknie dialogowym zostanie wybrany szablon projektu z listy Project Type, obszar listy Parameters zostanie wypełniony parametrami z tego szablonu. W razie potrzeby możesz zmienić te parametry (nazwy i/lub wartości) albo je usunąć. Podczas tworzenia projektu w Workspace parametr z wybranego szablonu zostanie zapisany jako parametr na poziomie projektu po stronie projektu (design-side), jeśli nazwa parametru nie została zmieniona. W przeciwnym razie zostanie zapisany jako parametr na poziomie projektu po stronie Workspace.

  Parametry na poziomie projektu po stronie Workspace można edytować w Workspace. Z kolei parametry po stronie projektu są zapisywane w pliku projektu (*.PrjPcb) i można je edytować w Altium Designer. Parametry na poziomie projektu obu typów można przeglądać na karcie Parameters w oknie dialogowym Project Options (Project » Project Options) i mogą być używane jako Special Strings w Altium Designer.

Po zdefiniowaniu projektu zgodnie z wymaganiami kliknij przycisk . Nowa struktura projektu zostanie utworzona w określonych folderach lokalnych i Workspace. Projekt zostanie otwarty w Projects panel, który odzwierciedli w pełni zsynchronizowany stan pomiędzy plikami w zdalnym repozytorium projektu (w Workspace) a lokalnym repozytorium (kopia robocza) – co będzie wskazane przez powiązane ikony . Jeśli utworzono go z odznaczoną opcją Version Control (dostępną tylko w Altium 365 Workspace), projekt lustrzany będzie pokazany w panelu Projects z powiązaną ikoną .

Nowo utworzony projekt został zatwierdzony (committed) do repozytorium projektu Versioned Storage w Workspace.

Alternatywnie, jeśli nowemu projektowi not przypisano szablon z dokumentami składowymi, zostanie utworzony tylko plik projektu (*.PrjPcb), a tym samym wyłącznie struktura projektu. Następnie projekt zostanie otwarty w Projects panel, który pokaże go jako Scheduled for addition, oznaczonego powiązaną ikoną . W tym momencie możesz dodać dokumenty do projektu albo po prostu zapisać strukturę do Workspace w jej bieżącym, „szkieletowym” stanie. Aby to zrobić, kliknij kontrolkę Save to Server powiązaną z wpisem projektu w panelu Projects – jest ona również dostępna z menu kontekstowego po kliknięciu prawym przyciskiem myszy oraz z głównego menu File. W kolejnym oknie Save to Server dialog zaznacz/odznacz pliki do uwzględnienia, dodaj opcjonalny Comment, a następnie potwierdź proces zapisu przyciskiem . Po dodaniu projektu do serwera panel Projects będzie odzwierciedlał w pełni zsynchronizowany stan pomiędzy plikami w repozytorium serwera a lokalną kopią roboczą, co będzie wskazane przez ikony .

Kopiowanie projektu

Aby skopiować projekt Workspace z poziomu Altium Designer, kliknij prawym przyciskiem myszy wpis projektu w panelu Projects i wybierz polecenie Make a copy  z menu kontekstowego. Użyj okna dialogowego Create Project Copy, aby określić Project Name (domyślnie będzie to oryginalna nazwa projektu z sufiksem - Copy), Description (nie jest wstępnie wypełniane), ścieżkę Folder (w obrębie Workspace) oraz ścieżkę Local Storage (do kopii roboczej).

Folder Workspace domyślnie będzie tym samym folderem, w którym przechowywany jest oryginalny projekt. Kliknij , aby otworzyć okno dialogowe Choose Folder (okrojoną wersję panelu Explorer) i w razie potrzeby zmienić folder. Local Storage domyślnie będzie ustawione na użycie lokalizacji zdefiniowanej na stronie System - Default Locations w oknie dialogowym Preferences. Kliknij , aby otworzyć standardowe okno systemu Windows, w którym można zmienić tę lokalizację.

Skopiuj projekt Workspace z poziomu Altium Designer.

Dodawanie i usuwanie dokumentu projektowego

Po utworzeniu projektu można dodawać, edytować lub usuwać dokumenty projektowe z aktywnego projektu. Najprostszym sposobem dodania nowych dokumentów projektowych do projektu jest kliknięcie prawym przyciskiem myszy nazwy projektu w panelu Projects i wybranie Add New to Project z opcji menu kontekstowego. Alternatywnie wybierz wymagany typ dokumentu z podmenu Project » Add New to Project w menu głównym, aby dodać nowy dokument do aktywnego projektu.

Dodaj do projektu określony lub inny typ dokumentu.

Do projektu można również dodać inne typy dokumentów istotnych dla projektu, takie jak pliki tekstowe, PDF-y, arkusze kalkulacyjne itp. Aby to zrobić, użyj opcji Add Existing to Project (lub polecenia Project » Add Existing to Project z menu głównego edytora aktywnego dokumentu) i ustaw listę rozwijaną File Type w oknie przeglądarki Choose Document to Add na All Files (*.*), aby uzyskać dostęp do wszystkich typów plików.

Aby usunąć dokument ze struktury projektu, kliknij prawym przyciskiem myszy jego nazwę w panelu Projects i wybierz opcję menu Remove from Project albo wybierz polecenie Project » Exclude from Project z menu głównego. Zostaniesz poproszony o wybór:

• Delete File– aby trwale usunąć sam plik dokumentu źródłowego.

• Exclude from Project – aby usunąć powiązanie projektu z tym dokumentem (bez usuwania samego pliku dokumentu źródłowego). Jeśli jest on aktualnie otwarty w oknie edytora projektu, zostanie usunięty z projektu nadrzędnego, ale pozostanie otwarty w panelu jako dokument niezależny. Jeśli natomiast nie jest aktualnie otwarty w przestrzeni projektowej, usunięcie spowoduje jego zamknięcie.

  

Usuwanie projektu

W przypadku projektów lokalnych usunięcie projektu polega na skasowaniu plików z dysku twardego. Otwórz folder projektu w Eksploratorze Windows i usuń jego zawartość.

W przypadku projektów w Workspace (oraz innych zasobów Workspace, takich jak komponenty i dane wydań), dostępna jest elastyczna funkcjonalność usuwania bezpośrednio z poziomu Altium Designer, z panelu Explorer panel. Działając jako „miękkie usunięcie” (soft delete), proces usuwania zapewnia więcej opcji i informacji w trakcie działania, w tym odpowiednie odnośniki do elementów źródłowych do celów weryfikacji. W Workspace usunięte zasoby są przenoszone do dedykowanej Trash lokalizacji, skąd można je przywrócić lub całkowicie usunąć na stronie Trash w interfejsie przeglądarkowym Workspace.

Aby wykonać soft-delete projektu w Workspace, przejdź do folderu projektu w panelu Explorer, kliknij prawym przyciskiem myszy jego wpis i wybierz polecenie Delete Folder z menu kontekstowego. Potwierdź usunięcie w wyświetlonym oknie dialogowym Confirm Delete. Jeśli projekt zawiera wydane dane (released data), otworzy się kolejne okno potwierdzenia, informujące, że te dane również zostaną usunięte. Kliknij Delete, aby kontynuować.

Soft delete w praktyce. Tutaj usuwany jest projekt wraz z powiązanym wydaniem (gdyby z jakichkolwiek wydań utworzono pakiety produkcyjne, one również zostałyby usunięte).