Performing Design Reviews

Una parte essenziale di qualsiasi processo di progettazione è la revisione del suo avanzamento e della sua validità nelle fasi chiave dello sviluppo, sia che ciò avvenga sotto forma di discussioni collaborative tra pari o di rigidi meccanismi di approvazione formale. Intrinseco a tale processo, a qualunque livello, è fornire ai revisori destinatari l'accesso a tutti i dati di progetto pertinenti, ai file, ai commenti, alle rappresentazioni visive e agli strumenti di feedback necessari.

Altium Designer offre questa funzionalità in una forma altamente flessibile tramite l'applicazione di processi di revisione Process Workflows ospitati da un Workspace connesso e accessibili dall'interno di Altium Designer.

► Per ulteriori informazioni sui processi e sui relativi flussi di lavoro, vedere Creating & Managing Processes (Altium 365 Workpace, Enterprise Server Workspace).

I flussi di lavoro dei processi incorporano moduli interattivi che vengono presentati all'utente man mano che avanza attraverso le fasi del flusso di processo e offrono la possibilità di commentare, allegare file, visualizzare documenti di progettazione e molto altro. I processi di revisione possono essere avviati da qualsiasi utente di Altium Designer che abbia accesso al progetto e vengono assegnati ad altri utenti (membri del team) o a gruppi di utenti (ruoli del team).

Dal lato del Workspace, un amministratore lavora con i processi come flussi basati su diagrammi, in cui i moduli utente e le fasi incorporate nei flussi sono completamente personalizzabili. Ciò consente di costruire (e applicare), se necessario, processi molto specifici, ad esempio mirati a soddisfare requisiti di revisione aziendali consolidati. È possibile creare un numero qualsiasi di processi di workflow.

► Per ulteriori informazioni, vedere Defining a Process Workflow (Altium 365 Workspace, Enterprise Server Workspace).

Processi di revisione

Il Workspace offre tre processi di revisione predefiniti che possono essere utilizzati così come forniti oppure come base per processi personalizzati più avanzati:

• Ad Hoc Review – Un processo di revisione informale senza una conclusione registrata.
• Handoff Review – Un processo di revisione più formale in cui l'iniziatore della revisione (mittente) registra una conclusione di esito positivo/negativo (Completato/Rifiutato) alla chiusura della revisione. Uno stato completato indica che il progetto è pronto per essere trasferito alla fase di sviluppo successiva.
• Milestone Review – Un processo di revisione a ciclo chiuso più elaborato in cui il mittente utilizza il feedback della revisione per decidere se lo stato è Completato, Rifiutato oppure se il progetto deve essere corretto (Rielaborato). In quest'ultimo caso, il progetto rielaborato viene quindi verificato e la decisione Completato/Rifiutato/Rielaborazione viene ripetuta. La revisione viene chiusa quando l'obiettivo o la milestone del progetto viene raggiunta con successo.

In tutti i casi sopra indicati, sia il mittente/approvatore della revisione (Initiator) sia i revisori (Assignees) vengono guidati attraverso il flusso di processo da una sequenza di moduli dell'interfaccia utente. I requisiti e le opzioni in ciascuna delle fasi del flusso di processo sono determinati dalla corrispondente voce Process nel Workspace, che a sua volta è gestita dall'amministratore del server, il quale è anche in grado di avviare e annullare un processo di revisione.

Esecuzione di una revisione

Una revisione assume in genere la forma di tre fasi sequenziali:

1. L'utente che avvia la revisione (il mittente) definisce cosa verrà revisionato e da chi, e aggiunge eventuali dati o informazioni necessari.
2. I revisori accedono ai dati del progetto e forniscono un feedback appropriato e, se necessario, aggiungono dati o informazioni pertinenti.
3. L'approvatore della revisione (di solito l'iniziatore) valuta e riepiloga il feedback dei revisori e chiude il processo.

Tutte le fasi di una revisione sono rappresentate da una Task corrispondente (Altium 365 Workspace, Enterprise Server Workspace) nel pannello Tasklist del software, che avvisa ciascun utente che è richiesta un'azione e fornisce informazioni sulle attività completate. Selezionando una Task in sospeso si attiverà quella fase della revisione.

Avviare e definire la revisione

Un processo di revisione viene avviato dal menu Project » Project Activities in Altium Designer. La revisione si applicherà inizialmente al progetto attualmente attivo.

Prendendo come esempio il processo Ad Hoc Review, nel suo formato predefinito non modificato, la finestra di dialogo del modulo iniziale consente al mittente (Barry nell'esempio seguente) di specificare il progetto che verrà revisionato e quali utenti sono assegnati a completare la fase di feedback della revisione.

I campi di immissione e i menu nella finestra di dialogo Ad Hoc Review sono:

• Request title – la modalità predefinita AUTO adotta il nome del processo come base del nome del processo attivo (il titolo dell'attività). Al suo posto è possibile immettere un nome personalizzato.
• Project – il nome del progetto che verrà revisionato. Si tratta del progetto attivo quando il processo viene avviato, ma è possibile selezionare qualsiasi progetto disponibile dalle opzioni del menu a discesa sensibile al testo digitato.
• Description – testo per fornire ulteriori informazioni ai revisori.
• Reviewers – membri del team o gruppi di ruoli specificati ai quali verrà assegnato il compito di inviare il feedback della revisione. Iniziare a digitare per visualizzare le voci disponibili.

Fare clic sul pulsante per avviare il workflow del processo e passare al modulo di definizione dei dati.

La seguente finestra di dialogo del modulo Prepare review data consente di specificare particolari risorse di dati di progettazione e aggiungere allegati. Si noti che qualsiasi testo del modulo evidenziato in blu è un collegamento attivo a tali dati di origine. La finestra di dialogo include anche un diagramma di flusso descrittivo del processo nella scheda Diagram, che indica anche la posizione corrente nelle fasi del flusso.

Le opzioni principali nella finestra di dialogo del modulo sono:

• Data – utilizzare il menu a discesa per selezionare un particolare set di dati di rilascio del progetto (per data), oppure usare l'opzione associata per sfogliare e selezionare uno specifico insieme di dati di rilascio. Nello stato predefinito, in cui non è selezionato alcun dato, i revisori avranno accesso solo ai dati sorgente del progetto.
• Attachments – sfogliare fino a () oppure trascinare i file che si desidera aggiungere come dati di revisione o fonti di informazione.

Quando tutti i dati della revisione sono stati specificati o aggiunti al modulo, fare clic sul pulsante per spostare il processo alla fase di revisione.

A questo punto la Task Prepare review data attiva viene chiusa nel pannello Tasklist poiché la fase di invio della revisione è completata; si noti che l'utente di Altium Designer a questo punto è il mittente del processo di revisione (Initiator). Il processo di revisione in corso viene mostrato nell'elenco Activities del pannello con uno stato attivo. Fare clic sul pulsante per assicurarsi di visualizzare lo stato più recente delle attività.

Per visualizzare lo stato di avanzamento del processo di revisione attivo, selezionare la relativa voce nell'elenco Activities per visualizzare i dati correnti e il diagramma di flusso annotato (scheda Diagram).

Fornire feedback sulla revisione

Una volta configurato e inviato dall'Initiator il processo di revisione, l'attività genererà automaticamente Task da completare da parte di coloro che sono stati specificati come revisori. Quando un revisore (ad esempio, Norm Smith in questo esempio) accede quindi ad Altium Designer, l'area Tasks mostrerà una Task Provide review feedback assegnata.

Selezionando questa Task si attiverà per il revisore la fase di revisione del flusso di processo. La seguente finestra di dialogo del modulo Provide review feedback offre i dati di progetto pertinenti (come specificato dal mittente della revisione), la possibilità di includere commenti e allegati o di aprire il progetto nel Web Viewer () e il requisito di inviare un voto di feedback.

Le opzioni principali nella finestra di dialogo Provide Review feedback sono:

• Open Project – selezionare per aprire il progetto nel Workspace Web Viewer. Questo fornisce una grande quantità di dati di progetto e viste interattive completamente renderizzate dei documenti sorgente di progettazione, consentendo di aggiungere commenti evidenziati e, facoltativamente, assegnarli a un utente specifico (membro del Workspace).
  ► Per ulteriori informazioni, vedere la pagina Web Viewer (Altium 365 Workspace, Enterprise Server Workspace).
• Comment – le note di commento incluse qui saranno attribuite al nome del revisore quando il processo di revisione sarà finalizzato.
• Vote – selezionare un riepilogo appropriato della conclusione della revisione.
• Reviewers attachments – sfogliare fino a () oppure trascinare file, come note più dettagliate o documenti di riferimento, che saranno inclusi nel feedback della revisione.

Si noti che qualsiasi testo evidenziato in blu è un collegamento attivo a tali dati di origine. Selezionare il pulsante per completare il processo di revisione; ciò è indicato nel pannello Tasklist, che chiuderà (rimuoverà) tale task attiva.

Riepilogare e chiudere la revisione

Quando tutti i revisori specificati hanno completato le attività di feedback della revisione loro assegnate, il processo di revisione attivo passa alla fase di riepilogo/chiusura. Viene generata una task Summarize review per l'utente incaricato di valutare l'attività di revisione, in questo caso Barry, lo stesso utente che ha inviato (avviato) la revisione. Si noti che per questo utente il processo di revisione viene mostrato in stato attivo nel pannello Tasklist sotto Activities. Per i revisori, l'attività è ora chiusa perché le loro attività di contributo sono state completate.

Selezionando la task Summarize review nel pannello Tasklist il flusso di revisione passerà alla sua fase finale, come mostrato nella finestra di dialogo del modulo Summarize review.

Le inclusioni degne di nota in questo modulo sono:

• Information provided by reviewers
  • Comment – un elenco dei commenti forniti dai revisori al completamento delle loro attività di revisione.
  • Vote – la valutazione conclusiva della revisione selezionata da ciascun revisore.
  • Review attachments – eventuali file correlati aggiunti all'attività dai revisori.
• Summary
  • Summary note – note conclusive aggiunte dal valutatore del processo di revisione (in questo caso il mittente/iniziatore) che verranno registrate alla chiusura della revisione.

Facendo clic sul pulsante della finestra di dialogo, il processo di Design Review attivo verrà chiuso. Si noti che, con i processi di Design Review più avanzati disponibili, nella fase di valutazione sono inclusi ulteriori passaggi, come la specifica di una conclusione completata/rifiutata o l'avvio di un'attività di rilavorazione del progetto.

Per esaminare la Design Review completata, aggiorna le voci Attività nel pannello Tasklist (), seleziona l'opzione Show Closed nel menu e scegli l'attività chiusa dall'elenco. La seguente finestra di dialogo include un riepilogo delle informazioni della revisione (nella scheda Data) e il diagramma del flusso del processo (scheda Diagram) con lo stato di avanzamento evidenziato, che è Completed, come ci si aspetterebbe.

Processi di revisione personalizzati

I processi di Design Review, così come vengono infine presentati a un utente in Altium Designer, vengono sviluppati e modificati nel Workspace connesso da un amministratore designato. La versatilità degli elementi dei passaggi del flusso e dei moduli UI che si combinano per formare un flusso di lavoro di Design Review consente di creare revisioni che soddisfano un'ampia gamma di esigenze specifiche.

Alcune delle ulteriori opzioni che possono essere applicate ai passaggi e ai moduli sono:

• assegnare qualsiasi passaggio del flusso a un utente o ruolo specifico, diverso da quelli designati come revisori o valutatore.
• negare a un utente o ruolo l'accesso a uno specifico passaggio del flusso di lavoro (un Exception) in modo che venga ignorato nel flusso per tale utente o ruolo.
• rendere obbligatoria la compilazione di un campo del modulo prima che la finestra di dialogo del modulo possa essere inviata.
• aggiungere passaggi intermedi del flusso di lavoro che impongono ulteriori attività e moduli utente.
• creare un ciclo decisionale del flusso di lavoro in cui solo un'azione specifica chiuderà quel ciclo.
• mostrare o nascondere dati particolari o messaggi di evento/errore in un modulo UI di un passaggio del flusso di lavoro.
• utilizzare la funzione Web Viewer del Workspace per consentire l'ispezione dei documenti di progetto e l'inserimento di commenti da parte di revisori che non hanno accesso diretto ai documenti sorgente del progetto.

Come illustrato in precedenza, è possibile creare un numero qualsiasi di processi di revisione e renderli disponibili in Altium Designer, e questi possono essere sviluppati per livelli di revisione che vanno dal feedback informale dei colleghi fino a processi di revisione formali approvati dall'azienda che confluiscono in altri sistemi aziendali (come il PLM).

► Per informazioni dettagliate sulla creazione di processi personalizzati, vedere Definizione di un flusso di lavoro di processo (Altium 365 Workspace, Enterprise Server Workspace).