Historia projektu

Parent page: Projekty w Workspace

Workspace Enterprise Server stanowi eleganckie rozwiązanie potrzeby uzyskania historycznego przeglądu aktywności projektu w postaci dedykowanego, interaktywnego Historywidoku. Dostępny poprzez interfejs przeglądarkowy Workspace lub z poziomu Altium Designer, History widok projektu udostępnia postępującą oś czasu najważniejszych zdarzeń związanych z projektem. Zdarzenia obejmują utworzenie projektu, commity, wydania (releases), klonowanie oraz wymiany MCAD, a tam, gdzie ma to zastosowanie, oferują także polecenia akcji dla zdarzeń.

Uzyskiwanie dostępu do historii projektu

Dostęp do History widoku 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

History Widok prezentuje 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 History widoku.

1. Main trunk of the timeline. Kierunek chronologii zdarzeń przebiega od dołu do góry. Pierwsze zdarzenie – utworzenie projektu – pojawi się na dole osi czasu. Kolejne zdarzenia pojawiają się powyż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 osobny kafelek. Każdy typ zdarzenia ma kafelek w innym kolorze i jest albo połączony bezpośrednio z głównym „pniem” osi czasu, albo ma 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ć wyłącznie 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 zaprezentowania jako część 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. Zdarzenie to wyznacza 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 StorageGit Workspace), 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 – poprzez okno dialogowe Save to Server – 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 diff), 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ą według 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:

• 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, a 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 do 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.

• Download Snapshot – 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ędą zawierały datę i godzinę (w czasie UTC), w której ta rewizja projektu została zatwierdzona (commit) i wypchnięta (push) 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 płytki (Board Design Release)

Za każdym razem, gdy wykonujesz wydanie projektu – używając Project Releaser w Altium Designer – do osi czasu zostanie dodany kafelek zdarzenia Project Released. Osoba, która wykonała wydanie, jest prezentowana z imienia i nazwiska (oraz zdjęciem), wraz z datą i godziną. Jeśli w momencie publikowania wygenerowanych danych do Workspace dodano notatkę do wydania – poprzez okno dialogowe Confirm Release – 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), w którym można dokładniej przeanalizować wydane dane. Z poziomu tego portalu możesz przeglądać i nawigować po wydanych danych plików, analizować BOM oraz wyświetlać i komentować migawkę samego projektu; źródło tych wydanych danych. Uzyskasz także 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 również wysłać – jako Manufacturing Package – bezpośrednio do producenta. Więcej informacji: przeglądanie pakietu wydania (Release Package) w Manufacturing Portal.

Uzyskiwanie dostępu do dedykowanej karty Manufacturing Portal, która umożliwia dokładniejszą analizę wydania projektu.

• BOM To– umożliwia porównanie danych zestawienia materiałowego (BoM) w tym wydaniu z danymi z innego wydania. Użyj powiązanego podmenu, aby porównać z danymi BOM poprzedniego wydania, albo wybierz spośród wszystkich wydań utworzonych dla projektu. Funkcja porównywania danych wykrywa różnice w surowych danych BOM pomiędzy wskazanymi wydaniami projektu i jest również dostępna z poziomu widoku projektu w Workspace Releases view. Wyniki porównania są udostępniane poprzez pobranie pliku CSV, który szczegółowo opisuje dane BOM, które uległy zmianie – dodane, usunięte lub zaktualizowane – pomiędzy wskazanymi wydaniami projektu.

• Download – 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 Snapshot – 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 – zarówno przez interfejs przeglądarkowy Workspace, jak i z poziomu Altium Designer – do osi czasu zostanie dodany kafelek zdarzenia Project Cloned. Osoba, która wykonała klonowanie, jest prezentowana z imienia i nazwiska (oraz zdjęciem), wraz z datą i godziną. W momencie klonowania do kafelka dodawany jest wygenerowany opis, który można zastąpić, 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 domeną projektowania elektronicznego i mechanicznego Workspace pełni rolę pomostu między nimi – ułatwiając bezpośrednie współprojektowanie ECAD-MCAD. Za każdym razem, gdy w projekcie PCB zostaną wprowadzone zmiany i zostaną one wypchnięte do Workspace za pośrednictwem odpowiedniego panelu CoDesigner, do osi czasu zostanie dodany kafelek zdarzenia MCAD Changes Suggested. Osoba, która wykonała push, jest prezentowana z imienia i nazwiska (oraz zdjęciem), wraz z datą i godziną. Jeśli w momencie wykonywania push opublikowano wiadomość – przez panel MCAD CoDesigner (Altium Designer) lub panel Altium CoDesigner (w obsługiwanym oprogramowaniu MCAD) – zostanie ona również wyświetlona w kafelku.

Gdy inżynier MCAD wprowadzi zmiany w PCB w obsługiwanym oprogramowaniu MCAD i wypchnie je z powrotem do Workspace, odpowiadające temu zdarzenie push będzie dostępne na osi czasu historii projektu only po pobraniu 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 odpowiadające wyszukiwaniu. Pasujący tekst w kafelku zdarzenia jest podświetlany.

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

Funkcja wyszukiwania działa z następującymi informacjami:

• 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 aktualny 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).

Aktualizacja 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 widoku History . Krótko po wystąpieniu zdarzenia u dołu widoku pojawi się powiadomienie – kliknij kontrolkę , aby zaktualizować oś czasu o nowe zdarzenie.

Dostępne jest również ręczne odświeżenie, wykonywane przez kliknięcie kontrolki w prawym górnym rogu widoku.