Historia projektu

Parent page: Projekty w obszarze roboczym

Obszar roboczy Enterprise Server zapewnia eleganckie rozwiązanie potrzeby historycznego przeglądu aktywności projektu w postaci dedykowanego, interaktywnego widoku History. Dostępny przez interfejs przeglądarkowy obszaru roboczego lub z poziomu Altium Designer, widok projektu History udostępnia postępującą oś czasu najważniejszych zdarzeń związanych z projektem. Zdarzenia obejmują utworzenie projektu, commity, wydania, klonowania oraz wymiany MCAD, które z kolei – tam, gdzie ma to zastosowanie – oferują polecenia akcji dla zdarzeń.

Dostęp do historii projektu

Dostęp do widoku History dla projektu uzyskuje się z poziomu szczegółowej, zorientowanej na CAD strony zarządzania tym projektem – strony Projects Management. Kliknij opcję History w lewym panelu.

Sama strona Projects Management jest otwierana z głównej strony Projects poprzez dwukrotne kliknięcie wpisu projektu, kliknięcie jego tytułu lub wybranie opcji Open z menu . Więcej informacji: Zarządzanie konkretnym projektem.

Uzyskaj dostęp do historii projektu z poziomu szczegółowej strony zarządzania tym projektem.

Oś czasu historii – przegląd

Widok History przedstawia oś czasu podstawowych zdarzeń, które wystąpiły w trakcie rozwoju projektu. Można go zasadniczo podzielić na trzy kluczowe elementy, jak pokazano na poniższym obrazie i w informacjach.

Identyfikacja trzech kluczowych komponentów widoku History .

1. Main trunk of the timeline. Kierunek chronologii zdarzeń jest od dołu do góry. Pierwsze zdarzenie – utworzenie projektu – pojawi się na dole osi czasu. Kolejne zdarzenia pojawiają się wyżej, a najnowsze (najbardziej aktualne) znajduje się na górze osi czasu.
2. Events. Za każdym razem, gdy wystąpi obsługiwane zdarzenie (patrz poniżej) powiązane z projektem, jest ono dodawane do osi czasu jako dedykowany kafelek. Każdy typ zdarzenia ma kafelek w innym kolorze i będzie albo połączony bezpośrednio z głównym „pniem” osi czasu, albo będzie miał obok ikonę powiązania (jak w przypadku zdarzeń MCAD Exchange; ).
3. Search. Kliknij kontrolkę w prawym górnym rogu widoku, aby uzyskać dostęp do pola wyszukiwania, które umożliwia podstawowe przeszukiwanie historii projektu. W miarę wpisywania frazy wyszukiwania oś czasu będzie filtrowana tak, aby prezentować tylko zdarzenia istotne dla tego wyszukiwania. Więcej informacji: Wyszukiwanie z filtrowaniem.

Obsługiwane zdarzenia

Oś czasu pokazuje postęp zdarzeń zachodzących w trakcie życia projektu. Każde z tych zdarzeń pojawia się na osi czasu jako dedykowany „kafelek zdarzenia”. Poniższe sekcje omawiają zakres zdarzeń aktualnie obsługiwanych i możliwych do prezentacji w ramach historycznej osi czasu projektu.

Utworzenie projektu

Related pages: Tworzenie nowego projektu w Workspace (interfejs przeglądarkowy / Altium Designer), Udostępnianie istniejącego projektu online, Klonowanie projektu (interfejs przeglądarkowy / Altium Designer)

Gdy projekt zostanie utworzony, do osi czasu zostanie dodany kafelek zdarzenia Project Created. To zdarzenie oznacza początek historycznej osi czasu projektu. W związku z tym zawsze znajduje się jako wpis na dole osi czasu. Kafelek dla tego zdarzenia może występować w dwóch odrębnych wariantach:

• Gdy projekt jest nowo utworzony w Workspace. Twórca projektu jest prezentowany z imienia i nazwiska (oraz zdjęciem/symbolem), wraz z czasem utworzenia projektu. Opis projektu, jeśli został wprowadzony w momencie tworzenia, jest również wyświetlany w kafelku.

• Gdy projekt jest klonem istniejącego projektu. Osoba, która utworzyła sklonowany projekt, jest prezentowana z imienia i nazwiska (oraz zdjęciem/symbolem), wraz z czasem utworzenia projektu. Opis projektu, jeśli został wprowadzony w momencie klonowania, jest również wyświetlany w kafelku. Udostępniany jest link do oryginalnego projektu źródłowego – kliknięcie go spowoduje przejście do szczegółowej strony zarządzania tym projektem, która otworzy się w osobnej karcie przeglądarki.

Kafelek zdarzenia Project Created jest fizycznie połączony z głównym „pniem” osi czasu ciągłą niebieską linią połączenia i węzłem:

Commit projektu

Za każdym razem, gdy zapisujesz projekt do Workspace (gdzie projekt jest zarządzany w ramach wewnętrznego repozytorium Versioned Storage Git obszaru roboczego), do osi czasu zostanie dodany kafelek zdarzenia Project Committed. Osoba, która wykonała commit i push, jest prezentowana z imienia i nazwiska (oraz zdjęciem), wraz z datą i godziną. Jeśli w momencie commit i push dodano komentarz – w oknie dialogowym Save to Server dialog – zostanie on również wyświetlony w kafelku.

Przykładowy początkowy kafelek zdarzenia Project Committed.

Kafelek obsługuje również i prezentuje informacje o różnicach w projekcie (design diffing), pokazując bardziej szczegółowe dane o tym, co zmieniło się pomiędzy bieżącym a poprzednim commitem. Obsługiwane elementy obejmują pliki, komponenty, sieci (nets), warianty oraz strukturę PCB. Sekcja różnic w kafelku podsumowuje różne elementy objęte zdarzeniem commitu, pogrupowane według następujących stanów:

– element dodany.

– element usunięty.

– element zmodyfikowany.

Kliknięcie kontrolki w kafelku rozwinie tę sekcję różnic, aby wyświetlić elementy objęte zmianą z nazwy.

Użyj dostępnych kontrolek Show More i Show Less, aby przeanalizować pełną listę dla każdego typu elementu. Kliknij kontrolkę w kafelku, aby wrócić do widoku podsumowania.

Kliknij kontrolkę w prawym górnym rogu kafelka, aby uzyskać dostęp do menu z następującymi poleceniami:

• View – użyj tego polecenia, aby otworzyć źródłowe dane projektu dla wybranego commitu w Web Viewer jako migawkę projektu z tamtego momentu.
• Create Tag – dodaj nazwę tagu VCS do aktualnie wybranego commitu. Tagi przypisane do commitu pojawiają się w kafelku widoku Historii, w nagłówku widoku migawki w Web Viewer oraz w komentarzach dołączonych do tego widoku migawki. Po dodaniu tagu do commitu polecenie w menu kafelka zmienia się na Tag i oferuje podopcje modyfikacji (Edit) lub usunięcia (Remove) tagu commitu.

Wybierz opcję menu Create Tag, aby dodać nazwę tagu do zdarzenia History dla commitu.

Widok migawki oznaczonego tagiem zdarzenia commitu w Historii jest opisany nazwą tagu.

Gdy komentarze są przeglądane w aktywnym projekcie WIP, te utworzone w migawce projektu dla otagowanego commitu będą zawierały powiązaną nazwę tagu. Wybierz link z nazwą tagu, aby otworzyć powiązaną migawkę commitu. Więcej informacji o pracy z komentarzami: Komentarze w Web Viewer.

Komentarze dodane do migawki otagowanego zdarzenia commitu będą zawierały powiązaną nazwę tagu.

• Schematic to – umożliwia porównanie danych schematu (Schematic) w tym commicie z danymi innego commitu lub zdarzenia wydania. Użyj podmenu, aby porównać z danymi źródłowymi poprzedniego commitu, albo wybierz spośród wszystkich możliwych commitów lub wydań. Po wybraniu commitu/wydania do porównania wyniki porównania są prezentowane w widoku Compare, który otwiera się jako nowa karta w domyślnej przeglądarce internetowej. Więcej informacji: Porównanie schematów.
• BOM to – umożliwia porównanie danych BOM w tym commicie z danymi innego commitu lub zdarzenia wydania. Użyj powiązanego podmenu, aby porównać z danymi BOM poprzedniego commitu, albo wybierz spośród wszystkich commitów/wydań wykonanych dla projektu. Po wybraniu celu porównania wyniki są prezentowane jako lista wpisów BOM oznaczonych kolorami, które reprezentują pozycje zmienione pomiędzy wskazanymi zdarzeniami Commit/Release. Zestawione podsumowanie zmian jest generowane w standardowym formacie CSV i udostępniane do pobrania w archiwum ZIP. Więcej informacji: Porównanie BOM.

• Clone– użyj tego polecenia, aby utworzyć klon z tej konkretnej rewizji projektu. Pojawi się okno Clone Project, w którym można określić Name projektu, Description oraz – w sekcji opcji Advanced – docelowe Server Folder i Repository. Zwróć uwagę, że tekst w banerze okna odzwierciedla, z której rewizji projektu tworzony jest klon. Po zdefiniowaniu wymaganych informacji kliknij przycisk . Projekt zostanie utworzony, a na osi czasu zostanie dodany kafelek zdarzenia Project Cloned.

Możesz utworzyć klon z dowolnej konkretnej rewizji aktywnego projektu – bezpośrednio z odpowiadającego jej kafelka zdarzenia Project Committed dla tej rewizji.

• Download Sources – użyj tego polecenia, aby pobrać źródła projektu dla tej konkretnej rewizji projektu w archiwum Zip. Nazwa pliku Zip oraz pliku projektu PCB będzie zawierać datę i godzinę (w czasie UTC), o której ta rewizja projektu została zatwierdzona (committed) i wypchnięta (pushed) do Workspace.

Kafelek zdarzenia Project Committed jest fizycznie połączony z głównym pniem osi czasu ciągłą niebieską linią połączenia i węzłem: . Najnowsza rewizja projektu (tj. ostatni commit) jest wyróżniona białym wypełnieniem węzła: .

Wydanie projektu

Related page: Wydanie projektu projektowego

Za każdym razem, gdy wykonasz wydanie projektu – używając Project Releaser w Altium Designer – na osi czasu zostanie dodany kafelek zdarzenia Project Released. Osoba, która wykonała wydanie, jest przedstawiona z imienia i nazwiska (oraz zdjęcia), wraz z datą i godziną. Jeśli w momencie publikowania wygenerowanych danych do Workspace dodano notatkę do wydania – w oknie dialogowym Confirm Release dialog – zostanie ona również wyświetlona w kafelku. Wymienione zostaną także wszystkie zestawy danych uwzględnione w wydaniu.

Przykładowy kafelek zdarzenia Project Released.

Kliknij kontrolkę w prawym górnym rogu kafelka, aby uzyskać dostęp do menu z następującymi poleceniami:

• View – otwiera dedykowany portal produkcyjny (w osobnej karcie przeglądarki), umożliwiający dokładniejszą inspekcję wydanych danych. Z tego portalu możesz przeglądać i nawigować po wydanych plikach, analizować BOM oraz wyświetlać i komentować migawkę samego projektu; źródło tych wydanych danych. Uzyskasz również dostęp do kontrolek pobierania danych produkcyjnych na różnych poziomach szczegółowości (od pełnych zestawów danych po pojedyncze wygenerowane pliki wyjściowe). Wybrane wydanie można także wysłać – jako Manufacturing Package – bezpośrednio do producenta. Więcej informacji znajdziesz w sekcji przeglądania pakietu wydania w Manufacturing Portal.

Uzyskiwanie dostępu do dedykowanej karty Manufacturing Portal, umożliwiającej dokładniejszą inspekcję wydania projektu.

• Schematic to – umożliwia porównanie danych schematu w tym wydaniu z danymi innego wydania lub zdarzenia commit. Użyj podmenu, aby porównać ze źródłowymi danymi poprzedniego wydania, albo wybierz spośród wszystkich możliwych wydań i commitów. Po wybraniu wydania/commitu do porównania wyniki są prezentowane w widoku Compare, który otwiera się jako nowa karta w domyślnej przeglądarce. Więcej informacji: Schematic Comparison.
• Gerber to – umożliwia porównanie wygenerowanych danych Gerber dla tego wydania z innym zestawem danych Gerber. Użyj powiązanego podmenu, aby porównać z danymi produkcyjnymi (fabrication) poprzedniego wydania, wybrać spośród wszystkich wydań wykonanych dla projektu (oś czasu zostanie przefiltrowana tak, aby pokazywać tylko kafelki zdarzeń Project Released), albo porównać z wybranym lokalnie wygenerowanym (i przesłanym) zestawem plików. Po wybraniu celu porównania wyniki są prezentowane w Gerber Compare widoku, który otwiera się w osobnej karcie przeglądarki. Więcej informacji: Gerber Comparison.

• BOM To – umożliwia porównanie danych zestawienia materiałowego (BoM) w tym wydaniu z danymi innego wydania. Użyj powiązanego podmenu, aby porównać z danymi BOM poprzedniego wydania, albo wybierz spośród wszystkich wydań wykonanych dla projektu. Po wybraniu celu porównania wyniki są prezentowane jako lista wpisów BOM oznaczonych kolorami, reprezentujących elementy, które zmieniły się pomiędzy wskazanymi zdarzeniami Commit/Release. Zestawione podsumowanie zmian jest generowane w standardowym formacie CSV i udostępniane do pobrania w archiwum ZIP. Więcej informacji: BOM Comparison.
• Download Outputs – umożliwia wybranie, w kolejnym oknie, które zestawy danych z pakietu wydania pobrać. Po dokonaniu wyboru kliknij przycisk . Zostanie pobrane pojedyncze archiwum Zip zawierające foldery dla każdego z wybranych zestawów danych.
• Download Sources– umożliwia pobranie migawki wersji projektu, która została użyta do utworzenia tego pakietu wydania, jako archiwum Zip.

Klonowanie projektu

Related page: Klonowanie projektu (interfejs przeglądarkowy / Altium Designer)

Za każdym razem, gdy klonujesz projekt – przez interfejs przeglądarkowy Workspace lub z poziomu Altium Designer – na osi czasu zostanie dodany kafelek zdarzenia Project Cloned. Osoba, która wykonała klonowanie, jest przedstawiona z imienia i nazwiska (oraz zdjęcia), wraz z datą i godziną. W momencie klonowania do kafelka dodawany jest wygenerowany opis, który można nadpisać, wpisując nowy opis. Udostępniany jest link do sklonowanego projektu – kliknięcie go otworzy szczegółową stronę zarządzania tym projektem w osobnej karcie przeglądarki.

Przykładowy kafelek zdarzenia Project Cloned.

Wymiany MCAD

Related page: Altium MCAD CoDesigner

Podczas pracy pomiędzy domenami projektowania elektronicznego i mechanicznego Workspace pełni rolę pomostu między nimi – umożliwiając bezpośrednie współprojektowanie ECAD-MCAD. Za każdym razem, gdy wprowadzane są zmiany w projekcie PCB i zmiany te są wypychane do Workspace za pośrednictwem odpowiedniego panelu CoDesigner, na osi czasu zostanie dodany kafelek zdarzenia MCAD Changes Suggested. Osoba, która wykonała push, jest przedstawiona z imienia i nazwiska (oraz zdjęcia), wraz z datą i godziną. Jeśli w momencie wykonywania push opublikowano wiadomość – w panelu MCAD CoDesigner (Altium Designer) lub panelu Altium CoDesigner (w obsługiwanym oprogramowaniu MCAD) – zostanie ona również wyświetlona w kafelku.

Gdy inżynier MCAD wprowadza zmiany w PCB w obsługiwanym oprogramowaniu MCAD i wypycha je z powrotem do Workspace, odpowiadające temu zdarzenie push będzie dostępne na osi czasu historii projektu only po pobraniu (pull) zmian z Workspace do Altium Designer.

Przykład pokazujący dwa zdarzenia związane z MCAD. Dolne zdarzenie w pniu osi czasu reprezentuje push ze strony ECAD, natomiast górne zdarzenie to push zwrotny ze strony MCAD.

Filtrowane wyszukiwanie

Kliknij kontrolkę w prawym górnym rogu widoku, aby uzyskać dostęp do pola wyszukiwania, które pozwala szybko znaleźć interesujące zdarzenia na osi czasu. Funkcja wyszukiwania obsługuje podstawowe przeszukiwanie historii projektu, z dynamicznym filtrowaniem stosowanym w miarę wpisywania frazy – na stronie pozostają wyświetlone tylko zdarzenia istotne dla danego wyszukiwania. Pasujący tekst w kafelku zdarzenia jest podświetlany.

Przykład wyszukiwania w historii projektu. Oś czasu jest dynamicznie filtrowana w miarę wpisywania wyszukiwanego terminu (bez rozróżniania wielkości liter), a pasujące wpisy są podświetlane w każdym odpowiednim kafelku zdarzenia.

Funkcja wyszukiwania działa w oparciu o następujące informacje:

• Tytuł kafelka zdarzenia.
• Imię i nazwisko osoby, która wykonała zdarzenie.
• Tekst opisowy (tekst pochodzący z komentarza/notatki/opisu w momencie wystąpienia danego zdarzenia).
• Tekst danych różnic (diff) – w kafelku zdarzenia Project Committed.
• Nazwa zestawu danych – w kafelku zdarzenia Project Released.
• Nazwa projektu – w kafelku zdarzenia Project Cloned oraz kafelku zdarzenia Project Created (gdy utworzono przez klonowanie).

Aby wyczyścić bieżące filtrowanie i wrócić do pełnej osi czasu, wyczyść pole wyszukiwania – albo zaznaczając bieżący tekst i naciskając klawisz Backspace , albo klikając kontrolkę po prawej stronie pola. Alternatywnie kliknij kontrolkę Clear Filter w polu podsumowującym liczbę wyświetlanych zdarzeń (u góry widoku).

Aktualizowanie o nowe zdarzenia

Za każdym razem, gdy w odniesieniu do projektu wystąpi obsługiwane zdarzenie, zostanie ono wykryte i automatycznie udostępnione w History widoku. Powiadomienie pojawi się u dołu widoku krótko po wystąpieniu zdarzenia – kliknij element sterujący , aby zaktualizować oś czasu o nowe zdarzenie.

Dostępne jest również ręczne odświeżanie, wykonywane po kliknięciu elementu sterującego w prawym górnym rogu widoku.