Acquisizione dei dati del Workspace tramite il Content Cart
A colpo d'occhio
- Scopri come aggiungere singole revisioni, più elementi o intere cartelle al Content Cart.
- Impara a configurare le cartelle di destinazione, le definizioni del ciclo di vita e gli schemi di denominazione prima di trasferire i dati.
- Comprendi gli aspetti fondamentali dell'acquisizione, tra cui gli elementi figlio collegati, le revisioni già acquisite e i requisiti di connettività dei Workspace.
La funzionalità di acquisizione dati di un Workspace offre uno strumento semplificato che consente essenzialmente di copiare dati tra due Workspace (vedere le informazioni sulla compatibilità). Lo strumento con cui si esegue questa operazione, ovvero l'interfaccia al servizio di acquisizione dati, è il Content Cart. È il centro di controllo per definire cosa acquisire dal Workspace di origine e trasferire al Workspace di destinazione designato: un affidabile furgone per traslochi che «trasporta» i dati selezionati tra le rispettive sedi nei Workspace.
Non c'è modo migliore di illustrare il funzionamento di una funzionalità che attraverso un esempio. Per mostrare nel dettaglio il funzionamento del Content Cart e il suo utilizzo per l'acquisizione dei dati, questo articolo illustra l'acquisizione di alcuni componenti tra i seguenti Workspace:
-
Source Server – un Workspace denominato
Company Workspace. -
Target Server – un secondo Workspace denominato
Secondary Company Workspace.
Accesso al carrello
La finestra di dialogo Content Cart è accessibile dal pannello Explorer. Durante l'esplorazione del Workspace di origine da cui si desidera ottenere i dati, fare clic con il pulsante destro del mouse sulla revisione di un elemento da acquisire e scegliere il comando Operations » Add to Content Cart dal menu contestuale. È possibile aggiungere una o più revisioni di elementi selezionate o persino una cartella di elementi. Al primo accesso, il carrello viene caricato con le revisioni degli elementi selezionate nel Workspace di origine al momento dell'accesso:
- Una singola revisione specifica di un elemento.
- Più revisioni specifiche dello stesso elemento.
- Le revisioni più recenti di più elementi.
- Le revisioni più recenti di tutti gli elementi nella cartella selezionata e nelle relative sottocartelle. In questo modo è possibile caricare un'intera cartella nel carrello preservandone la struttura. Per acquisire una cartella e le relative sottocartelle, selezionarla nell'area Server Folders del Workspace di origine, all'interno del pannello Explorer , quindi fare clic con il pulsante destro del mouse e scegliere il comando Operations » Add to Content Cart dal menu contestuale.

Un esempio di accesso al Content Cart.
Elementi che è possibile acquisire
Utilizzando la funzionalità di acquisizione dati, è possibile acquisire i seguenti tipi di elementi da un Workspace di origine a un Workspace di destinazione:
- Modello 3D
- Preferenze di Altium Designer
- Componente (incluse le scelte dei componenti associate)
- Modello di componente
- Scheda tecnica
- Footprint
- Foglio schematico gestito
- Outputjob
- Modello di schema elettrico
- Script
- Modello di simulazione
- Simbolo
Inoltre, quando si acquisisce una cartella di elementi dal Workspace di origine, sono supportati i seguenti tipi di cartelle:
- Componenti
- Cartella generica
Considerazioni sull'acquisizione
Aspetti da considerare durante l'acquisizione dei dati:
- È possibile acquisire solo gli elementi di dati che si trovano in uno stato rilasciato nel Workspace di origine.
- Viene acquisita solo la revisione scelta di un elemento di origine, non tutte le revisioni eventualmente esistenti per tale elemento.
-
Quando si acquisisce una revisione di un elemento di tipo Componente o Foglio schematico gestito di origine, vengono acquisiti anche tutti gli elementi secondari collegati:
- Component Item – le revisioni applicabili dei seguenti oggetti secondari collegati: elemento Simbolo, elementi Footprint, elementi Modello 3D, elemento Modello di simulazione, elemento Modello di componente, elementi Scheda tecnica, associazioni Scelta del componente.
Si noti che il parametro Tipo di componente non viene trasferito durante il processo di acquisizione; pertanto, i componenti trasferiti verranno visualizzati nella posizione Uncategorized della destinazione, sia nel pannello Components di Altium Designer sia nella pagina Components del Workspace. È possibile applicare il tipo di componente desiderato a una o più voci di componente utilizzando l'operazione Change Component Type nel pannello Explorer di Altium Designer.
- Managed Schematic Sheet Item – le revisioni applicabili dei seguenti oggetti secondari collegati: elementi Componente, elementi Simbolo, elementi Footprint, elementi Modello 3D, elementi Modello di simulazione, elementi Modello di componente, elementi Scheda tecnica, elemento Modello di schema elettrico.
- Il ciclo di vita della revisione acquisita di un elemento di origine assumerà lo stato iniziale «post-rilascio», determinato dalla definizione del ciclo di vita assegnata all'elemento di destinazione. Qualsiasi cronologia del ciclo di vita della revisione dell'elemento di origine verrà semplicemente ignorata.
- Se, per qualsiasi motivo, non è possibile acquisire un elemento secondario di un elemento di origine selezionato di tipo Componente/Foglio schematico gestito, l'acquisizione dell'elemento Componente/Foglio schematico gestito selezionato non verrà eseguita.
Processo di acquisizione dei dati - Riepilogo
Utilizzare il Content Cart per acquisire tutti i dati necessari. Il processo di acquisizione degli elementi di dati da un server di origine è semplice e può essere riepilogato nei seguenti passaggi:
-
Il server di origine viene identificato automaticamente come il server attualmente attivo, ma può essere sostituito con un altro server connesso tramite il menu di selezione disponibile nella parte superiore sinistra del pannello Explorer.
-
Utilizzare il menu a discesa con il nome del server di destinazione del Content Cart (evidenziato in blu) per selezionare un server di destinazione alternativo dall'elenco, che contiene i server attualmente connessi; scegliere l'opzione Server Administration per abilitare o disabilitare le connessioni ai server. Per i componenti, è inoltre possibile specificare come destinazione un file di libreria integrata (IntLib) salvato localmente.
-
La revisione dell'elemento originale è elencata nella griglia principale. È possibile aggiungere al carrello un numero qualsiasi di ulteriori revisioni di elementi. A tale scopo, fare clic sul controllo Add More Items in alto a destra nella finestra di dialogo e scegliere la voce Select per accedere alla finestra di dialogo Choose Item (una variante del pannello Explorer). Da qui è possibile esplorare il server di origine alla ricerca di altri elementi, aggiungendoli uno alla volta o in blocco mediante i normali strumenti di selezione multipla. In alternativa, scegliere la voce Add manually per accedere alla finestra di dialogo Add new items. Questa finestra di dialogo consente di incollare un elenco esterno degli elementi necessari (un elemento per riga), che possono poi essere cercati nel server di origine utilizzando un criterio di ricerca selezionato (GUID, Item ID, Name o MPN). Se si decide di non acquisire alcune revisioni di elementi, selezionarle e rimuoverle dall'elenco facendo clic sul pulsante
.
-
Fai clic sul controllo Change Settings in basso a destra nella finestra di dialogo Content Cart per accedere alla finestra di dialogo Content Cart Structure. Da qui puoi definire le opzioni predefinite per ciascuno dei tipi di elementi di dati di cui la funzionalità supporta l'acquisizione. Ciò comporta la specifica di una cartella predefinita nel server di destinazione, nonché di una definizione del ciclo di vita, di schemi di denominazione degli elementi e delle revisioni e di un indice iniziale predefiniti. Puoi anche aggiungere una nota, che può fornire ad altri informazioni utili sull'acquisizione durante la consultazione dei contenuti acquisiti.
-
Una volta scelti gli elementi di origine desiderati, fai clic sul pulsante
. Questa operazione prepara il server di destinazione per l'acquisizione, verificando lo stato delle revisioni degli elementi selezionati coinvolte (nel caso in cui siano già state acquisite), i collegamenti padre-figlio e proponendo l'azione necessaria che, per le nuove acquisizioni, sarà Transfer new revision and item. Sebbene durante questa fase di preparazione vengano applicate le opzioni di acquisizione predefinite specificate in precedenza, le proprietà degli elementi di destinazione proposti possono essere modificate singolarmente, se necessario. Per farlo, seleziona un elemento nell'elenco e fai clic sul pulsante
.
-
Al termine della preparazione, fai clic sul pulsante
per procedere con l'acquisizione. Verrà visualizzata una prima finestra di dialogo di conferma: fai clic su Yes per procedere con il trasferimento dei contenuti tra i server di origine e di destinazione. Una seconda finestra di dialogo di conferma indicherà il risultato dell'acquisizione: consulta gli elementi acquisiti nel server di destinazione tramite il pannello Explorer.
I dati acquisiti mantengono un riferimento alla propria origine. Queste informazioni sul collegamento all'origine possono essere visualizzate passando alla scheda della vista Origin della revisione dell'elemento di destinazione.
Specifica dei Workspace di origine e di destinazione
I due Workspace coinvolti nell'acquisizione vengono specificati nella parte superiore della finestra di dialogo Content Cart. Il Workspace di origine viene determinato automaticamente in base alla posizione delle revisioni degli elementi che hai scelto di acquisire: in genere, si tratta del Workspace a cui hai attualmente effettuato l'accesso (Company Workspace in questo esempio). Se sei connesso a più Workspace, fai clic sul nome del Workspace di destinazione o sul controllo
alla sua destra per accedere a un elenco a discesa dei Workspace attualmente connessi. Passa da un Workspace all'altro secondo necessità.

Specifica dei Workspace di origine e di destinazione coinvolti nell'acquisizione.
Assegnazione di un nome al carrello
I dati acquisiti dal Workspace di origine verranno copiati in nuove revisioni degli elementi nel Workspace di destinazione. Per impostazione predefinita, questi elementi verranno collocati in una struttura di cartelle definita e creata appositamente all'interno del Workspace di destinazione. La cartella di primo livello per questi contenuti acquisiti prende il nome dal carrello stesso. Il nome predefinito è nel formato Content Cart - <Current Date> - <Current Time> e viene determinato al momento dell'accesso al carrello. Se necessario, puoi sostituirlo con un nome più significativo facendo clic sul controllo Change, a destra del nome del carrello.
Utilizza la successiva finestra di dialogo Content Cart Name Selection per inserire direttamente il nome desiderato per il carrello. In alternativa, puoi scegliere una cartella nel Workspace di destinazione in cui trasferire i contenuti del carrello. Può trattarsi di una cartella esistente o di una completamente nuova, creata al momento. Individua e seleziona una cartella esistente per il carrello utilizzando la finestra di dialogo Choose Folder, accessibile facendo clic sul pulsante
all'estrema destra del campo Content Cart Name. In alternativa, crea una nuova cartella all'interno della struttura di cartelle utilizzando i comandi del menu contestuale.

Puoi assegnare a un Content Cart il nome desiderato. Modifica il nome del carrello (i cui contenuti verranno trasferiti in una cartella di primo livello con quel nome) oppure scegli di collocare i contenuti del carrello in una cartella specifica.
Specifica degli elementi da acquisire
L'area principale della finestra di dialogo Content Cart presenta una "griglia di acquisizione", che elenca tutte le revisioni degli elementi che hai scelto di acquisire dal Workspace di origine. È possibile "caricare" nel Content Cart un numero qualsiasi di revisioni degli elementi di dati da acquisire dal Workspace di origine. Al primo accesso, il carrello viene popolato con le revisioni degli elementi selezionate nel Workspace di origine al momento dell'accesso, ma è possibile caricare un numero qualsiasi di elementi aggiuntivi. A tale scopo, fai clic sul controllo Add More Items in alto a destra nella finestra di dialogo e scegli la voce Select per accedere alla finestra di dialogo Choose Item (una versione "ridotta" del pannello Explorer). Da qui puoi esplorare il Workspace di origine per trovare altri elementi. Ricorda che puoi scegliere di aggiungere:
- Una singola revisione specifica di un elemento.
- Più revisioni specifiche dello stesso elemento.
- Le revisioni più recenti di più elementi.
- Le revisioni più recenti di tutti gli elementi nella cartella selezionata (e nelle relative sottocartelle).
In alternativa, scegli la voce Add manually per accedere alla finestra di dialogo Add new items. Questa finestra di dialogo consente di incollare un elenco esterno degli elementi necessari (un elemento per riga), che possono quindi essere cercati nel Workspace di origine utilizzando un criterio di ricerca selezionato (GUID, Item ID, Name o MPN).

La griglia di acquisizione principale, con l'elenco di tutte le revisioni degli elementi scelte per l'acquisizione dal Workspace di origine.
Preparazione del carrello
Dopo aver scelto le revisioni degli elementi di origine, il Content Cart deve essere "preparato per la consegna" al Workspace di destinazione. A tale scopo, fai clic sul pulsante
. Questa operazione prepara il Workspace di destinazione per l'acquisizione, verificando lo stato delle revisioni degli elementi scelte (nel caso siano già state acquisite in precedenza) e i collegamenti padre-figlio, e proponendo l'azione da eseguire. I risultati di questa fase di preparazione vengono visualizzati nella griglia di acquisizione principale.

Un esempio di Content Cart, preparato e pronto per la consegna al Workspace di destinazione.
Per ogni revisione di un elemento coinvolta nell'acquisizione, l'area Source della griglia si espande per mostrare tutte le revisioni degli elementi figli pertinenti e, facoltativamente, la cartella in cui si trovano nel Workspace di origine. Per ogni revisione di un elemento (sia padre che figlio), nell'area Target della griglia possono essere visualizzate le seguenti informazioni:
- Revision ID – l'identificatore completo della revisione dell'elemento nel Workspace di destinazione, basato sugli schemi di denominazione degli elementi e delle revisioni definiti per quel tipo di elemento.
- Folder – la cartella di destinazione nel Workspace di destinazione in cui verrà creata/consegnata la revisione dell'elemento acquisita.
- Life Cycle – la definizione del ciclo di vita definita per l'elemento padre.
- Naming Scheme – lo schema di denominazione delle revisioni definito per identificare le revisioni dell'elemento padre.
- Note – una nota facoltativa che può essere utilizzata per fornire ad altri informazioni utili sull'acquisizione durante l'esplorazione dei contenuti acquisiti nel Workspace.
-
Status – lo stato corrente della revisione dell'elemento nel Workspace di destinazione. Gli stati possibili sono:
-
Not found– la revisione dell'elemento non è mai stata acquisita. -
Already Exists– la revisione dell'elemento è già stata acquisita in precedenza.
-
-
Action – l'azione da eseguire per ottenere la sincronizzazione tra il Workspace di origine e quello di destinazione. Le azioni possibili sono:
-
Transfer new revision and item– per acquisizioni completamente nuove, quando l'elemento non è mai stato acquisito prima. In altre parole, viene creato un elemento di quel tipo e una nuova revisione pianificata per accogliere i dati di origine. -
Transfer new revision of existing item– quando si acquisisce un'altra revisione di un elemento di cui è già stata acquisita una revisione in precedenza. -
Nothing to do– la revisione dell'elemento scelta è già stata acquisita in precedenza.
-
Struttura del carrello
Durante la fase di preparazione, il carrello utilizza le impostazioni predefinite specificate per ogni tipo di elemento che può essere acquisito. Queste impostazioni sono definite nella finestra di dialogo Content Cart Structure, accessibile facendo clic sul controllo Change Settings in basso a destra nella finestra di dialogo Content Cart.

Le impostazioni di acquisizione predefinite sono definite nella finestra di dialogo Content Cart Structure.
Queste impostazioni vengono utilizzate per determinare le proprietà delle revisioni degli elementi appena create nel Workspace di destinazione, predisposte nello stato pianificato per ricevere i dati dalle revisioni degli elementi originali nel Workspace di origine. Includono una cartella predefinita nel Workspace di destinazione, nonché una definizione del ciclo di vita predefinita, schemi di denominazione degli elementi e delle revisioni predefiniti e un indice iniziale. Viene inoltre definita una nota predefinita, nel formato Acquired from <SourceWorkspaceName>.
Per quanto riguarda le cartelle di destinazione nel Workspace di destinazione, ogni tipo di elemento verrà acquisito in una cartella distinta all'interno di:
- Una cartella padre di primo livello, con lo stesso nome del Content Cart
- Una cartella esistente, definita tramite la finestra di dialogo di selezione Content Cart Name.
Modifica queste impostazioni di acquisizione predefinite in base agli schemi utilizzati (e preferiti!) per quei tipi di elementi nel Workspace di destinazione. Fai clic su una cella per accedere ai controlli di modifica.
Le impostazioni di acquisizione nella finestra di dialogo Content Cart Structure sono impostazioni predefinite di carattere generale. Per gli elementi che non sono mai stati acquisiti prima, per i quali vengono quindi creati l'elemento padre e la revisione iniziale (Action è Transfer new revision and item), è possibile definire, se necessario, le proprietà a livello di singolo elemento, per un controllo più preciso. A tale scopo, seleziona una revisione di un elemento nella griglia di acquisizione principale e fai clic sul pulsante
. Si aprirà la finestra di dialogo Edit Item, da cui potrai modificare le proprietà dell'elemento secondo necessità, sovrascrivendo le impostazioni predefinite.

Per un maggiore controllo, puoi definire le proprietà a livello di singolo elemento.
Consegna del carrello
Una volta completata la preparazione, fai clic sul pulsante
per procedere con l'acquisizione. Verrà visualizzata una finestra di dialogo di conferma che ti avvisa che il Content Cart sta per essere trasferito dal Workspace di origine a quello di destinazione: fai clic su Yes per procedere. Una seconda finestra di dialogo di conferma comunicherà l'esito dell'acquisizione e gli elementi acquisiti saranno disponibili per la consultazione nel Workspace di destinazione tramite il pannello Explorer.
Acquisizione dei dati in formato IntLib
Puoi anche acquisire componenti dal tuo Workspace in una libreria integrata (*.IntLib). Quando inserisci componenti da una libreria integrata di questo tipo, i collegamenti effettivi rimandano ai componenti nel Workspace. Questo ti consente di utilizzare i componenti del Workspace aziendale anche offline, garantendo al contempo che il progetto mantenga un collegamento effettivo a tali componenti nel Workspace di origine.
Acquisizione in una IntLib
Dalla finestra di dialogo Content Cart, la procedura per acquisire i dati in una IntLib è la seguente:
-
Fai clic sul collegamento Select target server e scegli IntLib file dal menu.
-
Specifica il nome e il percorso del file IntLib generato. Per impostazione predefinita, il file verrà denominato nel formato
Integrated_Library - <Date> - <Time>.IntLibe generato nel percorso\Users\Public\Documents\Altium\AD<Solution/Version>\Library\ExportCmpLib. Modifica queste impostazioni secondo necessità tramite la finestra di dialogo Save As, accessibile facendo clic sul collegamento Change .
Accetta la cartella e il nome file di destinazione predefiniti oppure modificali secondo necessità. -
Se devi acquisire altri componenti nella stessa IntLib, fai clic sul collegamento Add More Items e scegli la voce Select per accedere alla finestra di dialogo Choose Item (una versione semplificata del pannello Explorer). Da qui puoi esplorare il Workspace di origine per trovare altri elementi. In alternativa, scegli la voce Add manually per accedere alla finestra di dialogo Add new items. Questa finestra di dialogo consente di incollare un elenco esterno degli elementi necessari (un elemento per riga), che possono quindi essere cercati nel Workspace di origine utilizzando un criterio di ricerca a scelta (GUID, Item ID, Name o MPN).
-
Quando sei pronto, fai clic sul pulsante
per procedere alla generazione della IntLib. Verrà creato un pacchetto di libreria integrata temporaneo (*.LibPkg), al quale verranno aggiunti i file sorgente SchLib (con simboli, parametri e collegamenti ai modelli) e PcbLib (con modelli di footprint) appositamente generati. Il pacchetto verrà quindi compilato per produrre il file IntLib nella cartella specificata. Una finestra di dialogo informativa confermerà la corretta generazione del file.
Trasferisci il contenuto del carrello nella cartella di destinazione, che conterrà il file di libreria integrata richiesto.
Utilizzo della IntLib
Dopo la generazione, la IntLib può essere aggiunta alle librerie non basate su Workspace disponibili nel software (tramite la scheda Installed della finestra di dialogo Available File-based Libraries). Sarà quindi disponibile per l'uso nel pannello Components. Inserisci i componenti della IntLib nel progetto secondo necessità. Pur lavorando di fatto con i componenti offline, i collegamenti ai componenti originali del Workspace garantiscono la continuità quando torni a lavorare online direttamente dal tuo Workspace.
