Cronologia del progetto

Il Workspace di Enterprise Server fornisce un'elegante soluzione all'esigenza 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, ove applicabile, comandi di azione sugli eventi.

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 stessa pagina Projects Management viene aperta 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.

Accedere alla cronologia di un progetto dalla relativa pagina di gestione dettagliata.

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à nella parte inferiore della timeline. Gli eventi successivi appariranno sopra, con il più recente (l'evento più attuale) nella parte superiore della 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 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. Pertanto, può sempre essere trovato come voce nella parte inferiore della 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 collegamento blu continua e un nodo:

Commit del progetto

Ogni volta che si salva il progetto nel Workspace (dove il progetto è gestito nel repository 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 e presenta anche 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 in base ai seguenti stati:

– elemento aggiunto.

– elemento rimosso.

– elemento modificato.

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

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 design del commit selezionato nel Web Viewer come snapshot del design in quel momento.
• Create Tag – aggiunge un nome di tag VCS al commit attualmente selezionato. I tag associati a un commit compaiono nel relativo riquadro della vista History, nell'intestazione della relativa vista snapshot nel Web Viewer e in tutti i commenti associati a tale 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 History di commit.

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

Quando i commenti vengono visualizzati nel design WIP live, quelli creati nello snapshot di design 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 Web Viewer Comments 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 schematico 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 scelto il commit/release 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 Schematic Comparison.
• PCB to – consente di confrontare i dati PCB 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 scelto il commit/release 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 PCB Comparison.
• 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 del confronto 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 BOM Comparison.
• 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 alla timeline verrà aggiunto un riquadro evento Project Cloned.

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 il sorgente del progetto per quella specifica revisione del progetto, in un archivio Zip. Il nome del file Zip e del file di progetto PCB includeranno 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 è collegato fisicamente al tronco principale della timeline con una linea di connessione blu continua e un nodo: . L'ultima revisione del progetto, ovvero l'ultimo commit, si distingue per il riempimento bianco del suo 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, alla timeline verrà aggiunto un riquadro evento Project Released. La persona che ha eseguito il rilascio viene indicata per nome (e immagine), insieme a data e 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, che consente di 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 il sorgente 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. Per ulteriori informazioni, vedi la consultazione di un pacchetto di rilascio 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 del confronto vengono presentati nella vista Compare, che si apre come nuova scheda nel browser web predefinito. Per ulteriori informazioni, vedi Schematic Comparison.
• PCB to– consente di confrontare i dati PCB 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 del confronto vengono presentati nella vista Compare, che si apre come nuova scheda nel browser web predefinito. Per ulteriori informazioni, vedi PCB 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 scelto generato localmente (e caricato). Una volta scelto l'obiettivo del confronto, i risultati vengono presentati nella vista Gerber Compare, che si apre in una scheda separata del browser. Per ulteriori informazioni, vedi Gerber Comparison.
• BOM To– consente di confrontare i dati della Bill of Materials (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 del confronto 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, vedi BOM Comparison.
• Download Outputs– consente di scegliere, tramite una subsequent window, quali set di dati del pacchetto di rilascio scaricare. Dopo aver effettuato le scelte, fai clic sul pulsante . Verrà scaricato un singolo archivio Zip contenente cartelle per ciascuno dei set di dati scelti.
• 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 (browser interface / Altium Designer)

Ogni volta che cloni il progetto, sia tramite l'interfaccia browser del Workspace sia dall'interno di Altium Designer, alla timeline verrà aggiunto un riquadro evento Project Cloned. La persona che ha eseguito il clone viene indicata per nome (e immagine), insieme a data e ora. Al momento della clonazione viene aggiunta al riquadro una descrizione generata, 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, alla timeline verrà aggiunto un riquadro evento MCAD Changes Suggested. La persona che ha eseguito l'invio viene indicata per nome (e immagine), insieme a data e 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 recuperato 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 quello 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 una 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, ovvero il testo derivato da un commento/nota/descrizione quando si è verificato l'evento pertinente.
• Testo dei dati di differenza, 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 filtro corrente e tornare alla timeline completa, svuota il campo di ricerca: seleziona il testo attuale e premi il tasto Backspace , oppure fai 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 vista History . Una notifica apparirà nella parte inferiore della vista poco dopo che l'evento si è verificato: fai clic sul controllo per aggiornare la timeline con il nuovo evento.

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