Przeglądanie otwartych treści za pomocą panelu Projects w CircuitMaker

Przycisk Projects otwiera panel Projects, który wyświetla wszystkie aktualnie otwarte projekty wraz z ich dokumentami składowymi. Polecenie jest dostępne z dowolnego edytora po wybraniu View | System | Projects.

Drzewo dokumentów projektu

Gdy otworzysz istniejący projekt lub utworzysz nowy, jego wpis pojawi się w panelu. Wszelkie istniejące dokumenty należące do projektu (oraz nowe, które zostały dodane) będą widoczne w podfolderach zgodnie z ich przeznaczeniem i/lub typem. Na przykład pod projektem mogą pojawić się następujące typowe foldery i typy dokumentów:

• Source Documents – podstawowe dokumenty projektowe, takie jak schematy, PCB itp.
• Settings – udostępnia różne pliki używane w projekcie, takie jak Harness Definitions Files.
• Documentation – dodatkowe dokumenty dodane do projektu (np. tekst, PDF itp.).
• Other Documents – dodatkowe dokumenty dodane do projektu. Mogą one zostać otwarte przez CircuitMaker, jeśli aplikacja jest znana systemowi Windows (np. dokumenty Word, arkusze Excel itp.).
• Generated – dokumenty generowane jako wyniki, takie jak raporty ERC i DRC.
• Components – wyświetla listę każdego komponentu pogrupowaną według pierwszej litery w oznaczeniu oraz liczbę komponentów, których oznaczenie zaczyna się od tej litery w projekcie. Zweryfikuj projekt, jeśli ten folder się nie pojawia.
• Nets – wyświetla listę każdej sieci użytej w projekcie. Zweryfikuj projekt, jeśli ten folder się nie pojawia.

Oprócz możliwości jednoczesnego otwarcia wielu dokumentów do edycji, można też mieć otwartych kilka projektów naraz. Mogą to być projekty powiązane lub niepowiązane.

Dokumenty w panelu Projects są automatycznie porządkowane w logiczne grupy lub „foldery”, takie jak dokumenty Source Documents i Settings. 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ć, aby zmienić ich kolejność w obrębie grupy.

W przypadku nowego projektu hierarchicznego w panelu będzie wyświetlana relacja nadrzędny–podrzędny między dokumentami. Zwróć uwagę, że relacji połączeń nie można zdefiniować przez przeciąganie i upuszczanie dokumentów schematów, ponieważ połączenia międzyarkuszowe i hierarchia projektu są w rzeczywistości definiowane przez symbole arkuszy i definicje portów.

Podfoldery dokumentów projektu, niezależnie od tego, czy są rozwinięte czy zwinięte, mają wspólne polecenia w menu pod prawym przyciskiem myszy, które umożliwiają otwieranie, zamykanie, usuwanie i odświeżanie dokumentów.

Bezpośrednia edycja komponentów

Gdy edytowany jest komponent społeczności w panelu Projects, będzie on widoczny pod wpisem My Personal Space. Kliknij komponent prawym przyciskiem myszy, aby uzyskać dostęp do następujących opcji.

• Save to Server – zwalnia aktualnie edytowany komponent i zapisuje go jako kolejną rewizję tego komponentu. To zamyka tymczasowy edytor i usuwa plik tymczasowy.
• Discard Local Changes – anuluje bezpośrednią edycję komponentu i odrzuca wszelkie wprowadzone lokalnie zmiany. To zamyka edytor i usuwa plik tymczasowy bez publikowania zmian wprowadzonych od momentu uruchomienia pierwotnej sesji edycji.

Praca z projektami w panelu

Projekty są wyświetlane w panelu Projects jako wpis My Personal Space z ikoną   obok.

Otwieranie projektu udostępnionego

Projekt udostępniony użytkownikowi CircuitMaker jest dostępny z opcji lokalizacji Shared With Me w oknie dialogowym Open Project. Taki projekt można zapisać i zatwierdzić z powrotem, jeśli przyznano do niego uprawnienia edycji. Aby otworzyć projekt w Web Viewer, wybierz opcję Show in Web Browser z menu kontekstowego (prawy przycisk myszy) wpisu projektu w panelu Projects.

Aktywny a skoncentrowany

W głównym drzewie panelu aktywny projekt jest wyróżniony kolorem aktywnego paska tytułu systemu Windows dla Twojego systemu. Gdy w obszarze projektu nie ma otwartych dokumentów, projekt staje się aktywny po wybraniu go z listy wszystkich aktualnie otwartych (załadowanych) projektów w panelu. Gdy tylko dokument projektu zostanie otwarty (w edytorze/przeglądarce), projekt nadrzędny tego dokumentu automatycznie staje się projektem aktywnym.

Aktywny dokument w obszarze projektu również będzie wyróżniony w panelu i będzie mu towarzyszyć ikona otwartego pliku, jak pokazano poniżej.

Gdy w obszarze projektu nie ma otwartych dokumentów, otwarcie dodatkowego projektu automatycznie uczyni go projektem aktywnym w panelu.

Gdy w obszarze projektu jest otwartych wiele dokumentów, zmiana aktywnego dokumentu za pomocą kart dokumentów w edytorze spowoduje, że panel Projects zaktualizuje się odpowiednio, aby odzwierciedlić zarówno aktywny dokument, jak i aktywny projekt (jeśli uaktywniony dokument nie należy do tego samego projektu co poprzednio aktywny dokument). Z kolei kliknięcie wpisu dokumentu, który jest już otwarty (i należy do nieaktywnego projektu), spowoduje, że projekt nadrzędny tego dokumentu stanie się projektem aktywnym.

W danym momencie aktywny może być tylko jeden projekt i jeden dokument, jednak panel pozwala skupić się i wykonywać działania na dowolnym projekcie lub dokumencie. Kliknięcie prawym przyciskiem myszy wpisu nieaktywnego projektu lub nieaktywnego dokumentu wyświetli powiązane menu z poleceniami dotyczącymi skoncentrowanego projektu lub skoncentrowanego dokumentu. Zobacz sekcję Right-click Menus poniżej.

W przypadku dokumentu focusing dokument stanie się skoncentrowany tylko wtedy, gdy jest zamknięty; w przeciwnym razie stanie się dokumentem aktywnym, a jego projekt nadrzędny stanie się projektem aktywnym. Na przykład na poniższym obrazie aktywnym projektem jest GSM Logger.PrjPcb, aktywnym dokumentem jest [7] MG323-B.SchDoc, a skoncentrowanym dokumentem jest [4] 2x16 LCD Module.SchDoc (wyróżniony w panelu niebieską ramką).

Zapisz na serwerze

Gdy plik należący do projektu został zmodyfikowany i zapisany lokalnie, możesz zapisać ten plik do Personal Space z panelu Projects. Zapisz wybrane pliki, klikając prawym przyciskiem myszy projekt i wybierając Save to Server albo wybierając łącze Save to Server obok pliku projektu (.PrjPcb).

Kliknięcie łącza i wybranie polecenia otwiera okno dialogowe Save to Server, w którym możesz wybrać dokumenty do zapisania. Po kliknięciu OK dokumenty są zapisywane do Personal Space, a łącze Save to Server znika z panelu Projects.

Ikony wyświetlania dokumentów

Wpisom dokumentów w panelu towarzyszą ikony dokumentów wskazujące ich stan otwarcia/modyfikacji. Zapewnia to szybkie wizualne podsumowanie, które dokumenty są zmodyfikowane lub zapisane.

Poniżej wymieniono ikony dokumentów i ich znaczenie.

Ikony stanu otwarcia/modyfikacji

[blank]	Dokument jest zamknięty.
	Otwarty – dokument jest otwarty jako dokument w zakładce w oknie edytora projektu.
	Otwarty/zmodyfikowany – dokument jest otwarty i został zmodyfikowany, ale nie został zapisany.

Ikony stanu kontroli wersji

	Brak modyfikacji	Lokalna kopia pliku jest zgodna z plikiem w Personal Space i jest aktualna.
	Zaplanowano dodanie	Plik został dodany do kontroli wersji, ale nie został jeszcze zapisany do Personal Space.
	Zmodyfikowany	Lokalna kopia pliku została zmodyfikowana i zapisana w lokalnej pamięci podręcznej.
	Nieaktualny	Lokalna kopia pliku (w lokalnej pamięci podręcznej) jest starsza niż jej odpowiednik w Personal Space i dlatego jest nieaktualna. Użyj polecenia Update Project, aby pobrać najnowszy plik z Personal Space.
	Zmodyfikowany i zablokowany przez kogoś innego (konflikt)	Ten sam plik został zapisany do Personal Space przez kogoś innego przed Twoją próbą zapisania zmodyfikowanej wersji tego pliku do Personal Space.
	Zaplanowano usunięcie	Plik został lokalnie usunięty z projektu i zostanie usunięty z Personal Space podczas procesu zapisywania projektu do Personal Space. * Pojawia się tylko w oknie dialogowym Save to Server.

Zobacz poniższe sekcje, aby uzyskać więcej informacji o funkcjonalności kontroli wersji i o tym, jak różne sytuacje plików projektu są odzwierciedlane w panelu Projects.

Zarządzanie plikami projektu

Kluczową koncepcją, o której należy pamiętać podczas pracy z CircuitMaker, jest to, że scentralizowany system kontroli wersji stale monitoruje różnicę między lokalnie buforowanymi plikami projektu a ich odpowiednikami w Personal Space.

W odpowiedzi na informacje wymieniane z systemem kontroli wersji CircuitMaker podejmie odpowiednie działania i zmieni dostępne opcje w zależności od tych różnic. Z praktycznego punktu widzenia użytkownika przejawia się to w CircuitMaker w postaci szeregu alertów i ikon plików w panelu Projects oraz zmian w dostępnych poleceniach zarządzania plikami.

Panel Projects pokazujący schemat, który został zmodyfikowany, oraz schemat, który został nowo dodany do projektu.

Funkcjonalność kontroli wersji i jej reakcje można podsumować poprzez następujące sytuacje dotyczące plików projektu.

A project is opened:

• Pliki projektu są pobierane (checked out) z Personal Space i otwierane w CircuitMaker, wypełniając w ten sposób lokalną pamięć podręczną.
• Ponieważ pliki w pamięci podręcznej i w Personal Space są zgodne, panel Projects pokazuje wszystkie pliki jako Not modified – ikoną .

A project is re-opened:

• Pliki projektu już istnieją w pamięci podręcznej i są otwierane przez CircuitMaker.
• System kontroli wersji sprawdza, czy te pliki odpowiadają swoim odpowiednikom w Personal Space:
  • jeśli plik w pamięci podręcznej jest zgodny ze swoim odpowiednikiem w Personal Space, zostaje oznaczony jako Not modified – ikoną .
  • jeśli plik w pamięci podręcznej jest nowszy niż plik w Personal Space, zostaje oznaczony jako Modified – ikoną .
  • jeśli plik w pamięci podręcznej jest starszy niż wersja w Personal Space, projekt zostaje oznaczony jako Out of date – ikoną .

A file is edited and saved:

• Lokalna pamięć podręczna jest aktualizowana edytowaną wersją pliku w momencie jego zapisania.
• Ponieważ plik w pamięci podręcznej jest teraz nowszą wersją niż jego odpowiednik w Personal Space, jest oznaczany jako Modified – ikoną  .

A new file is added to the project:

• Gdy nowy plik zostanie zapisany, jest dodawany do lokalnej pamięci podręcznej.
• Kontrola wersji odnotowuje, że plik nie występuje w Personal Space, i oznacza plik jako Scheduled for addition – ikoną  .

A project is saved to Personal Space:

• Projekt i pliki z lokalnej pamięci podręcznej są dodawane do Personal Space jako nowa wersja projektu.
  • Różnice między lokalną wersją projektu (w pamięci podręcznej) a poprzednią wersją projektu w Personal Space zostaną uwzględnione w nowej wersji poprzez aktualizacje i dodania plików.
• Lokalne wersje plików i wersje w Personal Space są teraz zsynchronizowane (są zgodne) i oznaczone jako Not modified – ikoną  .

Zarządzanie projektowaniem zespołowym

Gdy wielu projektantów CircuitMaker pracuje wspólnie nad jednym projektem, interakcja między wersją projektu każdego użytkownika a jego wersją źródłową w Personal Space staje się nieco bardziej złożona. Na szczęście zautomatyzowana kontrola wersji i jej integracja z CircuitMaker sprawiają, że te potencjalnie katastrofalne interakcje projektowe przebiegają płynnie, bez potrzeby ręcznej interwencji.

Podczas pracy zespołowej z innymi projektantami CircuitMaker działanie kontroli wersji i jej reakcje można podsumować następującymi sytuacjami dotyczącymi plików projektu, oprócz tych opisanych powyżej:

Another user has updated the project:

• Projekt w Personal Space został edytowany i zapisany z powrotem do Personal Space przez innego użytkownika. Wersja w Personal Space jest nowsza niż Twoja lokalna wersja w pamięci podręcznej.
• Twoja lokalna wersja projektu zostanie oznaczona jako Out of date – ikoną  . Jeśli spróbujesz zapisać projekt do Personal Space, zostaniesz poproszony(-a) o zaktualizowanie projektu.
• Użyj polecenia Update, aby zmienić lokalną wersję projektu na nową wersję w Personal Space albo zachować wersję przechowywaną w lokalnej pamięci podręcznej. Kliknij prawym przyciskiem myszy nazwę projektu i wybierz Update Project z menu kontekstowego albo wybierz Home | Project » Update Project.
  • Polecenie Update otwiera okno dialogowe Merge Project , które oferuje wybór: zachowanie lokalnej wersji projektu (Keep working copy version) lub przyjęcie wersji z Personal Space (Keep revision version) – wybierz odpowiednią opcję z listy rozwijanej User Action  w oknie dialogowym albo wybierz opcję z menu Apply for all , aby zastosować ją do wszystkich wpisów plików.
  Aktualizacja projektu z zachowaniem lokalnej wersji zmieni jego stan na Modified , ponieważ mimo że jest teraz aktualny, nadal nie odpowiada wersji w Personal Space. Następnie projekt można zapisać do Personal Space, aby zsynchronizować wersję w Personal Space z Twoją, jednak lokalna wersja drugiego użytkownika będzie teraz nieaktualna.Gdy Twoja lokalna wersja projektu jest starsza niż wersja w Personal Space, można ją zaktualizować tak, aby była zgodna, używając okna dialogowego Merge project .

  Another user has edited, but not saved to the Personal Space, the project:

  • Projekt został edytowany i zapisany lokalnie przez innego użytkownika, ale ten użytkownik not zapisał zmieniony projekt z powrotem do Personal Space.
  • Ten stan projektu to sytuacja oczekującego konfliktu plików, ponieważ między użytkownikami istnieje niezatwierdzona edycja. Sytuacja jest wykrywana przez scentralizowaną kontrolę wersji, co powoduje, że CircuitMaker na Twoim komputerze oznacza plik(i) projektu jako Modified and locked by someone else – ikoną  .
  • W tej sytuacji nie możesz zapisać ani zaktualizować projektu – został on „zablokowany” przez kontrolę wersji. Gdy drugi użytkownik zapisze zmiany do Personal Space, tworząc nową wersję, możesz zaktualizować do tej wersji. Wskazuje to późniejsza zmiana powiązanej ikony projektu na Out of date – ikonę  . Wybierz polecenie Update Project  i w oknie dialogowym Merge Project  wybierz opcję rewizji z Personal Space.

  
  Tutaj widok lokalny pokazuje, że schemat został edytowany i zapisany przez innego użytkownika CircuitMaker, ale użytkownik nie zapisał go jeszcze do Personal Space.

  Uwagi:

  • Podczas aktualizacji, jeśli wybierzesz opcję zachowania wersji local  zmienionego pliku(ów), zamiast przyjęcia nowej wersji z Personal Space, sytuacja między użytkownikami odwróci się. Innymi słowy, ponieważ masz teraz zmodyfikowany plik (względem wersji w Personal Space), który nie został zapisany do Personal Space, wersja pliku drugiego użytkownika zostanie oznaczona jako Modified and locked by someone else – .
  • Zamiast aktualizować projekt, jeśli zdecydujesz się otworzyć sporny plik (oznaczony jako ), zostanie otwarte okno dialogowe z ostrzeżeniem, że plik został zmodyfikowany przez innego użytkownika. O konflikcie zostaniesz ostrzeżony(-a) ponownie, jeśli następnie spróbujesz edytować i zapisać ten plik. Jeśli będziesz kontynuować, plik zmieni wtedy stan na Modified and locked  dla użytkownika other  – on również zobaczy ikonę  .
  • W tym przypadku wersja pliku żadnego z użytkowników nie została zapisana do Personal Space ani nie odpowiada wersji w Personal Space. Ten, kto jako pierwszy zapisze swoją wersję do Personal Space, będzie decydujący, zmuszając pozostałych użytkowników do aktualizacji do nowej wersji w Personal Space albo do kontynuowania edycji w celu utworzenia i zapisania własnej nowej wersji do Personal Space.

  Najedź kursorem myszy na nazwę projektu, pliki i ikony, aby zobaczyć status oraz ewentualne podpowiedzi instruktażowe.

  

  Menu po kliknięciu prawym przyciskiem myszy

  Plik projektu

  Kliknięcie prawym przyciskiem myszy pliku projektu w panelu zapewnia dostęp do dodatkowych opcji i poleceń. Dostępne i wymagane polecenia zależą od dokumentów podrzędnych dodanych do projektu.

  

  Wybory z menu po kliknięciu prawym przyciskiem myszy obejmują:

  • Validate PCB Project – proces walidacji wykrywa naruszenia elektryczne i rysunkowe i jest integralną częścią tworzenia poprawnej netlisty dla projektu.
  • Add New to Project – dodaj nowy, pusty dokument Schematic lub PCB do bieżącego projektu.
  • Add Existing to Project – dodaj istniejący, przechowywany lokalnie dokument Schematic lub PCB do bieżącego projektu. Obsługiwane są także inne typy plików (tekst itp.).
  • Update Project – włączone, gdy lokalna wersja projektu nie jest zgodna z wersją w Personal Space. Umożliwia wybór pobrania wersji projektu z Personal Space lub zachowania wersji lokalnej. Dowiedz się więcej.
  • Save Project to Server – otwiera okno dialogowe Save to Server dialog, z którego możesz zapisać pliki zmodyfikowane i zapisane lokalnie.

  • Revert Project – otwiera okno dialogowe Revert project, za pomocą którego możesz przywrócić bieżący dokument projektu do wybranej rewizji. Wybierz rewizję w Revision list u góry okna dialogowego. Lista zmodyfikowanych plików dla wybranej rewizji zostanie pokazana w Modified file list na dole okna dialogowego.

    

  • Save – zapisz bieżący dokument projektu do lokalnej pamięci podręcznej projektu. Dokumenty zapisane lokalnie (jeśli są dostępne) są pobierane z pamięci podręcznej po ponownym otwarciu projektu.
  • Clone – użyj, aby otworzyć okno dialogowe Clone Project dialog, którego możesz użyć do skopiowania projektu. Domyślnie zostanie użyta oryginalna nazwa projektu z sufiksem „- Copy”.
  • Close Project Documents – służy do zamknięcia wszystkich aktualnie otwartych dokumentów powiązanych z aktywnym projektem.
  •  

     

     

     

     

    Close Project – zamyka projekt i wszystkie aktywne dokumenty projektu. Jeśli projekt zawiera dokument, który został zmodyfikowany, ale nie zapisany lokalnie, otrzymasz monit o jego zapisanie. Jeśli projekt zawiera co najmniej dwa dokumenty, które zostały zmodyfikowane, zostanie otwarte okno dialogowe Confirm Save for Modified Documents. Użyj listy rozwijanej w kolumnie Decision, aby wybrać konkretne dokumenty do zapisania, lub użyj przycisków Save All / Save None w lewym dolnym rogu okna dialogowego, aby wybrać działanie dla wszystkich wymienionych dokumentów.

    

  • Generate Outputs – służy do generowania wyników projektu oraz do wydania projektu do Personal Space.
  • Variants – otwiera okno Variants Management dialog, w którym można zdefiniować warianty projektu bazowego.
  • Show in Web Browser – służy do otwarcia projektu w Web Viewerze Altium 365 w domyślnej przeglądarce internetowej.
  • Share – służy do otwarcia okna Share dialog, które umożliwia udostępnianie projektów projektowych konkretnemu użytkownikowi poprzez e-mail.
  • Project Options – otwiera okno Project Options dialog dla tego projektu, w którym można ustawić konfiguracje ostrzeżeń dotyczących błędów i różnic, generowania ECO, ścieżek plików itp., które nadpisują domyślne ustawienia instalacji.

  Plik dokumentu

  Kliknięcie prawym przyciskiem myszy pliku dokumentu w panelu zapewnia dostęp do dodatkowych opcji i poleceń.

  

  Wybory dostępne po kliknięciu prawym przyciskiem obejmują:

  • Close – zamknięty dokument nie będzie już otwarty w edytorze projektu. Jeśli dokument został zmodyfikowany, ale nie został zapisany lokalnie, pojawi się monit o jego zapisanie.
  • Save – zapisz dokument lokalnie.
  • Rename – zmień nazwę dokumentu.
  • Delete – służy do wykluczenia dokumentu z projektu nadrzędnego.

  • Revert – otwiera okno Revert project dialog, za pomocą którego można przywrócić bieżący dokument projektu do wybranej rewizji. Wybierz rewizję w Revision list.

    

  • Page Setup / Print Preview / Print – zarządzaj drukowaniem dokumentu. Więcej informacji: Print.
  • Show Differences – wykrywaj i rozwiązuj niespójności w strukturze projektu lub różnice między dwoma plikami projektu. Więcej informacji: Show Differences.

  Uwagi

  • Dokumenty można przenosić między projektami w panelu, klikając i przeciągając. Dokument nie musi być przeciągany do właściwego podfolderu. Zostanie automatycznie umieszczony we właściwym miejscu w strukturze projektu.
  • Skróty klawiaturowe Up Arrow, Home, End i Down Arrow mogą być używane do wyświetlenia odpowiednio poprzedniego, pierwszego, ostatniego i następnego wpisu w panelu. Użyj klawiszy Right Arrow i Left Arrow, aby odpowiednio rozwinąć lub zwinąć wpis najwyższego poziomu albo jego podfolder.