Creating & Editing Content

Gli Item vengono creati direttamente all'interno di un Workspace connesso e tutti i dati necessari per produrre/rappresentare un Item vengono quindi memorizzati in quel Workspace associati al numero dell'Item. A seconda del tipo di contenuto, un Item può essere creato manualmente o automaticamente come parte di un processo di salvataggio/caricamento/rilascio. Tutti i tipi di contenuto possono essere creati in Altium Designer tramite il pannello Explorer. Quando si lavora con i componenti, la creazione è possibile anche tramite il pannello Components.

Gli Item vengono creati in un Workspace connesso. All'interno di Altium Designer, il pannello Explorer fornisce l'interfaccia completa al tuo Workspace.

Creazione di un Item

Una volta definite le cartelle richieste, è possibile procedere con la creazione del contenuto nel Workspace. Per creare un Item, selezionare la cartella appropriata, quindi fare clic con il pulsante destro del mouse nell'area della griglia Items del pannello e scegliere uno dei comandi dal sottomenu Create Item. In alternativa, se la cartella è vuota, usare il controllo Add an item al centro dell'area per accedere al menu.

Fare clic con il pulsante destro del mouse nell'area della griglia Items del pannello Explorer per accedere ai comandi relativi alla creazione del contenuto.

Verrà visualizzata la finestra di dialogo Create New Item, che fornisce tutti i controlli necessari per definire completamente l'Item.

Specificare i dettagli del nuovo Item nella finestra di dialogo Create New Item.

Per molti tipi di contenuto, dopo la creazione hai la possibilità di modificare e rilasciare il documento di progetto applicabile nella revisione iniziale di quel contenuto. Per farlo, abilita l'opzione Open for editing after creation, nella parte inferiore della finestra di dialogo Create New Item (abilitata per impostazione predefinita). L'Item verrà creato e si aprirà il relativo editor temporaneo, pronto per consentirti di creare i dati per quell'Item. Per ulteriori informazioni su come lavorare con uno specifico tipo di contenuto, consulta la pagina dedicata, il cui collegamento è fornito nella tabella.

Una nota sull'ID dell'Item...

Un aspetto importante della cartella padre in cui viene creato il contenuto è il Item Naming Scheme utilizzato per essa. Questo definisce il formato dell'ID univoco per ogni Item creato in quella particolare cartella. Definendo lo Item Naming Scheme a livello di cartella, il contenuto può essere creato rapidamente all'interno di quella cartella, rispettando al contempo il corretto schema di denominazione degli ID. Questo è particolarmente vero quando gli Item vengono creati automaticamente "al volo", anziché rilasciati in Item esistenti che sono stati creati manualmente direttamente nel Workspace di destinazione.

Sono disponibili diversi schemi di esempio predefiniti, che utilizzano il codice in forma breve per il tipo di cartella o per il tipo di contenuto (fare riferimento alla tabella precedente in questo documento per un elenco dei codici). Utilizzando uno schema di denominazione predefinito, il software assegnerà automaticamente il successivo ID univoco disponibile, in base a quello schema, dopo aver analizzato l'intero Workspace e gli identificatori del contenuto esistente.

In alternativa, se è necessario avere un controllo manuale completo sulla denominazione di un elemento, selezionare la voce [NO ITEM NAMING SCHEME]. In questo caso, come parte della creazione dell’elemento, deve essere definito un identificatore univoco. Si noti che il sistema non consentirà la creazione di un elemento con un identificatore duplicato, quindi l’assegnazione manuale di un identificatore richiede la conoscenza di quali identificatori siano già stati utilizzati.

Lo schema di denominazione degli elementi della cartella padre viene applicato all’ID univoco di ciascun elemento creato all’interno di quella cartella.

Indipendentemente dall’impostazione di Item Naming Scheme a livello di cartella, è possibile sovrascrivere qualsiasi ID determinato automaticamente a livello di elemento. Modificare tali ID secondo necessità tramite la finestra di dialogo Create New Item.

Scelta di uno schema per gli ID degli elementi

Esiste un numero infinito di possibili schemi di denominazione/numerazione che possono essere utilizzati per gli elementi; quelli mostrati nelle immagini della documentazione sono solo esempi. Esistono numerose discussioni su quale sia il miglior schema di numerazione da utilizzare. In generale, gli esperti concordano sul fatto che sia preferibile uno schema di numerazione breve, non significativo e composto solo da numeri. Per non significativo si intende che nello schema di numerazione non è codificata alcuna informazione, come categoria del prodotto, sottocategoria, posizione, ecc.; a ogni nuovo elemento viene semplicemente assegnato il numero successivo della sequenza.

La lunghezza è importante perché, quanto più lungo è l’identificatore, tanto maggiore è la probabilità che una persona commetta un errore quando registra o richiama l’ID dell’elemento. L’esperienza e gli studi accademici hanno dimostrato che gli errori di inserimento dati aumentano all’aumentare del numero di caratteri. Si ritiene che sette cifre siano il numero ideale in termini di facilità e affidabilità di richiamo da parte di una persona. Oltre una certa lunghezza, gli errori aumentano con un tasso crescente: a 15 caratteri, la probabilità di errore è vicina al 100%.

Se nella tua organizzazione è importante creare un’identità nell’ID dell’elemento, allora un identificatore composito potrebbe essere la soluzione. In questo caso, si consiglia un semplice codice prefisso alfanumerico di commodity. Ad esempio, si consideri l’ID D-820-0001. Qui il valore D nel codice potrebbe indicare Design, cioè che si tratta di un elemento utilizzato per i progetti. Nelle 3 cifre successive, la prima cifra potrebbe indicare la categoria del prodotto, ad esempio schede periferiche; la seconda e la terza cifra del blocco di tre potrebbero essere utilizzate per indicare schede nude (1X) o assemblaggi (2X e superiori). Le ultime quattro cifre dell’ID dell’elemento sono un semplice numero progressivo non significativo.

Impostazione dell’ID per la revisione iniziale di un elemento del Workspace

Il passaggio da un paradigma di progettazione locale a uno basato su Workspace richiede la migrazione dei dati esistenti in un Workspace. Tali dati potrebbero essere già passati attraverso più iterazioni e avere una numerazione di revisione riconosciuta in tutta l’organizzazione. Ad esempio, la rev.3 di una scheda Magno-Synthetic Digitizer potrebbe essere già stata consegnata, con miglioramenti da fornire nella rev.4. Al momento del rilascio nel Workspace, avere una revisione iniziale che riparte da 1 sarebbe quantomeno fonte di confusione, non solo all’interno dell’organizzazione ma, cosa ancora più importante, per la propria base clienti (che si aspetta una versione successiva rispetto alla rev.3 attuale!).

A tal fine, Altium Designer offre la possibilità di impostare manualmente l’ID della revisione iniziale di un nuovo elemento creato in un Workspace.

Impostazione dell’ID della revisione iniziale

Creare il nuovo elemento richiesto nel Workspace come di consueto. Dopo la creazione, fare clic con il pulsante destro del mouse sull’elemento e scegliere Properties, ottenendo così l’accesso alla finestra di dialogo Edit Item. Espandere la sezione Advanced della finestra di dialogo e fare clic sul pulsante , a destra del campo Revision ID. Verrà visualizzata la finestra di dialogo Set Initial revision Id values, dalla quale è possibile impostare l’ID in base alle proprie esigenze. Verranno forniti, ove applicabile, i campi per modificare i vari livelli dell’ID, in conformità con lo Revision Naming Scheme scelto.

Per accedere agli elementi correlati al progetto (PCB Fabrication Data, PCB Assembly Data, PCB Project Design) nel pannello Explorer, assicurarsi di visualizzare un progetto nel relativo Classic View. Potrebbe essere necessario passare manualmente da Project View; i comandi sono disponibili dal menu associato al pulsante , nella parte superiore destra del pannello.

Impostare i vari livelli dell’ID (come applicabile allo schema di denominazione delle revisioni utilizzato).

Creazione e modifica dei contenuti direttamente tramite un Workspace

Il tuo Workspace connesso fornisce un metodo flessibile e sicuro per centralizzare l’archiviazione e la gestione di tutti i tipi di dati di progettazione utilizzati in Altium Designer. Dal modello schematico al componente, dai fogli schematici gestiti fino ai progetti PCB completati, il Workspace offre un metodo ideale per archiviare e gestire i dati di progettazione elettronica.

Un aspetto potente di un Workspace è il supporto per Direct Editing. Ma cosa significa esattamente “modifica diretta”? Significa che puoi fare clic con il pulsante destro del mouse su un modello, un componente o persino un foglio gestito nel Workspace e selezionare Edit. Certo, un file si apre in Altium Designer pronto per essere modificato — aperto in un editor temporaneo — ma quando hai finito, lo salvi semplicemente di nuovo nel Workspace. Per quanto riguarda il file appena modificato, non devi preoccupartene: non è più necessario poiché le modifiche vengono archiviate in modo sicuro nel Workspace, quindi viene eliminato e l’istanza dell’editor temporaneo viene chiusa.

La modifica diretta ti libera dai vincoli di dati sorgente separati e sottoposti a controllo di versione. Puoi semplicemente modificare un tipo di elemento supportato utilizzando un editor temporaneo caricato con l’ultima sorgente direttamente dal Workspace stesso. E una volta completata la modifica, l’entità viene rilasciata (o nuovamente rilasciata) in una revisione pianificata successiva del relativo elemento padre e l’editor temporaneo viene chiuso. Non ci sono file sul disco rigido, nessun dubbio sul fatto che tu stia lavorando con la sorgente corretta o più recente e nessuna necessità di mantenere un software separato per il controllo di versione. Il Workspace gestisce tutto con grande integrità e in un modo che accelera notevolmente le modifiche ai dati.

Tipi di contenuto supportati per la modifica diretta

I seguenti tipi di contenuto del Workspace sono supportati per quanto riguarda la modifica diretta:

Modifica della revisione iniziale di un elemento

Dal pannello Explorer, quando si crea un Item di uno dei tipi di contenuto supportati, si ha la possibilità di modificare e rilasciare l'entità dati associata nella revisione iniziale di quell'item, dopo la creazione. Quindi, invece di creare i dati sorgente al di fuori del Workspace e rilasciarli, è possibile iniziare a lavorare direttamente sulla sorgente fin dal momento in cui viene creato l'Item vuoto, grazie alla modifica diretta. E quando la modifica è completata, l'entità viene rilasciata nella revisione iniziale pianificata del relativo Item padre e l'editor temporaneo viene chiuso.

Per sfruttare questa funzionalità, abilitare l'opzione Open for editing after creation, che si trova nella parte inferiore della finestra di dialogo Create Item dialog. Anticipando l'utilità di questa funzionalità, l'opzione è abilitata per impostazione predefinita. L'Item verrà creato e si aprirà il relativo editor temporaneo, che presenterà il documento pertinente come documento attivo nella finestra principale di progettazione. Questo documento sarà denominato in base a Item-Revisione, nel formato: <Item>-<Revision>.<DocumentExtension>.

L'immagine seguente mostra questa funzione in azione per la creazione di un nuovo Symbol Item (SYM-001-0031). Viene aperto un editor temporaneo Schematic Symbol, che presenta un documento per definire il simbolo secondo necessità.

Esempio di modifica della revisione iniziale di un Symbol Item direttamente dal Workspace: l'editor temporaneo Schematic Symbol fornisce il documento con cui definire il simbolo schematico.

Controlli di modifica diretta

Durante la modifica diretta sono disponibili tre controlli pertinenti, facilmente accessibili dalla Quick Access Bar (in alto a sinistra nella finestra principale dell'applicazione), oppure dalla barra degli strumenti Standard dell'editor temporaneo attivo (dove disponibile):

• ​ – Save Active Document. Utilizzare questo pulsante per salvare eventuali modifiche apportate al documento. Ciò consente di salvare le modifiche correnti se si desidera tornare in seguito per apportarne altre prima del rilascio finale nel Workspace.

• / – Save to Server. Utilizzare questo pulsante per rilasciare (di fatto salvare e rilasciare) il documento nel Workspace, memorizzandolo nella revisione iniziale (pianificata) o successiva dell'Item di destinazione. Verrà visualizzata la finestra di dialogo Create Revision dialog (o Edit Revision dialog), nella quale è possibile modificare Nome e Descrizione e aggiungere note di rilascio secondo necessità. Dopo il rilascio, il documento e l'editor verranno chiusi.

  Se applicabile e desiderato, è possibile aggiornare anche le revisioni degli item padre correlati a (che fanno riferimento alla) revisione corrente dell'item che si sta salvando. Questo è controllato dall'opzione Update items related to <ItemRevision>, che è abilitata per impostazione predefinita. Si noti che questa opzione compare solo quando:

  • si crea una nuova revisione di un domain model (simboli, footprint, modelli di simulazione, modelli di cablaggio harness) a cui fanno riferimento revisioni di component item.

  • si crea una nuova revisione di un component template a cui fanno riferimento revisioni di component item.

  • si crea una nuova revisione di un modello 3D a cui fanno riferimento revisioni di footprint model item.

  Se si desidera mantenere tutti gli Item padre correlati sulla revisione corrente dell'Item, disabilitare questa opzione. In tal caso verrà salvato solo l'item stesso.

  Quando si salva nel Workspace un componente o un domain model modificato (simbolo, footprint, modello di simulazione, modello di cablaggio harness), è possibile preservarne lo stato del ciclo di vita corrente. Il controllo è fornito tramite l'opzione Preserve lifecycle state (not recommended) disponibile nella finestra di dialogo Edit Revision / Create Revision durante il nuovo salvataggio. Quando l'opzione è abilitata, la nuova revisione verrà automaticamente impostata sullo stato del ciclo di vita della revisione precedente. Questa possibilità è disponibile per coloro ai quali è stata assegnata l'autorizzazione operativa Allow to skip lifecycle state change for new revisions (per saperne di più, vedere Setting Global Operation Permissions for a Workspace).

  Per salvare nel Workspace un documento in fase di modifica, è anche possibile usare il controllo Save to Server accanto alla voce del documento nel pannello Projects.

• / – Discard Local Changes. Utilizzare questo pulsante se si desidera annullare la modifica. Il file temporaneo (usato esclusivamente per facilitare la modifica) verrà eliminato, la relativa voce sarà rimossa dal pannello Projects e nulla verrà rilasciato nell'Item di destinazione.

  Con il file temporaneo applicabile usato per una sessione di modifica diretta, non è necessario completare il processo di aggiornamento in una singola sessione di modifica: è possibile salvare il lavoro e chiudere il file, se lo si desidera. Altium Designer riconosce che si tratta di un file speciale, quindi lo conserva nella cartella <SourceWorkspaceName> del pannello Projects, in modo che possa essere riaperto quando si è pronti e si possa completare il processo di aggiornamento e nuovo rilascio.

Questi controlli possono essere accessibili anche come comandi dal menu contestuale della voce del documento nel pannello Projects. Per molti editor, questi controlli sono disponibili anche come comandi – Save (scorciatoia: Ctrl+S), Save to Server (scorciatoia: Ctrl+Alt+S) e Discard Local Changes – dal menu principale File.

Modifica di una revisione esistente di un Item

In qualsiasi momento, è possibile tornare a qualsiasi revisione di un Item di un tipo di contenuto supportato nel Workspace (tramite il pannello Explorer) e modificarla direttamente. Fare clic con il pulsante destro del mouse sulla revisione e scegliere il comando Edit dal menu contestuale. Ancora una volta si aprirà l'editor temporaneo, con il documento contenuto nella revisione aperto per la modifica. Apportare le modifiche necessarie, quindi confermare il rilascio del documento nella revisione successiva dell'item.

Esempio di accesso al comando per avviare la modifica diretta di un Draftsman Document Template esistente.

Comportamento dei file temporanei

Per poter modificare i dati del Workspace, deve essere creato qualcosa da modificare in Altium Designer. Ciò che accade è che vengono creati file temporanei. Ad esempio, quando si fa clic con il pulsante destro del mouse su un Symbol Item e si seleziona Edit, viene creato e aperto in Altium Designer un file SchLib temporaneo. Quando si termina e si esegue un Save to Server, questo file viene distrutto non appena i dati del Workspace vengono aggiornati.

Tuttavia, se non lo si rilascia e invece si Save e Close il file, esso rimarrà nel pannello Projects. Questo viene fatto in modo che non sia necessario completare il processo di aggiornamento in una singola sessione di modifica: è possibile salvare il lavoro e chiudere il file, se lo si desidera; Altium Designer riconosce che si tratta di un file speciale e quindi lo conserva sotto la voce <WorkspaceName> nel pannello Projects (ad esempio, /) in modo che possa essere riaperto quando si è pronti e si possa completare il processo di aggiornamento e nuovo rilascio.

I documenti temporanei rimangono accessibili, così non è necessario completare le modifiche in una singola sessione di modifica.

Modifica diretta dei componenti dal pannello Components

Nella gestione quotidiana dei componenti, la modifica diretta è disponibile dal pannello Components, che tenderà a essere usato più del pannello Explorer per quel particolare tipo di contenuto. Cercare il componente richiesto, selezionarlo, quindi fare clic con il pulsante destro del mouse e scegliere il comando Edit dal menu contestuale. Verrà aperta un'istanza temporanea del Component Editor, nella modalità Single Component Editing, pronta per apportare le modifiche necessarie.

Un esempio di modifica diretta dal pannello Components.

Modifica diretta dei modelli dal Component Editor

Quando si modifica un componente usando il Component Editor nella modalità Single Component Editing, è possibile modificare i domain model collegati usando il paradigma della modifica diretta. Per modificare un modello attualmente in uso (a cui fa riferimento il componente), fare clic sul controllo in alto a destra della relativa anteprima. Si aprirà l'editor temporaneo corrispondente per quel tipo di modello, pronto per apportare al modello le modifiche necessarie. Quando è tutto pronto, è sufficiente salvare e chiudere l'editor: il modello modificato apparirà nuovamente collegato nell'area Models. Al rilascio del componente, anche il modello modificato verrà automaticamente rilasciato nel Workspace, nella revisione successiva del relativo Item padre.

Un esempio di modifica diretta di un modello esistente a cui fa riferimento un componente che è esso stesso in fase di modifica diretta, usando il Component Editor nella modalità Single Component Editing.

Caricamento dei dati in una nuova revisione di un Item

La maggior parte dei tipi di contenuto supporta la creazione di una nuova revisione caricando il file di dati applicabile.

Il caricamento dei dati in una nuova revisione di un Item può essere eseguito in un paio di modi.

Menu Upload

Un file può essere caricato facendo clic con il pulsante destro del mouse sull’Item richiesto nel pannello Explorer panel e scegliendo il comando Upload dal menu contestuale. Verrà visualizzata la finestra di dialogo Create New Revision, nella quale è possibile modificare Nome, Descrizione e aggiungere note di rilascio secondo necessità. Utilizzare l’area Sources della finestra di dialogo per caricare il file richiesto. Questa operazione può essere eseguita trascinando il file da Windows Explorer nell’area. In alternativa, fare clic sul pulsante : verrà visualizzata la finestra di dialogo Add Files (una finestra standard di apertura file di Windows). Utilizzarla per individuare e aprire il file richiesto.

Esempio di caricamento. In questo caso, specifica manuale di un file di modello 3D da caricare in un Item 3D Model di destinazione.

Una volta trascinato il file desiderato oppure selezionato e fatto clic sul pulsante Open, una voce per esso apparirà nuovamente nell’area Sources.

Per un tipo di contenuto che supporta il caricamento di più file in una sua revisione, come Binary File, i file scelti verranno aggiunti e visualizzati nell’area Sources della finestra di dialogo. Se è necessario modificare il contenuto dell’elenco, aggiungere file aggiuntivi o selezionare e rimuovere file (fare clic sul pulsante  ) secondo necessità. L’area Sources supporta la selezione di più file utilizzando le tecniche standard di selezione multipla (Ctrl+Click, Shift+Click e clic-e-trascina).

Procedere con il caricamento facendo clic sul pulsante OK. A seconda del tipo di contenuto, le informazioni relative ai file caricati verranno presentate nelle schede di visualizzazione aspetto Details e/o Preview per la revisione dell’Item, nel pannello Explorer.

Sfogliare la revisione salvata dell’Item (mostrata qui per un Item 3D Model), di nuovo nel pannello Explorer. Passare alla scheda di visualizzazione aspetto Preview per vedere la sua rappresentazione grafica (ove applicabile).

Trascinamento da Windows Explorer

I file di dati pertinenti possono anche essere caricati trascinando i file selezionati da una cartella di origine in Windows Explorer e rilasciandoli sull’Item di destinazione richiesto nel pannello Explorer panel. Verrà visualizzata la finestra di dialogo Create New Revision, con il file trascinato elencato nell’area Sources. Aggiungere eventuali Release Notes secondo necessità, quindi fare clic sul pulsante OK.

Per alcuni tipi di contenuto, sarà necessario modificare il Name (che sarà il nome del file, inclusa l’estensione; per più file, le voci saranno separate da un punto e virgola) e la Description (che sarà nel formato Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (per più file, le voci saranno separate da un punto e virgola)). Per quei tipi di contenuto che supportano più file, se è necessario aggiungere file aggiuntivi questo può essere fatto facendo clic sul pulsante e cercando i file, oppure trascinando i file nell’area Sources. Se è necessario rimuovere file, selezionarli nell’elenco e fare clic sul pulsante  .

Caricamento tramite trascinamento, mostrato qui per un 3D Model.

Clonazione del contenuto del Workspace

Il pannello Explorer offre la possibilità di clonare una varietà di Item del Workspace. Quindi, invece di creare da zero il componente, il modello di dominio, il foglio schematico o il template richiesto, è possibile semplicemente clonarlo. Direct Editing garantisce che qualsiasi modifica necessaria, apportata a una copia dei dati sorgente della revisione dell’Item originale, sia un’operazione snella, con le modifiche risultanti rilasciate in una revisione iniziale di un nuovo Item dello stesso tipo. Fatto in un attimo, è possibile espandere rapidamente il contenuto del Workspace senza trovarsi davanti a una tela bianca.

I seguenti tipi di contenuto possono essere clonati:

• Component
• Footprint
• Symbol
• Simulation Model
• Component Template
• Managed Schematic Sheet
• Schematic Template
• Project Template
• Draftsman Document Template
• Draftsman Sheet Template
• Layerstack
• OutputJob

Il comando per clonare uno dei tipi di contenuto supportati è accessibile dal pannello Explorer nei seguenti modi:

• Facendo clic con il pulsante destro del mouse sulla voce della revisione Item sorgente e scegliendo il comando Operations » Clone dal menu contestuale.
• Selezionando la voce della revisione Item sorgente e utilizzando la scorciatoia da tastiera Ctrl+D.

Il comando Clone è disponibile in tutto il pannello Explorer, ovunque venga presentata la revisione Item applicabile, inclusi:

• L’elenco principale degli Item all’interno di una cartella.
• Children scheda di visualizzazione aspetto (quando si visualizza un Item Managed Schematic Sheet).
• Where-used scheda di visualizzazione aspetto (quando si visualizza un Item Component, Symbol, Footprint, Simulation Model, Component Template o Schematic Template).
• Preview scheda di visualizzazione aspetto (quando si visualizza un Item Component, Managed Schematic Sheet o Schematic Template).