Working with Items

All’interno di un Workspace connesso, ogni entità di progettazione che può essere archiviata, gestita e riutilizzata è rappresentata come un tipo specifico di Item. Per supportare la necessità di poter aggiornare un Item nel tempo, ciò che viene effettivamente archiviato nel Workspace è una serie di revisioni dell’Item (Item Revisions), ovvero revisioni specifiche di quell’Item il cui nome si basa sullo schema di denominazione delle revisioni scelto. Ogni nuovo Item viene creato in una cartella e, una volta definite le cartelle richieste all’interno di un Workspace, è possibile creare nuovi Item nella cartella selezionata nell’area Item del pannello Explorer.

Tipi di contenuto supportati

Item diversi vengono utilizzati per archiviare e rappresentare diversi tipi di dati. Un Item può rappresentare un simbolo schematico, un altro un modello di componente PCB, mentre un altro ancora può contenere i dati di fabbricazione generati da un progetto di scheda rilasciato. Per dichiarare il tipo di contenuto che un Item (o meglio, le sue revisioni) conterrà, è necessario specificare la relativa proprietà Content Type durante la creazione o la modifica di quell’Item. In altre parole, si sta essenzialmente specificando il Item Type.

La tabella seguente elenca i vari tipi di contenuto (tipi di Item) che possono essere creati manualmente da un utente in un Workspace connesso, insieme ai relativi:

• Associated Folder Type – il tipo di cartella dedicato, ove disponibile, in cui archiviare il contenuto di quel tipo. Questo non influisce sul contenuto della cartella. Fornisce semplicemente un “indizio” visivo su ciò che è archiviato in una cartella e può risultare utile durante la navigazione in un Workspace alla ricerca di contenuti specifici. Il contenuto può essere archiviato in qualsiasi tipo di cartella, inclusa la Generic Folder.

• Content Type Code – il codice utilizzato durante l’assegnazione dell’ID univoco a un Item creato di quel tipo di contenuto, quando lo schema di denominazione degli Item della cartella padre utilizza la voce $CONTENT_TYPE_CODE.

• Folder Type Code – il codice utilizzato durante l’assegnazione dell’ID univoco a un Item creato di quel tipo di contenuto, quando lo schema di denominazione degli Item della cartella padre utilizza la voce $FOLDER_TYPE_CODE.

Revisioni dell’Item

Un Item può avere un numero qualsiasi di revisioni, che rappresentano essenzialmente l’evoluzione di quell’Item nel tempo. Viene apportata una modifica e il nuovo contenuto dati viene salvato/caricato/rilasciato in una nuova revisione, garantendo che nessuna revisione esistente possa mai essere sovrascritta e assicurando così la massima integrità. I dati archiviati in ciascuna revisione di un Item sono quindi tipicamente diversi. Per distinguere queste diverse revisioni di un Item, viene utilizzato un identificatore di revisione (ID), che in combinazione con l’ID dell’Item crea un identificatore univoco per ogni rilascio di un Item. Questo ci fornisce il Item-Revision.

Un ID completo Item-Revision identifica quindi semplicemente una revisione specifica di un Item padre. Ci sarà sempre almeno una revisione di un Item (il primo rilascio), ma potrebbero essercene molte, a seconda di quante volte i dati di quell’Item sono stati salvati/caricati/rilasciati. Un punto importante da sottolineare qui è che è possibile rilasciare verso un particolare Item-Revision una sola volta. Se c’è una modifica, allora deve essere creata una nuova Item-Revision. Questo garantisce la massima integrità, poiché i dati contenuti in una determinata revisione non possono mai essere sovrascritti effettuando nuovamente il rilascio sulla stessa revisione. Per rilasciare di nuovo, deve essere utilizzata una nuova Item-Revision.

Il modo più semplice per comprendere il concetto di un Item e delle sue revisioni è pensare a una “scatola”, nella quale vengono archiviati tutti i dati per quella particolare revisione di quel particolare Item. Quando l’Item viene rilasciato, i dati vengono inseriti nella scatola e la scatola viene chiusa. L’ID dell’Item e l’ID della revisione diventano etichette sul lato di quella scatola: consentono di riconoscere immediatamente a cosa serve il contenuto della scatola. Se i dati devono essere aggiornati e rilasciati nuovamente, allora l’ID della revisione viene incrementato, creando una nuova scatola.

La “scatola” Item-Revision, etichettata con l’ID dell’Item e l’ID della revisione. Il contenuto è costituito dai dati necessari per costruire o rappresentare quella revisione di quell’Item. L’atto del rilascio chiude la scatola, impedendo che qualsiasi altro dato venga rilasciato a quella revisione in futuro. L’ID completo Item-Revision, in questo caso, sarebbe: D-820-1001-01.A.1.

Il formato dell’ID di una revisione è determinato dallo Revision Naming Scheme utilizzato per l’Item padre. Il formato specifico usato in uno schema è configurabile e dipenderà dalle esigenze di ciascuna organizzazione.

Note di modifica dello stato e di rilascio

Per migliorare la tracciabilità di audit dei contenuti in un Workspace, Altium Designer offre la possibilità di inserire note quando si modifica lo stato del ciclo di vita di una revisione di un elemento e, per molti tipi di contenuto, quando si rilascia il dato sorgente in revisioni pianificate nel Workspace.

Note sul cambio di stato

Quando si modifica lo stato del ciclo di vita di una revisione di un elemento in un Workspace, utilizzare l'area State change note della successiva finestra di dialogo di cambio stato per inserire una nota pertinente a tale modifica.

Aggiunta di una nota per spiegare la modifica nello stato del ciclo di vita di una revisione di un elemento.

Note di rilascio

Quando si rilascia il dato sorgente in una nuova revisione pianificata di un elemento in un Workspace, utilizzare l'area Release notes della successiva finestra di dialogo Create Revision per inserire una nota pertinente a tale rilascio. Questa funzionalità è disponibile quando si esegue nuovamente il rilascio di qualsiasi tipo di elemento che supporta il paradigma Direct Editing.

Esempio di aggiunta di una nota di rilascio durante il nuovo rilascio di uno stackup di layer in un Workspace di destinazione.

Visualizzazione delle note associate alle revisioni di un elemento

Le note aggiunte per qualsiasi revisione di un elemento possono essere visualizzate nei seguenti punti:

• Detailed Item view – visualizzare la nota di rilascio associata e le note per i cambi di stato della revisione nella colonna Note all'interno dell'area Timeline. Per ogni stato nella vita di una revisione, la nota applicabile (se aggiunta) può essere visualizzata anche nella rappresentazione grafica del ciclo di vita della revisione.
• Explorer panel – passare alla scheda della vista aspetto Lifecycle per una revisione di elemento selezionata. Per ogni stato nella vita di una revisione, la nota applicabile (se aggiunta) può essere visualizzata nella rappresentazione grafica del ciclo di vita della revisione. Inoltre, è possibile visualizzare la nota di rilascio associata e la nota relativa all'ultimo cambio di stato della revisione nella colonna Note, all'interno dell'area principale Item del pannello (potrebbe essere necessario abilitare la visualizzazione di questa colonna).

Visualizzazione delle note associate alle revisioni di un componente.

Comandi generali degli elementi

Insieme alle opzioni di visualizzazione, l'area delle opzioni del pannello Explorer include anche il pulsante di comando Add <item>, che si applica al tipo di cartella attualmente selezionato.

Questo comando richiama la creazione di un nuovo elemento del Workspace del tipo selezionato. Quando nel pannello è selezionato, ad esempio, un tipo di cartella componente, viene proposto un pulsante . Questo aprirà un componente appena creato di quel tipo nel Component Editor. Analogamente, viene mostrato un pulsante quando è stato selezionato un tipo di cartella Output Job, e così via. Il pulsante seguirà una ricerca di componente, come inserita nel campo del percorso componente nella parte superiore del pannello, creando un'attività Part Request che si applica al componente selezionato nei risultati della ricerca.

Posizionamento tramite trascinamento

Il posizionamento di determinati elementi del Workspace in un progetto di progettazione PCB in Altium Designer è semplificato grazie alla possibilità di trascinare e rilasciare le revisioni di questi tipi di elementi sul documento attivo (e applicabile), direttamente dal pannello Explorer. È supportato il trascinamento di:

• Una revisione di un Component Item sul documento schematico attivo (o documento PCB). Il modello applicabile per il dominio scelto apparirà quindi agganciato al cursore.
• Una revisione di un Managed Schematic Sheet Item sul documento schematico attivo. Un simbolo di foglio che fa riferimento al foglio apparirà agganciato al cursore.
• Una revisione di un 3D Model Item su un documento PCB o PCB Library, creando un oggetto 3D Body che fa riferimento a quella revisione dell'elemento.

Esplorare il Workspace per trovare l'elemento richiesto da posizionare. Il posizionamento riguarda una revisione specifica di quell'elemento, quindi assicurarsi di espandere la voce principale dell'elemento per elencare tutte le revisioni disponibili (fare clic sul pulsante in alto a destra del pannello e disabilitare l'opzione Show only latest per vedere tutte le revisioni precedenti). Quindi fare clic sulla revisione richiesta e trascinarne un'istanza nel documento di progettazione.

Inoltre, Altium Designer supporta l'accesso ai componenti dal pannello Components panel e il loro posizionamento.

Download dei dati di contenuto

Scaricare i dati memorizzati in una revisione di un elemento facendo clic con il pulsante destro del mouse su tale revisione e scegliendo il comando Operations » Download dal menu contestuale. I dati associati verranno scaricati in una sottocartella nella directory scelta, denominata utilizzando l'ID della revisione dell'elemento. I file possono essere trovati nella cartella Released al suo interno.

Tipo di contenuto file binario

Altium Designer, insieme al Workspace connesso, offre la possibilità di archiviare file liberi in un tipo di contenuto speciale: l'elemento Binary File. Tali elementi possono essere creati per contenere uno o più file di qualsiasi formato. Ciò consente di sfruttare efficacemente la natura sicura del Workspace e sottolinea come il Workspace sia il luogo perfetto per archiviare qualsiasi cosa, inclusi i file binari sorgente riuniti in un'unica entità. Per facilitare inoltre il flusso semplificato dei file di dati, è disponibile una funzionalità bidirezionale di trascinamento, che consente di spostare rapidamente file tra cartelle nel Workspace e cartelle in Esplora risorse di Windows.

• Creare un elemento del tipo di contenuto Binary File nel Workspace. Una nuova revisione di un elemento Binary File può essere creata caricando i file applicabili. Questa operazione può essere eseguita in un paio di modi: vedere Uploading Data into a New Revision of an Item per ulteriori informazioni.
• Se è necessario modificare i file memorizzati in un elemento Binary File, caricare i nuovi file richiesti in quell'elemento: i nuovi file verranno memorizzati nella revisione successiva di quell'elemento.
• Per aprire un file memorizzato in una revisione di un elemento Binary File, selezionare tale file nella scheda della vista aspetto Details per la revisione, quindi fare clic con il pulsante destro del mouse e scegliere il comando Open dal menu contestuale. L'applicazione pertinente (o Altium Designer stesso) verrà utilizzata per presentare il file, ove applicabile.

Uso di un file binario con le preferenze dei template

Nell'ambito delle Preferenze di Altium Designer, è possibile definire i documenti template predefiniti utilizzati quando si crea un nuovo documento di un determinato tipo. Questa operazione viene eseguita dalla scheda Defaults della pagina Data Management – Templates page della finestra di dialogo Preferences. Un documento template predefinito può essere basato su file oppure provenire da un Workspace connesso.

Per alcuni tipi di documento (ActiveBOM Document, Out Job File, Multi-board Schematic e Multi-board Assembly), un documento template predefinito basato su Workspace può provenire solo da un file binario. È quindi necessario caricare il documento template richiesto nella revisione di un file binario e quindi utilizzarlo come predefinito per il nuovo documento.

Caricare un documento necessario (ad esempio, un file OutputJob) nella revisione iniziale di un nuovo file binario.

Ora, quando si tenta di definire un nuovo documento predefinito dal Workspace connesso, è possibile cercare il file binario e la voce nelle preferenze verrà compilata di conseguenza.

Utilizzo corretto di un OutputJob come nuovo documento predefinito, tramite il file binario che lo contiene.