Cronologia del progetto

Parent page: Progetti del Workspace

Il Workspace di Enterprise Server offre una soluzione elegante alla necessità di una panoramica storica dell'attività di progetto sotto forma di una vista History dedicata e interattiva. Accessibile tramite l'interfaccia browser del Workspace o dall'interno di Altium Designer, la History vista del progetto fornisce una timeline progressiva dei principali eventi relativi al progetto. Gli eventi includono la creazione del progetto, i commit, le release, i cloni e gli scambi MCAD, che a loro volta offriranno comandi di azione sugli eventi ove applicabile.

Accesso alla cronologia del progetto

L'accesso alla History vista di un progetto si ottiene dalla pagina dettagliata di gestione CAD-centrica di quel progetto, ovvero la pagina Projects Management. Fare clic sull'opzione History nel riquadro a sinistra.

La pagina Projects Management stessa si apre dalla pagina principale Projects facendo doppio clic su una voce di progetto, facendo clic sul suo titolo oppure scegliendo l'opzione Open dal menu . Per ulteriori informazioni, vedere Gestione di un progetto specifico.

Accedi alla cronologia di un progetto dalla pagina di gestione dettagliata di quel progetto.

Timeline della cronologia – Panoramica

La History vista presenta una timeline degli eventi di base che si sono verificati durante l'evoluzione del progetto. In sostanza, può essere suddivisa in tre elementi chiave, come mostrato nell'immagine e nelle informazioni seguenti.

Identificazione dei tre componenti chiave della History vista.

1. Main trunk of the timeline. La direzione cronologica degli eventi va dal basso verso l'alto. Il primo evento, la creazione del progetto, apparirà in fondo alla timeline. Gli eventi successivi appariranno sopra, con l'ultimo (l'evento più recente) in cima alla timeline.
2. Events. Ogni volta che si verifica un evento supportato (vedere sotto) associato al progetto, esso viene aggiunto alla timeline come riquadro dedicato. Ogni tipo di evento avrà un riquadro di colore diverso e sarà collegato direttamente al tronco principale della timeline oppure avrà accanto un'icona di associazione (come nel caso degli eventi MCAD Exchange; ).
3. Search. Fare clic sul controllo in alto a destra della vista per accedere a un campo di ricerca che facilita la ricerca di base nella cronologia del progetto. Durante la digitazione della stringa di ricerca, verrà applicato un filtro alla timeline per mostrare solo gli eventi pertinenti a tale ricerca. Per ulteriori informazioni, vedere Ricerca filtrata.

Eventi supportati

La timeline mostra una progressione degli eventi che si verificano durante il ciclo di vita di un progetto. Ognuno di questi eventi appare lungo la timeline come un apposito "riquadro evento". Le sezioni seguenti esaminano la gamma di eventi attualmente supportati e visualizzabili come parte della timeline storica di un progetto.

Creazione del progetto

Related pages: Creazione di un nuovo progetto del Workspace (interfaccia browser / Altium Designer), Rendere disponibile online un progetto esistente, Clonazione di un progetto (interfaccia browser / Altium Designer)

Quando viene creato un progetto, il riquadro evento Project Created verrà aggiunto alla timeline. Questo evento segna l'inizio della timeline storica del progetto. In quanto tale, può sempre essere trovato come voce in fondo alla timeline. Il riquadro di questo evento può apparire in due varianti distinte:

• Quando il progetto viene creato ex novo all'interno del Workspace. Il creatore del progetto viene indicato per nome (e immagine/simbolo), insieme all'ora di creazione del progetto. Anche la descrizione del progetto, se inserita al momento della creazione, viene visualizzata all'interno del riquadro.

• Quando il progetto è un clone di un progetto esistente. La persona che ha creato il progetto clonato viene indicata per nome (e immagine/simbolo), insieme all'ora di creazione del progetto. Anche la descrizione del progetto, se inserita al momento della clonazione, viene visualizzata all'interno del riquadro. Viene fornito un collegamento al progetto sorgente 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.

Il riquadro evento Project Created è collegato fisicamente al tronco principale della timeline con una linea di connessione blu continua e un nodo:

Commit del progetto

Ogni volta che si salva il progetto nel Workspace (dove il progetto è gestito nel repository Versioned Storage Git interno del Workspace), un riquadro evento Project Committed verrà aggiunto alla timeline. La persona che ha eseguito il commit e il push viene indicata per 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 Save to Server, anche questo verrà visualizzato all'interno del riquadro.

Esempio di riquadro evento iniziale Project Committed.

Il riquadro supporta inoltre e presenta informazioni di design diffing, mostrando informazioni più dettagliate su ciò che è cambiato tra il commit corrente e quello precedente. Gli elementi supportati includono file, componenti, net, varianti e struttura PCB. La sezione di diffing del riquadro riepiloga i vari elementi interessati dall'evento di commit, raggruppati secondo i seguenti stati:

– elemento aggiunto.

– elemento rimosso.

– elemento modificato.

Facendo clic sul controllo nel riquadro, questa sezione di diffing si espanderà per presentare gli elementi interessati per nome.

Utilizzare i controlli disponibili Show More e Show Less per esaminare l'elenco completo per ciascun tipo di elemento. Fare clic sul controllo nel riquadro per tornare alla visualizzazione di riepilogo.

Fare clic sul controllo nell'angolo in alto a destra del riquadro per accedere a un menu con i seguenti comandi:

• View – utilizzare questo comando per aprire i dati sorgente del progetto del commit selezionato nel Web Viewer come snapshot del progetto in quel momento.
• Create Tag – aggiunge un nome di tag VCS al commit attualmente selezionato. I tag associati a un commit compaiono nel riquadro della vista Cronologia, nell'intestazione della relativa vista snapshot nel Web Viewer e in tutti i commenti associati a quella vista snapshot. Una volta aggiunto un tag a un commit, il comando del menu del riquadro cambia in Tag e offre sotto-opzioni per modificare (Edit) o eliminare (Remove) il tag del commit.

Selezionare l'opzione di menu Create Tag per aggiungere un nome di tag a un evento Cronologia di commit.

La vista snapshot di un evento di commit della Cronologia con tag è etichettata con il nome del tag.

Quando i commenti vengono visualizzati nel progetto WIP live, quelli creati nello snapshot del progetto di un commit con tag includeranno il nome del tag associato. Selezionare il collegamento del nome del tag per aprire lo snapshot del commit correlato. Vedere Commenti del Web Viewer per ulteriori informazioni su come lavorare con i commenti.

I commenti aggiunti a uno snapshot di un evento di commit con tag includeranno il nome del tag associato.

• Schematic to – consente di confrontare i dati dello schema in questo commit con quelli di un altro evento di commit o release. Utilizzare il sottomenu per confrontare con i dati sorgente del commit precedente oppure selezionare tra tutti i possibili commit o release. Una volta scelta la release/il commit di confronto, i risultati del confronto vengono presentati nella vista Compare, che si apre come nuova scheda nel browser web predefinito. Per ulteriori informazioni, vedere Confronto schematico.
• BOM to – consente di confrontare i dati BOM in questo commit con quelli di un altro evento di commit o release. Utilizzare il relativo sottomenu per confrontare con i dati BOM del commit precedente oppure selezionare tra tutti i commit/release effettuati per il progetto. Una volta scelto l'obiettivo del confronto, i risultati vengono presentati come un elenco di voci BOM con codifica a colori che rappresentano gli elementi modificati tra gli eventi Commit/Release specificati. Viene generato un riepilogo aggregato delle modifiche in formato CSV standard e reso disponibile per il download in un file archivio ZIP. Per ulteriori informazioni, vedere Confronto BOM.

• Clone – usa questo comando per creare un clone da quella specifica revisione del progetto. Verrà visualizzata la finestra Clone Project, nella quale definire il Name del progetto, il Description e, nelle opzioni Advanced, il Server Folder e il Repository di destinazione. Nota che il testo del banner della finestra indica da quale revisione del progetto viene creato il clone. Una volta definite le informazioni richieste, fai clic sul pulsante . Il progetto verrà creato e un riquadro evento Project Cloned verrà aggiunto alla timeline.

Puoi creare un clone da qualsiasi revisione specifica del progetto attivo, direttamente dal corrispondente riquadro evento Project Committed per quella revisione.

• Download Sources – usa questo comando per scaricare i sorgenti del progetto per quella specifica revisione del progetto, in un archivio Zip. Il nome del file Zip e del file di progetto PCB includerà la data e l'ora (in UTC) in cui quella revisione del progetto è stata sottoposta a commit e inviata al Workspace.

Un riquadro evento Project Committed è fisicamente collegato al tronco principale della timeline con una linea di collegamento blu continua e un nodo: . L'ultima revisione del progetto (ovvero l'ultimo commit) si distingue per avere un riempimento bianco del nodo: .

Rilascio del progetto

Related page: Rilascio del progetto di progettazione

Ogni volta che esegui un rilascio del progetto, utilizzando il Project Releaser di Altium Designer, un riquadro evento Project Released verrà aggiunto alla timeline. La persona che ha eseguito il rilascio viene indicata per nome (e immagine), 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 dialog, anche questa verrà visualizzata nel riquadro. Verranno inoltre elencati tutti i set di dati inclusi nel rilascio.

Esempio di riquadro evento Project Released.

Fai clic sul controllo nell'angolo in alto a destra del riquadro per accedere a un menu con i seguenti comandi:

• View – apre un portale di produzione dedicato (in una scheda separata del browser) con cui ispezionare più da vicino i dati rilasciati. Da questo portale puoi visualizzare e navigare i dati dei file rilasciati, ispezionare la BOM e visualizzare e commentare l'istantanea del progetto stesso, ovvero i sorgenti di quei dati rilasciati. Avrai inoltre accesso ai controlli per scaricare i dati di produzione a vari livelli di granularità, dall'intero set di dati ai singoli file di output generati. Un rilascio selezionato può anche essere inviato, come Manufacturing Package, direttamente al tuo produttore. Per ulteriori informazioni, vedi la consultazione di un Release Package nel Manufacturing Portal.

Accesso alla scheda dedicata Manufacturing Portal, con cui ispezionare più da vicino il rilascio del progetto.

• Schematic to – consente di confrontare i dati dello schema in questo rilascio con quelli di un altro evento di rilascio o commit. Usa il sottomenu per confrontare con i dati sorgente del rilascio precedente, oppure seleziona tra tutti i possibili rilasci e commit. Una volta scelto il rilascio/commit di confronto, i risultati vengono presentati nella vista Compare, che si apre come nuova scheda nel browser web predefinito. Per ulteriori informazioni, vedi Schematic Comparison.
• Gerber to – consente di confrontare i dati Gerber generati per questo rilascio con un altro set di dati Gerber. Usa il relativo sottomenu per confrontare con i dati di fabbricazione del rilascio precedente, selezionare tra tutti i rilasci effettuati per il progetto (la timeline verrà filtrata per mostrare solo i riquadri evento Project Released) oppure confrontare con un set di file generato localmente (e caricato). Una volta scelto l'obiettivo del confronto, i risultati vengono presentati nella Gerber Compare view, che si apre in una scheda separata del browser. Per ulteriori informazioni, vedi Gerber Comparison.

• BOM To – consente di confrontare i dati della distinta base (BoM) in questo rilascio con quelli di un altro rilascio. Usa il relativo sottomenu per confrontare con i dati BOM del rilascio precedente, oppure seleziona tra tutti i rilasci effettuati per il progetto. Una volta scelto l'obiettivo del confronto, i risultati vengono presentati come un elenco di voci BOM con codifica a colori che rappresentano gli elementi modificati tra gli eventi Commit/Release specificati. Viene generato un riepilogo aggregato delle modifiche in formato CSV standard e reso disponibile per il download in un archivio ZIP. Per ulteriori informazioni, vedi BOM Comparison.
• Download Outputs – consente di scegliere, tramite una subsequent window, quali set di dati del pacchetto di rilascio scaricare. Una volta effettuate le scelte, fai clic sul pulsante . Verrà scaricato un singolo archivio Zip contenente cartelle per ciascuno dei set di dati selezionati.
• Download Sources– consente di scaricare l'istantanea della versione del progetto utilizzata per creare quel pacchetto di rilascio, come archivio Zip.

Clonazione del progetto

Related page: Clonazione di un progetto (interfaccia browser / Altium Designer)

Ogni volta che cloni il progetto, sia tramite l'interfaccia browser del Workspace sia dall'interno di Altium Designer, un riquadro evento Project Cloned verrà aggiunto alla timeline. La persona che ha eseguito il clone viene indicata per nome (e immagine), insieme alla data e all'ora. Al momento della clonazione viene aggiunta al riquadro una descrizione generata automaticamente, che può essere sostituita inserendo una nuova descrizione. Viene fornito un collegamento al progetto clonato: facendo clic su di esso si accede alla pagina di gestione dettagliata di quel progetto, che si apre in una scheda separata del browser.

Esempio di riquadro evento Project Cloned.

Scambi MCAD

Related page: Altium MCAD CoDesigner

Quando si lavora tra i domini della progettazione elettronica e meccanica, il Workspace funge da ponte tra i due, facilitando la co-progettazione diretta ECAD-MCAD. Ogni volta che vengono apportate modifiche al progetto PCB del progetto e tali modifiche vengono inviate al Workspace tramite il relativo pannello CoDesigner, un riquadro evento MCAD Changes Suggested verrà aggiunto alla timeline. La persona che ha eseguito l'invio viene indicata per 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 verrà visualizzato nel riquadro.

Quando l'ingegnere MCAD apporta modifiche al PCB nel proprio software MCAD supportato e le reinvia al Workspace, il corrispondente evento di invio sarà disponibile nella timeline della cronologia del progetto only dopo aver scaricato le modifiche dal Workspace in Altium Designer.

Esempio che mostra due eventi correlati a MCAD. L'evento inferiore nel tronco della timeline rappresenta un evento di invio dal lato ECAD, mentre l'evento superiore è il reinvio dal lato MCAD.

Ricerca filtrata

Fai clic sul controllo in alto a destra della vista per accedere a un campo di ricerca con cui trovare rapidamente gli eventi di interesse lungo la timeline. La funzione di ricerca supporta la ricerca di base nella cronologia del progetto, con filtraggio dinamico applicato mentre digiti la stringa di ricerca, lasciando visualizzati nella pagina solo gli eventi pertinenti a quella ricerca. Il testo corrispondente all'interno di un riquadro evento viene evidenziato.

Esempio di ricerca nella cronologia di un progetto. La timeline viene filtrata dinamicamente mentre digiti il termine di ricerca (senza distinzione tra maiuscole e minuscole), con le voci corrispondenti evidenziate all'interno di ciascun riquadro evento pertinente.

La funzione di ricerca lavora con le seguenti informazioni:

• Titolo del riquadro evento.
• Nome della persona che ha eseguito l'evento.
• Testo descrittivo (il testo derivato da un commento/nota/descrizione quando si è verificato l'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 creato tramite clonazione).

Per cancellare il filtraggio corrente e tornare alla timeline completa, svuota il campo di ricerca, selezionando il testo corrente e premendo il tasto Backspace , oppure facendo clic sul controllo all'estrema destra del campo. In alternativa, fai clic sul controllo Clear Filter nel riquadro che riepiloga quanti eventi sono visualizzati (nella parte superiore della vista).

Aggiornamento con nuovi eventi

Ogni volta che si verifica un evento supportato relativo al progetto, tale evento verrà rilevato e reso automaticamente disponibile nella History vista. Una notifica apparirà nella parte inferiore della vista poco dopo che l’evento si è verificato: fare clic sul controllo per aggiornare la timeline con il nuovo evento.

È disponibile anche un aggiornamento manuale, eseguibile facendo clic sul controllo nell’angolo in alto a destra della vista.