Performing Design Reviews

Istotnym elementem każdego procesu projektowego jest przegląd jego postępów i poprawności na kluczowych etapach rozwoju — niezależnie od tego, czy ma on formę wspólnych dyskusji zespołowych, czy też sztywnych mechanizmów zatwierdzania. Nierozerwalnie związane z tym procesem, na dowolnym poziomie, jest zapewnienie dostępu do wszystkich istotnych danych projektowych, plików, komentarzy, reprezentacji wizualnych oraz narzędzi do przekazywania informacji zwrotnej, potrzebnych docelowemu recenzentowi(-om).

Altium Designer zapewnia tę funkcjonalność w bardzo elastycznej formie poprzez zastosowanie procesów przeglądu Process Workflows, które są hostowane przez połączony Workspace i dostępne z poziomu Altium Designer.

► Więcej informacji o procesach i ich przepływach pracy znajdziesz w Creating & Managing Processes (Altium 365 Workpace, Enterprise Server Workspace).

Przepływy pracy procesów zawierają interaktywne formularze, które są prezentowane użytkownikowi w miarę przechodzenia przez kolejne kroki procesu i dają możliwość komentowania, dołączania plików, przeglądania dokumentów projektowych i wiele więcej. Procesy przeglądu mogą być uruchamiane przez dowolnego użytkownika Altium Designer mającego dostęp do projektu i są przypisywane innym użytkownikom (członkom zespołu) lub grupom użytkowników (rolom zespołu).

Po stronie Workspace administrator pracuje z procesami jako przepływami w formie diagramów, w których formularze użytkownika i kroki włączone do przepływów są w pełni konfigurowalne. Pozwala to w razie potrzeby tworzyć (i egzekwować) bardzo specyficzne procesy, np. ukierunkowane na ustalone firmowe wymagania dotyczące przeglądów. Można utworzyć dowolną liczbę procesów workflow.

► Więcej informacji znajdziesz w Defining a Process Workflow (Altium 365 Workspace, Enterprise Server Workspace).

Procesy przeglądu

Workspace oferuje trzy domyślne procesy przeglądu, do których można uzyskać dostęp w dostarczonej postaci lub użyć ich jako podstawy do bardziej zaawansowanych procesów niestandardowych:

• Ad Hoc Review – Nieformalny proces przeglądu bez rejestrowanego wyniku końcowego.
• Handoff Review – Bardziej formalny proces przeglądu, w którym inicjator przeglądu (zgłaszający) rejestruje wniosek zaliczony/niezaliczony (Completed/Rejected) podczas zamykania przeglądu. Status Completed oznacza, że projekt jest gotowy do przekazania do kolejnego etapu rozwoju.
• Milestone Review – Bardziej rozbudowany proces przeglądu w zamkniętej pętli, w którym zgłaszający wykorzystuje informacje zwrotne z przeglądu, aby zdecydować, czy status ma być Completed, Rejected, czy też projekt powinien zostać poprawiony (Reworked). W tym ostatnim przypadku poprawiony projekt jest następnie weryfikowany, a decyzja Completed/Rejected/Rework jest powtarzana. Przegląd zostaje zamknięty, gdy cel lub kamień milowy projektu zostanie pomyślnie osiągnięty.

We wszystkich powyższych przypadkach zarówno zgłaszający/zatwierdzający przegląd (Initiator), jak i recenzenci (Assignees) są prowadzeni przez przepływ procesu za pomocą sekwencji formularzy interfejsu użytkownika. Wymagania i opcje w każdym kroku przepływu procesu są określane przez odpowiadający mu wpis Process w Workspace, który z kolei jest zarządzany przez administratora serwera — ma on również możliwość zarówno inicjowania, jak i anulowania procesu przeglądu.

Wykonywanie przeglądu

Przegląd zazwyczaj ma postać trzech następujących po sobie etapów:

1. Użytkownik inicjujący przegląd (zgłaszający) definiuje, co będzie przeglądane i przez kogo, oraz dodaje wszelkie dane lub informacje, które będą potrzebne.
2. Recenzenci uzyskują dostęp do danych projektu i przekazują odpowiednią informację zwrotną, a w razie potrzeby dodają istotne dane lub informacje.
3. Zatwierdzający przegląd (zwykle inicjator) ocenia i podsumowuje informacje zwrotne od recenzentów oraz zamyka proces.

Wszystkie etapy przeglądu są reprezentowane przez odpowiadające im zadanie Task (Altium 365 Workspace, Enterprise Server Workspace) w panelu Tasklist oprogramowania, który informuje każdego użytkownika, że wymagane jest działanie, oraz dostarcza informacji o ukończonych zadaniach. Wybranie oczekującego zadania Task aktywuje dany etap przeglądu.

Inicjowanie i definiowanie przeglądu

Proces przeglądu jest inicjowany z menu Project » Project Activities w Altium Designer. Przegląd będzie początkowo dotyczył aktualnie aktywnego projektu.

Biorąc jako przykład proces Ad Hoc Review, w jego domyślnym, niezmodyfikowanym formacie, początkowy formularz dialogowy pozwala zgłaszającemu (Barry w poniższym przykładzie) określić projekt, który będzie przeglądany, oraz wskazać użytkowników przypisanych do wykonania etapu przekazywania informacji zwrotnej.

Pola i menu w oknie dialogowym Ad Hoc Review to:

• Request title – domyślny tryb AUTO przyjmuje nazwę procesu jako podstawę nazwy aktywnego procesu (tytułu aktywności). W jej miejsce można wprowadzić nazwę niestandardową.
• Project – nazwa projektu, który będzie przeglądany. Jest to aktywny projekt w momencie inicjowania procesu, ale z opcji rozwijanego menu zależnego od typu można wybrać dowolny dostępny projekt.
• Description – tekst dostarczający recenzentom dodatkowych informacji.
• Reviewers – wskazani członkowie zespołu lub grupy ról, którym zostanie przypisane zadanie przesłania informacji zwrotnej z przeglądu. Zacznij pisać, aby zobaczyć dostępne pozycje.

Kliknij przycisk , aby rozpocząć przepływ pracy procesu i przejść do formularza definiowania danych.

Kolejny formularz dialogowy Prepare review data pozwala wskazać konkretne zasoby danych projektowych i dodać załączniki. Zwróć uwagę, że każdy tekst formularza podświetlony na niebiesko jest aktywnym łączem do danych źródłowych. Okno dialogowe zawiera również opisowy diagram przepływu procesu w zakładce Diagram, który wskazuje także Twoją bieżącą pozycję w krokach przepływu.

Istotne opcje w oknie dialogowym formularza to:

• Data – użyj menu rozwijanego, aby wybrać konkretny zestaw danych wydania projektu (według daty), lub użyj powiązanej opcji , aby przejść do i wybrać konkretny zestaw danych wydania. W stanie domyślnym, gdy nie wybrano danych, recenzent(-ci) będą mieli dostęp wyłącznie do danych źródłowych projektu.
• Attachments – wskaż () lub przeciągnij i upuść pliki, które chcesz dodać jako dane przeglądu lub źródła informacji.

Gdy wszystkie dane przeglądu zostały określone lub dodane do formularza, kliknij przycisk , aby przenieść proces do etapu Review.

W tym momencie aktywne zadanie Prepare review data Task zostaje zamknięte w panelu Tasklist, ponieważ etap zgłaszania przeglądu został ukończony — zwróć uwagę, że użytkownik Altium Designer jest w tym momencie zgłaszającym proces przeglądu (Initiator). Trwający proces przeglądu jest widoczny na liście Activities panelu ze statusem aktywnym. Kliknij przycisk , aby upewnić się, że widzisz najnowszy status Activities.

Aby wyświetlić status postępu aktywnego procesu przeglądu, wybierz jego pozycję na liście Activities, aby wyświetlić bieżące dane oraz opisany diagram przepływu (zakładka Diagram).

Przekazywanie informacji zwrotnej z przeglądu

Po skonfigurowaniu i zgłoszeniu procesu przeglądu przez Initiator aktywność automatycznie wygeneruje zadania Tasks do wykonania przez osoby wskazane jako Reviewers. Gdy recenzent (np. Norm Smith w tym przykładzie) zaloguje się do Altium Designer, obszar Tasks pokaże przypisane zadanie Provide review feedback.

Wybranie tego zadania Task aktywuje dla recenzenta etap Review w przepływie procesu. Poniższy formularz dialogowy Provide review feedback oferuje odpowiednie dane projektu (zgodnie z tym, co określił zgłaszający przegląd), możliwość dodania komentarzy i załączników lub otwarcia projektu w Web Viewer () oraz wymóg oddania głosu (Vote) w ramach informacji zwrotnej.

Istotne opcje w oknie dialogowym Provide Review feedback to:

• Open Project – wybierz, aby otworzyć projekt w Workspace Web Viewer. Zapewnia to bogaty zestaw danych projektu oraz w pełni renderowane, interaktywne widoki dokumentów źródłowych projektu, co umożliwia dodawanie wyróżnionych komentarzy i opcjonalne przypisywanie ich do konkretnego użytkownika (członka Workspace).
  ► Więcej informacji znajdziesz na stronie Web Viewer (Altium 365 Workspace, Enterprise Server Workspace).
• Comment – notatki komentarzy dodane tutaj zostaną przypisane do nazwy recenzenta po sfinalizowaniu procesu przeglądu.
• Vote – wybierz odpowiednie podsumowanie wniosku z przeglądu.
• Reviewers attachments – wskaż () lub przeciągnij i upuść pliki, takie jak bardziej szczegółowe notatki lub dokumenty referencyjne, które zostaną dołączone do informacji zwrotnej z przeglądu.

Zwróć uwagę, że każdy tekst podświetlony na niebiesko jest aktywnym łączem do danych źródłowych. Wybierz przycisk , aby zakończyć etap przeglądu — jest to wskazane w panelu Tasklist, który zamknie (usunie) to aktywne zadanie.

Podsumowanie i zamknięcie przeglądu

Gdy wszyscy wskazani Reviewers ukończą przypisane im zadania przekazania informacji zwrotnej, aktywny proces Review przechodzi do etapu podsumowania/zamknięcia. Generowane jest zadanie Summarize review dla użytkownika przypisanego do oceny aktywności przeglądu — w tym przypadku Barry, tego samego użytkownika, który zgłosił (zainicjował) przegląd. Zwróć uwagę, że dla tego użytkownika proces przeglądu jest widoczny jako aktywny w panelu Tasklist w sekcji Activities. Dla recenzentów aktywność jest teraz zamknięta, ponieważ ich zadania wkładu zostały ukończone.

Wybranie zadania Summarize review w panelu Tasklist przeniesie przepływ przeglądu do jego końcowego etapu, przedstawionego w formularzu dialogowym Summarize review.

Istotne elementy uwzględnione w tym formularzu to:

• Information provided by reviewers
  • Comment – lista komentarzy przekazanych przez recenzentów po zakończeniu ich zadań przeglądu.
  • Vote – ocena końcowa (wniosek) przeglądu wybrana przez każdego recenzenta.
  • Review attachments – wszelkie powiązane pliki dodane do zadania przez recenzentów.
• Summary
  • Summary note – końcowe uwagi dodawane przez osobę oceniającą proces przeglądu (w tym przypadku zgłaszającego/inicjatora), które zostaną zapisane przy zamknięciu przeglądu.

Kliknięcie przycisku w oknie dialogowym spowoduje zamknięcie aktywnego procesu Design Review. Zwróć uwagę, że w bardziej zaawansowanych procesach Design Review, które są dostępne, na etapie oceny uwzględnione są dodatkowe kroki, takie jak określenie wniosku „zakończone/odrzucone” lub zainicjowanie zadania Rework dla projektu.

Aby przejrzeć zakończony Design Review, odśwież wpisy Activities w panelu Tasklist (), zaznacz opcję Show Closed w menu i wybierz z listy zamknięte zadanie. Poniższe okno dialogowe zawiera podsumowanie informacji o przeglądzie (na karcie Data) oraz diagram przepływu procesu (karta Diagram) z podświetlonym stanem postępu – którym jest Completed, jak można się spodziewać.

Niestandardowe procesy przeglądu

Procesy Design Review, w ostatecznej postaci prezentowane użytkownikowi w Altium Designer, są tworzone i edytowane w połączonym Workspace przez wyznaczonego administratora. Elastyczność elementów kroków przepływu oraz formularzy UI, które składają się na workflow procesu Design Review, pozwala tworzyć przeglądy spełniające szeroki zakres konkretnych potrzeb.

Niektóre dodatkowe opcje, które można zastosować do kroków i formularzy, to:

• przypisanie dowolnego kroku w przepływie do konkretnego użytkownika lub roli, innej niż te wyznaczone jako recenzenci lub osoba oceniająca.
• odebranie użytkownikowi lub roli dostępu do konkretnego kroku workflow ( Exception), tak aby był on dla nich pomijany w przepływie.
• wymuszenie, aby wprowadzenie wartości w polu formularza było obowiązkowe przed wysłaniem okna dialogowego formularza.
• dodanie pośrednich kroków workflow, które nakładają dodatkowe zadania i formularze użytkownika.
• utworzenie pętli decyzyjnej workflow, w której tylko określone działanie zamknie tę pętlę.
• udostępnianie lub ukrywanie określonych danych albo komunikatów zdarzeń/błędów w formularzu UI danego kroku workflow.
• wykorzystanie funkcji Web Viewer w Workspace, aby umożliwić recenzentom, którzy nie mają bezpośredniego dostępu do źródłowych dokumentów projektu, przeglądanie dokumentacji projektowej i dodawanie komentarzy.

Jak wcześniej opisano, można utworzyć dowolną liczbę procesów przeglądu i udostępnić je w Altium Designer; mogą one obejmować poziomy od nieformalnego zbierania opinii od współpracowników po formalne, zatwierdzone w firmie procesy przeglądu, które zasilają inne systemy firmowe (np. PLM).

► Szczegółowe informacje o tworzeniu procesów niestandardowych: Defining a Process Workflow (Altium 365 Workspace, Enterprise Server Workspace).