Creazione di progetti e documenti

Altium Training

Altium Essentials: Project Creation and Storage

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

A colpo d'occhio

Ogni progetto in Altium Designer parte da una struttura che ne riunisce i documenti di progettazione. Questo articolo spiega come creare un progetto in Altium Designer, scegliere un tipo di progetto e un modello e configurare l'archiviazione in un Workspace connesso, in un repository esterno per il controllo delle versioni o in una cartella locale. Illustra inoltre le opzioni di configurazione, tra cui il controllo delle versioni, la gestione dei vincoli, i percorsi delle cartelle e i parametri di progetto. Continua a leggere per creare una solida base per il tuo prossimo progetto.

- Scopri le opzioni disponibili per l'archiviazione dei progetti e i vantaggi della gestione basata su Workspace.
- Impara a utilizzare la finestra di dialogo Crea progetto per selezionare i modelli e configurare le impostazioni del progetto.
- Scopri come vengono visualizzati i nuovi progetti nel pannello Progetti e in quali casi un progetto contiene soltanto una struttura vuota.
Approfondisci con l'IA:

Il punto di partenza per ogni progetto realizzato in Altium Designer è un progetto. Un progetto di Altium Designer riunisce 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 di un progetto PCB comprendono l'insieme di file necessari per produrre un circuito stampato. Al contrario, l'insieme di file generato da un progetto di cablaggio viene utilizzato per acquistare e assemblare un cablaggio, mentre lo schema logico e i file di assemblaggio fisico di un progetto multischeda generano l'insieme di file necessario per produrre e assemblare un prodotto completo con più PCB collegati.

I documenti di progettazione del progetto possono essere riuniti da qualsiasi origine accessibile, locale al computer o meno; il file di progetto li collega tra loro come un unico progetto integrato. Il software utilizza la compilazione dinamica per creare e gestire un modello di dati unificato dei componenti del progetto e delle relative connessioni. Questo modello di dati può quindi essere utilizzato per propagare le modifiche tra gli ambiti di progettazione, ad esempio mediante la sincronizzazione per risolvere le differenze tra i documenti degli ambiti schematico e PCB.

I documenti del progetto possono essere creati e archiviati nel proprio Workspace Altium, nel proprio sistema di controllo delle versioni 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 Crea progetto

È possibile creare un nuovo progetto in Altium Designer utilizzando la finestra di dialogo Create Project (File » New » Project).

La finestra di dialogo Create Project consente di creare un nuovo progetto nel Workspace connesso, aggiungere un nuovo progetto a un repository esterno di controllo delle versioni esistente (con una copia di lavoro nella posizione preferita) e creare un nuovo progetto in una cartella specificata sul disco rigido locale.

  1. Nell'elenco Locations, selezionare la voce relativa al proprio Workspace (verrà visualizzata con il nome assegnatogli): per visualizzare questa opzione nell'elenco è necessario essere connessi al Workspace. Questo sarà il server di destinazione in cui archiviare il nuovo progetto del Workspace.

    In sintesi, la gestione dei progetti si concentra sull'archiviazione sicura e sul monitoraggio delle modifiche durante l'intero processo di progettazione e, infine, sulla trasformazione del progetto risultante in un oggetto fisico, ad esempio un PCB assemblato da utilizzare nel prodotto finale. Per soddisfare queste esigenze, Altium Designer offre una serie di approcci alla gestione dei progetti con livelli crescenti di sofisticazione e funzionalità, semplificando al contempo il processo dal punto di vista del progettista. Si va dall'archiviazione e gestione locale basata su file agli approcci di archiviazione con sistemi di controllo delle versioni (VCS) locali/remoti, fino alla modalità più avanzata e consigliata, in cui la gestione dei dati di progettazione è incentrata sulle funzionalità di un Workspace.

    Un Workspace connesso e il relativo servizio VCS interno ospitano e gestiscono i progetti di Altium Designer e offrono inoltre operazioni VCS semplificate, funzionalità integrate di collaborazione alla progettazione, condivisione avanzata dei dati di progettazione, tracciamento della cronologia, gestione del ciclo di vita 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 vengono semplificate e automatizzate; inoltre, funzionalità aggiuntive di collaborazione alla progettazione, come il controllo degli accessi degli utenti (condivisione), i commenti e la cronologia, sono disponibili direttamente in Altium Designer. Il risultato finale è un formato e una posizione di archiviazione dei progetti robusti e sicuri, che possono diventare il punto centrale per la progettazione collaborativa.

    Quando si è connessi a un Workspace con una o più definizioni di processo attive per la categoria di processo Creazione progetti, la possibilità di creare un nuovo progetto tramite la finestra di dialogo Create Project è limitata ai soli progetti di tipo Locale e VCS. La creazione di progetti basati sul Workspace è invece controllata dalle definizioni di processo attive. Ulteriori informazioni sulla creazione di progetti basata su processi.

  2. Nell'elenco Project Type, scegliere il tipo di progetto da creare e selezionare, secondo necessità, uno dei modelli disponibili applicabili. La voce <Empty> creerà un progetto vuoto senza documenti sorgente iniziali.

    Ulteriori informazioni sulla creazione di un modello di progetto.

  3. Immettere 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 trattini bassi, 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:

  • Selezionare l'opzione Version Control (impostazione predefinita) per applicare al progetto tutte le funzionalità VCS, come la cronologia e le funzionalità avanzate di condivisione. Quando l'opzione è deselezionata, il progetto viene archiviato nel Workspace e sincronizzato con la copia locale: un progetto «speculare» nel formato Sincronizzazione semplice.

    L'opzione Version Control è disponibile solo quando si è connessi a un Workspace Altium 365. Quando si è connessi a un Workspace Enterprise Server, questa opzione è di fatto selezionata.
  • Quando si crea un progetto di tipo PCB, selezionare l'opzione Constraint Management per gestire i vincoli di progettazione di questo progetto utilizzando Gestione vincoli. Quando l'opzione è disabilitata, per questo progetto verrà utilizzato il sistema di regole di progettazione.

    L'opzione Constraint Management è abilitata per impostazione predefinita nella finestra di dialogo Create Project quando l'opzione System.ConstraintManager è abilitata nella finestra di dialogo Impostazioni avanzate.

  • Quando si è connessi a un Workspace Enterprise Server, il menu a discesa Repository (se presente) elenca tutti i repository di progettazione gestiti tramite il servizio di controllo delle versioni del Workspace e condivisi con l'utente per l'utilizzo. Scegliere il repository in cui archiviare il nuovo progetto e i relativi file: per impostazione predefinita è disponibile un unico repository basato su Git (Versioned Storage). Se si seleziona un repository di tipo SVN, è disponibile un'ulteriore opzione Repository Folder per specificare o individuare una cartella di destinazione alternativa all'interno del repository stesso.

    Il menu a discesa Repository viene visualizzato solo se Enterprise Server è stato aggiornato da una versione o da un prodotto server in cui era abilitato l'utilizzo dei repository SVN. In alternativa, Enterprise Server fornisce un unico repository di progettazione basato su Git per ospitare tutti i progetti di progettazione del Workspace; in questo caso il menu a discesa Repository non viene visualizzato.

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

    Per ulteriori informazioni sulla dismissione di SVN in Altium On-Prem Enterprise Server, consultare l'articolo della Knowledge Base Dismissione di SVN con Altium On-Prem Enterprise Server 7.2.1 .

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

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

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

    • Utilizzare il campo Local Storage per specificare dove archiviare la versione locale del progetto sul disco rigido. La posizione predefinita è definita nella pagina Sistema – Posizioni predefinite della finestra di dialogo Preferences. Fare clic sul pulsante per individuare e selezionare una cartella diversa, se necessario. Questa è la cartella di lavoro del progetto e del repository Git local in cui viene eseguito 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.

     

  • Utilizzare l'area dell'elenco Parameters per aggiungere o rimuovere coppie di parametri Nome/Valore personalizzate associate al progetto e salvate nel Workspace. Utilizzare 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 nel Workspace, questi parametri vengono salvati nel Workspace insieme al nuovo progetto come parametri a livello di progetto lato Workspace.

    Quando si seleziona un modello di progetto nell'elenco Project Type della finestra di dialogo, l'area dell'elenco Parameters viene popolata con i parametri di questo modello. Se necessario, è possibile modificare questi parametri (nomi e/o valori) o rimuoverli. Quando si crea un progetto nel Workspace, un parametro del modello selezionato viene salvato come parametro a livello di progetto lato progettazione se il nome del parametro non è stato modificato. In caso contrario, viene salvato come parametro a livello di progetto lato Workspace.

    I parametri a livello di progetto lato Workspace possono essere modificati all'interno del Workspace. I parametri lato progettazione, invece, vengono salvati nel file di progetto (*.PrjPcb) e possono essere modificati in Altium Designer. I parametri a livello di progetto di entrambi i tipi possono essere visualizzati nella scheda Parametri della finestra di dialogo Project Options (Project » Project Options) e possono essere utilizzati come stringhe speciali in Altium Designer.

Una volta definito il progetto secondo le proprie esigenze, fare clic sul pulsante . La nuova struttura del progetto verrà creata nelle cartelle locali e del Workspace specificate. Il progetto verrà aperto nel pannello Progetti, che mostrerà lo stato di completa sincronizzazione tra i file nel repository di progettazione remoto (nel Workspace) e il repository locale (copia di lavoro), come indicato dalle icone associate. Se viene creato con l'opzione Version Control deselezionata (disponibile solo in un Workspace di Altium 365), il progetto con mirroring verrà visualizzato nel pannello Projects con un'icona associata.

Il progetto appena creato di cui è stato eseguito il commit nel repository di progettazione Versioned Storage del Workspace.Il progetto appena creato di cui è stato eseguito il commit nel repository di progettazione Versioned Storage del Workspace.

In alternativa, se al nuovo progetto not è stato assegnato un modello con documenti costitutivi, verrà creato il file di progetto (*.PrjPcb) e quindi soltanto la struttura del progetto. Il progetto viene quindi aperto nel pannello Progetti, che lo mostrerà come Scheduled for addition, contrassegnato dall'icona associata. A questo punto è possibile aggiungere documenti al progetto o semplicemente salvare la struttura nel Workspace nel suo stato attuale, ancora vuoto. A tale scopo, fare clic sul controllo Save to Server associato alla voce del progetto nel pannello Projects, disponibile anche nel menu contestuale accessibile con il pulsante destro del mouse e nel menu principale File. Nella successiva finestra di dialogo Salva sul server, selezionare/deselezionare i file da includere, aggiungere un Comment facoltativo e confermare il salvataggio con il pulsante . Una volta aggiunto il progetto al server, il pannello Projects mostrerà lo stato di completa sincronizzazione tra i file nel repository del server e la copia di lavoro locale, come indicato dalle icone .

  • Il progetto verrà visualizzato nel pannello Projects sotto una voce relativa al Workspace di destinazione, che riporta il nome di tale Workspace.

  • Inoltre, una voce relativa al progetto verrà visualizzata nella pagina Projects dell'interfaccia browser del Workspace.

  • Inizialmente, il progetto verrà condiviso con accesso in lettura/scrittura con il progettista che lo ha creato (proprietario) e con tutti gli amministratori del Workspace.

    Consultare Condivisione di un progetto per ulteriori informazioni sulla configurazione delle autorizzazioni di accesso al progetto.

  • È inoltre possibile creare un nuovo progetto direttamente in un Workspace tramite la relativa interfaccia browser, nella pagina dei progetti (selezionare Projects), e successivamente aprirlo in Altium Designer per modificarlo e aggiungere contenuti.

  • Insieme al file di progetto (*.PrjPcb), viene creato il file della struttura del progetto (*.PrjPCBStructure). Questo file contiene informazioni sulla gerarchia del progetto, che sia piatta o gerarchica. Il file viene rigenerato durante la compilazione dinamica del progetto (quando viene aperto un documento del progetto).

  • È possibile accedere alla finestra di dialogo Create Project anche facendo clic con il pulsante destro del mouse sulla voce del Workspace all'interno del pannello Projects  e scegliendo il comando Create Project dal menu.

Copia di un progetto

Per copiare un progetto del Workspace da Altium Designer, fai clic con il pulsante destro del mouse 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 definire 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).

Non sono necessarie autorizzazioni speciali per copiare un progetto. Il progetto copiato è una copia esatta del progetto originale del Workspace e ha le stesse proprietà di modifica, senza restrizioni; non è quindi possibile creare un progetto di sola lettura. Tieni inoltre presente che il progetto copiato verrà creato nello stesso repository di progettazione dell'originale: non è possibile cambiarlo durante la procedura di copia.

Per impostazione predefinita, Folder del Workspace corrisponderà alla cartella in cui è archiviato il progetto originale. Fai clic su per aprire la finestra di dialogo Choose Folder (una versione semplificata del pannello Explorer) e cambiare cartella secondo necessità. Per impostazione predefinita, Local Storage utilizzerà il percorso definito nella pagina Sistema - Percorsi predefiniti della finestra di dialogo Preferences. Fai clic su per aprire una finestra di dialogo standard di Windows con cui modificare questo percorso secondo necessità.

Copia di un progetto del Workspace da Altium Designer.
Copia di un progetto del Workspace da Altium Designer.

Ogni volta che copi il progetto, alla sequenza temporale della cronologia del progetto copiato verrà aggiunto un riquadro evento Project Copied. Inoltre, il riquadro Project Created della copia del progetto includerà un collegamento al progetto originale. Scopri di più sulla cronologia del progetto.
Puoi copiare un progetto esistente del Workspace dalla finestra di dialogo Apri progetto. Seleziona il progetto nel Workspace a cui sei connesso, quindi fai clic sul controllo Open Project As Copy nella parte inferiore del riquadro Information a destra. Inoltre, quando esplori il progetto tramite il pannello Explorer di Altium Designer, configurato nella modalità predefinita Project View anziché Classic View, puoi copiare il progetto facendo clic sul pulsante Copy  in alto a destra nel pannello.
Puoi copiare solo un progetto del Workspace aperto dal Workspace Altium attualmente connesso. Se Altium Designer non è attualmente connesso al Workspace del progetto, oppure se il progetto non è un progetto del Workspace, il comando Make a copy non sarà disponibile nel menu accessibile con il pulsante destro del mouse.

Aggiunta e rimozione di un documento di progettazione

Una volta creato un progetto, è possibile aggiungere, modificare o rimuovere documenti di progettazione dal progetto attivo. Il modo più semplice per aggiungere nuovi documenti di progettazione a un progetto consiste nel fare clic con il pulsante destro del mouse 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 desiderato dal sottomenu Project » Add New to Project dei menu principali per aggiungere un nuovo documento al progetto attivo.

  • Se per il tipo di documento scelto è possibile specificare impostazioni predefinite nella pagina Gestione dati - Modelli della finestra di dialogo Preferences, il documento verrà creato utilizzando tale impostazione predefinita come modello.
  • Inizialmente il documento non è salvato.

Aggiunta di un documento di un tipo specifico o diverso a un progetto.
Aggiunta di un documento di un tipo specifico o diverso a un progetto.

A un progetto è possibile aggiungere anche altri tipi di documenti pertinenti, come file di testo, PDF, fogli di calcolo e così via. A tale scopo, usa l'opzione Add Existing to Project (oppure 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 di selezione file Choose Document to Add su All Files (*.*), in modo da poter accedere a tutti i tipi di file.

I progetti di progettazione non sono limitati ai soli file creati da Altium Designer: è possibile includere praticamente qualsiasi documento in un progetto. Quando si accede al documento da Altium Designer, il sistema tenta di individuare lo strumento di creazione o visualizzazione corrispondente in base all'estensione del file e alle impostazioni del registro di Windows. Se viene trovata una corrispondenza, Altium Designer avvia l'editor associato, all'interno del proprio ambiente di modifica oppure come applicazione separata. Ciò significa che puoi includere nei tuoi progetti qualsiasi tipo di documento di test, documentazione, materiale di riferimento e specifiche, con la certezza che, ovunque venga trasferito il progetto, tutta la documentazione di supporto lo seguirà.
Quando aggiungi documenti esistenti a un progetto del Workspace Altium 365, tieni presente che esiste una limitazione per i file zip, 7z e rar di dimensioni superiori a 256 MB. I progetti contenenti tali file non possono essere salvati nel Workspace e verrà visualizzato un errore Git. Consulta l'articolo della Knowledge Base Come correggere i dati del progetto dopo un errore Git con codice di stato 471 per scoprire come risolvere questo problema.

Per rimuovere un documento dalla struttura del progetto, fai clic con il pulsante destro del mouse 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 eliminare definitivamente il file sorgente del documento.
  • Exclude from Project – per rimuovere il collegamento del progetto a quel documento (senza eliminare il file sorgente del documento). Se il documento è attualmente aperto nella finestra dell'editor di progettazione, verrà rimosso dal progetto di appartenenza ma resterà aperto nel pannello come documento libero. Se invece non è attualmente aperto nell'area di progettazione, la rimozione ne comporterà la chiusura.

Puoi anche rimuovere dal progetto di appartenenza tutti i documenti della categoria selezionata (sottocartella), facendo clic con il pulsante destro del mouse sulla voce della categoria desiderata e scegliendo il comando Remove All dal menu contestuale.

Rimozione di un progetto

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

Per aprire rapidamente una finestra di Esplora file di Windows nel percorso in cui è archiviato il progetto, fai clic con il pulsante destro del mouse sulla voce del progetto nel pannello Projects e seleziona il comando Explore.

Per i progetti del Workspace (e altri contenuti del Workspace, come componenti e dati rilasciati), è disponibile una funzionalità flessibile per la rimozione direttamente da Altium Designer, tramite il pannello Explorer. Il processo di rimozione funziona come un'eliminazione reversibile e offre ulteriori opzioni e informazioni durante la procedura, inclusi collegamenti pertinenti agli elementi di origine per consentirne la verifica. Nel Workspace, i contenuti eliminati vengono spostati in una posizione dedicata Trash , da cui possono essere recuperati o rimossi definitivamente tramite la pagina Trash dell'interfaccia browser del Workspace.

Per un progetto, solo il proprietario o un amministratore può eseguire l'eliminazione definitiva o il ripristino da Trash.

Per eliminare un progetto del Workspace in modo reversibile, accedi alla cartella del progetto nel pannello Explorer, fai clic con il pulsante destro del mouse sulla relativa voce e seleziona il comando Delete Folder dal menu contestuale. Conferma l'eliminazione nella finestra di dialogo Confirm Delete visualizzata. Se il progetto contiene dati rilasciati, si aprirà un'altra finestra di conferma che ti avviserà che anche questi dati verranno eliminati. Fai clic su Delete per procedere.

Per aprire rapidamente il pannello Explorer con la cartella del progetto selezionata, fai clic con il pulsante destro del mouse sulla voce del progetto nel pannello Projects e seleziona il comando Show in Explorer.

Eliminazione reversibile in azione. Qui viene eliminato un progetto, insieme al relativo rilascio (se fossero stati creati pacchetti di produzione a partire da uno qualsiasi dei rilasci, verrebbero eliminati anche quelli).
Eliminazione reversibile in azione. Qui viene eliminato un progetto, insieme al relativo rilascio (se fossero stati creati pacchetti di produzione a partire da uno qualsiasi dei rilasci, verrebbero eliminati anche quelli).

AI-LocalizedLocalizzato tramite A
Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Enter per inviarci il tuo feedback.
Nav
Contents
Disponibilità delle funzionalità

Le funzionalità a tua disposizione dipendono dalla soluzione Altium di cui disponi: Altium Develop, Altium Agile Teams, Altium Agile Enterprise oppure Altium Designer (con abbonamento attivo).

Se non vedi una funzionalità documentata nel software che stai effettivamente utilizzando, contatta il reparto 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.

Contents