Preparing a BOM in the Report Manager

Altium Training

Altium Essentials: Output Job File for Documentation

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

La distinta base, o BOM, è un elemento fondamentale del set di dati generato da un progetto di progettazione di una scheda. Questo documento di tipo report fornisce l’elenco di tutti i componenti necessari per realizzare il prodotto, inclusa la scheda nuda, che è essenzialmente il “componente” di base su cui vengono assemblate tutte le altre parti. La BOM funge da guida per ciò che deve essere approvvigionato per costruire il prodotto come progettato. Fornisce inoltre un mezzo per calcolare il costo in base al numero richiesto di schede assemblate in una determinata revisione.

La BOM finale viene generata tramite un motore dedicato e potente per la generazione di report, la cui interfaccia è nota come Report Manager. La finestra di dialogo Report Manager viene utilizzata per:

  • Configuare quali proprietà del progetto devono essere incluse nella BOM.
  • Disporre il contenuto nell’ordine richiesto nella BOM.
  • Applicare, se necessario, filtri personalizzati a livello di colonna, simili a quelli di un foglio di calcolo.
  • Abilitare diverse opzioni di origine dei componenti.
  • Abilitare le opzioni dei fornitori.
  • Configuare il formato del file di esportazione.
  • Selezionare un modello Excel per la BOM, se il formato di esportazione è XLS o PDF.
Oltre a essere utilizzato per generare una BOM, Report Manager può anche essere configurato per generare altri output di tipo componente, come un riferimento incrociato dei componenti.

Per un controllo completo del processo di configurazione della BOM, inclusa una vista interattiva delle informazioni della supply chain, nonché righe e colonne BOM personalizzate, aggiungere un documento ActiveBOM (BomDoc) al progetto. Il BomDoc offre visibilità immediata sulla supply chain dei componenti e supporta anche righe e colonne definite dall’utente, ideale per includere elementi aggiuntivi come colla, etichette e così via. La creazione e la gestione della BOM tramite un BomDoc è l’approccio consigliato per la gestione della BOM in Altium Designer.

Scelte per la creazione della BOM

L’output finale della distinta base viene generato da Report Manager. Report Manager può generare output in vari formati, tra cui PDF, CSV, TXT, Excel, HTML o XML.

Report Manager può estrarre le informazioni di origine per la BOM da quanto segue:

  • Il progetto - le informazioni vengono estratte dagli schemi, nonché dai database collegati e dal PCB, se necessario
  • Un documento ActiveBOM (BomDoc) - l’approccio consigliato.

Se il progetto non include un ActiveBOM, Report Manager genera la BOM dal progetto. Con questo approccio, Report Manager viene utilizzato per eseguire tutta la configurazione del layout della BOM, come la selezione e la disposizione delle colonne, il filtraggio delle righe non necessarie, l’inclusione delle informazioni sui fornitori e così via. Report Manager viene utilizzato anche per configurare le impostazioni di output, come il formato, il modello Excel richiesto e così via. Con questo approccio, la BOM viene preparata una volta completato il processo di progettazione. Report Manager può essere utilizzato per configurare un solo output BOM. Se si utilizza questo approccio, è necessario utilizzare un OutputJob se occorre impostare configurazioni di output BOM differenti.

L’approccio consigliato consiste nell’includere un documento ActiveBOM (BomDoc) nel progetto. Il BomDoc è un documento sorgente che può essere aggiunto in qualsiasi fase dello sviluppo del progetto: in sostanza, un elenco parti dinamico. Le parti compaiono automaticamente nel BomDoc man mano che i componenti vengono aggiunti allo schema, e il progettista può iniziare immediatamente a esplorare prezzi e opzioni della supply chain e ad assegnare le parti preferite. Il progettista può anche selezionare e disporre le colonne, applicare filtri, aggiungere numeri di riga, aggiungere ulteriori colonne personalizzate, aggiungere ulteriori righe per elementi personalizzati; in breve, eseguire tutti i tipici passaggi di preparazione della BOM durante il processo di progettazione. Nel BomDoc è possibile preparare più configurazioni di output, ciascuna salvata come BOM Set, selezionando poi il BOM Set richiesto in Report Manager per la generazione finale della BOM.

Se il progetto include un BomDoc, questo viene utilizzato automaticamente come origine per Report Manager, a meno che non venga ignorato manualmente in un OutputJob impostando Data Source su [Project] anziché [ActiveBOM document]. Quando il progetto viene utilizzato come origine dati, l’interfaccia di Report Manager cambia leggermente, con l’inclusione della funzione Column Grouping nella scheda Columns della finestra di dialogo. Maggiori dettagli di seguito.

Quando il progetto include un BomDoc, questo viene utilizzato come origine per Report Manager. Quando il progetto include un BomDoc, questo viene utilizzato come origine per Report Manager.

Creazione di una BOM

Report Manager può essere aperto da:

  • I documenti schematici sorgente del progetto oppure dal documento PCB attivo usando il comando Reports » Bill of Materials dell’editor schematico o PCB.
È anche possibile aggiungere una distinta base se nel progetto non sono presenti documenti schematici. In tal caso, il report della distinta base viene ricavato dal PCB.
  • Un output job di tipo Report configurato in un OutputJob.
  • Un ActiveBOM, usando il comando Reports » Bill of Materials.

In ogni caso, i documenti sorgente verranno compilati e si aprirà la finestra di dialogo Report Manager. Utilizzare questo motore dedicato, potente e altamente configurabile per la generazione di report per configurare il contenuto del report BOM secondo necessità.

Una distinta base, ricavata dal BomDoc del progetto, pronta per essere generata da Report Manager. Una distinta base, ricavata dal BomDoc del progetto, pronta per essere generata da Report Manager.

Sebbene la finestra di dialogo sia indicata come Report Manager, non è denominata in questo modo. Viene nominata automaticamente in base al tipo di report che si sta creando, che in questo caso è una distinta base.

La finestra di dialogo presenta le varie proprietà/parametri per tutti i componenti nei documenti sorgente. Ogni proprietà/parametro ha una propria colonna. Il progettista sceglie semplicemente quali dati includere nel report BOM generato. I dati possono essere raggruppati, ordinati e filtrati secondo necessità, con la possibilità di includere dati parametrici aggiuntivi da un PCB designato per il progetto e/o da un database collegato, se necessario.

Se il progetto include un BomDoc, il comportamento predefinito prevede che il Report Manager presenti i dettagli dei componenti nello stesso modo in cui sono stati configurati nel BomDoc.

Le sezioni seguenti esaminano più da vicino la manipolazione dei dati per ottenere il contenuto BOM desiderato prima di esportare il report.

Raggruppamento dei componenti nella BOM

Se il progetto include un ActiveBOM, la configurazione presente nel BomDoc viene trasferita automaticamente alla finestra di dialogo Report Manager. Questa capacità di trasferire la configurazione della BOM da ActiveBOM al Report Manager comporta differenze nel layout e nelle funzionalità disponibili nella finestra di dialogo Report Manager.

La differenza fondamentale nella finestra di dialogo Report Manager riguarda il modo in cui i componenti uguali vengono raggruppati insieme in una singola riga:

  • BOM da ActiveBOM - il raggruppamento è definito in ActiveBOM nella finestra di dialogo Component Grouping. L'editor ActiveBOM include anche i controlli View Mode per passare istantaneamente da una vista piatta (una riga per componente) a una vista raggruppata (componenti uguali raggruppati in una singola riga).
  • BOM dal progetto - se nel progetto non è presente alcun BomDoc oppure Report Manager viene aperto da un OutputJob che ha un Data Source di [Project], allora Report Manager deve essere configurato manualmente. In questa situazione, il raggruppamento dei componenti della BOM viene eseguito in Report Manager nella scheda Columns della finestra di dialogo.

Raggruppamento dei componenti - quando il BomDoc è la sorgente

Un approccio comune utilizzato in una BOM consiste nell'avere una riga per ogni componente univoco. Per ottenere questo risultato, i componenti uguali devono essere raggruppati.

In un BomDoc, il raggruppamento delle colonne è configurato nella finestra di dialogo Component Grouping. Il progettista può quindi attivare e disattivare il raggruppamento delle colonne utilizzando i pulsanti View Mode , passando istantaneamente tra Flat View (una parte per riga) e Base View (parti raggruppate in base alle impostazioni nella finestra di dialogo Component Grouping di ActiveBOM).

Se Report Manager utilizza un BomDoc come sorgente, allora la finestra di dialogo include gli stessi pulsanti View Mode; utilizzarli per passare tra una parte per riga o raggruppato. La Consolidated View viene utilizzata quando sono presenti varianti; questo aspetto viene discusso più avanti nella sezione Catering for Variants.

Queste differenze nella finestra di dialogo Report Manager possono essere osservate confrontando le due immagini seguenti (passare il cursore sull'immagine per cambiare immagine).

Quando la BOM proviene da un BomDoc non è presente alcuna sezione Grouped Columns, poiché il raggruppamento viene eseguito in ActiveBOM.Quando la BOM proviene da un BomDoc non è presente alcuna sezione Grouped Columns, poiché il raggruppamento viene eseguito in ActiveBOM.

In genere non è necessario apportare modifiche al layout dei dati nella finestra di dialogo Report Manager se la sorgente è un BomDoc, ma è possibile farlo se necessario utilizzando le tecniche di raggruppamento descritte di seguito.

Raggruppamento dei componenti - quando il progetto è la sorgente

Quando il progetto viene utilizzato come sorgente per Report Manager, il raggruppamento dei componenti uguali viene configurato in Report Manager.

Si noti che se un componente è stato eliminato da un progetto, il suo stato verrà segnalato come avviso di violazione nella colonna BOM Status in ActiveBOM.

La scheda Columns della finestra di dialogo include la sezione Drag a column to group, come mostrato di seguito. I componenti uguali verranno raggruppati nella BOM quando il contenuto di tutte le colonne raggruppate corrisponde. Ad esempio, nell'immagine seguente, i componenti C1 e C3 sono stati raggruppati nella stessa riga della BOM (la prima riga), quindi devono avere gli stessi valori per i parametri Comment, Description e Value.

Per raggruppare in base a parametri aggiuntivi, fare clic, tenere premuto e trascinare il nome di una colonna dall'elenco Columns (in basso a destra nella finestra di dialogo), quindi rilasciarlo nella sezione Drag a column to group. Fare clic sull'icona di eliminazione ( ) accanto a ciascun nome di colonna per rimuovere quel parametro dall'elenco dei parametri di raggruppamento.

Abilitare l'opzione Show  di una colonna per includere tali dati nella BOM.Abilitare l'opzione Show di una colonna per includere tali dati nella BOM.

Configurazione del layout degli elementi BOM

Ogni colonna abilitata elencherà le informazioni per ciascuno dei componenti trovati nei documenti sorgente, laddove tali informazioni esistano. Se il componente non dispone di alcuna informazione per quella particolare proprietà/parametro, il campo sarà vuoto.

Selezione delle colonne visibili

Per scegliere quali colonne mostrare o nascondere nell’area griglia della finestra di dialogo Report Manager, utilizzare la scheda Columns nel pannello Properties sul lato destro della finestra di dialogo. È anche possibile usare la finestra di dialogo Select columns, accessibile facendo clic con il pulsante destro del mouse sull’intestazione di una colonna nell’area griglia principale e quindi scegliendo Select Columns.

La finestra di dialogo Select columns
La finestra di dialogo Select columns

Modifica dell’ordine delle colonne

L’ordine delle colonne nella regione dati della finestra di dialogo può essere modificato facendo clic e trascinando l’intestazione di una colonna in una nuova posizione, secondo necessità. Durante lo spostamento dell’intestazione di una colonna, le posizioni di rilascio valide sono indicate da due frecce verticali bianche.

Regolazione della larghezza delle colonne

Se non tutti i dati vengono visualizzati in una determinata colonna, trascinare il separatore della colonna interessata per allargarla oppure usare il comando Best Fit del menu contestuale. Questo comando allarga la colonna in base al campo con la voce più lunga (o alla lunghezza della stringa dell’intestazione) in quella colonna. Per ridimensionare tutte le colonne in modo che si adattino alla voce di campo più lunga (o alla lunghezza della stringa dell’intestazione), usare il comando Best Fit all Columns .

Ordinamento dei dati nelle colonne

I dati in una qualsiasi colonna possono essere ordinati in ordine crescente o decrescente facendo clic sull’intestazione della colonna (lontano dall’icona del filtro). Si noti che tutte le colonne saranno interessate, ma le righe verranno ordinate in base alla colonna su cui si è fatto clic. È supportato anche l’ordinamento su più colonne; tenere premuto il tasto Shift mentre si fa clic sulle intestazioni delle colonne successive per eseguire un sotto-ordinamento in base a quella seconda colonna.

Filtro personalizzato

In alcuni casi, potrebbe essere necessario escludere parti specifiche dal report BOM, come i fiducial, oppure potrebbe essere necessario elencare un insieme particolare di componenti con una specifica radice del designatore e/o footprint. Per supportare questa esigenza, la finestra di dialogo offre la possibilità di applicare un filtro personalizzato, fornendo il pieno controllo sul contenuto della BOM.

Per applicare il filtro, fare clic sull’icona del filtro ( ), situata a destra di ciascuna intestazione di colonna. Si noti che il menu successivo elenca tutte le singole voci di riga per un rapido filtro selettivo, oppure selezionare la voce (Custom…) per accedere alla finestra di dialogo Filter Editor. Utilizzare la finestra di dialogo per costruire il filtro, che può essere basato sui valori di qualsiasi colonna. Per ulteriori informazioni, fare riferimento alla pagina della finestra di dialogo Filter Editor dialog.

Una volta applicato un filtro, l’icona del filtro diventa blu ( ) per indicare che per quella colonna è attivo un filtro personalizzato. Il filtro attualmente applicato è visualizzato nella parte inferiore sinistra della regione dati e può essere modificato nuovamente facendo clic sull’icona della matita, come mostrato di seguito.

Un esempio di utilizzo del filtro personalizzato.Un esempio di utilizzo del filtro personalizzato.

Per cancellare il filtro corrente applicato al set di dati, fare clic sulla piccola croce (Clear Filter) a destra dell’espressione del filtro nella parte inferiore della regione dati.

Dove viene memorizzato il layout

Il layout definito nel Report Manager viene memorizzato in modo da poter essere riapplicato la volta successiva che la finestra di dialogo viene aperta. La posizione in cui il layout viene memorizzato cambia a seconda della sorgente da cui il Report Manager ricava le informazioni BOM e da dove viene aperto il Report Manager.

  • Se la sorgente per il Report Manager è un BomDoc ActiveBOM: il layout corrente definito nel BomDoc viene trasferito al Report Manager ogni volta che viene aperto. Le modifiche al layout apportate nel Report Manager non vengono mantenute; utilizzare la funzione BOM Sets in ActiveBOM per configurare layout di report specifici.
  • Se la sorgente per il Report Manager è il progetto (o il PCB):
    • E il Report Manager viene aperto dal menu Reports dell’editor schematico o PCB; il layout del Report Manager viene memorizzato nel file di progetto.
    • E il Report Manager viene aperto da un OutputJob; il layout del Report Manager viene memorizzato nel file OutJob. Questo viene fatto in modo che l’OutJob possa essere trasferito da un progetto a un altro.

Inclusione di informazioni aggiuntive direttamente nella BOM

In passato, le informazioni sorgente per una distinta base sono state ricavate dalle informazioni di proprietà dei componenti posizionati nel progetto. Ciò può comportare una grande quantità di informazioni associate a uno schema che vengono utilizzate solo per la BOM.

Oltre alle informazioni derivate dai componenti dello schema, il Report Manager può anche estrarre informazioni da sorgenti dati collegate, tra cui:

un Workspace (per i componenti di libreria del Workspace)

Altium Cloud Services (per i componenti posizionati dal pannello Manufacturer Part Search)

un database, per i componenti collegati a quel database

il PCB

i parametri del documento schematico

Abilitare la/le Sources richiesta/e nella scheda Columns di Report Manager, quindi abilitare i parametri richiesti nell’elenco Columns.

Per raggruppare i parametri nell’elenco Columns in base alla loro sorgente, fare clic sulla sezione dell’intestazione Data Source senza etichetta, come mostrato di seguito.

Inclusione delle informazioni del database

In passato, le informazioni sorgente per una distinta base (BOM) sono state ricavate dalle informazioni dei parametri dei componenti posizionati nel progetto. Ma ciò può comportare una grande quantità di informazioni associate a uno schema che vengono utilizzate solo per la BOM. Se i componenti sono collegati a un database esterno tramite un file di libreria database, il Report Manager è in grado di estrarre direttamente da quel database qualsiasi altra informazione di record che non sia stata aggiunta ai componenti come parametri di progetto. Fare clic sul pulsante nella regione Sources della scheda Columns per abilitare i database come sorgente. Questa opzione sarà disponibile solo se uno o più componenti nel progetto sono collegati a un database esterno.

I parametri del database possono essere inclusi da un database esterno, indipendentemente dal metodo utilizzato per collegarsi a quel database: *.DbLib, *.SVNDbLib o *.DbLink. Cercare l’icona nell’elenco Columns per distinguere un parametro che esiste per uno o più componenti posizionati nel database esterno collegato da includere nella BOM. Fare clic sull’icona di visibilità in modo che diventi un occhio (), per includere quella colonna (parametro) nella BOM.

Includere informazioni aggiuntive sui componenti che esistono solo in un database esterno.
Includere informazioni aggiuntive sui componenti che esistono solo in un database esterno.

Per un progetto che include Variants, i parametri utilizzati per interrogare il database vengono variati nella finestra di dialogo Variant Management dialog. Poiché tali valori dei parametri esistono solo nella finestra di dialogo Variant Management, vengono utilizzati solo per interrogare e far corrispondere i record nel database quando si configura una BOM per la generazione. Per fare ciò, assicurarsi che la sotto-opzione - Include DB Parameters in Variations - sia abilitata nella scheda General delle proprietà di Report Manager.

Inclusione delle informazioni PCB

Le informazioni sorgente per una distinta base possono includere informazioni di proprietà ricavate dal PCB, nel caso in cui il progettista debba personalizzare e utilizzare la generazione del report per BOM per scopi speciali. Un esempio potrebbe essere la generazione di un file pick and place, in cui l’operatore della macchina di posizionamento desidera dati PCB (come la posizione X, Y), insieme ad altri parametri specifici del componente, configurati in un ordine di colonne e in un formato file specifici.

Fare clic sul pulsante nella regione Sources della scheda Columns per abilitare il PCB come sorgente. Questa opzione sarà disponibile solo se nel file di progetto è presente un documento PCB. Se il progetto include più documenti PCB, verrà visualizzata la finestra di dialogo Choose PCB to Use.

Scegliere quale PCB utilizzare come sorgente per la BOM.Scegliere quale PCB utilizzare come sorgente per la BOM.

Per passare a un altro documento PCB, fare clic sul pulsante nella regione Sources per disabilitare quel PCB come sorgente, quindi fare nuovamente clic su di esso per riaprire la finestra di dialogo Choose PCB to Use e selezionare un PCB diverso.

Inclusione dei dati del fornitore nella BOM

La possibilità di calcolare il costo di un progetto e determinare le quantità dei componenti di progetto da ordinare presso fornitori/distributori è una parte essenziale dell’intero processo di progettazione. Se i componenti di progetto sono stati inseriti da un Workspace (e hanno Part Choices definiti), oppure dal pannello Manufacturer Part Search, tali componenti includeranno collegamenti alla supply chain. Se dispongono di collegamenti alla supply chain, i dati del fornitore collegato, inclusi prezzi e informazioni sulle scorte, possono essere inclusi al momento del rilascio del progetto nella distinta base, abilitando le opportune colonne dei parametri.

I dati del fornitore sono disponibili solo quando si genera una distinta base per il progetto. Non sono disponibili quando si genera una distinta base per un documento PCB e non sono inclusi nemmeno quando si genera una Simple BOM.

I seguenti dati basati sul fornitore possono essere inclusi in una distinta base abilitando la casella di controllo di ciascun elemento desiderato nell’area Columns:

  • Manufacturer n - nome del produttore.
  • Manufacturer Lifecycle n - stato del ciclo di vita del produttore, se disponibile.
  • Manufacturer Part Number n - codice componente del produttore.
  • Supplier n - nome del fornitore.
  • Supplier Currency n – codice alfabetico della valuta scelta utilizzata per i dati di prezzo.
  • Supplier Order Qty n – il valore maggiore tra: (Item Quantity * Production Qty), oppure; Minimum Order Qty (MOQ)
  • Supplier Part Number n – codice componente per l’articolo del fornitore.
  • Supplier Stock n – quante unità dell’articolo il fornitore ha in magazzino.
  • Supplier Subtotal per Board nSupplier Unit Price moltiplicato per Item Quantity, con il risultato del subtotale per quell’articolo. Si noti che questo valore non considera la MOQ.
  • Supplier Subtotal nSupplier Unit Price moltiplicato per Supplier Order Quantity, con il risultato del subtotale per quell’articolo tenendo conto della MOQ.
  • Supplier Unit Price n – costo per unità dell’articolo del fornitore (senza considerare alcuna MOQ).
La BOM utilizza insiemi indicizzati di dati relativi ai fornitori per gestire componenti che hanno più di un articolo fornitore collegato, ad esempio Supplier 1, Supplier Currency 1, ecc., Supplier 2, Supplier Currency 2, ecc., e così via.

Le informazioni su prezzi e scorte provengono direttamente dai Part Providers abilitati. L’aggiunta di questi parametri ai componenti non influisce sulla compilazione dei dati nella BOM.

Per ulteriori informazioni, fare riferimento alla pagina Linking to Part Supply Chain Data.

Specifica della quantità di produzione

È possibile calcolare completamente il costo di un progetto in base al numero di unità del prodotto che si intende produrre, cioè la Production Quantity. Utilizzare il campo Production Quantity nell’area Supply Chain del Report Manager per specificare il valore richiesto. È importante definire questo campo poiché viene utilizzato durante la ricerca nella supply chain per verificare la disponibilità dei componenti e anche il prezzo unitario per le fasce di prezzo disponibili del fornitore.

Il valore immesso nel campo Production Quantity viene utilizzato per determinare la Supplier Order Qty – la quantità del componente che dovrebbe essere ordinata per produrre la quantità di prodotto indicata. Questa viene calcolata moltiplicando la Quantity (di ciascun particolare componente) per la Production Quantity specificata. Si noti che per i componenti che hanno una quantità minima d’ordine (MOQ), la Supplier Order Qty è il valore maggiore tra: (Item Quantity * Production Qty), oppure; Minimum Order Qty (MOQ).

A sua volta, la Supplier Order Qty viene utilizzata per determinare il Supplier Unit Price applicabile. Ricordare che i fornitori offrono in genere vari livelli di prezzo in base alla quantità (price break), a seconda di quante unità di un articolo vengono acquistate.

Cambio della valuta del fornitore

La valuta utilizzata per i dati relativi ai prezzi in una distinta base può essere specificata dall’intervallo di valute supportate. Scegliere la valuta richiesta nell’area Supply Chain del Report Manager. La valuta scelta influirà sulle seguenti colonne di dati, che possono anch’esse essere incluse nella BOM:

  • Supplier Unit Price n
  • Supplier Currency n
  • Supplier Subtotal per Board n
  • Supplier Subtotal n

Scegliere da un elenco di valute supportate quando si esportano dati di prezzo in una distinta base.Scegliere da un elenco di valute supportate quando si esportano dati di prezzo in una distinta base.

Uso dei dati di prezzo memorizzati nella cache nei parametri BOM quando si è offline

Quando si lavora online (connessi a Internet e con accesso effettuato a un account Altium Live), i dati relativi ai prezzi per i componenti con Live Links ai dati del fornitore verranno aggiornati. Quando si genera una BOM, verranno utilizzati i prezzi più recenti disponibili in quel momento. Per valute specifiche, i tassi di cambio vengono aggiornati quotidianamente.

Quando si lavora offline, è possibile utilizzare gli ultimi dati di prezzo memorizzati nella cache nei parametri basati sul prezzo nella BOM. Per farlo dal Report Manager, fare clic sul pulsante Cached nell’area Supply Chain Data della finestra di dialogo.

Gestione delle varianti

Se per il progetto sono definite delle varianti, è possibile generare una distinta base basata su una variante scelta.

Per farlo, selezionare la variante richiesta dal menu a discesa delle varianti disponibile nella parte superiore della finestra di dialogo Report Manager. Il banner Report Manager indicherà la variante attualmente selezionata.

Basare il report BOM su una variante specifica; il banner della finestra di dialogo mostra quale variante è attualmente in uso.Basare il report BOM su una variante specifica; il banner della finestra di dialogo mostra quale variante è attualmente in uso.

Per tornare a utilizzare il progetto base, scegliere la voce [No Variations] nel menu a discesa.

L’area dati della finestra di dialogo verrà aggiornata di conseguenza:

  • I componenti definiti come Not Fitted per la variante scelta vengono rimossi, a meno che non sia abilitata l’opzione Show Not Fitted.
  • I valori dei parametri vengono aggiornati con quelli della variante scelta laddove differiscono dal progetto base.

Per mantenere nella BOM i componenti che sono Not Fitted e contrassegnarli esplicitamente come tali, abilitare l’opzione Show Not Fitted e abilitare anche la colonna Fitted nella scheda Columns della finestra di dialogo. Per ciascun componente, una voce in questa colonna indica se ogni componente è Fitted oppure Not Fitted per la variante scelta. Il valore immesso nella colonna Quantity per un componente che è Not Fitted nella variante scelta è zero (0).

Supporto delle varianti quando l’origine è un BomDoc

Se il Report Manager utilizza un BomDoc come origine, è possibile generare una singola BOM per tutte le varianti. Questa è definita Consolidated BOM; per visualizzarla, impostare View Mode su Consolidated View.

Per ciascuna variante vengono visualizzate automaticamente due colonne aggiuntive specifiche della variante:

  • Qty@<VariantName>
  • Price@<VariantName>

A queste colonne specifiche della variante vengono assegnati automaticamente nomi Alias nel formato <VariantName> - Qty e <VariantName> - Price.

Esportazione della BOM

Una volta che il contenuto della BOM è stato definito e organizzato come richiesto, il report può essere generato, stampato oppure esportato in uno dei diversi formati di file.

I controlli per l’esportazione dei dati della BOM si trovano nell’area Export Options del Report Manager.

Per esportare la distinta base, eseguire i seguenti passaggi:

  1. Utilizzare il menu a discesa File Format per scegliere il formato in cui esportare i dati della BOM. Sono supportati i seguenti formati:

    • CSV (separato da virgole) (*.csv)

    • Testo delimitato da tabulazioni (*.txt)

    • MS-Excel (*.xls, *.xlsx) (utilizza Microsoft Excel)

    • Generic XLS (*.xls, *.xlsx) (utilizza un generatore di file in formato XLS integrato, quindi questo formato può essere generato senza che Microsoft Excel sia installato)

    • Portable Document Format (*.pdf)

    • Pagina Web (*.htm, *.html)

    • Foglio di calcolo XML (*.xml)

  2. Se il formato di esportazione è Excel, è possibile applicare un modello Excel ai dati esportati.

    Fare riferimento alla sezione Making an Excel-based BOM Template Available for Use qui sotto per sapere come rendere disponibile un modello BOM nel proprio Workspace.

    Un Workspace BOM Template può anche essere utilizzato come elemento di dati di configurazione in una o più Environment Configurations definite. Una configurazione dell’ambiente viene utilizzata per vincolare l’ambiente di lavoro di un progettista all’uso esclusivo di elementi di progettazione approvati dall’azienda. Le configurazioni dell’ambiente sono definite e memorizzate all’interno del Team Configuration Center, un servizio fornito tramite il Workspace. Una volta effettuata la connessione al Workspace e scelta, se applicabile, una delle configurazioni dell’ambiente disponibili, Altium Designer verrà configurato, per quanto riguarda l’uso dei BOM Templates. Se la configurazione dell’ambiente scelta ha uno o più BOM template definiti, allora only possono essere utilizzati tali template definiti. Se la configurazione dell’ambiente applicabile non ha alcun BOM template specificato/aggiunto, oppure è impostata su Do Not Control, questi rimarranno definibili manualmente. In altre parole, si è liberi di utilizzare template locali basati su file. Per ulteriori informazioni, vedere Environment Configuration Management (Altium 365 Workspace, Enterprise Server Workspace).

  3. Per aprire il file esportato nell’applicazione software associata, abilitare l’opzione Open Exported.

  4. Per aggiungere il report generato al progetto dopo la sua creazione, abilitare l’opzione Add to Project.

  5. Abilitare l’opzione Report BOM Violations in Messages per eseguire un controllo dell’ActiveBOM durante la generazione della BOM. Le violazioni rilevate saranno dettagliate nel pannello Messages.

  6. Fare clic sul pulsante Export , quindi utilizzare la finestra di dialogo visualizzata per specificare dove e con quale nome salvare il report BOM. Fare clic su Save per creare l’esportazione.

Diversi modelli di esempio sono forniti con Altium Designer nella cartella \Templates dei file utente dell’installazione.

Mappatura dei dati di progetto nella BOM

Un approccio comune alla generazione della BOM consiste nell’esportare i dati della BOM da Altium Designer in un foglio di calcolo Excel nel formato preferito dall’azienda. I dati di Altium Designer vengono mappati nel foglio di calcolo includendo speciali istruzioni Field e Column nel modello Excel. Questo può essere utilizzato per specificare il layout desiderato. L’istruzione Field viene utilizzata per mappare un singolo parametro, ad esempio un parametro del documento chiamato Title. L’istruzione Column viene utilizzata per mappare parametri per componente, ad esempio il parametro del componente Designator.

Campi

L’istruzione Field viene utilizzata per mappare un parametro di documento o di progetto (sono supportati sia i parametri di progetto locali sia quelli lato Workspace), ad esempio Title, nella BOM. La dichiarazione Field viene sostituita con il valore passato, come mostrato nelle immagini seguenti.

I campi vengono utilizzati nel formato:

Field=<FieldName>

Un esempio è Field=Currency

I campi devono essere definiti sopra o sotto la regione Column del template.

Columns

Le dichiarazioni Column vengono utilizzate per mappare parametri per singolo componente, ad esempio il Designator, il Description, i parametri definiti dall’utente e così via di ciascun componente. Questo può includere anche: numeri di riga, dati di posizione del PCB e dati di colonna personalizzati inseriti nel BomDoc, se nel progetto è presente un BomDoc. La dichiarazione Column nel template viene sostituita dalla stringa ColumnName, con ogni riga sottostante popolata con il valore di quella colonna per ciascun elemento BOM, come mostrato nelle due immagini seguenti.

Le colonne vengono utilizzate nel formato:

Column=<ColumnName>

Un esempio è Column=Designator

Note:

  • Ogni colonna definita nel template deve essere visualizzata nel Report Manager affinché i dati di quella colonna vengano trasferiti. Ad esempio, nelle immagini seguenti, la colonna Line # è visualizzata nel Report Manager, quindi può essere inclusa nella BOM (usando la sintassi Column=Line #). Si noti che la colonna Line # è disponibile come colonna configurabile dall’utente solo quando si generano report da un ActiveBOM BomDoc.
  • I dati verranno presentati nel foglio di calcolo Excel nello stesso ordine di riga del Report Manager. Utilizzare la funzione di ordinamento e sotto-ordinamento delle colonne Report Manager's per ordinare le righe come richiesto.

Example of a simple Excel template, showing how the design parameters are mapped into the template

Example of a BOM created from the simple Excel template shown in the previous image

  • I template di esempio sono inclusi nella cartella \Templates dei file utente dell’installazione.

  • I template disponibili vengono configurati nella pagina Data Management - Templates della finestra di dialogo Preferences.

  • La posizione predefinita per i template non gestiti (Local) viene configurata nel campo Local Templates folder di quella pagina nella finestra di dialogo Preferences.

  • Per una progettazione gestita, i template disponibili (Server) sono archiviati nella cartella \Templates\BOM Templates del tuo Altium Workspace (server dei contenuti gestiti). Questi vengono elencati nella finestra di dialogo Preferences solo quando sei connesso a un Workspace.

  • L’elenco dei template disponibili nel menu a discesa Report Manager Template si basa sulla configurazione corrente dei template nella finestra di dialogo Preferences. Assicurati che l’opzione Templates visibility sia configurata in base alle tue esigenze.

  • I template Excel supportano l’occultamento di righe o colonne. Questa funzione è stata utilizzata in alcuni template di esempio per nascondere le dichiarazioni Column = <ColumnName>. Per visualizzare righe o colonne nascoste in Excel, seleziona tutte le celle nel template, quindi fai clic con il pulsante destro in un punto qualsiasi del foglio e scegli il comando Unhide (mostra immagine).

Mappatura delle informazioni di intestazione BOM a livello di progetto

Le informazioni a livello di progetto vengono in genere mappate utilizzando l’istruzione Field= nell’intestazione del documento BOM.

Mappatura dei parametri di documento e di progetto

Oltre alle istruzioni Field elencate sopra, anche i parametri di documento schematico (sia i parametri predefiniti sia quelli definiti dall’utente inseriti nel pannello Properties del documento schematico) e i parametri di progetto (finestra di dialogo Options for PCB Project) possono essere utilizzati come Fields o come Columns.

Mappatura delle informazioni degli elementi BOM

La regione principale di una BOM è la griglia degli elementi BOM, che in genere utilizza una riga per ciascun componente. Ogni colonna di questa griglia rappresenta una proprietà del componente, come il designatore, il valore e così via. Le colonne vengono definite inserendo la proprietà/il parametro del componente (intestazione della colonna BOM), nel formato:

Column=ColumnName

Un esempio potrebbe essere Column=Description, oppure Column=Designator

Le informazioni di colonna possono essere ricavate da diverse sorgenti, tra cui:

Rendere disponibile per l’uso un template BOM basato su Excel

Un template BOM basato su Excel (preparato come descritto nella sezione Mappatura dei dati di progettazione nella BOM sopra) può essere reso disponibile per l’uso durante la preparazione di una BOM per l’esportazione caricando il relativo file template Excel (*.xls, *.xlsx, *.xlt, *.xltx) nel tuo Workspace. Per farlo, apri la scheda Templates della pagina Data Management – Templates della finestra di dialogo Preferences e seleziona il comando BOM o Load from File dal menu del pulsante Add o dal menu contestuale Add della griglia dei template. Nella finestra di dialogo Open (una finestra standard di apertura file di Windows) che si apre, seleziona l’opzione Microsoft Excel File (*.xlt;*.xltx;*.xltm;*.xls;*.xlsx;*.xlsm) nel menu a discesa a destra del campo File name e usa la finestra di dialogo per individuare e aprire il file richiesto, che verrà caricato nella revisione iniziale del nuovo Workspace BOM Template creato automaticamente in una cartella Workspace di tipo BOM Templates.

Se il file modello Excel richiesto si trova in Local Template folder (definito nella parte inferiore della pagina Data Management – Templates della finestra di dialogo Preferences) ed è elencato sotto la voce Local della griglia dei modelli, può essere migrato in un nuovo Workspace BOM Template facendo clic con il pulsante destro su di esso e selezionando il comando Migrate to Server. Fare clic sul pulsante OK nella finestra di dialogo Template migration per procedere con il processo di migrazione: come indicato in questa finestra di dialogo, il file modello Excel originale verrà aggiunto a un archivio Zip nella cartella locale dei modelli (e quindi non sarà visibile nell’elenco dei modelli Local).

Se è necessario modificare il modello Excel memorizzato in un Workspace BOM Template, caricare il nuovo file Excel richiesto in quel modello Workspace. Dalla scheda Templates della pagina Data Management – Templates page della finestra di dialogo Preferences, fare clic con il pulsante destro sulla voce del modello e scegliere il comando Upload dal menu contestuale. Nella finestra di dialogo Open, individuare e selezionare il file richiesto. Il nuovo modello verrà memorizzato nella revisione successiva di quel modello Workspace.

  • Per aprire il file modello Excel BOM memorizzato in una revisione di un Workspace BOM Template, individuare questa revisione nel Explorer panel e selezionare quel file nella scheda di visualizzazione aspetti Details per la revisione, quindi fare clic con il pulsante destro e scegliere il comando Open dal menu contestuale. Il file verrà aperto in Excel, se installato.
  • Per scaricare il file modello Excel BOM memorizzato in una revisione di un Workspace BOM Template, individuare questa revisione nel pannello Explorer e selezionare quel file nella scheda di visualizzazione aspetti Details per la revisione, quindi fare clic con il pulsante destro e scegliere il comando Download dal menu contestuale. Specificare la cartella di destinazione che riceverà il file nella successiva finestra di dialogo Choose destination folder.

Generazione della BOM da un Output Job

Una distinta base può anche essere configurata e generata come parte di un file di configurazione Output Job (*.OutJob). Aggiungere un Output Job al progetto tramite il menu New oppure fare clic con il pulsante destro sul progetto nel pannello Projects.

Per aggiungere un generatore di output BOM a un file Output Job aperto, fare clic su Add New Report Output nella categoria Report Outputs e scegliere Bill of Materials dal menu a comparsa. Viene fornito un secondo menu dal quale è possibile specificare la sorgente dati (quale/i documento/i sorgente deve/devono essere utilizzato/i quando viene generato il report BOM). Sono disponibili solo le sorgenti dati applicabili, lasciando meno spazio agli errori.

La sorgente dati per una BOM può essere un singolo documento schematico sorgente specifico, il documento di progettazione PCB, tutti i documenti schematici sorgente (la voce [Project]) oppure un documento ActiveBOM.

Una volta aggiunta, fare doppio clic sulla nuova voce per accedere a Report Manager e personalizzare la BOM come descritto in questo documento. Una volta configurato il generatore di output, collegarlo ai relativi Output Container. Un report BOM può essere generato come output basato su file oppure pubblicato come PDF. Può anche essere stampato inviandolo direttamente a un dispositivo di stampa come copia cartacea (tramite un Print Job configurato).

Abilitare l’output per l’Output Container selezionato, quindi fare clic su Change per configurare l’output, pronto per generare un report BOM da un file Output Job.Abilitare l’output per l’Output Container selezionato, quindi fare clic su Change per configurare l’output, pronto per generare un report BOM da un file Output Job.

Le impostazioni definite in Report Manager durante la generazione di una BOM dallo schematico o dal PCB vengono memorizzate nel file di progetto e sono distinte da quelle definite per gli stessi tipi di output in un file Output Job. Sebbene la generazione dall’editor sorgente possa essere utile per test rapidi, il file Output Job fornisce una soluzione portabile che può essere utilizzata tra progetti senza dover impostare ogni volta una personalizzazione BOM preferita.
Per un’analisi dettagliata dei file Output Job, inclusi tutti gli aspetti della loro configurazione e del loro funzionamento, fare riferimento alla pagina Preparing Manufacturing Data with Output Jobs.

Pubblicazione in PDF basata su un modello Excel

Da un file Output Job, il report BOM può anche essere pubblicato in formato PDF sulla base di un modello Excel specificato eseguendo quanto segue:

  • Durante la configurazione del generatore di output BOM:
    • Impostare File Format nell’area Export Options su Microsoft Excel Worksheet (*.xls, *.xlsx, *.xlt, *.xltx).
    • Specificare il modello Excel richiesto utilizzando il campo Template nell’area Excel Options.
  • Collegare il generatore di output BOM al PDF Output Container richiesto (e configurato), come mostrato nell’immagine sopra. Per determinare le dimensioni del foglio di calcolo da stampare in PDF vengono applicate le seguenti regole:
    • Le celle a destra dell’intestazione di colonna più a destra non sono incluse nell’output.
    • Le celle sotto la cella di testo più in basso non sono incluse, a meno che non contengano bordi orizzontali e/o colori di sfondo e non siano separate dalla sezione principale della BOM da più di dieci righe vuote.

Preparazione di un report di riferimento incrociato dei componenti

Il Component Cross Reference Report è un elenco di componenti, basato sul foglio schematico in cui si trovano nel progetto. Selezionare Reports » Component Cross Reference da un documento schematico oppure fare doppio clic su un Component Cross Reference Report aggiunto a un OutJob per accedere alla finestra di dialogo Component Cross Reference Report, in cui il report può essere configurato.

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

Le funzionalità disponibili dipendono dalla soluzione Altium in uso – Altium Develop, un’edizione di Altium Agile (Agile Teams o Agile Enterprise), oppure Altium Designer (con licenza attiva).

Se non vedi nel tuo software una funzionalità descritta,  contatta il team 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.

Contenuto