Cronologia del progetto

Updated: March 19, 2026

Altium Designer, in combinazione con un Workspace connesso, consente di visualizzare e utilizzare una Project Historytimeline avanzata orientata graficamente. La Historyvista dedicata fornisce una timeline progressiva dei principali eventi relativi al progetto PCB, Multi-board o Harness: creazione, commit, release, copie e scambi MCAD, con varie azioni supportate ove applicabile.

Per sfruttare al meglio questa funzionalità, il progetto deve essere completamente gestito, assicurandosi che sia sotto il VCS integrato del Workspace (Git).

Se il progetto è sotto controllo di versione esterno, è possibile convertirlo in un progetto completamente gestito ospitato nell'Altium 365 Workspace migrandolo al VCS nativo del Workspace. Per informazioni dettagliate su come farlo, vedere Passaggio da VCS esterno a VCS nativo del Workspace.

Per informazioni su come lavorare con la Historyvista di un progetto tramite l'interfaccia browser del Workspace, vedere Cronologia del progetto.

Per accedere alle funzionalità della cronologia del progetto in Altium Designer, deve essere installata l'estensione software Project History . Questa estensione è installata per impostazione predefinita con Altium Designer. Può essere installata o rimossa manualmente.

Per ulteriori informazioni sulla gestione delle estensioni, fare riferimento alla pagina Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

Accesso alla cronologia del progetto

Per accedere alla Historyvista di un progetto Workspace dall'interno di Altium Designer, fare clic con il pulsante destro sulla relativa voce nel pannello Projects e scegliere il History & Version Contol » Show Project History comando dal menu contestuale. In alternativa, selezionare il History & Version Control » Show Project History comando dal menu principale Projects per aprire la vista History del progetto Workspace attivo. La History vista viene presentata come un documento a schede distinto (<ProjectName>.PrjPcb History).

Per un progetto nel Workspace già esistente prima dell'introduzione della funzionalità Project History, la relativa cronologia inizialmente non sarà completa. La reindicizzazione dei dati degli eventi per quel progetto verrà eseguita automaticamente al primo accesso alla History vista per quel progetto. Una notifica apparirà nella parte inferiore della vista una volta completata la reindicizzazione: fare clic sul controllo

per aggiornare la timeline con i dati storici completi degli eventi.

Per accedere alla Historyvista di un file di un progetto Workspace, cioè alla timeline dei principali eventi del progetto relativi al file, fare clic con il pulsante destro sul file nel pannello Projects e quindi scegliere il History & Version Control » Show File History comando dal menu contestuale.

Timeline della cronologia – Panoramica

La History vista presenta una timeline degli eventi di base verificatisi durante l'evoluzione del progetto. Può essere sostanzialmente suddivisa in tre sezioni chiave, come mostrato nell'immagine seguente e nei dettagli riportati.

Identificazione dei tre componenti chiave della History vista.

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.
Events. Ogni volta che si verifica un evento supportato (vedere sotto) associato al progetto, tale evento 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à un'icona aggiuntiva accanto (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 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 seguenti sezioni espandibili esaminano la gamma di eventi attualmente supportati e visualizzabili come parte della timeline storica di un progetto.

Project Creation

Refer to: Creazione di un progetto, Rendere disponibile online un progetto esistente

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 un progetto viene creato ex novo all'interno del Workspace. Il creatore del progetto viene indicato per nome (e immagine), insieme alla data e all'ora di creazione del progetto. Anche la descrizione del progetto viene visualizzata nel riquadro, se inserita al momento della creazione.

Quando il progetto è una copia di un progetto esistente. La persona che ha creato il progetto copiato viene indicata per nome, insieme alla data e all'ora di creazione del progetto. Anche la descrizione del progetto viene visualizzata nel riquadro, se inserita al momento della copia. Viene fornito un collegamento al progetto originale; facendo clic su di esso si accederà alla pagina di gestione dettagliata di quel progetto tramite l'interfaccia browser del Workspace.

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

Project Commit

Questo tipo di evento è supportato solo per un progetto completamente gestito e archiviato nel VCS nativo del Workspace (all'interno del relativo Versioned Storage repository Git). Per un progetto locale reso disponibile nell'Altium 365 Workspace ma non sotto controllo di versione formale, e che quindi utilizza la metodologia Simple Sync, non verranno visualizzati eventi di commit correlati al VCS nella timeline della cronologia. Per ottenere queste informazioni, è possibile cambiare lo stile di disponibilità online abilitando l'opzione Version Control nella scheda General della finestra di dialogo Project Options. In questo modo il progetto passa sotto il VCS nativo del Workspace.

Per un progetto reso disponibile in un Altium 365 Workspace ma già sotto controllo di versione esterno, non verranno comunque visualizzati eventi di commit correlati al VCS nella timeline della cronologia. Utilizzare il client di controllo di versione esterno per esaminare la cronologia del controllo di versione del progetto. In alternativa, è possibile passare di fatto al VCS nativo del Workspace. È possibile creare uno snapshot del progetto, operazione eseguibile nel modo più efficiente e pulito usando Project Packager di Altium Designer. Questo lo scollega dal VCS esterno e dal Workspace (se già reso disponibile lì), dopodiché sarà possibile renderlo nuovamente disponibile nel Workspace, ma sotto il VCS del Workspace, ricominciando di fatto da zero. Per informazioni dettagliate su come farlo, vedere Passaggio da VCS esterno a VCS nativo del Workspace.

Ogni volta che si esegue il Commit di un progetto nel Workspace (dove il progetto è gestito nel Versioned Storage repository Git interno del Workspace), alla timeline verrà aggiunto un riquadro evento Project Committed. La persona che ha eseguito il commit (Save to Server) viene indicata per nome (e immagine), insieme alla data e all'ora. Se al momento del commit e del push è stato aggiunto un commento, utilizzando la finestra di dialogo Commit to Version Control, anche questo verrà visualizzato nel riquadro.

Se il progetto era un progetto locale non gestito che è stato successivamente reso disponibile online, allora la descrizione inserita nella finestra di dialogo Make Available Online verrà utilizzata sia nel riquadro evento Project Created sia nel riquadro evento iniziale Project Committed, poiché il commit del progetto viene eseguito come parte della pubblicazione online del progetto, a condizione naturalmente che l'opzione Version Control fosse abilitata.

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 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 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 superiore destro del riquadro per accedere a un menu con i seguenti comandi:

Download Sources - uda usare per scaricare e aprire quella specifica revisione del progetto PCB o Harness nel pannello Projects. Il nome del progetto includerà la data e l'ora in cui quella revisione è stata sottoposta a commit. Si noti che questa revisione è di sola lettura; è possibile visualizzarla ma non modificarla.

È possibile aprire (solo per la visualizzazione) qualsiasi revisione specifica del progetto direttamente dal corrispondente riquadro evento Project Committed per quella revisione.
Compare: Schematic to, PCB to, BOM to – consente di confrontare i dati di Schematic, PCB o BOM del progetto PCB in questo commit con quelli di un altro commit o evento di release. Usa il sottomenu per confrontare con il commit precedente oppure seleziona tra tutte le release e i commit possibili. Una volta scelti i dati da confrontare, i risultati del confronto vengono presentati nella vista delle differenze associata, che si apre come nuova scheda nel browser predefinito. Per ulteriori informazioni, vedere Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Create Tag – aggiunge un singolo tag personalizzato a qualsiasi commit di un progetto di progettazione (e solo quando tale progetto è archiviato in un Workspace nel suo sistema Git VCS interno). È possibile creare un tag solo per il commit già salvato nel Workspace. Dopo aver eseguito il comando, si apre la finestra di dialogo Create Tag. Immettere il tag desiderato, quindi fare clic su Create.

Quando viene immesso un tag che contiene un carattere non valido, l'icona appare nella finestra di dialogo Create Tag. Passare il puntatore sull'icona per visualizzare un "suggerimento" sui caratteri consentiti, ovvero lettere, numeri, punto ('.'), trattino ('-'), cancelletto ('#') e underscore ('_'); aggiornare il tag secondo necessità.

Si aprirà un popup informativo che avvisa della presenza di caratteri non validi nel nome del Tag. Il Tag non verrà creato finché i caratteri non validi non saranno rimossi.

Se il progetto contiene commit che non sono ancora stati inviati con push, si aprirà la finestra di dialogo Save To Server, che chiederà se si desidera eseguire un push. Se il commit viene inviato, si aprirà la finestra di dialogo Create Tag.

Quando il progetto viene rilasciato utilizzando il Project Releaser e il suo commit più recente non ha ancora un tag, a questo commit più recente verrà assegnato automaticamente un tag. Questo tag avrà la forma RELEASE_<RevisionID>, dove <RevisionID> è il numero di revisione dei sorgenti del progetto rilasciato (A.1, A.2, ecc.), ad esempio, RELEASE_A.3.

Per rinominare o eliminare un tag, fare clic su e quindi passare il puntatore sulla voce Tag . Si aprirà una finestra di dialogo nella quale è possibile immettere il nuovo nome del tag. Se è selezionato Remove , il tag viene eliminato immediatamente.

Il comando Create Tag può essere richiamato anche facendo clic con il pulsante destro del mouse sul nome di un progetto o documento nel pannello Projects e scegliendo quindi History & Version Control » Create Tag per creare un tag per l'ultimo/più recente commit.

Note:

Non è disponibile il supporto ai tag per il controllo di versione esterno.
È possibile creare un solo (1) tag per commit.

Crea una copia – usare per creare una copia da quella specifica revisione del progetto. Si apre la finestra di dialogo Create Project Copy, nella quale si immettono un Project Name (per impostazione predefinita, sarà il nome del progetto originale con il suffisso ' - Copy'), Description (che non è precompilata), il percorso Folder (all'interno del Workspace) e il percorso Local Storage (per la copia di lavoro). Il progetto verrà creato e verrà aggiunto alla timeline un riquadro evento Project Copied.

Il Folder del Workspace sarà, per impostazione predefinita, la stessa cartella in cui è archiviato il progetto originale. Fare clic su per aprire la finestra di dialogo Choose Folder (una versione ridotta del pannello Explorer) e modificare la cartella secondo necessità. Il Local Storage sarà, per impostazione predefinita, impostato per utilizzare la posizione definita nella pagina System - Default Locations della finestra di dialogo Preferences. Fare clic su per aprire una finestra di dialogo standard di Windows con cui modificare questa posizione secondo necessità.

Revert to – usare questo comando per tornare a utilizzare i dati di quella specifica revisione del progetto. I dati dei documenti sorgente del progetto in quella specifica revisione sovrascrivono i dati nella copia di lavoro locale del progetto. In pratica, il progetto viene momentaneamente chiuso e quindi riaperto con i dati ripristinati. Se si desidera completare il ripristino e rendere tali dati la Head Revision (versione corrente), è necessario eseguire commit e push del progetto di nuovo nel Workspace.

È possibile ripristinare qualsiasi revisione specifica del progetto direttamente dal corrispondente riquadro evento Project Committed per quella revisione.

Dopo il ripristino a una revisione specifica e prima di eseguire il commit, è possibile riportare la copia di lavoro locale alla revisione più recente utilizzando il comando Revert to associato al riquadro evento Project Committed più recente nella timeline.

Un riquadro evento Project Committed è fisicamente collegato 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 il nodo con riempimento bianco:

Project Release

Related page: Release del progetto di progettazione

Ogni volta che si esegue una release del progetto PCB – utilizzando il Project Releaser di Altium Designer – verrà aggiunto alla timeline un riquadro evento Project Released. La persona che ha eseguito la release viene indicata con nome (e immagine), insieme a data e ora. Se al momento della release dei dati generati nel Workspace è stata aggiunta una nota di release – tramite la finestra di dialogo Confirm Release dialog – anche questa verrà visualizzata all'interno del riquadro. Verranno inoltre elencati tutti i set di dati inclusi nella release.

Esempio di riquadro evento Project Released.

Fare clic sul controllo nell'angolo superiore destro del riquadro per accedere a un menu con i seguenti comandi:

Download Sources – usare questo comando per scaricare e quindi aprire (nel pannello Projects ) la specifica revisione del progetto da cui è stato generato questo pacchetto di release. Il nome del progetto includerà la versione di release. Si noti che questa revisione è di sola lettura; è possibile visualizzarla, ma non modificarla in alcun modo.
Compare: Schematic to, PCB to, Gerber to, BOM to – consente di confrontare i dati di Schematic, PCB o BOM di questa release con quelli di un'altra release o evento di commit. Per i Gerber generati, è possibile confrontare i dati di questa release con quelli di un'altra release oppure, quando si utilizza un Altium 365 Workspace, con un set di file Gerber caricato. Usa il sottomenu per confrontare con il set di dati richiesto. Una volta scelti i dati da confrontare, i risultati del confronto vengono presentati nella vista delle differenze associata, che si apre come nuova scheda nel browser predefinito. Per ulteriori informazioni, vedere Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).

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

Copying a Project

Ogni volta che si copia il progetto, sia tramite l'interfaccia browser del Workspace sia dall'interno di Altium Designer, viene aggiunto alla timeline un riquadro evento Project Copied. La persona che ha eseguito la copia viene indicata con nome, immagine, data e ora. Se al momento della copia è stata aggiunta una descrizione tramite la finestra Clone Project (basata su browser) o la finestra di dialogo Create Project Copy (Altium Designer), anche questa verrà visualizzata all'interno del riquadro. Viene fornito un collegamento al progetto copiato. Facendo clic su di esso si accede alla pagina di gestione dettagliata di quel progetto tramite l'interfaccia browser del Workspace.

Esempio di riquadro evento Project Copied.

I principali comandi Make a copy sono disponibili all'interno di Altium Designer (facendo clic con il pulsante destro del mouse sulla voce del progetto nel pannello Projects o dalla pagina Projects dell'interfaccia browser del Workspace), agendo sulla revisione più recente (o Head) del progetto. Quando si accede alla vista History del progetto tramite l'interfaccia browser del Workspace, si ha anche la possibilità di copiare una revisione specifica di quel progetto. Per farlo, individuare il riquadro evento Project Committed relativo alla revisione richiesta del progetto, quindi fare clic sul controllo

nell'angolo superiore destro del riquadro. Dal menu successivo, scegliere il comando Make a copy .

Il riquadro evento Project Copied è fisicamente collegato al tronco principale della timeline con una linea di connessione verde tratteggiata e un nodo non riempito:

MCAD Exchanges

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 Suggested. La persona che ha eseguito il push viene indicata con nome (e immagine), insieme a data e ora. Se al momento del push è stato pubblicato un messaggio – tramite il pannello MCAD CoDesigner (Altium Designer), o il pannello Altium CoDesigner (nel software MCAD supportato) – anche questo verrà visualizzato all'interno del riquadro.

Attualmente sono supportati solo gli eventi Push.

Esempio di riquadro evento MCAD Changes Suggested.

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

Esempio che mostra due eventi correlati a MCAD. A sinistra del tronco della timeline, l'evento di push dal lato ECAD, mentre a destra l'evento di push dal lato MCAD.

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

Local Changes

Quando sono presenti documenti del progetto PCB salvati localmente ma non ancora nel Workspace, un riquadro evento Local Changes verrà aggiunto nella parte superiore della timeline. La persona che ha eseguito il salvataggio locale (ovvero l'utente corrente) viene mostrata per nome (e immagine).

Esempio di riquadro evento Local Changes.

Fare clic sul controllo nell'angolo superiore destro del riquadro per accedere a un menu con il seguente comando:

Compare: Schematic to, PCB to, BOM to – consente di confrontare i dati di Schematic, PCB, o BOM salvati localmente in questo commit con quelli di un evento di commit o release. Utilizzare il sottomenu per confrontare con i dati sorgente della release precedente, con i dati sorgente del commit precedente, oppure selezionare tra tutte le release e i commit possibili. Una volta scelti i dati da confrontare, i risultati del confronto vengono presentati nella vista differenze associata, che si apre come nuova scheda nel browser predefinito. Per ulteriori informazioni, vedere Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).

Il riquadro evento Local Changes non è fisicamente collegato al tronco principale della timeline. Al suo posto viene utilizzato un simbolo a cerchio tratteggiato:

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 filtro dinamico applicato mentre si digita la 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 mostrati, 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 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 Copied e in un riquadro evento Project Created (quando creato tramite copia).

Per cancellare il filtro corrente e tornare alla timeline completa, svuotare 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, fare clic sul controllo Clear Filter nel riquadro che riepiloga quanti eventi sono mostrati (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 disponibile automaticamente nella vista History . Poco dopo il verificarsi dell'evento apparirà una notifica nella parte inferiore della vista: fare clic sul controllo per aggiornare la timeline con il nuovo evento.

È disponibile anche un aggiornamento manuale facendo clic sul controllo

in alto a destra della vista.

Creazione di un report della cronologia del progetto

Per un progetto Workspace è possibile creare un report della cronologia del progetto in formato PDF. Il report mostra tutte le informazioni sulla cronologia del progetto, inclusi creazione, commit e release, nonché una descrizione delle modifiche rispetto all'evento precedente. È inoltre possibile impostare il periodo di tempo per il report (descritto di seguito), in modo da ottenere il report definitivo necessario.

Da un OutJob

Per creare il report, nel file OutputJob (*.OutJob), fare clic con il pulsante destro del mouse sul [Add New Report Output] associato alla voce Report Outputs e quindi scegliere Project History, come mostrato di seguito.

Collegare il report appena creato a un contenitore di output PDF. Impostare il periodo di tempo per il report facendo clic con il pulsante destro del mouse sull'output creato e selezionando quindi Configure. Abilitare il Period di tempo desiderato: For all time (dalla creazione del progetto fino al presente), oppure Specific releases (utilizzare i menu a discesa del campo From/To per impostare le release desiderate). Il report esportato conterrà le informazioni relative al periodo di tempo selezionato.

Dopo che il report è stato creato, collegato a un contenitore di output PDF e configurato, nell'area del contenitore PDF fare clic su Generate content, oppure, se lo si desidera, è possibile generare il report della cronologia del progetto come parte del processo di project release.

Dal menu Reports

La cronologia del progetto può essere esportata in PDF scegliendo Reports » Project History dai menu principali. Si apre la finestra di dialogo Project History Report Configuration , nella quale è possibile impostare il Period per cui il report deve essere esportato: l'intera cronologia del progetto oppure da/a una release specifica del progetto (o l'ultima). Fare clic su Export quindi immettere un nome per il PDF esportato nella finestra Explorer che si apre, quindi fare clic su Save. Il report PDF si apre nel browser.

Versione stampabile

Localizzato tramite A

Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Invio per inviarci il tuo feedback.

Disponibilità delle funzionalità

Le funzionalità disponibili dipendono dalla soluzione Altium in uso – Altium Develop, un’edizione di Altium Agile (Agile Teams o Agile Enterprise), oppure Altium Designer (con licenza attiva).

Se non vedi nel tuo software una funzionalità descritta, contatta il team vendite di Altium per saperne di più.

Documentazione legacy

La documentazione di Altium Designer non è più suddivisa per versione. Se è necessario accedere alla documentazione delle versioni precedenti di Altium Designer, visitare la sezione Documentazione legacy della pagina Altri programmi di installazione.