Cronologia del progetto
A colpo d'occhio
- Scopri dove trovare la vista Cronologia e come la sua sequenza temporale organizza gli eventi del progetto.
- Comprendi i requisiti del controllo di versione per visualizzare la cronologia dei commit.
- Scopri come esaminare le modifiche dei commit, aprire le istantanee delle versioni precedenti del progetto e aggiungere tag ai commit.
Non poter accedere facilmente alla cronologia dello sviluppo di un progetto è spesso motivo di frustrazione per progettisti e responsabili di prodotto. Troppo spesso, un progettista deve destreggiarsi tra strumenti esterni di gestione VCS che possono richiedere competenze piuttosto avanzate per essere utilizzati: un notevole dispendio di tempo quando si desidera svolgere semplici attività di gestione del progetto. Anche se si ha dimestichezza con gli strumenti VCS esterni, questi gestiscono solo alcuni aspetti del progetto: operazioni legate al controllo versione come apertura, clonazione e ripristino di versioni precedenti. Ma che dire della gestione del progetto nel suo complesso, inclusi i rilasci e gli scambi MCAD? Senza dimenticare che, in genere, quasi tutte queste attività richiedono di rimanere vincolati al computer desktop.
Offrendo una soluzione elegante all'esigenza di visualizzare queste informazioni e interagire con esse da un unico punto, il Workspace Altium 365 introduce il concetto di Project History. Accessibile dall'interfaccia browser del Workspace (parte integrante dell'interfaccia della piattaforma Altium 365) o da Altium Designer, una vista History dedicata offre una sequenza temporale progressiva degli eventi principali relativi al progetto, ovvero creazione, commit, rilasci, clonazioni e scambi MCAD, con varie azioni disponibili dove applicabili, come la visualizzazione di un'istantanea dei file sorgente del progetto.
Accesso alla cronologia del progetto
La vista History di un progetto è accessibile dalla pagina di gestione dettagliata del progetto stesso. Fare clic sulla voce History nel riquadro a sinistra.
Accedere alla cronologia di un progetto dalla relativa pagina di gestione dettagliata.
Sequenza temporale della cronologia: panoramica
La vista History presenta una sequenza temporale degli eventi principali verificatisi durante l'evoluzione del progetto. Può essere suddivisa essenzialmente in tre sezioni chiave, come illustrato nell'immagine seguente e descritto più avanti.
Identificazione dei tre componenti chiave della vista History .
- Main trunk of the timeline. Gli eventi sono ordinati cronologicamente dal basso verso l'alto. Il primo evento, ovvero la creazione del progetto, viene visualizzato in fondo alla sequenza temporale. Gli eventi successivi vengono visualizzati più in alto, con l'ultimo evento (quello più recente) in cima alla sequenza temporale.
- Events. Ogni volta che si verifica un evento supportato (vedere di seguito) associato al progetto, tale evento viene aggiunto alla sequenza temporale come riquadro dedicato. Ogni tipo di evento avrà un riquadro di colore diverso e sarà collegato direttamente alla linea principale della sequenza temporale oppure presenterà un'icona aggiuntiva accanto (come nel caso degli eventi di scambio MCAD).
-
Search. Fare clic sul controllo
in alto a destra nella vista per accedere a un campo di ricerca che consente di eseguire ricerche semplici nella cronologia del progetto. Durante la digitazione della stringa di ricerca, la sequenza temporale viene filtrata per mostrare solo gli eventi pertinenti. Per ulteriori informazioni, consultare Ricerca con filtri.
Eventi supportati
La sequenza temporale mostra il susseguirsi degli eventi che si verificano durante il ciclo di vita di un progetto. Ciascuno di questi eventi viene visualizzato lungo la sequenza temporale come un «riquadro evento» dedicato. Le sezioni seguenti illustrano i tipi di eventi attualmente supportati e visualizzabili nella cronologia di un progetto.
Creazione del progetto
Related pages: Creazione di un nuovo progetto gestito (interfaccia browser / Altium Designer), Disponibilità online di un progetto esistente, Clonazione di un progetto (interfaccia browser / Altium Designer)
Quando viene creato un progetto, il riquadro evento Project Created viene aggiunto alla sequenza temporale. Questo evento segna l'inizio della cronologia del progetto. Di conseguenza, si trova sempre in fondo alla sequenza temporale. Il riquadro di questo evento può presentarsi in due varianti distinte:
- Quando il progetto viene creato da zero nel Workspace. Vengono mostrati il nome (e l'immagine) dell'autore del progetto, insieme alla data e all'ora di creazione. Nel riquadro viene visualizzata anche la descrizione del progetto, se è stata inserita al momento della creazione.
- Quando il progetto è un clone di un progetto esistente. La persona che ha creato il progetto clonato viene indicata con nome (e immagine), insieme alla data e all'ora di creazione del progetto. Nel riquadro viene visualizzata anche la descrizione del progetto, se è stata inserita al momento della clonazione. È disponibile un collegamento al progetto originale: facendo clic su di esso si accede alla pagina di gestione dettagliata di quel progetto, che si apre in una scheda separata del browser.
Commit del progetto
Ogni volta che si esegue un Commit & Push del progetto nel Workspace (dove il progetto è gestito nel repository Git Versioned Storage interno del Workspace), alla sequenza temporale viene aggiunto un riquadro dell'evento Project Committed. La persona che ha eseguito il commit e il push viene indicata con nome (e immagine), insieme alla data e all'ora. Se al momento del commit e del push è stato aggiunto un commento, tramite la finestra di dialogo Commit nel controllo di versione, anche questo viene visualizzato nel riquadro.
Esempio di riquadro dell'evento Project Committed iniziale.
Il riquadro supporta e presenta anche informazioni sulle differenze di progettazione, mostrando maggiori dettagli sulle modifiche tra il commit corrente e quello precedente. Gli elementi supportati includono file, componenti, net, varianti e struttura del PCB. La sezione delle differenze del riquadro riepiloga i vari elementi interessati dall'evento di commit, raggruppati in base ai seguenti stati:
– elemento aggiunto.
– elemento rimosso.
– elemento modificato.
Facendo clic sul controllo
nel riquadro, questa sezione delle differenze viene espansa per mostrare per nome gli elementi interessati.
Fare clic sul controllo
nell'angolo superiore destro del riquadro per accedere a un menu con i seguenti comandi:
- View – utilizzare questo comando per aprire i dati sorgente di progettazione del commit selezionato nel Web Viewer come istantanea del progetto in quel momento.
- Create Tag – aggiunge un nome di tag VCS al commit attualmente selezionato. I tag associati a un commit vengono visualizzati nel relativo riquadro della vista Cronologia, nell'intestazione della relativa vista istantanea nel Web Viewer e in tutti i commenti associati a tale vista istantanea. Una volta aggiunto un tag a un commit, il comando nel menu del riquadro diventa Tag e offre opzioni secondarie per modificare (Edit) o eliminare (Remove) il tag del commit.
Selezionare l'opzione di menu Crea tag per aggiungere un nome di tag a un evento di commit nella Cronologia.
La vista istantanea di un evento di commit con tag nella Cronologia è contrassegnata con il nome del tag.
Quando i commenti vengono visualizzati nel progetto WIP corrente, quelli creati nell'istantanea di progettazione di un commit con tag includeranno il nome del tag associato. Selezionare il collegamento del nome del tag per aprire l'istantanea del commit corrispondente. Per ulteriori informazioni sull'utilizzo dei commenti, vedere Commenti nel Web Viewer.
I commenti aggiunti a un'istantanea di un evento di commit con tag includeranno il nome del tag associato.
All'evento di commit associato a un rilascio del progetto, creato tramite Project Releaser di Altium Designer, viene assegnato automaticamente un tag con l'ID di revisione del rilascio. Se necessario, il tag di revisione del commit risultante può essere successivamente modificato o eliminato. Per informazioni al riguardo, vedere Rilascio in un Workspace.
Al commit associato a un rilascio viene assegnato automaticamente da Altium Designer un tag con l'ID del rilascio.
- Schematic to – consente di confrontare i dati dello schema elettrico di questo commit con quelli di un altro evento di commit o di rilascio. Utilizzare il sottomenu per eseguire il confronto con i dati sorgente del commit precedente oppure selezionare tra tutti i commit o i rilasci disponibili. Una volta scelto il rilascio o il commit di confronto, i risultati vengono presentati nella vista Confronto, che si apre come nuova scheda nel browser web predefinito. Per ulteriori informazioni, vedere Confronto degli schemi elettrici.
- PCB to – consente di confrontare i dati del PCB di questo commit con quelli di un altro evento di commit o di rilascio. Utilizzare il sottomenu per eseguire il confronto con i dati sorgente del commit precedente oppure selezionare tra tutti i commit o i rilasci disponibili. Una volta scelto il rilascio o il commit di confronto, i risultati vengono presentati nella vista Confronto, che si apre come nuova scheda nel browser web predefinito. Per ulteriori informazioni, vedere Confronto dei PCB.
- BOM to – consente di confrontare i dati della BOM di questo commit con quelli di un altro evento di commit o di rilascio. Utilizza il sottomenu associato per confrontarli con i dati della BOM del commit precedente oppure scegli tra tutti i commit e i rilasci effettuati per il progetto. Una volta scelto l'elemento con cui effettuare il confronto, i risultati vengono presentati sotto forma di elenco di voci della BOM con codifica a colori, che rappresentano gli elementi modificati tra gli eventi di commit/rilascio specificati. Viene generato un riepilogo delle modifiche in formato CSV standard, disponibile per il download in un archivio ZIP. Per ulteriori informazioni, consulta Confronto delle BOM.
-
Clone – utilizza questo comando per creare un clone a partire da quella specifica revisione del progetto. Viene visualizzata la finestra Clone Project, nella quale puoi definire Name, Description e Parent Folder del progetto (all'interno del Workspace). Nota che il testo del banner della finestra indica la revisione del progetto da cui viene creato il clone. Dopo aver definito le informazioni necessarie, fai clic sul pulsante
. Il progetto viene creato e alla sequenza temporale viene aggiunto un riquadro evento Project Cloned.
Puoi creare un clone da qualsiasi revisione specifica del progetto attivo, direttamente dal riquadro evento Project Committed corrispondente a quella revisione.
- Download Sources – utilizza questo comando per scaricare i file sorgente di quella specifica revisione del progetto in un archivio ZIP. Il nome del file ZIP e quello del file di progetto PCB includeranno la data e l'ora (UTC) in cui è stato eseguito il commit di quella revisione del progetto e il relativo push nel Workspace.
Rilascio del progetto
Related page: Rilascio del progetto di progettazione
Ogni volta che esegui un rilascio del progetto utilizzando Project Releaser di Altium Designer, alla sequenza temporale viene aggiunto un riquadro evento Project Released. Vengono mostrati il nome e la foto della persona che ha eseguito il rilascio, insieme alla data e all'ora. Se al momento del rilascio dei dati generati nel Workspace è stata aggiunta una nota di rilascio, tramite la finestra di dialogo Confirm Release, anche questa viene visualizzata nel riquadro. Vengono inoltre elencati tutti i set di dati inclusi nel rilascio, con l'indicazione dello stato del ciclo di vita.
Esempio di riquadro evento Project Released.
Fai clic sul controllo
nell'angolo superiore destro del riquadro per accedere a un menu con i seguenti comandi:
- View – apre un portale di produzione dedicato (in una scheda separata del browser) che consente di esaminare più nel dettaglio i dati rilasciati. Da questo portale puoi visualizzare ed esplorare i dati dei file rilasciati, esaminare la BOM e visualizzare e commentare l'istantanea del progetto stesso, ovvero la sorgente dei dati rilasciati. Avrai inoltre accesso ai controlli per scaricare i dati di produzione a vari livelli di dettaglio, dai set di dati completi ai singoli file di output generati. Un rilascio selezionato può anche essere inviato, come Manufacturing Package, direttamente al produttore. Per ulteriori informazioni, consulta Esplorazione di un pacchetto di rilascio tramite il portale di produzione.
Accesso alla scheda dedicata Manufacturing Portal, che consente di esaminare più nel dettaglio il rilascio del progetto.
- Schematic to – consente di confrontare i dati dello schema di questo rilascio con quelli di un altro evento di rilascio o di commit. Utilizza il sottomenu per confrontarli con i dati sorgente del rilascio precedente oppure scegli tra tutti i rilasci e i commit disponibili. Una volta scelto il rilascio o il commit con cui effettuare il confronto, i risultati vengono presentati nella vista Compare, che si apre in una nuova scheda del browser web predefinito. Per ulteriori informazioni, consulta Confronto degli schemi.
Confronto dei dati dello schema tra due rilasci del progetto di progettazione.
- PCB to – consente di confrontare i dati PCB di questo rilascio con quelli di un altro evento di rilascio o di commit. Utilizza il sottomenu per confrontarli con i dati sorgente del rilascio precedente oppure scegli tra tutti i rilasci e i commit disponibili. Una volta scelto il rilascio o il commit con cui effettuare il confronto, i risultati vengono presentati nella vista Compare, che si apre in una nuova scheda del browser web predefinito. Per ulteriori informazioni, consulta Confronto dei PCB.
Confronto dei dati PCB tra due rilasci del progetto di progettazione.
- Gerber to – consente di confrontare i dati Gerber generati per questo rilascio con un altro set di dati Gerber. Utilizza il sottomenu associato per confrontarli con i dati di fabbricazione del rilascio precedente, scegliere tra tutti i rilasci effettuati per il progetto (la sequenza temporale verrà filtrata per mostrare solo i riquadri evento Project Released) oppure effettuare il confronto con un set di file generato localmente e caricato. Una volta scelto l'elemento con cui effettuare il confronto, i risultati vengono presentati nella vista Gerber Compare , che si apre in una scheda separata del browser. Per ulteriori informazioni, consulta Confronto dei Gerber.
Confronto dei dati Gerber generati tra due rilasci del progetto di progettazione.
- BOM to – consente di confrontare i dati della BOM di questo rilascio con quelli di un altro evento di commit o di rilascio. Utilizza il sottomenu associato per confrontarli con i dati della BOM del commit precedente oppure scegli tra tutti i commit e i rilasci effettuati per il progetto. Una volta scelto l'elemento con cui effettuare il confronto, i risultati vengono presentati sotto forma di elenco di voci della BOM con codifica a colori, che rappresentano gli elementi modificati tra gli eventi di commit/rilascio specificati. Viene generato un riepilogo delle modifiche in formato CSV standard, disponibile per il download in un archivio ZIP. Per ulteriori informazioni, consulta Confronto delle BOM.
Download di un confronto dei dati della BOM generati tra due eventi del progetto di progettazione.
-
Download Outputs – consente di scegliere, tramite una finestra successiva, quali set di dati di output scaricare dal pacchetto di rilascio. Dopo aver effettuato le scelte, fai clic sul pulsante
. Verrà scaricato un unico archivio ZIP contenente una cartella per ciascuno dei set di dati scelti.
- Download Sources – consente di scaricare, come archivio ZIP, i dati sorgente della versione del progetto utilizzata per creare quel pacchetto di rilascio.
Clonazione del progetto
Related page: Clonazione di un progetto (interfaccia browser / Altium Designer)
Ogni volta che cloni il progetto, tramite l'interfaccia browser del Workspace o da Altium Designer, alla sequenza temporale viene aggiunto un riquadro evento Project Cloned. La persona che ha eseguito la clonazione viene identificata con nome e immagine, insieme alla data e all'ora. Se durante la clonazione è stata aggiunta una descrizione, tramite la finestra Clone Project (nel browser) o la finestra di dialogo Clona progetto (in Altium Designer), anche questa viene visualizzata nel riquadro. Viene fornito un collegamento al progetto clonato: facendo clic si accede alla pagina di gestione dettagliata del progetto, che si apre in una scheda separata del browser.
Esempio di riquadro evento Project Cloned.
Scambi MCAD
Related page: Ulteriori informazioni sulla coprogettazione ECAD-MCAD
Quando si lavora tra gli ambiti della progettazione elettronica e meccanica, il Workspace funge da ponte tra i due, facilitando la coprogettazione diretta ECAD-MCAD. Ogni volta che vengono apportate modifiche al progetto PCB e queste vengono inviate al Workspace tramite il relativo pannello CoDesigner, alla sequenza temporale viene aggiunto un riquadro evento MCAD Changes Suggested. La persona che ha eseguito l'invio viene identificata con nome e immagine, insieme alla data e all'ora. Se al momento dell'invio è stato pubblicato un messaggio, tramite il pannello MCAD CoDesigner (Altium Designer) o il pannello Altium CoDesigner (nel software MCAD supportato), anche questo viene visualizzato nel riquadro.
Esempio di riquadro evento MCAD Changes Suggested.
Quando il progettista MCAD apporta modifiche al PCB nel proprio software MCAD supportato e le invia al Workspace, l'evento di invio corrispondente viene visualizzato automaticamente nella sequenza temporale della cronologia del progetto. Potrebbe essere necessario aggiornare la pagina Cronologia per visualizzare l'ultima modifica.
Esempio di due eventi relativi a MCAD. A sinistra dell'asse della sequenza temporale è riportato l'evento di invio dal lato ECAD, mentre a destra quello dal lato MCAD.
Ricerca con filtro
Fai clic sul controllo
in alto a destra nella vista per accedere a un campo di ricerca con cui trovare rapidamente gli eventi di interesse lungo la sequenza temporale. La funzione di ricerca supporta ricerche di base nella cronologia del progetto, applicando un filtro dinamico mentre digiti la stringa di ricerca, in modo da lasciare visibili nella pagina solo gli eventi pertinenti. Il testo corrispondente all'interno di un riquadro evento viene evidenziato.
Esempio di ricerca nella cronologia di un progetto. La sequenza temporale viene filtrata dinamicamente mentre digiti il termine di ricerca (senza distinzione tra maiuscole e minuscole), con le corrispondenze evidenziate in ciascun riquadro evento pertinente.
La funzione di ricerca opera sulle seguenti informazioni:
- Titolo del riquadro evento.
- Nome della persona che ha eseguito l'evento.
- Testo descrittivo (il testo ricavato da un commento, una nota o una descrizione inseriti al verificarsi dell'evento pertinente).
- Testo dei dati di confronto, in un riquadro evento Project Committed.
- Nome del set di dati, in un riquadro evento Project Released.
- Nome del progetto, in un riquadro evento Project Cloned e in un riquadro evento Project Created (quando viene creato tramite clonazione).
Aggiornamento con nuovi eventi
Ogni volta che si verifica un evento supportato relativo al progetto, questo viene rilevato e reso disponibile automaticamente nella vista History . Una notifica compare nella parte inferiore della vista poco dopo che l'evento si è verificato: fai clic sul controllo
per aggiornare la sequenza temporale con il nuovo evento.