Projekty obszaru roboczego

Parent page: Altium On-Prem Enterprise Server

Altium Designer, w połączeniu z Workspace Enterprise Server, zapewnia obsługę Workspace Projects. Projekty Workspace są ukierunkowane na etap rozwoju w cyklu życia projektu, upraszczając tworzenie oraz bieżący przepływ pracy dla projektów objętych kontrolą wersji. Scentralizowane przechowywanie pod kontrolą Workspace umożliwia również, aby ta funkcja stanowiła fundament dla innych usług współpracy.

Najważniejsze korzyści z używania projektów Workspace to:

• Uproszczone przechowywanie. Nie ma potrzeby podejmowania decyzji o lokalizacjach składowania. Kopie zapasowe i inne podstawowe usługi są zapewnione.
• Podstawa dla funkcji współpracy.
• Wymuszona kontrola wersji.
• Zalety dedykowanego systemu komentowania.
• Powiadomienia i status. Status dokumentu, w tym lokalne modyfikacje, jest widoczny dla całych zespołów projektowych.
• Równoległe projektowanie PCB działa bez skomplikowanej konfiguracji.
• Możliwość udostępnienia innym użytkownikom tylko do odczytu, przeglądarkowego interaktywnego widoku projektu za pośrednictwem Web Viewer.
• Szereg zaawansowanych funkcji kontroli wersji, takich jak interaktywny widok Project History.

Od strony technicznej projekt Workspace to połączenie metainformacji przechowywanych w Workspace Enterprise Server oraz ścisłej integracji z własną usługą Version Control service w Workspace. Typowy przepływ pracy wygląda następująco:

1. Użytkownik tworzy nowy projekt Workspace za pomocą Create Project okna dialogowego w Altium Designer, poprzez konwersję istniejącego projektu lokalnego za pomocą Make Available On Server okna dialogowego, lub z poziomu interfejsu przeglądarkowego Workspace (szczegóły poniżej). Podczas tworzenia użytkownik definiuje nazwę projektu, opis oraz repozytorium projektowe.
2. Dostęp do projektu jest definiowany i zarządzany w przeglądarkowym interfejsie Workspace lub bezpośrednio w Altium Designer.
3. Wszyscy współpracownicy wybierają projekt do otwarcia (z poziomu Altium Designer lub z interfejsu przeglądarkowego Workspace), po czym jest on automatycznie pobierany jako pliki projektowe (checked out).

Ten dokument omawia pracę z projektami poprzez interfejs przeglądarkowy Workspace Enterprise Server. Informacje o pracy z projektami w oprogramowaniu projektowym znajdują się w Getting Familiar with the Altium Design Environment.

Tworzenie nowego projektu Workspace

Istnieje kilka sposobów utworzenia projektu Workspace:

• Utworzenie nowego projektu z przeglądarkowego interfejsu Workspace lub z poziomu Altium Designer.
• Udostępnienie istniejącego projektu (projektu lokalnego lub projektu lokalnego aktualnie objętego zewnętrzną kontrolą wersji) w Workspace z poziomu Altium Designer – czyli konwersja projektu lokalnego na projekt Workspace. Więcej informacji na stronie Making an Existing Project Available in the Workspace .
• Klonowanie istniejącego projektu Workspace poprzez przeglądarkowy interfejs Workspace lub przez klonowanie projektu z panelu Projects w Altium Designer.
• Wgrywanie projektu lokalnego z przeglądarkowego interfejsu Workspace.

Aby utworzyć projekt Workspace bezpośrednio w przeglądarkowym interfejsie Workspace:

1. Zaloguj się do interfejsu i wybierz opcję menu Projects, aby przejść do strony Designs . Wszelkie wcześniej utworzone projekty będą tutaj wyświetlone.

2. Kliknij przycisk u góry strony, a następnie opcję menu Create Project, aby otworzyć okno Create Project .

   Jeśli dostępne są jakiekolwiek aktywne process definitions dla motywu procesu Project Creations – zdefiniowane na karcie Project Creations na stronie Processes w przeglądarkowym interfejsie Workspace – wówczas menu przycisku zaoferuje te procesy jako opcje zamiast opcji Create Project. Wybierz wymagany wpis, aby uruchomić przepływ pracy tego procesu.

3. Okno początkowo zostanie wyświetlone w widoku uproszczonym. Wprowadź żądaną nazwę projektu, opis (jeśli potrzebny) oraz wybierz odpowiedni Project Template z listy rozwijanej Templates.

   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ą być użyte tylko w środku nazwy (początkowe i końcowe spacje zostaną zignorowane). Nie można użyć 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: \ . / ? % * : | " < >.
4. Aby uzyskać dostęp do większej liczby ustawień, kliknij przycisk . Zostaną wyświetlone następujące pola:
   1. Parent Folder – użyj tego pola, aby określić, gdzie w strukturze folderów Workspace ma zostać utworzony folder projektu. Domyślnie będzie to Projects\<ProjectName>. Domyślna ścieżka dla nowych projektów jest określona na stronie Admin – Settings – Projects w interfejsie przeglądarkowym Workspace.

   2. Repository – to pole wyświetla wszystkie repozytoria projektowe zarządzane przez lokalną usługę Version Control w Workspace, które zostały Ci udostępnione do użycia. Wybierz repozytorium, w którym mają być przechowywane nowy projekt i jego pliki. Domyślnie wybrane będzie repozytorium Versioned Storage (oparte na Git).

      Jeśli zaktualizowano do Enterprise Server z wcześniejszej technologii serwerowej i nadal istnieje możliwość używania wewnętrznych (SVN) i/lub zewnętrznych (SVN/Git) repozytoriów projektowych, zostanie wyświetlone pole Repository . Zawiera ono listę wszystkich repozytoriów projektowych zarządzanych przez lokalną usługę Version Control w Workspace, które zostały Ci udostępnione do użycia. Wybierz repozytorium, w którym mają być przechowywane projekt i jego pliki. Jeśli wybrane zostanie repozytorium oparte na SVN, zostanie wyświetlone pole Repository Folder. Użyj go, aby określić nazwę folderu w repozytorium, w którym ma zostać umieszczony projekt i powiązane pliki. Domyślnie będzie to nazwa projektu.

Definiowanie nowego projektu Workspace bezpośrednio w przeglądarkowym interfejsie Workspace.

Po zdefiniowaniu nowego projektu zgodnie z potrzebami kliknij – nowy projekt zostanie utworzony. Wrócisz do listy projektów na poziomie podsumowania, gdzie zobaczysz wpis dla nowo utworzonego projektu.

Dodatkowy projekt Workspace utworzony poprzez interfejs przeglądarkowy.

Przeglądanie projektów Workspace

Lista projektów na stronie Projects w przeglądarkowym interfejsie Workspace obejmuje wszystkie projekty, które zostały Ci udostępnione, i oferuje zestaw narzędzi do korzystania z funkcji zarządzania projektami. Użyj przycisku  , aby przełączyć stronę w tryb podglądu projektów (kafelki graficzne), oraz przycisku , aby przełączyć stronę w tryb szczegółowej listy.

Strona Designs w przeglądarkowym interfejsie Workspace – centrum dowodzenia do pracy z projektami Workspace. Tutaj pokazano tryb szczegółowej listy. Najedź kursorem na obraz, aby zobaczyć tryb podglądu projektów.

Wpisy projektów w widoku są automatycznie sortowane według daty Last modified, przy czym ostatnio modyfikowany projekt pojawia się jako pierwszy na liście. Kliknij przycisk , aby zmienić sortowanie na według nazwy projektu, a następnie kliknij ponownie, aby przełączać między kolejnością rosnącą i malejącą.

Widok w trybie listy () można sortować według Name, Author lub Date, używając w każdym przypadku nagłówka kolumny. Kliknij raz, aby sortować rosnąco, kliknij ponownie, aby sortować malejąco. Strzałki po prawej stronie nazwy kolumny wskazują aktualnie aktywny kierunek sortowania.

Widok Projects udostępnia dane Properties i Activities dotyczące wybranego projektu, dostępne w panelu bocznym po prawej stronie widoku.

Informacje w panelu bocznym obejmują: PropertiesKarta : Project – ogólne podsumowanie stanu projektu, w tym widok 3D płytki (jeśli dla projektu dostępna jest PCB). Shared With – użytkownicy i/lub role mające dostęp do projektu. Najedź kursorem na wpis, aby zobaczyć pełną nazwę użytkownika/roli. Parameters – szczegółowe metadane wyodrębnione lub obliczone na podstawie samego projektu. Kliknij kontrolkę Show More, aby rozwinąć pełną listę. Where Used – lista innych projektów, takich jak Multi-board projects, które zawierają treść tego projektu. Kliknij wpis, aby otworzyć i wyświetlić ten projekt w nowej karcie przeglądarki. Releases – lista wydań projektu w porządku chronologicznym. Kliknij wpis, aby otworzyć to wydanie w Manufacturing Portal w Workspace. Activity karta – chronologiczna lista zdarzeń projektu, takich jak Commit, Release lub ukończony przebieg procesu (workflow) powiązany z projektem.

Dla każdego projektu dostępne są również następujące operacje, realizowane przyciskami u góry widoku (i opisane szczegółowo w powiązanych sekcjach poniżej):

• Share – kontrola dostępu służąca do konfigurowania uprawnień dostępu do projektu.
• Functions – dostęp do funkcji projektu z menu. Dostępne także z przycisku dla wybranego projektu w trybie Preview:
  • Open – otwórz projekt w jego szczegółowym widoku zorientowanym na CAD. Odpowiada kliknięciu (tryb Preview) lub dwukrotnemu kliknięciu (tryb List) wpisu nazwy projektu.
  • Move – przenieś projekt do innego folderu nadrzędnego w strukturze folderów Workspace.
  • Edit – edytuj projekt w zakresie jego Name, Description oraz Workspace Parameters.
  • Clone – utwórz identyczną kopię projektu z nową nazwą.
  • Watch/Unwatch – obserwuj/nie obserwuj aktywności projektu, otrzymując powiązane powiadomienia (aktualizacje, wydania itp.) na karcie Activitiy projektu, a także e-mailem, jeśli włączono Email Notifications.
  • Delete – usuń wpis projektu, przenosząc jego strukturę i dane do Workspace Trash, skąd można je trwale usunąć z Workspace lub przywrócić do poprzedniego stanu.

Dostępna jest także funkcja Search projektu, która umożliwia filtrowanie listy projektów według zakresu właściwości, takich jak Name, Author, Description itd. Wpisz dowolną część wyszukiwanego ciągu w polu u góry interfejsu przeglądarki. Lista zostanie zaktualizowana tak, aby zawierała tylko te wpisy projektów, których atrybuty obejmują wyszukiwany ciąg.

Aby wyczyścić filtrowanie wyszukiwania, kliknij główny wpis strony Projects w lewym panelu nawigacji albo wyczyść pole wyszukiwania i naciśnij Enter.

Przykład użycia funkcji wyszukiwania – w tym przypadku znalezienie projektu na podstawie jego Description.

Praca z folderami Workspace

Workspace umożliwia także tworzenie i zarządzanie folderami projektów w ramach swojej struktury. Projekty można następnie tworzyć w dowolnym folderze lub przenosić do dowolnego folderu w powstałej hierarchii.

Aby utworzyć nowy folder pod (domyślnym) folderem najwyższego poziomu Project, wybierz opcję Create Folder z menu przycisku . W kolejnym oknie Create Folder podaj nazwę nowego folderu, jego folder nadrzędny oraz opcjonalny opis. Nowy folder jest zawsze tworzony pod aktualnie wybranym folderem, który staje się jego folderem nadrzędnym.

Otwórz utworzony folder, wybierając jego tytuł, a do wyższych poziomów hierarchii wracaj, korzystając z okruszków nawigacyjnych (breadcrumbs) u góry.

Użyj opcji menu , aby zmodyfikować szczegóły folderu (Edit), przenieść folder pod inny folder nadrzędny (Move) lub usunąć folder ze struktury folderów Workspace (Delete). Podczas przenoszenia folderu wybierz nowy folder nadrzędny z drzewa hierarchii w oknie Move folder <folder> to.

Przesyłanie projektu

W Altium Designer polecenie Make Available on Server prześle lokalny projekt do Workspace, gdzie stanie się projektem Workspace objętym kontrolą wersji. Równoważny proces można wykonać w interfejsie przeglądarkowym Workspace, korzystając z opcji Upload Project dostępnej w menu przycisku . Przejdź do folderu hostującego lokalny projekt i wybierz go, aby przesłać projekt domyślnie do aktualnie wybranego folderu Workspace, albo użyj opcji Change na liście Parent Folder w oknie Upload Project, aby wskazać alternatywną lokalizację w hierarchii folderów.

Wszelkie istniejące powiązania kontroli wersji w lokalnym projekcie są ignorowane, a przesłany projekt staje się w pełni wersjonowanym projektem Workspace – lokalny projekt źródłowy nie jest w żaden sposób modyfikowany.

Przenoszenie projektu

Aby przenieść projekt do innego folderu Workspace, wybierz opcję Move z listy rozwijanej menu i wskaż nową lokalizację w hierarchii folderów w oknie Move project <project> to. Po potwierdzeniu przyciskiem wybrany projekt będzie hostowany pod nowo określonym folderem nadrzędnym.

Udostępnianie projektu Workspace

Gdy projekt znajduje się w Workspace, warto określić, którzy użytkownicy faktycznie mogą uzyskać do niego dostęp. Realizuje się to przez udostępnienie projektu, a dokładniej – przez skonfigurowanie jego uprawnień dostępu. Projekt Workspace jest domyślnie udostępniany następującym podmiotom:

• Właścicielowi projektu, którym zwykle jest projektant, który go utworzył (lub udostępnił w Workspace): pełne uprawnienia dostępu (Read/Write).
• Grupie ról Administrators: pełne uprawnienia dostępu (Read/Write).Wszystkim członkom Workspace: z dostępem tylko do podglądu.

Domyślne uprawnienia dla nowych projektów można zdefiniować/zmienić na stronie Admin – Settings – Projects w interfejsie przeglądarkowym Workspace. Zwróć uwagę, że właściciel projektu ma z natury przypisane uprawnienia dostępu, dlatego nie jest widoczny na liście.

Konfigurację uprawnień dostępu można wykonać w interfejsie przeglądarkowym Workspace, a także bezpośrednio w Altium Designer.

Aby skonfigurować dostęp do projektu z poziomu interfejsu przeglądarkowego Workspace, wybierz wpis projektu na stronie Designs  (Projects w menu głównym) i kliknij przycisk , aby otworzyć okno Share:<project> – albo wybierz opcję Share z menu powiązanego z wpisem projektu. Zapewnia to wszystkie elementy sterujące potrzebne do udostępnienia projektu innym użytkownikom lub grupom użytkowników (Roles).

Gdy projekty są centralnie zarządzane w Workspace, udostępnianie innym sprowadza się do zarządzania uprawnieniami każdego projektu.

W oknie Share <project>:

• Użytkownik/rola ma dostęp Read/Write, gdy włączona jest opcja Can Edit. Jeśli ta opcja jest wyłączona, ma tylko dostęp Read.
• Projekt można udostępnić wszystkim członkom Workspace z dostępem tylko do odczytu (Can View) lub odczytu/zapisu (Can Edit), korzystając z menu rozwijanego wpisu Workspace Members w obszarze Shared With.
• Aby odebrać istniejącemu użytkownikowi/roli współdzielony dostęp do projektu, kliknij opcję Remove w powiązanym menu rozwijanym.

Warto pamiętać o następujących kwestiach:

• Domyślnie wszyscy użytkownicy Workspace będą mogli zobaczyć projekt. Jeśli chcesz ograniczyć dostęp do określonego zestawu użytkowników i/lub grup, musisz najpierw wybrać No access w menu rozwijanym wpisu Workspace Members .
• Właściciel projektu ma stały dostęp Read/Write.
• Możesz także udostępnić bezpośredni link do projektu. Link uzyskuje się, klikając kontrolkę Copy Link na dole okna Sharing. Link zostaje skopiowany do schowka. Po użyciu zapewnia uprawnionemu użytkownikowi dostęp do szczegółowej strony zarządzania projektem, której przegląd przedstawiono w następnej sekcji.

Aktywności projektów w Workspace

Workspace oferuje unikalną możliwość stosowania konfigurowalnych Process Workflows do projektów w Workspace w celu wykonywania dopasowanych zadań, takich jak przeprowadzanie przeglądów projektu i tworzenie nowych projektów. Procesy oraz ich bazowe Workflows są tworzone i konfigurowane przez administratora Workspace, a po włączeniu stają się dostępne dla użytkowników zarówno Altium Designer, jak i interfejsu przeglądarkowego Workspace.

► Zobacz Creating & Managing Processes, aby uzyskać więcej informacji.
► Zobacz Performing Design Reviews, aby uzyskać informacje o tych procesach w Altium Designer.

Z perspektywy użytkownika Process Workflows i ich wbudowane kroki są traktowane jako Activities. Dostępne aktywności mogą być uruchamiane przez użytkowników, a kroki workflow realizowane przez przypisanych użytkowników jako sekwencja zadań – dostępnych na stronie Tasks page.

Wybierz menu na stronie Designs (Projects) i wybierz jeden z dostępnych procesów, aby zainicjować aktywność dla aktualnie wybranego projektu. Uzupełnij wymagane pola i opcje w kolejnych oknach formularza procesu, a następnie uruchom proces (). W zależności od uruchomionego Process Workflow, kolejny krok może wymagać przesłania (), aby przygotować dane do przeglądu.

Następnie tworzone są zadania workflow dla użytkownika lub użytkowników przypisanych do aktywności. Zadanie dotyczące zalogowanego użytkownika pojawi się na stronie Tasks page, gdzie można je wykonać, aby przejść z workflow do następnego etapu.

Uwaga: jeśli aktywność została przypisana do grupy ról – Engineers na przykład – powiązane zadanie staje się dostępne dla wszystkich członków tej grupy, a także dla wszystkich indywidualnych użytkowników przypisanych do aktywności. W takich przypadkach każdy z tych użytkowników może wykonać krok przeglądu i przesłać wynik ().

Funkcje projektów w Workspace

Operacje funkcjonalne związane z projektami są dostępne z menu na stronie Designs  i obejmują możliwość otwierania, przenoszenia, edycji, klonowania, obserwowania i usuwania projektu w Workspace. Menu jest również dostępne z przycisku dla wybranego wpisu projektu:

Otwieranie projektu

Wybierz opcję Open z menu wpisu projektu lub z górnego menu , aby otworzyć projekt w jego zorientowanym na wytwarzanie, CAD-centrycznym widoku – albo, będąc w trybie Preview (), kliknij nazwę projektu. Widok zapewnia dostęp do kilku podwidoków dostępnych z panelu nawigacyjnego:

• Design – nawiguj i wchodź w interakcję z dokumentami projektowymi, sprawdzaj właściwości obiektów i umieszczaj komentarze do przeglądu. Widok dotyczy bieżącej (najnowszej) rewizji projektu i korzysta z interfejsu Web Viewer.
• Tasks – przeglądaj i korzystaj z interfejsu typu flow, który prezentuje wszystkie Tasks (zadania aktywności) dotyczące bieżącego projektu.
• Releases – przeglądaj informacje podsumowujące o wszystkich Releases dla bieżącego projektu, z których każdy można otworzyć w widoku Manufacturing Portal . Ten z kolei udostępnia podwidoki dla plików pakietu wydania, dokumentów projektowych oraz danych zaopatrzeniowych w wybranym wydaniu.
• Activities – przeglądaj aktywne lub zamknięte Process workflow Activities dotyczące bieżącego projektu.
• History – przeglądaj postępującą oś czasu głównych zdarzeń związanych z projektem, w tym jego utworzenie, commity, wydania i klony. Za każdym razem, gdy wystąpi obsługiwane zdarzenie powiązane z projektem, jest ono dodawane do osi czasu jako osobny kafelek z różnymi akcjami (takimi jak porównania danych projektowych), jeśli mają zastosowanie.

► Zobacz Management of a Specific Project, aby uzyskać więcej informacji.

Edycja projektu

Aby edytować właściwości istniejącego projektu w Workspace, wybierz jego wpis na stronie Designs  (Projects), a następnie opcję Edit z menu lub z górnego menu . W kolejnym oknie Project Editing możesz zmienić Name i Description projektu oraz zarządzać wpisami Workspace Parameters.

Kliknij przycisk w oknie Project Editing, aby wyświetlić dodatkowe dane właściwości pochodzące z projektu i przechowywane wraz z nim. Wybierz kontrolkę Parameters, aby uzyskać dostęp i dodać (), edytować lub usunąć () pary parametrów Nazwa/Wartość. Są one zapisywane w Workspace razem z projektem i mogą być używane jako Special Strings w Altium Designer – dostępne z panelu Properties, gdy w obszarze projektu zaznaczony jest umieszczony obiekt tekstowy . Dla porównania, parametry typu projektu są zapisywane w pliku projektu (*.PrjPcb) i mogą być edytowane w Altium Designer.

Klonowanie projektu

Aby sklonować (zduplikować) istniejący projekt w Workspace, wybierz jego wpis na stronie Designs (Projects), a następnie opcję Clone z menu lub z górnego menu . Użyj okna Clone Project, aby ustawić nazwę i opis sklonowanego projektu – domyślnie zostanie użyta oryginalna nazwa projektu z sufiksem - Copy.

Kliknij przycisk , aby wyświetlić dodatkowe pola właściwości, w tym docelowy folder nadrzędny oraz informacje o repozytorium. Ustawienie folderu docelowego automatycznie dopasuje się do nazwy projektu, chyba że zostanie ręcznie określone lub przypisane do innego istniejącego folderu nadrzędnego za pomocą opcji Change.

Projekt można sklonować w Altium Designer z opcji Clone w menu w panelu Explorer panel, albo klikając prawym przyciskiem myszy nazwę projektu w panelu Projects panel i wybierając opcję Clone z menu kontekstowego.

Po ustawieniu pól zgodnie z wymaganiami kliknij przycisk , aby potwierdzić. Oryginalny projekt zostanie sklonowany (zduplikowany) wraz z jego plikami składowymi i danymi, a następnie dodany jako nowy wpis projektu do listy na stronie Projects.

Obserwowanie projektu

Aby „obserwować” – otrzymywać powiadomienia dotyczące – projektu w Workspace, wybierz jego wpis na stronie Designs (Projects), a następnie opcję Watch z menu lub z górnego menu .

Gdy obserwujesz projekt, będziesz otrzymywać powiadomienia związane z projektem (takie jak komunikaty o commitach, wydaniach i zmianach właściwości) w zakładce Activities w prawym panelu interfejsu. Twórca projektu zostanie automatycznie ustawiony jako obserwujący ten projekt. Po włączeniu polecenie zmieni się na Unwatch – wybierz je, aby przestać obserwować projekt i zaprzestać otrzymywania powiadomień o zdarzeniach dotyczących tego projektu.

Usuń projekt Workspace

Aby usunąć (skasować) istniejący projekt Workspace, wybierz jego pozycję na stronie Designs  (Projects), a następnie wybierz opcję Delete z menu tego projektu lub z górnego menu . Działanie to jest w praktyce „miękkim usunięciem” (soft delete), w ramach którego repozytorium projektu zostaje przeniesione do obszaru Trash w Workspace. Projekt można usunąć w Altium Designer, korzystając z opcji Delete w menu w panelu Explorer.

Z poziomu tego widoku (wybierz Trash z menu głównego) wpis projektu można usunąć całkowicie (Permanently Delete) albo cofnąć tę operację (Restore). Zwróć uwagę, że przycisk usunie wszystkie wpisy (tam, gdzie to możliwe) przechowywane w Koszu Workspace.