Cronologia del progetto
A colpo d'occhio
- Scopri come aprire la cronologia di progetti e file, navigare tra gli eventi e filtrare la sequenza temporale tramite la ricerca.
- Comprendi i requisiti di configurazione, tra cui l’estensione Project History e il controllo di versione Git nativo del Workspace.
- Scopri come esaminare le modifiche dei commit, aprire revisioni in sola lettura, confrontare i dati di schemi elettrici, PCB e distinte base e gestire i tag dei commit.
Altium Designer, insieme a un Workspace connesso, consente di visualizzare e utilizzare una Project History timeline avanzata con orientamento grafico. La vista dedicata History offre una timeline progressiva degli eventi principali relativi al progetto PCB, Multi-board o Harness (creazione, commit, rilasci, copie e scambi MCAD), con varie azioni disponibili ove applicabili.
Accesso alla cronologia del progetto
Per accedere alla vista History di un progetto del Workspace da Altium Designer, fare clic con il pulsante destro del mouse sulla relativa voce nel pannello Projects e scegliere il comando History & Version Contol » Show Project History dal menu contestuale. In alternativa, selezionare il comando History & Version Control » Show Project History dal menu principale Project per aprire la vista Cronologia del progetto attivo del Workspace. La vista History viene visualizzata come documento distinto in una scheda (<ProjectName>.PrjPcb History).
Timeline della cronologia – Panoramica
La vista History presenta una timeline degli eventi fondamentali che si sono verificati durante l'evoluzione del progetto. Può essere suddivisa essenzialmente in tre sezioni principali, come illustrato nell'immagine e nei dettagli seguenti.
Identificazione dei tre componenti principali della vista History .
- Main trunk of the timeline. L'ordine cronologico degli eventi procede dal basso verso l'alto. Il primo evento, ovvero la creazione del progetto, viene visualizzato nella parte inferiore della timeline. Gli eventi successivi vengono visualizzati più in alto, con l'ultimo evento (il più recente) in cima alla timeline.
- Events. Ogni volta che si verifica un evento supportato (vedere di seguito) associato al progetto, questo viene aggiunto alla timeline sotto forma di riquadro dedicato. Ogni tipo di evento ha un riquadro di colore diverso, che può essere collegato direttamente all'asse principale della timeline oppure presentare 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 di base nella cronologia del progetto. Mentre si digita la stringa di ricerca, la timeline viene filtrata per mostrare solo gli eventi pertinenti alla ricerca. Per ulteriori informazioni, vedere Ricerca con filtri.
Eventi supportati
La timeline mostra la successione degli eventi che si verificano durante il ciclo di vita di un progetto. Ciascuno di questi eventi viene visualizzato lungo la timeline come un apposito "riquadro evento". Le sezioni espandibili seguenti illustrano gli eventi attualmente supportati e visualizzabili nella timeline della cronologia di un progetto.
Creazione del progetto
Refer to: Creazione di un progetto, Pubblicazione online di un progetto esistente
Quando viene creato un progetto, il riquadro evento Project Created viene aggiunto alla timeline. Questo evento segna l'inizio della timeline della cronologia del progetto. Pertanto, si trova sempre come prima voce nella parte inferiore della timeline. Il riquadro di questo evento può presentarsi in due varianti distinte:
- Quando un nuovo progetto viene creato nel Workspace. Vengono visualizzati 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 è una copia di un progetto esistente. Vengono visualizzati il nome della persona che ha creato la copia 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 copia. È disponibile un collegamento al progetto originale; facendo clic su di esso si accede alla pagina di gestione dettagliata di quel progetto tramite l'interfaccia browser del Workspace.
Commit del progetto
Ogni volta che esegui il commit di un progetto nel Workspace (dove il progetto è gestito nel repository Git Versioned Storage interno del Workspace), alla cronologia viene aggiunto un riquadro evento Project Committed. La persona che ha eseguito il commit (Salva sul server) viene identificata tramite nome (e immagine), insieme alla data e all'ora. Se al momento del commit è stato aggiunto e inviato un commento, utilizzando la finestra di dialogo Commit nel controllo di versione, anche questo verrà visualizzato nel riquadro.
Esempio di riquadro evento iniziale Project Committed.
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, reti, 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, la sezione delle differenze si espande per mostrare gli elementi interessati per nome.
Fai clic sul controllo
nell'angolo superiore destro del riquadro per accedere a un menu con i seguenti comandi:
-
Download Sources - uUtilizza questo comando per scaricare e aprire quella specifica revisione del progetto PCB o di cablaggio nel pannello Progetti. Il nome del progetto includerà la data e l'ora in cui è stato eseguito il commit della revisione. Tieni presente che questa revisione è di sola lettura: puoi visualizzarla ma non modificarla.

Puoi aprire (solo per la visualizzazione) qualsiasi revisione specifica del progetto direttamente dal riquadro evento Project Committed corrispondente a tale revisione. -
Compare: Schematic to, PCB to, BOM to – consente di confrontare i dati dello schema elettrico, del PCB o della distinta base del progetto PCB in questo commit con quelli di un altro evento di commit o di rilascio. Utilizza il sottomenu per confrontarli con il commit precedente oppure scegli tra tutti i rilasci e i commit disponibili. Una volta scelti i dati da confrontare, i risultati del confronto vengono presentati nella relativa vista delle differenze, che si apre in una nuova scheda del browser predefinito. Per ulteriori informazioni, consulta Design Data Comparisons (Workspace Altium 365, Workspace Enterprise Server).
-
Create Tag – aggiungi un singolo tag con nome personalizzato a qualsiasi commit di un progetto di progettazione (solo se il progetto è archiviato in un Workspace e gestito dal relativo sistema VCS Git interno). Puoi creare un tag solo per un commit già salvato nel Workspace. Dopo aver eseguito il comando, si apre la finestra di dialogo Create Tag. Inserisci il tag desiderato, quindi fai clic su Create.
Quando viene inserito un tag contenente un carattere non valido, nella finestra di dialogo Create Tag viene visualizzata l'icona
. Passa il puntatore sull'icona per visualizzare un suggerimento sui caratteri consentiti, ovvero lettere, numeri, punto ('.'), trattino ('-'), cancelletto ('#') e trattino basso ('_'); modifica il tag secondo necessità.
Quando il progetto viene rilasciato utilizzando Project Releaser e il suo ultimo commit non ha ancora un tag, a tale commit viene assegnato automaticamente un tag. Il tag avrà il formato RELEASE_<RevisionID>, dove <RevisionID> è il numero di revisione dei sorgenti del progetto rilasciati (A.1, A.2, ecc.), ad esempio RELEASE_A.3.
Per rinominare o eliminare un tag, fai clic su
quindi passa il puntatore sulla voce Tag . Si apre una finestra di dialogo in cui puoi inserire il nuovo nome del tag. Se viene selezionato Remove , il tag viene eliminato immediatamente.
- Crea una copia – consente di creare una copia da quella specifica revisione del progetto. Si apre la finestra di dialogo Create Project Copy, in cui inserire un Project Name (per impostazione predefinita, sarà il nome del progetto originale con il suffisso ' - Copy'), Description (che non viene precompilato), il percorso Folder (all'interno del Workspace) e il percorso Local Storage (della copia di lavoro). Il progetto verrà creato e alla cronologia verrà aggiunto un riquadro evento Project Copied.
-
Revert to – usa questo comando per ripristinare 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 poi riaperto con i dati ripristinati. Per completare il ripristino e rendere tali dati la revisione Head (versione corrente), devi eseguire il commit e il push del progetto nel Workspace.
Puoi ripristinare qualsiasi revisione specifica del progetto direttamente dal riquadro dell'evento Project Committed corrispondente a quella revisione.
Rilascio del progetto
Related page: Rilascio del progetto
Ogni volta che esegui un rilascio del progetto PCB usando Project Releaser di Altium Designer, viene aggiunto alla sequenza temporale un riquadro dell'evento Project Released. La persona che ha eseguito il rilascio viene indicata con 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 Conferma rilascio, anche questa viene visualizzata nel riquadro. Vengono inoltre elencati tutti i set di dati inclusi nel rilascio.
Esempio di riquadro dell'evento Project Released.
Fai clic sul controllo
nell'angolo superiore destro del riquadro per accedere a un menu con i seguenti comandi:
- Download Sources – usa questo comando per scaricare e poi aprire (nel pannello Projects ) la revisione specifica del progetto da cui è stato generato questo pacchetto di rilascio. Il nome del progetto includerà la versione del rilascio. Tieni presente che questa revisione è di sola lettura: puoi visualizzarla, ma non modificarla in alcun modo.
- Compare: Schematic to, PCB to, Gerber to, BOM to – consente di confrontare i dati dello schema elettrico, del PCB o della BOM di questo rilascio con quelli di un altro rilascio o evento di commit. Per i Gerber generati, puoi confrontare i dati di questo rilascio con quelli di un altro rilascio oppure, quando usi un Workspace Altium 365, con un set di file Gerber caricato. Usa il sottomenu per scegliere il set di dati con cui effettuare il confronto. Una volta scelti i dati da confrontare, i risultati vengono presentati nella vista delle differenze associata, che si apre in una nuova scheda del browser predefinito. Per ulteriori informazioni, consulta Design Data Comparisons (Workspace Altium 365, Workspace Enterprise Server).
Copia di un progetto
Ogni volta che copi il progetto, tramite l'interfaccia browser del Workspace o da Altium Designer, viene aggiunto alla sequenza temporale un riquadro dell'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 (nel browser) o la finestra di dialogo Create Project Copy (Altium Designer), anche questa viene visualizzata nel 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 dell'evento Project Copied.
Scambi MCAD
Related page: Altium MCAD CoDesigner
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 tali modifiche vengono inviate al Workspace tramite il relativo pannello CoDesigner, viene aggiunto alla sequenza temporale un riquadro dell'evento MCAD Changes Suggested. La persona che ha eseguito il push viene indicata con nome (e immagine), insieme alla data e all'ora. Se al momento del push è stato inserito 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 dell'evento MCAD Changes Suggested.
Quando il progettista MCAD apporta modifiche al PCB nel proprio software MCAD supportato e le invia al Workspace, il corrispondente evento di push sarà disponibile nella sequenza temporale della cronologia del progetto only dopo aver importato le modifiche dal Workspace in Altium Designer.
Esempio che mostra due eventi relativi a MCAD. A sinistra dell'asse principale della sequenza temporale, l'evento di push dal lato ECAD; a destra, l'evento di push dal lato MCAD.
Modifiche locali
Quando sono presenti documenti di progetto PCB salvati localmente ma non ancora nel Workspace, viene aggiunto un riquadro evento Local Changes in cima alla sequenza temporale. La persona che ha eseguito il salvataggio locale (ovvero l'utente corrente) viene identificata tramite nome (e immagine).

Esempio di riquadro evento Local Changes.
Fai clic sul controllo
nell'angolo in alto a destra del riquadro per accedere a un menu con il seguente comando:
- Compare: Schematic to, PCB to, BOM to – consente di confrontare i dati dello schema elettrico, del PCB o della BOM salvati localmente in questo commit con quelli di un evento di commit o di rilascio. Usa il sottomenu per confrontarli con i dati sorgente del rilascio precedente, con quelli del commit precedente oppure per scegliere tra tutti i rilasci e i commit disponibili. Una volta scelti i dati da confrontare, i risultati del confronto vengono presentati nella relativa vista delle differenze, che si apre in una nuova scheda del browser predefinito. Per ulteriori informazioni, consulta Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Ricerca con filtro
Fai clic sul controllo
in alto a destra nella vista per accedere a un campo di ricerca che consente di 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: nella pagina rimangono visualizzati solo gli eventi pertinenti alla ricerca. 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 all'interno di ogni 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 tratto da un commento, una nota o una descrizione al momento in cui 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 viene creato tramite copia).
Aggiornamento con nuovi eventi
Ogni volta che si verifica un evento supportato relativo al progetto, questo viene rilevato e reso automaticamente disponibile nella vista History . Poco dopo l'evento, viene visualizzata una notifica nella parte inferiore della vista: fai clic sul controllo
per aggiornare la sequenza temporale con il nuovo evento.
Creazione di un report della cronologia del progetto
Per un progetto del 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 rilasci, nonché una descrizione delle modifiche rispetto all'evento precedente. Puoi anche impostare l'intervallo di tempo del report (come descritto di seguito), per ottenere il report completo di cui hai bisogno.
Da un OutJob
Per creare il report, nel file OutputJob (*.OutJob), fai clic con il pulsante destro del mouse su [Add New Report Output] associato alla voce Report Outputs , quindi scegli Project History, come mostrato di seguito.
Collega il report appena creato a un contenitore di output PDF. Imposta l'intervallo di tempo del report facendo clic con il pulsante destro del mouse sull'output creato, quindi seleziona Configure. Abilita l'intervallo di tempo Period desiderato: For all time (dalla creazione del progetto fino al momento attuale), oppure Specific releases (usa i menu a discesa del campo From/To per impostare i rilasci desiderati). Il report esportato conterrà le informazioni relative all'intervallo di tempo selezionato.
Dopo aver creato il report, averlo collegato a un contenitore di output PDF e averlo configurato, fai clic su Generate content, nell'area del contenitore PDF oppure, se preferisci, puoi generare il report della cronologia del progetto nell'ambito del processo di rilascio del progetto.


per aprire la finestra di dialogo Choose Folder (una versione semplificata del pannello Explorer) e modificare la cartella secondo necessità. Per impostazione predefinita, Local Storage utilizzerà la posizione definita nella pagina 

