Sincronizzazione dei dati dal database dei componenti ai dati del Workspace

Updated: October 15, 2026

A colpo d'occhio

Mantieni i parametri dei componenti del Workspace allineati ai tuoi dati master con la sincronizzazione dei componenti in Altium Designer. Questo articolo spiega come configurare le origini dati, associare le voci del database ai componenti del Workspace ed eseguire gli aggiornamenti su richiesta o secondo una pianificazione. Tratta inoltre la mappatura dei parametri, i controlli sulle revisioni e la sincronizzazione delle scelte dei componenti. La sincronizzazione riguarda solo i parametri (non i modelli dei componenti) e la configurazione è guidata dai tipi di componente e dai relativi modelli. Continua a leggere per configurare una sincronizzazione che mantenga i dati del Workspace coerenti con il database di origine.

- Scopri come creare una configurazione di sincronizzazione utilizzando librerie di database, database, fogli di calcolo o file CSV.
- Scopri come mappare i parametri e le scelte dei componenti e controllare quali modifiche ai parametri generano nuove revisioni dei componenti.
- Scopri come eseguire la sincronizzazione manualmente o pianificare gli aggiornamenti indipendentemente dal client Altium Designer.

Approfondisci con l'IA:

Le librerie di componenti basate su database, che ricavano i parametri dei componenti da un database principale, possono essere sincronizzate con tale database dopo che la libreria è stata migrata in un Workspace Altium 365 o in un Workspace Enterprise Server.

Utilizzando la funzionalità Components Synchronization di Altium Designer, come descritto di seguito, i dati di una tabella selezionata nel database principale vengono usati per creare un profilo di sincronizzazione completamente configurato e mappato, che può essere eseguito su richiesta o come processo pianificato. In questo modo, gli aggiornamenti dei dati nel database principale vengono propagati ai parametri dei componenti corrispondenti in un Workspace connesso.

Questa funzionalità consente alle aziende che gestiscono centralmente i dati dei componenti nel database di un sistema aziendale di sfruttare i vantaggi di un Workspace mantenendo la sincronizzazione con il proprio sistema aziendale (PLM, PDM, ERP, ecc.), oppure semplicemente con un database condiviso o un file CSV. In modalità di sincronizzazione automatica, un'attività pianificata di Windows eseguirà l'aggiornamento dei dati dal database al Workspace indipendentemente dal client di progettazione Altium Designer.

Consulta Importazione delle librerie esistenti nel Workspace connesso per informazioni sull'importazione delle librerie basate su database nel tuo Workspace.

Per accedere alle funzionalità di sincronizzazione dei componenti in Altium Designer, la funzionalità Custom Data Synchronization deve essere abilitata nella tua installazione di Altium Designer. Questa funzionalità può essere abilitata o disabilitata dopo l'installazione.

Per ulteriori informazioni su come modificare le funzionalità principali installate, consulta la pagina Installing & Managing (Altium Designer Develop, Altium Designer Agile, Altium Designer).

Creazione di una configurazione di sincronizzazione dei componenti

La sincronizzazione dal database al Workspace viene impostata creando e configurando un documento Components Synchronization Configuration (*.CmpSync) in Altium Designer. Quando sei connesso al tuo Workspace, crea il nuovo documento tramite il comando di menu File » New » Components Synchronization Configuration.

Aggiungi l'origine dati principale desiderata alla configurazione di sincronizzazione tramite il pulsante oppure trascinando i file appropriati nell'area Data Sources dell'interfaccia. La configurazione supporta le seguenti origini dati per i parametri dei componenti:

File di libreria basata su database (*.dBLib), che si collegano a un database principale.
File di database Access (*.mdb, *.accdb)
Fogli di calcolo Excel (*.xlsx)
File CSV (*.csv)
Altre origini dati, come le interfacce compatibili con OLE DB basate su server (inclusi i database PostgreSQL), tramite una stringa di connessione proprietaria.

Per la connettività al database, Parts Provider Synchronizer richiede l'accesso alla versione a 64 bit di Microsoft OLE DB Provider.

Connettività al database e risoluzione dei problemi

La versione a 64 bit richiesta di Microsoft OLE DB Provider è disponibile sul PC host se:

è installata la versione a 64 bit di Microsoft Access, oppure se...
è stato installato il pacchetto ridistribuibile Microsoft Access Database Engine (versione a 64 bit).

Se invece è installata una versione a 32 bit di Microsoft Access, il sistema operativo non consentirà l'installazione di Access Database Engine a 64 bit. Consulta Utilizzo delle librerie basate su database con Altium Designer a 32 bit e a 64 bit sullo stesso computer per informazioni sulle opzioni disponibili.

Nell'esempio seguente, alla configurazione è stata aggiunta una libreria basata su database per i componenti diodo Zener; questa dBLib è già stata migrata nel Workspace. Il database di origine della libreria (Semi_8.mdb) contiene le tabelle DiodeGP e Zeners, e quest'ultima è abilitata per la sincronizzazione.

Seleziona la tabella o le tabelle di dati da sincronizzare nel pannello Properties; queste vengono quindi utilizzate come origine dati parametrica che popola l'elenco Components Preview. Il sistema tenterà di determinare il tipo di componente (resistore, condensatore, ecc.) dai dati dei parametri, quindi applicherà tale Component Type e il relativo Component Template alla configurazione; se necessario, queste impostazioni possono essere selezionate manualmente. Seleziona una voce di tabella in Data Sources per visualizzare la configurazione corrente nel pannello Properties.

In questo esempio, il tipo di componente (Zeners) è stato identificato ed è stato applicato il relativo template di componente. Il template determina quindi la cartella di destinazione nel Workspace, lo schema di denominazione del componente e la definizione del ciclo di vita applicata. Le voci dei componenti vengono associate alle voci del database di origine tramite un identificatore univoco, specificato dalla voce Key Parameter nel pannello Properties; in questo caso viene utilizzato Part Number, anche se Name o persino Description sarebbero altrettanto efficaci.

Quando come origine dati viene utilizzata una libreria basata su database (*.dBLib) anziché un'origine di tipo database diretto (*.mdb, *.xlsx, ecc.), le seguenti informazioni vengono estratte dal file dBLib e applicate alla configurazione:

La connessione e il percorso del database di origine.
La selezione della tabella del database.
Il campo chiave di ricerca (parametro).

Queste impostazioni di configurazione corrisponderanno quindi a quelle utilizzate quando è stata generata la dBLib, garantendo la corretta sincronizzazione tra i componenti dBLib migrati e il database di origine.

Sincronizzazione

Una volta verificata la configurazione della sincronizzazione, salva il documento di configurazione ed esegui la sincronizzazione dal database ai componenti della libreria nel Workspace tramite il pulsante , oppure imposta una sincronizzazione pianificata ().

Nell'esempio mostrato di seguito, il parametro di descrizione di due voci di componente è stato aggiornato nel database di origine/principale. Queste modifiche possono essere visualizzate facendo clic sul pulsante di aggiornamento () nell'interfaccia di configurazione; questa operazione è facoltativa e non influisce sulla sincronizzazione dei dati aggiornati.

Una successiva sincronizzazione aggiornerà i parametri dei componenti nel Workspace con i dati correnti dei campi del database. Questa modifica può essere visualizzata nei pannelli Components ed Explorer. Aggiorna le rispettive viste utilizzando il tasto F5 o il pulsante .

I file di registro dettagliati della sincronizzazione sono disponibili nella cartella C:\Users\Public\Documents\Altium\Logs\ComponentSync del sistema.

Come si può vedere nel pannello Explorer, sono state create nuove revisioni per i due componenti aggiornati. Le impostazioni Parameter Mapping nella configurazione di sincronizzazione determinano quali parametri, se aggiornati dal database principale, genereranno nuove revisioni dei componenti.

Le revisioni degli elementi componente create durante il processo di sincronizzazione dei componenti presenteranno la nota Created by component synchronization o Modified by component synchronization (a seconda che sia stato creato un nuovo elemento o una nuova revisione di un elemento esistente). Visualizza la colonna Note per il tipo di componente che stai esplorando nel pannello Components o per la cartella del Workspace che stai esplorando nel pannello Explorer, per identificare facilmente i componenti creati o modificati dalla sincronizzazione dei componenti.

Visualizza la colonna Note durante la consultazione dei componenti. Qui è mostrato un esempio nel pannello Components. Passa il cursore sull'immagine per visualizzare il pannello Explorer.

Mappatura dei parametri

Il controllo dei parametri sincronizzati è disponibile nell'area Parameter Mapping del pannello Properties, che presenta una griglia con le corrispondenze tra i parametri di destinazione del Workspace e i parametri (campi) del database di origine. Sono inoltre disponibili impostazioni per il tipo di parametro trasferito (testo o con supporto delle unità di misura) e per il controllo della creazione di nuove revisioni in caso di aggiornamento dei parametri.

Per quanto riguarda la mappatura dei parametri, le colonne della tabella rappresentano la destinazione nel Workspace (Parameter) e i campi del database di origine/master (Column), come nei dati delle colonne mostrati nella griglia Components Review dell'interfaccia di configurazione principale. I parametri possono essere esclusi dalla sincronizzazione (ignorati) o rimappati su un altro parametro disponibile. È possibile modificare i nomi dei parametri e aggiungere, modificare e rimuovere insiemi di parametri. I parametri di base dei componenti (ID, Name, Description) possono essere rimappati, ma per il resto sono di sola lettura.

L'immagine sopra mostra tre stati della mappatura dei parametri nel pannello Properties. A sinistra è mostrata la situazione senza alcun modello di componente applicato, l'immagine centrale mostra il risultato quando è stato specificato un modello e l'immagine a destra illustra la mappatura dei parametri e il controllo delle revisioni modificati.

Immagine a sinistra: per impostazione predefinita, senza un modello applicato, i parametri vengono essenzialmente mappati con una corrispondenza uno a uno tra il database master e i componenti del Workspace. Il parametro ID impostato qui su <Auto> rappresenta la creazione automatica (se necessaria) del parametro Revision ID del Workspace, che è correlato all'impostazione Revision Naming Scheme dell'elemento corrente, sotto Advanced nel pannello. Si noti inoltre che il campo Comment del database viene mappato automaticamente al parametro Name del Workspace.
Immagine centrale: quando viene applicato un modello di componente (qui Zeners), i campi dei parametri del database vengono mappati ai parametri equivalenti del modello. Il sistema interpreta automaticamente le mappature più comuni dei parametri, come in questo caso da Pin Count a Pins (un parametro del modello). I parametri non definiti nel modello vengono mappati con una corrispondenza uno a uno: in questo esempio, i nove parametri in fondo all'elenco.
Immagine a destra: diversi parametri del database sono stati rimossi dalla configurazione di sincronizzazione impostando le modalità delle rispettive colonne su <Skip>. Il parametro PackageReference è stato mappato al campo Footprint del database master. L'opzione Revision è stata deselezionata per i parametri VZ(Max), VZ(Min) e ZZ(Max): questo significa che una modifica del loro valore nel database master non comporterà la creazione di una nuova revisione nel Workspace durante la sincronizzazione. Il valore modificato viene comunque propagato al componente del Workspace come di consueto.

Mappatura delle scelte dei componenti

Utilizzando il documento di configurazione della sincronizzazione dei componenti, puoi definire e sincronizzare le informazioni sulle scelte dei componenti. Il controllo dei parametri sincronizzati è disponibile nell'area Part Choices Mapping del pannello Properties. Utilizza i pulsanti nella parte inferiore dell'area per aggiungere e rimuovere coppie di parametri delle scelte dei componenti (Manufacturer / Part Number) e le opzioni dei menu a discesa per definire la mappatura. Una volta definite le mappature, i parametri corrispondenti vengono visualizzati nelle colonne Part Choice n della griglia del documento.

Nota che, dopo l'esecuzione di un processo di sincronizzazione, l'elenco delle scelte di un componente viene sovrascritto con le scelte appena mappate, ad eccezione di quelle aggiunte manualmente.

Pannello delle proprietà

Quando il documento attivo è un documento di configurazione della sincronizzazione dei componenti (*.CmpSync), il pannello Properties presenta le opzioni di configurazione. Le seguenti sezioni espandibili contengono informazioni sulle opzioni e sui controlli disponibili.

Tabella dei tipi di componente

Reset to Default – consente di annullare tutte le modifiche apportate.
General
- Component Type – indica il tipo di componente identificato.
- Component Template – indica il modello di componente identificato, che determina la cartella di destinazione nel Workspace, lo schema di denominazione del componente e la definizione del ciclo di vita applicata.
- Key Parameter – indica il parametro chiave associato alla voce del database di origine tramite un identificatore univoco.
Advanced
- Folder – la cartella di destinazione del Workspace in cui risiede il componente.
- Revision Naming Scheme – lo schema di denominazione utilizzato per le revisioni dell'oggetto nel Workspace, impostato dal modello applicato o selezionato dalle opzioni del menu a discesa della voce. Saranno disponibili come opzione solo gli schemi abilitati dal sistema.
- Lifecycle Definition – il sistema del ciclo di vita utilizzato per l'oggetto, impostato dal modello applicato o selezionato dalle opzioni del menu a discesa della voce. Saranno disponibili come opzione solo le definizioni abilitate dal sistema.
- Preserve lifecycle state – abilita questa opzione per mantenere gli stati attuali del ciclo di vita delle revisioni dei componenti. Quando l'opzione è abilitata, le nuove revisioni dei componenti create durante la sincronizzazione dei componenti vengono impostate automaticamente sullo stato del ciclo di vita della revisione precedente. Questa funzionalità è disponibile per gli utenti a cui è stata assegnata l'autorizzazione operativa Allow to skip lifecycle state change for new revisions (scopri di più su Impostazione delle autorizzazioni operative globali per un Workspace).
Parameter Mapping – presenta una griglia con le corrispondenze tra i parametri di destinazione del Workspace e i parametri (campi) del database di origine. Sono inoltre disponibili impostazioni per il Type del parametro trasferito (testo o con supporto delle unità di misura) e per il controllo della creazione di nuove revisioni in caso di aggiornamento dei parametri. Per quanto riguarda la mappatura dei parametri, le colonne della tabella rappresentano la destinazione nel Workspace (Parameter) e i campi del database di origine/master (Column).
- Add – consente di aggiungere un ulteriore parametro.
- – consente di eliminare il parametro specificato.
Part Choices Mapping – offre controlli che consentono di definire coppie di parametri delle scelte dei componenti (Manufacturer / Part Number) per le informazioni sulle scelte dei componenti da sincronizzare. Utilizza le opzioni dei menu a discesa per definire la mappatura.
- Add – consente di aggiungere un'ulteriore coppia di parametri delle scelte dei componenti.
- – consente di eliminare la coppia di parametri delle scelte dei componenti specificata.

Inclusione delle tabelle

Table Inclusion – elenca le tabelle del database che puoi selezionare per la sincronizzazione nel pannello Properties, a cui si accede poi come origine dati parametrica che popola l'elenco Components Preview nel menu Component Synchronization Configuration.

Sincronizzazione pianificata

Le configurazioni di sincronizzazione salvate vengono impostate per l'elaborazione automatica dei componenti dal database al Workspace tramite la finestra di dialogo Auto Synchronization Schedule, accessibile dal pulsante nell'interfaccia principale.

La sincronizzazione pianificata, in base al profilo di configurazione corrente, può essere impostata a un'ora specifica ogni giorno, a un determinato orario in vari giorni della settimana oppure all'accesso a Windows. È inoltre possibile disabilitare la sincronizzazione quando non si è connessi. Dopo aver confermato le impostazioni con il pulsante , la configurazione verrà aggiunta come attività ricorrente in Windows Task Scheduler. Impostare su No automatic synchronization per rimuovere una pianificazione di sincronizzazione esistente.

La sincronizzazione dal database ai componenti può essere eseguita anche dalla riga di comando utilizzando l'applicazione ComponentSync.Executor.exe, disponibile nella cartella \System dell'installazione del software. La sintassi del comando è ComponentSync.Executor.exe [configuration file name]. Un esempio tipico potrebbe essere:
C:\Program Files\Altium\AD<Solution/Version>\System\ComponentSync.Executor.exe C:\Users\Public\Documents\Altium\CmpSync\MySyncConfig.CmpSync

A seconda del sistema operativo, potrebbe essere necessario racchiudere tra virgolette i percorsi che contengono spazi.

Versione stampabile

Localizzato tramite A

Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Enter per inviarci il tuo feedback.

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.