Managing Project Documents in Altium Designer

Panel projektów

Panel Projects wyświetla wszystkie aktualnie otwarte projekty oraz ich dokumenty składowe i strukturę. Menu kontekstowe panelu dostępne po kliknięciu prawym przyciskiem myszy oferuje większość poleceń wymaganych do pracy z dokumentami projektowymi.

Panel Projects panel

Należy pamiętać, że prezentacja dokumentów w panelu Projects nie odzwierciedla sposobu ich przechowywania na dysku twardym lub w innym miejscu. Zawartość panelu można uznać za logiczną reprezentację projektu, podczas gdy fizyczna lokalizacja i organizacja przechowywania plików dokumentów (i ich typ) zależy od użytkownika - dokumenty mogą być przechowywane w folderze na komputerze lokalnym lub w sieci LAN i oczywiście hostowane w repozytorium kontrolowanym wersjami dostarczanym przez podstawowy system Git/SVN VCS lub w pełni zarządzany system, taki jak Workspace.

Zachowanie panelu Projects można skonfigurować za pomocą opcji na stronie System - Panel projektów w oknie dialogowym Preferences okna dialogowego. Dostęp do tych opcji można również uzyskać za pomocą kontrolki w górnej części panelu.

Po połączeniu z obszarem roboczym ikona obszaru roboczego (/) jest wyświetlana obok najwyższego wpisu tego obszaru roboczego. Gdy lokalna kopia robocza projektu jest otwarta, ale przestrzeń robocza, w której znajduje się projekt, nie jest podłączona, pojawi się wyszarzona ikona przestrzeni roboczej (/).

Projekt Workspace może być również udostępniony użytkownikowi bez zapraszania go do zespołu Workspace, w którym znajduje się ten projekt. Projekt, który został otwarty z udostępnionego dostępu, jest oznaczony powiązaną etykietą z ikoną obok Shared with me etykietą z ikoną obok niej.

Jeśli projekt został udostępniony użytkownikowi, aby mógł go tylko przeglądać, etykieta View Only etykieta zostanie wyświetlona obok wpisu projektu w panelu, aby to wskazać - pokaż przykład.

Projekty lokalne są wyświetlane pod wpisem grupy projektów ( *.DsnWrk) - albo domyślnej (Project Group 1.DsnWrk) lub utworzonej lub otwartej przez użytkownika.

Aby uzyskać dostęp do menu kontekstowego dotyczącego aktualnie podłączonego obszaru roboczego, kliknij prawym przyciskiem myszy nazwę obszaru roboczego lub kliknij kontrolkę po jego prawej stronie. Polecenia te obejmują:

• Open Project - otwiera okno dialogowe Otwórz projekt.
• Create Project - otwiera okno dialogowe Utwórz projekt.
• Show in Explorer - otwiera panel Eksploratora.
• Show in Web Browser - otwiera stronę Projects w domyślnej przeglądarce.
• Sign out - wylogowuje użytkownika z Workspace.
• Sign in - loguje użytkownika do obszaru roboczego. To polecenie jest dostępne pod warunkiem, że masz co najmniej jeden element przestrzeni roboczej (np. projekt) otwarty w panelu Projekty i jesteś obecnie odłączony od przestrzeni roboczej, w której znajduje się ten element.

Aby uzyskać dostęp do tych poleceń, musisz być połączony z obszarem roboczym. Po wylogowaniu się z przestrzeni roboczej kliknij prawym przyciskiem myszy przestrzeń roboczą, z którą chcesz się połączyć, a następnie kliknij polecenie Sign In polecenie.

Drzewo dokumentów projektu

Po otwarciu istniejącego lub utworzeniu nowego projektu, jego wpis pojawi się w panelu Projects panelu. Wszelkie istniejące dokumenty, które są częścią projektu (i wszelkie nowe, które zostały dodane) pojawią się w podfolderach zgodnie z ich przeznaczeniem i/lub typem. Na przykład, w ramach projektu mogą pojawić się następujące wspólne foldery i typy dokumentów zawartości:

• Source Documents - podstawowe dokumenty projektowe, takie jak schematy, PCB itp.
• Settings - zapewnia różne pliki używane w projekcie, w tym pliki zadań wyjściowych, pliki definicji wiązek i dokumenty adnotacji, a także inne istotne pliki.
• Libraries - dokumenty lokalnej biblioteki źródłowej. Dokumenty są dalej podzielone na podstawie typu biblioteki (np. biblioteki schematów, biblioteki PCB itp.).
• Documentation - dodatkowe dokumenty, które zostały dodane do projektu, o typie znanym przez Altium Designer (np. tekst, PDF itp.).
• Other Documents - dodatkowe dokumenty, które zostały dodane do projektu, typu, który nie jest znany przez Altium Designer. Mogą one być otwierane przez Altium Designer, jeśli aplikacja będąca ich właścicielem jest znana systemowi Windows (np. dokumenty Word, arkusze kalkulacyjne Excel itp.).
• Generated - dokumenty wygenerowane jako dane wyjściowe. Dokumenty są dalej dzielone na podstawie typu (np. dokumenty BOM, dokumenty tekstowe itp.). W miarę generowania danych wyjściowych projektu, odpowiednie podfoldery w głównym drzewie będą tworzone i zapełniane.
• Components - Ten folder zawiera listę każdego komponentu i liczbę komponentów w każdej grupie. Zatwierdź projekt, jeśli ten folder się nie pojawia (Project » Validate). Komponenty są domyślnie grupowane według pierwszej litery w desygnatorze - kliknij prawym przyciskiem myszy wpis komponentu (lub folder grupowania komponentów) i wybierz polecenie Component Grouping z menu kontekstowego, aby szybko uzyskać dostęp do Components Grouping elementów sterujących dla Projects i zmienić styl grupowania lub wyłączyć grupowanie, w zależności od potrzeb. Więcej informacji można znaleźć w sekcji Wyszukiwanie komponentów i sieci w strukturze projektu na stronie Tworzenie połączeń obwodów na schematach.
• Nets - ten folder zawiera listę wszystkich sieci używanych w projekcie. Sprawdź poprawność projektu, jeśli ten folder nie jest widoczny (Project » Validate). Więcej informacji można znaleźć w sekcji Wyszukiwanie komponentów i sieci w strukturze projektu na stronie Tworzenie połączeń obwodów na schematach.

Notes on working in the documents tree:

• Wszelkie dokumenty niezależne od projektu będą wyświetlane jako Free Documents i pojawią się w odpowiednich podfolderach. Klikając prawym przyciskiem myszy na wolnym dokumencie i wybierając polecenie Add to Project z menu kontekstowego, można dodać aktualnie otwarty wolny dokument do aktywnego projektu. Alternatywnie, można przeciągnąć i upuścić go na wymaganą nazwę projektu w panelu Projects panelu.
• Oprócz możliwości otwierania wielu dokumentów do edycji, środowisko obsługuje również wiele projektów otwartych w tym samym czasie. Mogą to być powiązane lub niepowiązane projekty.
• Dokumenty w panelu Projects są automatycznie układane w logiczne grupy lub "foldery", takie jak dokumenty źródłowe (schemat, płytka drukowana itp.), dokumenty ustawień (uprząż, zadanie wyjściowe itp.) oraz, w przypadku projektu hierarchicznego, dokumenty schematu najwyższego poziomu. Dokumenty w każdej grupie folderów są domyślnie wyświetlane w kolejności, w jakiej zostały dodane, ale można je przeciągać i upuszczać do nowej pozycji w grupie.
• W przypadku nowego projektu hierarchicznego, relacje rodzic-dziecko między dokumentami będą wyświetlane w panelu. Należy pamiętać, że relacje połączeń nie mogą być definiowane przez przeciąganie i upuszczanie dokumentów schematu, ponieważ połączenia między arkuszami i hierarchia projektu są w rzeczywistości definiowane przez symbole arkuszy i definicje portów.
• Kliknij prawym przyciskiem myszy podfolder dokumentu projektu, rozwinięty lub zamknięty, aby uzyskać dostęp do dodatkowych poleceń zarządzania dokumentami, takich jak otwieranie, zamykanie lub zapisywanie wszystkich dokumentów w skoncentrowanym podfolderze dokumentu projektu.
• Dokumenty mogą być przenoszone między projektami w panelu poprzez kliknięcie i przeciągnięcie. Dokument nie musi być przeciągany do właściwego podfolderu; zostanie on automatycznie prawidłowo umieszczony w strukturze projektu.
• Skróty klawiaturowe Up Arrow, Home, End, i Down Arrow mogą być używane do wyświetlania odpowiednio poprzedniego, pierwszego, ostatniego i następnego wpisu w panelu. W tym celu należy użyć przycisków Right Arrow i Left Arrow służą odpowiednio do rozwijania i zwijania wpisu najwyższego poziomu lub jego podfolderu.
• Aby wykonać sondę krzyżową z wybranego komponentu lub wpisu sieci w panelu Projects do tej jednostki na schemacie lub w dokumencie PCB nadrzędnego projektu PCB, kliknij prawym przyciskiem myszy na wpis i wybierz opcję Cross Probe to Schematic lub Cross Probe to PCB z menu kontekstowego.
• Aby otworzyć instancję Eksploratora Windows w lokalizacji, w której przechowywany jest dokument projektu, kliknij prawym przyciskiem myszy jego wpis w panelu Projects i wybierz polecenie Explore polecenie. W przypadku dokumentu skoncentrowanego w panelu Projects można to zrobić, klikając kontrolkę w górnej części panelu.

Opcje projektu

Istniejący lub nowo utworzony projekt jest powiązany z szeregiem ustawień opcji, które są specyficzne dla tego projektu. Są one przechowywane w pliku projektu (*.PrjPcb) i różnią się w zależności od typu projektu.

Ustawienia opcji są konfigurowane w oknie dialogowym Opcje projektu, do którego dostęp można uzyskać z Project » Project Options w menu głównym lub klikając prawym przyciskiem myszy nazwę projektu w panelu Projects a następnie wybierając Project Options z menu kontekstowego. W przypadku projektu skoncentrowanego w panelu Projects okno dialogowe jest dostępne po kliknięciu kontrolki w górnej części panelu.

Inne ustawienia projektu, które są definiowane w innych oknach dialogowych, a następnie zapisywane w pliku projektu, obejmują:

• Ustawienia adnotacji schematu.
• Ustawienia wyjściowe, takie jak raporty, drukowanie, Gerber itp. Należy pamiętać, że są to ustawienia wyjściowe dostępne za pośrednictwem menu schematu lub edytora PCB, a nie ustawienia wyjściowe zdefiniowane w dokumencie OutJob.

Wskazywanie statusu dokumentu

Podczas pracy z dokumentami projektu w Altium Designer, panel Projects zapewnia wizualne podsumowanie, które pliki dokumentów są modyfikowane lub zapisywane za pomocą ikon stanu, które są powiązane z każdym dokumentem projektu i głównym plikiem projektu. Zapewnia to szybkie wizualne podsumowanie tego, które dokumenty są modyfikowane, zapisywane, czy są to pliki Workspace czy lokalne, a także ich status kontroli wersji. Ikony dokumentów i ich znaczenie są wymienione poniżej.

Ikony statusu otwartego/zmodyfikowanego

[puste]	Dokument jest zamknięty.
	Otwarty - dokument jest otwarty jako dokument z zakładkami w oknie edytora projektu.
	Otwarty/Zmodyfikowany - dokument jest otwarty i został zmodyfikowany (nie został jeszcze zapisany). Zmodyfikowany dokument jest oznaczony gwiazdką obok jego wpisu w panelu Projects panelu. Zmodyfikowany dokument ma również gwiazdkę obok swojej nazwy na karcie otwartego dokumentu (lub w powiązanym menu podręcznym, jeśli dokumenty są zgrupowane).
	Plik dokumentu jest otwarty i zablokowany przez tę instancję Altium Designer.
	Plik dokumentu jest otwarty i został zablokowany przez inną instancję Altium Designer.
	Dokument jest edytowany przez innego użytkownika. Ten stan jest włączony przez funkcję Wizualizacja współpracowników i zapobieganie konfliktom.
	Dokument edytowany przez innego użytkownika jest aktualnie otwarty w edytorze. Ten warunek stanu jest włączony przez funkcję Wizualizacja współpracowników i zapobieganie konfliktom.
	Brak dokumentu(dowiedz się więcej o brakujących dokumentach).

Ikony stanu kontroli wersji

System kontroli wersji zasadniczo monitoruje i porównuje pliki dokumentów w folderze roboczym z ich odpowiednikami w repozytorium projektu. Altium Designer zarówno żąda, jak i wymienia informacje z systemem kontroli wersji za pośrednictwem interfejsu VCS i odpowiednio reaguje na warunki stanu pliku porównawczego. W praktyce przejawia się to w ikonach plików Projects ikonach plików, poprzez szereg alertów VCS i odpowiednie zmiany w dostępnych poleceniach zarządzania plikami.

Ikony i ich znaczenie są następujące:

[puste]	NIE DOTYCZY	Dokument nie jest objęty kontrolą wersji w repozytorium VCS.
	Brak modyfikacji	Lokalna kopia dokumentu jest zgodna z dokumentem w repozytorium i jest aktualna.
	Zaplanowane do dodania	Dokument został dodany do kontroli wersji, ale nie został jeszcze zatwierdzony (zaewidencjonowany) w repozytorium VCS.
	Zmodyfikowany	Lokalna kopia dokumentu została zmodyfikowana i zapisana w folderze roboczym. Zatwierdź dokument, by utworzyć nową wersję w repozytorium. W przypadku dokumentu PCB można również użyć funkcji PCB CoDesign, aby porównać lokalne zmiany z najnowszym zatwierdzeniem w Workspace za pomocą polecenia Local Changes to Remote Document Version z menu History & Version Control » Compare To menu prawego przycisku myszy panelu Projects panelu lub menu Projects » History & Version Control » Compare To menu głównego.
	Nieaktualne	Lokalna kopia dokumentu (w folderze roboczym) jest starsza niż jej odpowiednik w repozytorium i dlatego jest nieaktualna. Użyj polecenia Update Project From Server z menu History & Version Control menu prawego przycisku myszy panelu Projects panelu lub menu Projects » History & Version Control aby pobrać najnowszy dokument z obszaru roboczego. Należy pamiętać, że zapisanie dokumentu w tym stanie spowoduje powstanie konfliktu. Gdy projekt zawiera tylko dokumenty w stanach Nieaktualny i Bez modyfikacji, można również użyć kontrolki Update from Server który pojawia się obok nazwy projektu w panelu Projects aby pobrać najnowsze dokumenty nieaktualnych dokumentów z obszaru roboczego - pokaż obraz.
	Zapobieganie konfliktom	Inny użytkownik zatwierdził dokument przed zatwierdzeniem edytowanej i zapisanej lokalnie wersji tego dokumentu. Użyj polecenia Kontrola wersji Revert Local Changes aby odrzucić lokalne modyfikacje dokumentu projektu. W przypadku dokumentu PCB można również użyć funkcji PCB CoDesign, aby porównać i scalić zmiany.
	Wykryto konflikt	Podczas próby zapisania projektu w obszarze roboczym, gdy projekt zawiera dokumenty w stanie Conflict Prevention dokumenty te będą w stanie Conflict Detected stanie. Zostanie wyświetlone okno dialogowe Action Required zostanie wyświetlone okno dialogowe z listą dokumentów powodujących konflikt, które wymagają rozwiązania. Użyj następujących poleceń z menu History & Version Control » Resolve Conflict menu prawego przycisku myszy panelu Projects aby rozwiązać konflikt: Compare To Remote Version & Merge - użyj tego polecenia, aby rozwiązać konflikt dla dokumentu PCB poprzez porównanie i scalenie zmian przy użyciu funkcji PCB CoDesign. Use Remote Version - Użyj tego polecenia, aby rozwiązać konflikt poprzez aktualizację dokumentu z jego najnowszą wersją z obszaru roboczego. Keep Local Version - użyj tego polecenia, aby rozwiązać konflikt przy użyciu lokalnej wersji dokumentu.
	Przed serwerem (Git)	Dokument w lokalnym repozytorium roboczym jest nowszy niż jego odpowiednik w zdalnym repozytorium Git. Dzieje się tak, gdy lokalny dokument został zmodyfikowany, zapisany i zatwierdzony do lokalnego repozytorium, ale jeszcze nie Pushed do zdalnego repozytorium.
	Zaplanowane do usunięcia	Dokument projektu został usunięty z kontroli wersji i zostanie usunięty z repozytorium i bazy danych VCS podczas procesu zatwierdzania kontroli wersji. Ta ikona pojawia się również, gdy dokumentu brakuje w lokalnym folderze roboczym (został usunięty, zmieniono jego nazwę lub został przeniesiony), co można rozwiązać poprzez ponowne wypełnienie folderu z repozytorium za pomocą polecenia Restore document from VCS z menu kontekstowego VCS.
	Scalono	Dokument PCB został scalony z nowszą wersją z repozytorium przy użyciu funkcji PCB CoDesign. Zatwierdź projekt w obszarze roboczym, aby zapisać scalony dokument PCB w repozytorium obszaru roboczego.

Zmiana kolejności dokumentów projektu

Dokumenty w panelu Projects są automatycznie układane w logiczne grupy lub "foldery", takie jak dokumenty źródłowe (schemat, płytka drukowana itp.), dokumenty ustawień (wiązka, zadanie wyjściowe itp.), a w przypadku projektu hierarchicznego, dokumenty schematu najwyższego poziomu. Dokumenty w każdej grupie folderów są domyślnie wyświetlane w kolejności, w jakiej zostały dodane, ale można je przeciągać i upuszczać do nowej pozycji w grupie.

W przypadku nowego projektu hierarchicznego, relacje rodzic-dziecko między dokumentami będą wyświetlane w panelu Projects w panelu. Należy pamiętać, że relacje połączeń nie mogą być definiowane przez przeciąganie i upuszczanie dokumentów schematu, ponieważ połączenia między arkuszami i hierarchia projektu są w rzeczywistości definiowane przez symbole arkuszy i definicje portów.

więcej informacji na temat hierarchii projektu można znaleźć w sekcji Tworzenie połączeń i w sekcji Net Identifier Scope w zakładce Opcje okna dialogowego Project Options oknie dialogowym.

Zmiana nazwy dokumentu

Możesz bezpośrednio zmienić nazwę dowolnego dokumentu projektu składowego PCB (*.PcbDoc, *.SchDoc, itp.), samego projektu PCB (*.PrjPcb) lub grupy projektów (*.DsnWrk) za pomocą polecenia Rename dostępnego z menu kontekstowego po kliknięciu prawym przyciskiem myszy projektu w panelu Projekty - i następującego po nim okna dialogowego Rename okno dialogowe.

Przykłady zmiany nazwy projektu i jednego z jego dokumentów projektowych, lokalnie z poziomu Altium Designer. Zmiany te zostaną zsynchronizowane z obszarem roboczym podczas zapisywania i wysyłania zmian do tego obszaru.

Po zmianie nazwy należy zapisać zmiany w obszarze roboczym za pomocą polecenia Save to Server (dostępnego z tego samego menu kontekstowego dla projektu). Synchronizacja zmiany nazwy pliku jest utrzymywana pomiędzy lokalną kopią roboczą projektu i jej odpowiednikiem w Workspace. Dodatkowo, po zmianie nazwy pliku projektu i zapisaniu projektu na serwerze, Workspace automatycznie zmienia parametr Name zarządzanego projektu, aby go dopasować.

I odwrotnie, gdy nazwa zarządzanego projektu jest aktualizowana za pośrednictwem interfejsu przeglądarki Workspace, zmiana jest propagowana do Altium Designer, gdy projekt jest otwierany po raz kolejny.

Aby edytować właściwości istniejącego projektu zarządzanego w Workspace, wybierz jego wpis na stronie, kliknij kontrolkę powyżej Projects na stronie, kliknij kontrolkę znajdującą się nad listą projektów i wybierz pozycję z powiązanego menu Edit w powiązanym menu. Zmień nazwę projektu w wyświetlonym oknie Edit Project wyświetlonym oknie.

Gdy zaktualizowany projekt zostanie otwarty w Altium Designer (File » Open Project), początkowe okno dialogowe zapewnia opcję dostosowania nazwy lokalnego pliku projektu do nowej nazwy projektu lub wymuszenia dopasowania nazwy projektu serwera do istniejącej nazwy pliku projektu.

Opcje dostępne po zmianie nazwy projektu po stronie Workspace.

Współdzielenie dokumentów pomiędzy projektami

Ponieważ projekt Altium Designer definiuje i zapisuje łącza do przechowywanych plików dokumentów, można utworzyć dowolną liczbę projektów, które łączą się z tymi samymi plikami dokumentów.

Chociaż może to być wygodny sposób na ponowne wykorzystanie ustalonych dokumentów projektowych - powiedzmy, w tym standardowego schematu zasilania w kilku projektach - nie jest to zalecana praktyka, ponieważ zmiana w dokumencie wpłynie na wszystkie projekty, z którymi jest powiązana. Znacznie lepszym podejściem do ponownego wykorzystania projektu jest ustanowienie i zastosowanie Managed Sheets.

Więcej informacji na temat ponownego wykorzystania dokumentów projektowych i zarządzanych arkuszy schematów można znaleźć na stronie Praca z zarządzanymi arkuszami schematów.

Zarządzanie brakującymi dokumentami

Jeśli dokument projektu zdefiniowany w pliku projektu nie zostanie znaleziony w folderze projektu (na przykład dokument został usunięty z Eksploratora Windows), zostanie on uznany za brakujący. Po otwarciu projektu zawierającego brakujący plik, odpowiednie powiadomienie zostanie wyświetlone w panelu Messages w panelu. Wpis dokumentu zostanie wyszarzony i oznaczony jako brakujący ikoną wyróżniającą w panelu Projects panelu.

Dostępne są powiązane polecenia, które zapewniają pełną kontrolę nad obsługą brakujących dokumentów. Użyj menu po kliknięciu prawym przyciskiem myszy brakującego dokumentu w panelu Projects aby usunąć wybrane lub wszystkie brakujące pliki z projektu lub zaktualizować ścieżkę do pliku (tj. zastąpić brakujący plik wybranym). W przypadku projektu pod kontrolą wersji można również przywrócić lokalne modyfikacje, aby przywrócić brakujący plik z repozytorium VCS projektu.

Podczas dodawania istniejącego pliku do projektu za pomocą polecenia Add Existing to Project z menu prawego przycisku myszy wpisu projektu, a nazwa i ścieżka dodawanego pliku są takie same jak nazwa i ścieżka brakującego pliku (co jest możliwe, gdy na przykład brakujący plik został dodany do folderu projektu po otwarciu projektu w Altium Designer), otworzy się okno dialogowe potwierdzenia z pytaniem, czy chcesz zastąpić brakujący plik wybranym.

Porównywanie lokalnych dokumentów z danymi zatwierdzenia lub wydania

W przypadku projektów hostowanych przez obszar roboczy można porównać lokalnie zapisane dokumenty schematu, PCB i BOM z danymi zatwierdzenia lub wydania tego projektu. Polecenia wyboru wymaganego zestawu danych, z którym mają być porównywane dokumenty lokalne, można wybrać z następujących lokalizacji:

• Menu History & Version Control » Compare To menu prawego przycisku myszy dokumentu projektu w panelu Projekty.
• Menu przycisku Compare w oknie dialogowym Zapisz na serwerze.
• Menu sterowania na kafelku Local Changes kafelka widoku Historia projektu.

❯ ❮ IdentyfikatorJavascript: LocalCompare_AD24

• Kiedy Latest Commit lub Latest Release rozpocznie się porównywanie danych projektu z danymi z ostatniego wpisu commit/release.
• Po wybraniu polecenia Select Document Version or Release (z panelu Projects panelu) lub Select Commit or Release (z okna dialogowego Save to Server okna dialogowego) zostanie wybrany przycisk Document History lub Project History dla wybranego dokumentu/projektu. Wybierz kafelek zatwierdzenia lub wydania, aby porównać lokalnie zapisane dane z danymi tego zatwierdzenia/wydania.

Po zakończeniu wyniki porównania są prezentowane w widoku Porównaj, który otwiera się jako nowa karta w domyślnej przeglądarce.

Panel schowka

Aby przechowywać i wyświetlać skopiowane obiekty, które mogą być dodane (wklejone) do dokumentów Altium Designer na dowolnym etapie, umożliwiając wielokrotne operacje kopiowania/wklejania, można użyć panelu Clipboard można użyć panelu.

Wyświetlanie i stosowanie (wklejanie) Clipboard zawartość panelu dla wszystkich typów danych projektowych.