Cronologia del progetto
Altium Designer, insieme a un Workspace connesso, consente di visualizzare e interagire con una avanzata Project History cronologia orientata graficamente. La History vista 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 dove applicabile.
Accesso alla cronologia del progetto
Per accedere alla History vista di un progetto Workspace dall'interno di Altium Designer, fare clic con il tasto destro sulla relativa voce nel Projects pannello 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 Project menu principale per aprire la vista History del progetto Workspace attivo. La History vista viene presentata come un documento a schede distinto (<ProjectName>.PrjPcb History).
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 sezioni chiave, come mostrato nell'immagine seguente e nei relativi dettagli.
Identificazione dei tre componenti chiave della History vista.
- Main trunk of the timeline. La cronologia degli eventi procede 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 corrente) 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 alla ricerca. Per ulteriori informazioni, vedere Filtered Searching.
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 apposito "riquadro evento". Le sezioni espandibili seguenti 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. Come tale, può sempre essere trovato come voce nella parte inferiore della timeline. Il riquadro di questo evento può comparire 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 accede alla pagina di gestione dettagliata di quel progetto tramite l'interfaccia browser del Workspace.
Project Commit
Ogni volta che si esegue il Commit di un progetto nel Workspace (dove il progetto è gestito nel Versioned Storage repository Git interno del Workspace), un riquadro evento Project Committed verrà aggiunto alla timeline. La persona che ha eseguito il commit (Save to Server) viene indicata per nome (e immagine), insieme a data e ora. Se al momento del commit e del push è stato aggiunto un commento – utilizzando la finestra di dialogo Commit to Version Control dialog – anch'esso verrà visualizzato nel 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 diff del riquadro riassume 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 diff verrà espansa per presentare per nome gli elementi interessati.
Fare clic sul controllo
nell'angolo in alto a destra del riquadro per accedere a un menu con i seguenti comandi:
-
Download Sources - use 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; può essere visualizzata ma non modificata.

È possibile aprire (solo per visualizzazione) qualsiasi revisione specifica del progetto – direttamente dal corrispondente riquadro evento Project Committed di quella revisione. -
Compare: Schematic to, PCB to, BOM to – consente di confrontare i dati Schematic, PCB o BOM di questo commit con quelli di un altro evento di commit o release. Utilizzare il sottomenu per confrontare con il commit precedente oppure selezionare tra tutte le possibili release e commit. 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).
-
Create Tag – aggiunge un singolo tag con nome personalizzato a qualsiasi commit di un progetto di progettazione (e solo quando tale progetto è memorizzato in un Workspace con il suo sistema VCS Git 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 e fare clic su Create.
Quando viene immesso un tag contenente 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, ossia lettere, numeri, punto ('.'), trattino ('-'), cancelletto ('#') e underscore ('_'); aggiornare il tag secondo necessità.
Quando il progetto viene rilasciato utilizzando il Project Releaser e il suo commit più recente non ha ancora un tag, a quest'ultimo 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.), per esempio, RELEASE_A.3.
Per rinominare o eliminare un tag, fare clic su
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.
- Crea una copia – utilizzare 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 è precompilato), il percorso Folder (all'interno del Workspace) e il percorso Local Storage (della copia di lavoro). Il progetto verrà creato e un riquadro evento Project Copied verrà aggiunto alla timeline.
-
Revert to – utilizzare questo comando per tornare a usare 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 nuovamente nel Workspace.
È possibile ripristinare qualsiasi revisione specifica del progetto direttamente dal corrispondente riquadro evento Project Committed di quella revisione.
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 – un riquadro evento Project Released verrà aggiunto alla timeline. La persona che ha eseguito la release 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 release – tramite la finestra di dialogo Confirm Release dialog – anch'essa verrà visualizzata nel riquadro. Verranno inoltre elencati tutti i set di dati inclusi nella release.
Esempio di riquadro evento Project Released.
Fare clic sul controllo
nell'angolo in alto a destra del riquadro per accedere a un menu con i seguenti comandi:
- Download Sources – utilizzare questo comando per scaricare e quindi aprire (nel Projects pannello) 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; può essere visualizzata, ma non modificata in alcun modo.
- Compare: Schematic to, PCB to, Gerber to, BOM to – consente di confrontare i dati Schematic, PCB o BOM di questa release con quelli di un altro evento di release o commit. Per i Gerber generati, è possibile confrontare i dati di questa release con quelli di un'altra release o, quando si utilizza un Altium 365 Workspace, con un set di file Gerber caricato. Utilizzare 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 differenze associata, che si apre come nuova scheda nel browser predefinito. Per ulteriori informazioni, vedere Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Copying a Project
Ogni volta che si copia il progetto, sia tramite l'interfaccia browser del Workspace sia dall'interno di Altium Designer, un riquadro evento Project Copied viene aggiunto alla timeline. 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), anch'essa verrà 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 evento Project Copied.
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 design 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 il push viene indicata per nome (e immagine), insieme alla data e all'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) – anch'esso verrà visualizzato nel riquadro.
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 recuperato 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; a destra, l’evento di push dal lato MCAD.
Local Changes
Quando sono presenti documenti del progetto PCB salvati localmente ma non ancora nel Workspace, verrà aggiunto un riquadro evento Local Changes nella parte superiore della timeline. La persona che ha eseguito il salvataggio locale (cioè l’utente corrente) viene indicata con nome (e immagine).

Esempio di riquadro evento Local Changes.
Fare 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 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, i dati sorgente del commit precedente oppure selezionare tra tutte le possibili release e commit. 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).
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.
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 corrispondenze evidenziate all’interno di ogni 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 ricavato 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).
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 . Poco dopo il verificarsi dell’evento, comparirà una notifica nella parte inferiore della vista: fare clic sul controllo
per aggiornare la timeline con il nuovo evento.
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. È anche 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, 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.


per aprire la finestra di dialogo Choose Folder (una versione ridotta del pannello Explorer) per cambiare la cartella secondo necessità. Il Local Storage sarà, per impostazione predefinita, impostato per utilizzare la posizione definita nella pagina 

