Creating Projects and Documents

Il punto di partenza per ogni progetto creato in Altium Designer è un progetto. Un progetto di Altium Designer raccoglie un insieme di documenti di progettazione il cui output definisce in ultima analisi una singola implementazione di ciò che si intende creare. Ad esempio, gli schemi e il PCB in un progetto PCB includono l’insieme di file necessario per produrre una scheda a circuito stampato. Al contrario, l’insieme di file generato da un progetto di cablaggio viene utilizzato per acquistare e assemblare un cablaggio, mentre i file dello schema logico e dell’assieme fisico in un progetto multi-board generano l’insieme di file necessario per produrre e assemblare un prodotto completo con più PCB collegati.

L’insieme dei documenti di progettazione del progetto può essere riunito da qualsiasi origine accessibile, locale alla macchina o meno, con il file di progetto che li mette in relazione come un progetto unificato. Il software utilizza la compilazione dinamica per creare e gestire un modello dati unificato dei componenti del progetto e della loro connettività. Questo modello dati può quindi essere utilizzato per propagare le modifiche di progettazione tra i domini di progettazione, ad esempio sincronizzando per risolvere le differenze tra i documenti nei domini Schematic e PCB.

I documenti del progetto possono essere creati e archiviati nel tuo Workspace Altium, all’interno del tuo sistema di controllo versione oppure localmente come file sulla rete disponibile.

Le sezioni seguenti descrivono come creare un nuovo progetto e aggiungere documenti di progettazione a un progetto esistente.

Creazione di un nuovo progetto tramite la finestra di dialogo Create Project

Un nuovo progetto può essere creato in Altium Designer utilizzando la finestra di dialogo Create Project (File » New » Project).

1. Nell’elenco Locations, seleziona la voce relativa al tuo Workspace (apparirà con il nome definito per esso): devi essere connesso attivamente al Workspace per vedere questa opzione nell’elenco. Questo sarà il server di destinazione in cui archiviare il tuo nuovo progetto Workspace.

   In sintesi, la gestione dei progetti è focalizzata sull’archiviazione sicura e sul tracciamento delle modifiche durante tutto il processo di progettazione e, in ultima analisi, sull’instradamento del progetto risultante verso la creazione di un elemento fisico, come un PCB assemblato da utilizzare nel prodotto finale. Per soddisfare queste esigenze, Altium Designer offre una gamma di approcci alla gestione dei progetti che forniscono livelli crescenti di sofisticazione e funzionalità, semplificando al contempo il processo dal punto di vista del progettista. Questi approcci spaziano dall’archiviazione e gestione locale basata su file, agli approcci di archiviazione tramite Version Control System (VCS) locale/remoto, fino alla forma avanzata e consigliata in cui la gestione dei dati di progettazione è incentrata sulle funzionalità di un Workspace.

   Un connected Workspace e il suo servizio VCS interno ospitano e gestiscono i progetti Altium Designer e forniscono anche operazioni VCS semplificate, funzionalità intrinseche di collaborazione alla progettazione, condivisione avanzata dei dati di progettazione, tracciamento della cronologia, gestione del Lifecycle e molto altro. I progetti integrati con un Workspace sono accessibili direttamente da Altium Designer, ad esempio dal pannello Projects, oppure dal Workspace stesso tramite la sua interfaccia basata su browser.

   Grazie all’intelligenza integrata nei servizi forniti da un Workspace, attività come le operazioni VCS sono semplificate e automatizzate, e funzionalità aggiuntive di collaborazione alla progettazione come il controllo dell’accesso utente (condivisione), i commenti e la cronologia sono disponibili direttamente all’interno di Altium Designer. Il risultato finale è un formato e una posizione di archiviazione del progetto robusti e sicuri che possono diventare il punto centrale per la progettazione collaborativa del progetto.

   Quando si è connessi a un Workspace con una o più definizioni di processo attive per il tema di processo Project Creations, la possibilità di creare un nuovo progetto tramite la finestra di dialogo Create Project è limitata ai soli progetti di tipo Local e VCS. Invece, la creazione di progetti basati su Workspace è soggetta al controllo delle definizioni di processo attive. Scopri di più su Process-based Project Creation.

2. Nell’elenco Project Type, scegli il tipo di progetto che desideri creare e, se necessario, seleziona tra i modelli applicabili disponibili. La voce <Empty> creerà un progetto shell senza documenti sorgente iniziali.

   Scopri di più su Creating a Project Template.

3. Inserisci un Project Name e, facoltativamente, una Description del progetto.

   Il nome del progetto deve iniziare con e può contenere A-Z, a-z o 0-9. Sono consentiti underscore, trattini e spazi, ma questi ultimi possono essere utilizzati solo all’interno del nome (gli spazi iniziali e finali verranno ignorati). Non è possibile utilizzare le seguenti parole: AUX, COM1-COM9, LPT1-LPT9, CON, NUL e PRN. Inoltre, il nome non può contenere i seguenti caratteri: \ . / ? % * : | " < >.

La finestra di dialogo Create Project include ulteriori opzioni:

• Seleziona l’opzione Version Control (predefinita) per applicare al progetto tutte le funzionalità VCS, come cronologia e funzionalità avanzate di condivisione. Se deselezionata, il progetto viene archiviato nel Workspace e sincronizzato con la copia locale: un progetto “mirrored” nel formato Simple Sync.

  L’opzione Version Control è disponibile solo quando si è connessi a un Altium 365 Workspace. Quando si è connessi a un Enterprise Server Workspace, questa opzione risulta di fatto selezionata.

• Quando si crea un progetto di tipo PCB, selezionare l’opzione Constraint Management per gestire i vincoli di progettazione per questo progetto utilizzando il Constraint Manager. Quando l’opzione è disabilitata, per questo progetto verrà utilizzato il sistema di design rules.

  L’opzione Constraint Management è abilitata nella finestra di dialogo Create Project per impostazione predefinita quando l’opzione System.ConstraintManager è abilitata nella finestra di dialogo Advanced Settings dialog.

• Quando si è connessi a un Enterprise Server Workspace, il menu a discesa Repository (se presente) elencherà tutti i repository di progettazione gestiti tramite il Version Control Service del Workspace e che sono stati condivisi con te per l’utilizzo. Scegli il repository in cui archiviare il nuovo progetto e i relativi file: per impostazione predefinita è disponibile un singolo repository basato su Git (Versioned Storage). Se viene selezionato un repository di tipo SVN, è disponibile un’ulteriore opzione Repository Folder per specificare o cercare una cartella di destinazione alternativa all’interno del repository stesso.

  Il menu a discesa Repository viene visualizzato solo se hai aggiornato il tuo Enterprise Server da una versione o da un prodotto server in cui era abilitato l’uso di repository SVN. In alternativa, Enterprise Server fornisce un singolo repository di progettazione basato su Git per ospitare tutti i progetti di progettazione del tuo Workspace e, in questo caso, il menu a discesa Repository non verrà visualizzato.

  SVN non è supportato in Altium On-Prem Enterprise Server a partire dalla versione 7.2. Per evitare le limitazioni della gestione di un progetto SVN, si consiglia di migrare i progetti SVN nel repository Git integrato del Workspace di Enterprise Server. Questa operazione può essere eseguita prima dell’aggiornamento del server come descritto qui.

  Per ulteriori informazioni sulla dismissione di SVN in Altium On-Prem Enterprise Server, fai riferimento all’articolo della Knowledge Base SVN Discontinuation with Altium On-Prem Enterprise Server 7.2.1.

• Fai clic sul controllo Advanced per specificare i percorsi delle cartelle.

  • Utilizza il campo Folder per specificare dove creare la cartella del progetto all’interno della struttura di cartelle del Workspace. Il percorso predefinito per i nuovi progetti è specificato nella pagina Admin – Settings – Projects dell’interfaccia browser del Workspace (per impostazione predefinita sarà Projects\<ProjectName>). Fai clic sul pulsante per cercare e selezionare una cartella Workspace diversa, se necessario.

    Se l’utente che crea un progetto nel Workspace connesso non dispone dei permessi di scrittura per la cartella di progetto predefinita, il sistema creerà automaticamente una struttura Personal Folder specifica per l’utente per archiviare il nuovo progetto. Questa apparirà come una cartella di primo livello basata sull’indirizzo email del membro (per un Altium 365 Workspace) o sul nome utente (per un Enterprise Server Workspace), con una sottocartella My Projects che archivia i progetti di quell’utente. La struttura/gerarchia delle cartelle è disponibile solo per l’utente che ha effettuato l’accesso e per gli amministratori; non è visibile agli altri utenti. Scopri di più su Managing Project Creation Permissions (Altium 365 Workspace, Enterprise Server Workspace).

  • Utilizza il campo Local Storage per specificare dove verrà archiviata sul disco rigido la versione locale del progetto. La posizione predefinita è definita nella pagina System – Default Locations della finestra di dialogo Preferences. Fai clic sul pulsante per cercare e selezionare una posizione di cartella diversa, se necessario. Questa è la cartella di lavoro del progetto e del repository Git local a cui viene effettuato il commit. Il progetto viene infine, o al momento del commit, inviato al repository di progettazione centralizzato nel Workspace (Versioned Storage), che è il repository Git remote.

   

• Usa l’area elenco Parameters per aggiungere o rimuovere coppie di parametri Nome/Valore personalizzate associate al progetto e salvate nel Workspace. Usa il pulsante per aggiungere una nuova coppia Nome/Valore all’elenco oppure il pulsante  per rimuovere una coppia selezionata. I campi Nome e Valore consentono un massimo di 255 caratteri. Quando si crea un progetto Workspace, questi parametri del progetto Workspace vengono salvati nel Workspace con il nuovo progetto come parametri di progetto a livello Workspace.

  Quando viene selezionato un modello di progetto nell’elenco Project Type della finestra di dialogo, l’area elenco Parameters verrà caricata con i parametri di questo modello. Se necessario, puoi modificare questi parametri (nomi e/o valori) oppure rimuoverli. Quando si crea un progetto Workspace, un parametro del modello selezionato verrà salvato come parametro di progetto lato design se il nome del parametro non è stato modificato. In caso contrario, verrà salvato come parametro di progetto lato Workspace.

  I parametri di progetto a livello Workspace lato Workspace possono essere modificati all’interno del Workspace. Al contrario, i parametri lato design vengono salvati nel file di progetto (*.PrjPcb) e possono essere modificati in Altium Designer. I parametri di progetto di entrambi i tipi possono essere visualizzati nella scheda Parameters della finestra di dialogo Project Options (Project » Project Options) e possono essere utilizzati come Special Strings in Altium Designer.

Una volta definito il progetto come richiesto, fai clic sul pulsante . La nuova struttura del progetto verrà creata nelle cartelle locali e Workspace specificate. Il progetto verrà aperto nel Projects panel, che rifletterà lo stato completamente sincronizzato esistente tra i file nel repository di progettazione remoto (nel Workspace) e il repository locale (copia di lavoro), come indicato dalle icone associate. Se creato con l’opzione Version Control deselezionata (disponibile solo in un Altium 365 Workspace), il progetto mirrorato verrà mostrato nel pannello Projects con un’icona associata.

Il progetto appena creato è stato sottoposto a commit nel repository di progettazione Versioned Storage nel Workspace.

In alternativa, se al nuovo progetto not è stato assegnato un modello con documenti costitutivi, verranno creati solo il file di progetto (*.PrjPcb) e quindi la sola struttura del progetto. Il progetto viene quindi aperto nel Projects panel, che lo mostrerà come Scheduled for addition, indicato dall’icona associata . A questo punto puoi aggiungere documenti al progetto oppure semplicemente salvare la struttura nel Workspace nel suo stato shell corrente. Per farlo, fai clic sul controllo Save to Server associato alla voce del progetto nel pannello Projects – disponibile anche dal menu contestuale del tasto destro e dal menu principale File. Nella successiva finestra di dialogo Save to Server dialog, seleziona/deseleziona i file da includere, aggiungi un Comment facoltativo, quindi conferma il processo di salvataggio con il pulsante . Una volta che il progetto è stato aggiunto al server, il pannello Projects rifletterà lo stato completamente sincronizzato esistente tra i file nel repository del server e la copia di lavoro locale, come indicato dalle icone .

Copiare un progetto

Per copiare un progetto Workspace da Altium Designer, fai clic con il tasto destro sulla voce del progetto nel pannello Projects e scegli il comando Make a copy  dal menu contestuale. Usa la finestra di dialogo Create Project Copy per determinare il 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 (verso la copia di lavoro).

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

Copia un progetto Workspace da Altium Designer.

Aggiunta e rimozione di un documento di progettazione

Una volta creato un progetto, i documenti di progettazione possono essere aggiunti, modificati o rimossi dal progetto attivo. Il modo più semplice per aggiungere nuovi documenti di progettazione a un progetto è fare clic con il tasto destro sul nome del progetto nel pannello Projects e selezionare Add New to Project dalle opzioni del menu contestuale. In alternativa, scegli il tipo di documento richiesto dal sottomenu Project » Add New to Project dei menu principali per aggiungere un nuovo documento al progetto attivo.

Aggiungi a un progetto un tipo di documento specifico o un altro tipo di documento.

Altri tipi di documenti rilevanti per il progetto possono anch’essi essere aggiunti a un progetto, come file di testo, PDF, fogli di calcolo, ecc. Per farlo, usa l’opzione Add Existing to Project (o il comando Project » Add Existing to Project dal menu principale dell’editor del documento attivo) e imposta l’elenco a discesa File Type nella finestra di dialogo browser Choose Document to Add su All Files (*.*) in modo che sia possibile accedere a tutti i tipi di file.

Per rimuovere un documento dalla struttura del progetto, fai clic con il tasto destro sul suo nome nel pannello Projects e seleziona l’opzione di menu Remove from Project oppure scegli il comando Project » Exclude from Project dai menu principali. Ti verrà chiesto di scegliere:

• Delete File – per rimuovere definitivamente il file del documento sorgente stesso.

• Exclude from Project – per rimuovere il collegamento del progetto a quel documento (senza eliminare il file del documento sorgente stesso). Se è attualmente aperto nella finestra dell'editor di progettazione, verrà rimosso dal progetto padre ma rimarrà aperto nel pannello come documento libero. Se invece non è attualmente aperto nell'area di progettazione, la rimozione lo chiuderà di fatto.

  

Rimozione di un progetto

Per i progetti locali, la rimozione di un progetto consiste nell'eliminare i file dal disco rigido. Aprire la cartella del progetto in Esplora file di Windows ed eliminarne il contenuto.

Per i progetti Workspace (e altri contenuti del Workspace come componenti e dati rilasciati), è disponibile una funzionalità flessibile per la rimozione direttamente dall'interno di Altium Designer, dal pannello Explorer. Operando come una "eliminazione soft", il processo di rimozione offre maggiori opzioni e informazioni durante l'avanzamento, inclusi collegamenti pertinenti agli elementi sorgente a scopo di revisione. Nel Workspace, il contenuto eliminato viene spostato in una posizione dedicata Trash , da cui può essere recuperato o rimosso completamente dalla pagina Trash dell'interfaccia browser del Workspace.

Per eliminare in modalità soft un progetto Workspace, passare alla cartella del progetto nel pannello Explorer, fare clic con il pulsante destro del mouse sulla relativa voce e selezionare il comando Delete Folder dal menu contestuale. Confermare l'eliminazione nella finestra di dialogo Confirm Delete visualizzata. Se il progetto contiene dati rilasciati, si aprirà un'altra finestra di dialogo di conferma che informerà del fatto che anche questi dati verranno eliminati. Fare clic su Delete per procedere.

Eliminazione soft in azione. Qui viene eliminato un progetto, insieme alla relativa release (se fossero stati creati pacchetti di produzione da eventuali release, verrebbero eliminati anch'essi).