Cronologia del progetto

Updated: September 01, 2022 | Applies to version: 5.5

Now reading version 5.5. For the latest, read: Cronologia del progetto for version 8.1

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

Accesso alla cronologia del progetto

L'accesso alla History vistaHistory di un progetto si ottiene dalla pagina dettagliata di gestione incentrata sul CAD per quel progetto, ovvero la pagina Projects ManagementProjects Management. Fare clic sull'opzione HistoryHistory nel riquadro a sinistra.

La pagina Projects ManagementProjects Management stessa viene aperta dalla pagina principale ProjectsProjects facendo doppio clic su una voce di progetto, facendo clic sul suo titolo oppure scegliendo l'opzione OpenOpen dal menu

. Per ulteriori informazioni, vedere Gestione di un progetto specifico.

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

La HistoryvistaHistory del progetto generata dal Workspace è disponibile anche in Altium Designer. Per caricare la vista in Altium Designer, selezionare l'opzione History & Version Control » Show Project HistoryHistory & Version Control » Show Project History dal menu contestuale accessibile con il tasto destro sul nome del progetto nel pannello Projects. La vista può anche essere aperta dall'opzione di menu HistoryHistory nella vista del progetto aperto del pannello Explorer.

Si noti che le azioni evento disponibili nella Cronologia sul lato Altium Designer differiscono da quelle sul lato dell'interfaccia browser. In particolare, sul lato Altium Designer è possibile ripristinare il progetto a uno snapshot precedentemente sottoposto a commit (Revert toRevert to) e anche aprire una release nell'ambiente di modifica (Open SnapshotOpen Snapshot).

► Vedere Cronologia del progetto in Altium Designer per ulteriori informazioni.

Timeline della cronologia – Panoramica

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

Identificazione dei tre componenti chiave della History vistaHistory .

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 appaiono sopra, con l'ultimo (l'evento più recente) in cima alla timeline.
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; ).
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 presentare solo gli eventi pertinenti a tale ricerca. Per ulteriori informazioni, vedere Ricerca filtrata.

Eventi supportati

La timeline mostra una progressione di eventi che si verificano durante il ciclo di vita di un progetto. Ognuno di questi eventi appare lungo la timeline come un "riquadro evento" dedicato. Le sezioni seguenti esaminano la gamma di eventi attualmente supportati e presentabili 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 CreatedProject 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 per questo evento può apparire in due varianti distinte:

Quando il progetto viene creato ex novo all'interno del Workspace. Il creatore del progetto viene presentato 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 presentata 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 accederà alla pagina di gestione dettagliata di quel progetto, che si apre in una scheda separata del browser.

Il riquadro evento Project CreatedProject 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 Git interno del Workspace), un riquadro evento Project CommittedProject Committed verrà aggiunto alla timeline. La persona che ha eseguito il commit e il push viene presentata 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.

Se il progetto era un progetto locale successivamente reso disponibile online, allora la descrizione inserita nella finestra di dialogo Make Available Online verrà utilizzata sia nel riquadro evento Project CreatedProject Created sia nel riquadro evento iniziale Project CommittedProject Committed, poiché il commit e il push del progetto vengono eseguiti come parte della procedura per rendere il progetto disponibile online, a condizione naturalmente che l'opzione Enable Formal Version ControlEnable Formal Version Control fosse abilitata.

Esempio di riquadro evento iniziale Project CommittedProject 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 gli elementi interessati per nome.

Utilizzare i controlli disponibili Show MoreShow More e Show LessShow 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:

Clone – utilizzare questo comando per creare un clone da quella specifica revisione del progetto. Verrà visualizzata la finestra Clone ProjectClone Project con cui determinare il NameName del progetto, DescriptionDescription e, nelle opzioni AdvancedAdvanced, il Server FolderServer Folder e il RepositoryRepository di destinazione. Si noti che il testo del banner della finestra riflette da quale revisione del progetto viene creato il clone. Una volta definite le informazioni richieste, fare clic sul pulsante . Il progetto verrà creato e un riquadro evento Project ClonedProject Cloned verrà aggiunto alla timeline.

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

Download Snapshot – utilizzare 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 includerà la data e l'ora (in UTC) in cui quella revisione del progetto è stata sottoposta a commit e push nel Workspace.

Un riquadro evento Project CommittedProject 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 avere un riempimento bianco per il suo nodo:

Release del progetto

Related page: Release del progetto scheda

Ogni volta che si esegue una release del progetto, utilizzando il Project Releaser di Altium Designer, un riquadro evento Project ReleasedProject Released verrà aggiunto alla timeline. La persona che ha eseguito la release viene presentata 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 release, tramite la finestra di dialogo Confirm Release, anche questa verrà visualizzata all'interno del riquadro. Verranno inoltre elencati tutti i set di dati inclusi nella release.

Esempio di riquadro evento Project ReleasedProject Released.

Fare 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 è possibile visualizzare e navigare i dati dei file rilasciati, ispezionare la BOM e visualizzare e commentare lo snapshot del progetto stesso, la sorgente di quei dati rilasciati. Si avrà inoltre accesso ai controlli per scaricare i dati di produzione a vari livelli di granularità (dai set di dati completi ai singoli file di output generati). Una release selezionata può anche essere inviata, come Manufacturing PackageManufacturing Package, direttamente al proprio produttore. Per ulteriori informazioni, vedere la consultazione di un pacchetto di release nel Manufacturing Portal.

Accesso alla scheda dedicata Manufacturing PortalManufacturing Portal, con cui ispezionare più da vicino la release del progetto.

BOM To – consente di confrontare i dati della Bill of Materials (BoM) di questa release con quelli di un'altra release. Utilizzare il sottomenu associato per confrontare i dati BOM della release precedente, oppure selezionare tra tutte le release create per il progetto. La funzione di confronto dei dati rileva le differenze nei dati BOM grezzi tra le release di progetto specificate ed è accessibile anche dalla vista Releases del progetto nel Workspace. I risultati del confronto vengono forniti tramite il download di un file CSV che riporta in dettaglio i dati BOM modificati – aggiunti, rimossi o aggiornati – tra le release di progetto specificate.

Download – consente di scegliere, tramite una finestra successiva, quali set di dati del pacchetto di release scaricare. Dopo aver effettuato le scelte, fare clic sul pulsante . Verrà scaricato un unico archivio Zip contenente cartelle per ciascuno dei set di dati selezionati.
Download Snapshot – consente di scaricare come archivio Zip l'istantanea della versione del progetto utilizzata per creare quel pacchetto di release.

Poiché la release di un progetto è un evento molto significativo, il riquadro evento Project ReleasedProject Released viene reso più evidente: anziché essere semplicemente un evento "connesso", si estende sulla timeline come evento "principale".

Clonazione del progetto

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

Ogni volta che si clona il progetto – sia tramite l'interfaccia browser del Workspace, sia dall'interno di Altium Designer – verrà aggiunto alla timeline un riquadro evento Project ClonedProject Cloned. La persona che ha eseguito la clonazione viene indicata con nome (e immagine), insieme a data e ora. Al momento della clonazione viene aggiunta al riquadro una descrizione generata automaticamente, che può essere sostituita inserendo una nuova descrizione. Viene inoltre 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 ClonedProject Cloned.

I principali Clone comandiClone sono disponibili dalle opzioni del menu nella Projects paginaProjects dell'interfaccia browser del Workspace, oppure dalla HistoryvistaHistory scegliendo l'opzione CloneClone dal menu all'interno di un riquadro evento Project CommittedProject Committed. Quest'ultima opzione clonerà quella specifica revisione di un progetto anziché la revisione più recente (Head) del progetto.

Da Altium Designer, fare clic con il pulsante destro sulla voce del progetto nel pannello ProjectsProjects e scegliere l'opzione CloneClone, oppure nel pannello ExplorerExplorer scegliere l'opzione CloneClone dal menu durante la visualizzazione di un progetto.

Il riquadro evento Project ClonedProject Cloned è associato fisicamente (ma non connesso) al tronco principale della timeline tramite una linea di collegamento verde tratteggiata e un nodo non riempito.

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 e tali modifiche vengono inviate al Workspace tramite il relativo pannello CoDesigner, alla timeline verrà aggiunto un riquadro evento MCAD Changes SuggestedMCAD Changes Suggested. La persona che ha eseguito l'invio viene indicata con nome (e immagine), insieme a data e ora. Se al momento dell'invio è stato pubblicato un messaggio – tramite il pannello MCAD CoDesignerMCAD CoDesigner (Altium Designer), oppure il pannello Altium CoDesignerAltium CoDesigner (nel software MCAD supportato) – questo verrà visualizzato all'interno del riquadro.

Attualmente sono supportati solo gli eventi PushPush.

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 onlydopo aver recuperato le modifiche dal Workspace in Altium Designeronly.

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.

Il riquadro evento MCAD Changes SuggestedMCAD Changes Suggested non è fisicamente connesso al tronco principale della timeline. Al suo posto viene utilizzato un simbolo a freccia direzionale, che punta verso il tronco.

Ricerca filtrata

Fare 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 durante la digitazione della stringa di ricerca, lasciando visualizzati nella pagina solo gli eventi pertinenti a tale ricerca. Il testo corrispondente all'interno di un riquadro evento viene evidenziato.

La funzione di ricerca non distingue tra maiuscole e minuscole.

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

Sopra la selezione filtrata è presente un riquadro che riepiloga quanti eventi sono attualmente visualizzati, insieme ai controlli per rimuovere rapidamente il filtro/la stringa di ricerca.

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 diffing – in un riquadro evento Project CommittedProject Committed.
Nome del set di dati – in un riquadro evento Project ReleasedProject Released.
Nome del progetto – in un riquadro evento Project ClonedProject Cloned e in un riquadro evento Project CreatedProject Created (quando creato tramite clonazione).

Per cancellare il filtraggio corrente e tornare alla timeline completa, svuotare il campo di ricerca – selezionando il testo corrente e premendo il tasto Backspace Backspace , oppure facendo clic sul controllo

all'estrema destra del campo. In alternativa, fare clic sul controllo Clear FilterClear 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 vistaHistory . Poco dopo che l'evento si è verificato, nella parte inferiore della vista apparirà una notifica: fare clic sul controllo per aggiornare la timeline con il nuovo evento.