Preparando uma BOM no 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.

Num relance

Aprenda a preparar e exportar uma lista de materiais (BOM) usando o Report Manager no Altium Designer. Este artigo explica como gerar sua BOM a partir de um projeto ou de um documento ActiveBOM, configurar as informações e a disposição dos componentes, incluir dados da cadeia de suprimentos e selecionar formatos e modelos de exportação. Também apresenta os motivos pelos quais o ActiveBOM é a abordagem recomendada para gerenciar o conteúdo da BOM ao longo do processo de projeto. Continue lendo para assumir o controle da configuração da sua BOM e preparar os arquivos de saída de que seu projeto precisa.

- Entenda as diferenças entre BOMs geradas a partir de projetos e de documentos ActiveBOM.
- Aprenda a organizar colunas, filtrar dados de componentes e lidar com variantes de projeto e itens alternativos.
- Explore as configurações de dados de fornecedores, os formatos de exportação e as opções de modelos para gerar sua BOM final.
Aprofunde-se com a IA:

A lista de materiais, ou BOM, é um elemento essencial do conjunto de dados gerado a partir de um projeto de placa. Esse documento do tipo relatório fornece uma lista de todos os componentes necessários para fabricar o produto, incluindo a placa nua, que é essencialmente o 'componente' de base sobre o qual todas as outras peças são montadas. A BOM serve como um guia do que precisa ser adquirido para fabricar o produto conforme projetado. Ela também permite calcular o custo com base no número necessário de placas montadas em uma rodada de fabricação solicitada.

A BOM final é gerada por um mecanismo dedicado e poderoso de geração de relatórios, cuja interface é conhecida como Report Manager. A caixa de diálogo Report Manager é usada para:

  • Configurar quais propriedades do projeto devem ser incluídas na BOM.
  • Organizar o conteúdo na ordem necessária na BOM.
  • Aplicar filtros personalizados por coluna, semelhantes aos de uma planilha, se necessário.
  • Habilitar diferentes opções de origem dos componentes.
  • Habilitar opções de fornecedores.
  • Configurar o formato do arquivo de exportação.
  • Selecionar um modelo de BOM do Excel, se o formato de exportação for XLS ou PDF.
Além de ser usado para gerar uma BOM, o Report Manager também pode ser configurado para gerar outras saídas relacionadas a componentes, como uma referência cruzada de componentes.

Para ter controle completo sobre o processo de configuração da BOM, incluindo uma visualização interativa das informações da cadeia de suprimentos, além de linhas e colunas personalizadas da BOM, adicione um documento ActiveBOM (BomDoc) ao seu projeto. O BomDoc oferece visibilidade instantânea da cadeia de suprimentos dos componentes e também permite definir linhas e colunas personalizadas, o que é ideal para incluir itens extras, como cola, etiquetas e assim por diante. Criar e gerenciar a BOM por meio de um BomDoc é a abordagem recomendada para o gerenciamento de BOM no Altium Designer.

Opções de criação da BOM

A saída final da lista de materiais é gerada pelo Report Manager. O Report Manager pode gerar saídas em diversos formatos, incluindo PDF, CSV, TXT, Excel, HTML ou XML.

O Report Manager pode extrair as informações de origem da BOM dos seguintes elementos:

  • O projeto — as informações são extraídas dos esquemáticos, bem como dos bancos de dados conectados e da PCB, se necessário.
  • Um documento ActiveBOM (BomDoc) — a abordagem recomendada.

Se o projeto não incluir um ActiveBOM, o Report Manager gerará a BOM a partir do projeto. Nessa abordagem, o Report Manager é usado para realizar toda a configuração do layout da BOM, como selecionar e organizar as colunas, filtrar linhas desnecessárias, incluir informações de fornecedores e assim por diante. O Report Manager também é usado para configurar as opções de saída, como o formato, o modelo do Excel necessário e assim por diante. Nessa abordagem, a BOM é preparada após a conclusão do processo de projeto. O Report Manager só pode ser usado para configurar uma saída de BOM. Se essa abordagem for adotada, será necessário usar um OutputJob caso você precise definir diferentes configurações de saída de BOM.

A abordagem recomendada é incluir um documento ActiveBOM (BomDoc) no projeto. O BomDoc é um documento de origem que pode ser adicionado em qualquer etapa do desenvolvimento do projeto — em essência, uma lista de peças dinâmica. As peças aparecem automaticamente no BomDoc à medida que os componentes são adicionados ao esquemático, e o projetista pode começar imediatamente a explorar opções de preços e da cadeia de suprimentos e definir as peças preferenciais. O projetista também pode selecionar e organizar as colunas, aplicar filtros, adicionar números de linha, adicionar colunas personalizadas e linhas para itens personalizados — em resumo, realizar todas as etapas típicas de preparação da BOM durante o processo de projeto. Várias configurações de saída podem ser preparadas no BomDoc, cada uma salva como um conjunto de BOM, com o conjunto de BOM necessário sendo selecionado no Report Manager para a geração final da BOM.

Se o projeto incluir um BomDoc, ele será usado automaticamente como origem para o Report Manager, a menos que você substitua essa definição manualmente em um OutputJob, definindo o Data Source como [Projeto] em vez de [Documento ActiveBOM]. Quando o projeto é usado como fonte de dados, a interface do Report Manager muda ligeiramente, com a inclusão do recurso Column Grouping na aba Columns da caixa de diálogo. Mais detalhes sobre isso a seguir.

Quando o projeto inclui um BomDoc, ele é usado como origem para o Report Manager. Quando o projeto inclui um BomDoc, ele é usado como origem para o Report Manager.

Como criar uma BOM

O Report Manager pode ser aberto a partir de:

  • Os documentos esquemáticos de origem do projeto ou o documento PCB ativo, usando o comando Reports » Bill of Materials do editor de esquemáticos ou de PCB.
Uma lista de materiais também pode ser adicionada se não houver documentos esquemáticos no projeto. Nesse caso, o relatório da lista de materiais tem como origem a PCB.
  • Uma tarefa de saída do tipo Relatório configurada em um OutputJob.
  • Um ActiveBOM, usando o comando Reports » Bill of Materials.

Em cada caso, os documentos de origem serão compilados, e a caixa de diálogo Report Manager será aberta. Use esse mecanismo de geração de relatórios altamente configurável, dedicado e poderoso para configurar o conteúdo do relatório da BOM conforme necessário.

Uma lista de materiais, com origem no BomDoc do projeto, pronta para ser gerada a partir do Report Manager. Uma lista de materiais, com origem no BomDoc do projeto, pronta para ser gerada a partir do Report Manager.

Embora a caixa de diálogo seja referida como Report Manager, ela não recebe esse nome. Ela é nomeada automaticamente de acordo com o tipo de relatório que está sendo criado, que, neste caso, é uma lista de materiais.

A caixa de diálogo apresenta as diversas propriedades/parâmetros de todos os componentes nos documentos de origem. Cada propriedade/parâmetro tem sua própria coluna. O projetista simplesmente escolhe quais dados incluir no relatório de BOM gerado. Os dados podem ser agrupados, classificados e filtrados conforme necessário, com a possibilidade de incluir dados paramétricos adicionais de uma PCB especificada para o projeto e/ou de um banco de dados vinculado, conforme necessário.

Se o projeto incluir um BomDoc, o comportamento padrão do Report Manager será apresentar os detalhes dos componentes da mesma forma que foram configurados no BomDoc.

As seções a seguir examinam mais detalhadamente a manipulação dos dados para obter o conteúdo desejado da BOM antes de exportar o relatório.

Agrupamento de componentes na BOM

Se o projeto incluir um ActiveBOM, a configuração presente no BomDoc será transferida automaticamente para a caixa de diálogo Report Manager. Essa capacidade de transferir a configuração da BOM do ActiveBOM para o Report Manager resulta em diferenças no layout e nos recursos disponíveis na caixa de diálogo Report Manager.

A diferença fundamental na caixa de diálogo Report Manageré a forma como os componentes semelhantes são agrupados em uma única linha:

  • BOM do ActiveBOM - o agrupamento é definido no ActiveBOM, na caixa de diálogo Component Grouping. O editor do ActiveBOM também inclui controles View Modepara alternar instantaneamente entre uma visualização plana (uma linha por componente) e uma visualização agrupada (componentes semelhantes agrupados em uma única linha).
  • BOM do projeto - se não houver um BomDoc no projeto ou se o Report Managerfor aberto a partir de um OutputJob que tenha um Data Sourcede [Project], o Report Managerdeverá ser configurado manualmente. Nessa situação, o agrupamento de componentes da BOM é realizado no Report Manager, na aba Columnsda caixa de diálogo.

Agrupamento de componentes - Quando o BomDoc é a origem

Uma abordagem comum em uma BOM é ter uma linha para cada componente exclusivo. Para isso, os componentes semelhantes devem ser agrupados.

Em um BomDoc, o agrupamento de colunas é configurado na caixa de diálogo Component Grouping. O projetista pode então ativar e desativar o agrupamento de colunas usando os botões de modo de visualização , alternando instantaneamente entre Flat View(uma peça por linha) ou Base View(peças agrupadas de acordo com as configurações da caixa de diálogo Component Groupingdo ActiveBOM).

Se o Report Managerestiver usando um BomDoc como origem, a caixa de diálogo incluirá os mesmos botões de modo de visualização; use-os para alternar entre uma peça por linha ou peças agrupadas. A visualização consolidada é usada quando há variantes; isso é discutido mais adiante na seção Como lidar com variantes.

Essas diferenças na caixa de diálogo Report Managerpodem ser vistas comparando as duas imagens a seguir (passe o cursor sobre a imagem para alternar entre elas).

Quando a BOM tem como origem um BomDoc, não há uma seção de colunas agrupadas, pois o agrupamento é realizado no ActiveBOM.Quando a BOM tem como origem um BomDoc, não há uma seção de colunas agrupadas, pois o agrupamento é realizado no ActiveBOM.

Normalmente, não é necessário fazer alterações no layout dos dados na caixa de diálogo Report Managerse um BomDoc for a origem, mas isso é possível, se necessário, usando as técnicas de agrupamento descritas abaixo.

Agrupamento de componentes - Quando o projeto é a origem

Quando o projeto é usado como origem para o Report Manager, o agrupamento de componentes semelhantes é configurado no Report Manager.

Observe que, se um componente tiver sido excluído de um projeto, seu status será sinalizado como um aviso de violação na coluna BOM Statusdo ActiveBOM.

A aba Columnsda caixa de diálogo inclui a seção Drag a column to group, conforme mostrado abaixo. Componentes semelhantes serão agrupados na BOM quando o conteúdo de todas as colunas agrupadas corresponder. Por exemplo, na imagem abaixo, os componentes C1 e C3 foram agrupados na mesma linha da BOM (a primeira linha) e, portanto, devem ter os mesmos valores para seus parâmetros Comment, Descriptione Value.

Para agrupar por parâmetros adicionais, clique e mantenha pressionado o nome de uma coluna na lista Columns(na parte inferior direita da caixa de diálogo), arraste-o e solte-o na seção Drag a column to group. Clique no ícone de exclusão ( ) ao lado de cada nome de coluna para remover esse parâmetro dos critérios de agrupamento.

Ative a opção Show de uma coluna para incluir esses dados na BOM.Ative a opção Show de uma coluna para incluir esses dados na BOM.

Configuração do layout dos itens da BOM

Cada coluna ativada listará informações de cada um dos componentes encontrados nos documentos de origem, quando essas informações existirem. Se o componente não tiver informações para determinada propriedade/parâmetro, o campo ficará em branco.

Seleção das colunas visíveis

Para escolher quais colunas mostrar ou ocultar na área da grade da caixa de diálogo Report Manager, use a aba Colunas do painel Propertiesà direita da caixa de diálogo. Você também pode usar a caixa de diálogo Select columns, acessada clicando com o botão direito no cabeçalho de uma coluna na área principal da grade e, em seguida, escolhendo Select Columns.

A caixa de diálogo Select columns
A caixa de diálogo Select columns

Alteração da ordem das colunas

A ordem das colunas na região de dados da caixa de diálogo pode ser alterada clicando e arrastando o cabeçalho de uma coluna para uma nova posição, conforme necessário. Ao mover o cabeçalho de uma coluna, os locais válidos para soltá-lo são indicados por duas setas brancas verticais.

Ajuste da largura das colunas

Se nem todos os dados forem exibidos em uma determinada coluna, arraste o separador correspondente para alargá-la ou use o comando Best Fit do menu de contexto. Esse comando ajusta a largura da coluna de acordo com a entrada de campo mais longa (ou o comprimento do texto do cabeçalho) dessa coluna. Para redimensionar todas as colunas de modo que comportem a entrada de campo mais longa (ou o comprimento do texto do cabeçalho), use o comando Best Fit all Columns .

Classificação dos dados nas colunas

Os dados de qualquer coluna podem ser classificados em ordem crescente ou decrescente clicando no cabeçalho da coluna (longe do ícone de filtro). Observe que todas as colunas serão afetadas, mas as linhas serão classificadas de acordo com a coluna em que você clicou. A classificação por várias colunas também é compatível; mantenha a tecla Shift pressionada ao clicar nos cabeçalhos de outras colunas para aplicar uma classificação secundária por essa segunda coluna.

Filtragem personalizada

Em alguns casos, pode ser necessário excluir determinadas peças do relatório da BOM, como marcas fiduciais, ou talvez seja necessário listar um conjunto específico de componentes com um determinado prefixo de designador e/ou footprint. Para isso, a caixa de diálogo permite aplicar filtros personalizados, oferecendo controle total sobre o conteúdo da BOM.

Para aplicar um filtro, clique no ícone de filtro ( ), localizado à direita do cabeçalho de cada coluna. Observe que o menu exibido lista todas as entradas individuais das linhas para uma filtragem seletiva rápida. Você também pode selecionar a entrada (Custom…) para acessar a caixa de diálogo Filter Editor. Use essa caixa de diálogo para criar o filtro, que pode se basear nos valores de qualquer coluna. Consulte a página Caixa de diálogo Filter Editor para obter mais informações.

Depois que um filtro é aplicado, o ícone de filtro fica azul ( ) para indicar que a filtragem personalizada está ativa nessa coluna. O filtro aplicado no momento é mostrado no canto inferior esquerdo da região de dados e pode ser editado novamente clicando no ícone de lápis, conforme mostrado abaixo.

Um exemplo de uso da filtragem personalizada.Um exemplo de uso da filtragem personalizada.

Para remover o filtro aplicado ao conjunto de dados, clique no pequeno “x” (Clear Filter) à direita da expressão do filtro, na parte inferior da região de dados.

Onde o layout é armazenado

O layout definido no Report Manager é armazenado para que possa ser reaplicado na próxima vez que a caixa de diálogo for aberta. O local de armazenamento do layout varia conforme a origem das informações da BOM usadas pelo Report Manager e o local de onde o Report Manager é aberto.

  • Se a origem do Report Manager for um BomDoc do ActiveBOM: o layout atual definido no BomDoc será transferido para o Report Manager sempre que ele for aberto. As alterações de layout feitas no Report Manager não são mantidas; use o recurso BOM Sets do ActiveBOM para configurar layouts de relatório específicos.
  • Se a origem do Report Manager for o projeto (ou a PCB):
    • E o Report Manager for aberto pelo menu Reports do editor de esquemáticos ou de PCB, o layout do Report Manager será armazenado no arquivo do projeto.
    • E o Report Manager for aberto a partir de um OutputJob, o layout do Report Manager será armazenado no arquivo OutJob. Isso permite que o OutJob seja transferido de um projeto para outro.

Inclusão de informações adicionais diretamente na BOM

Tradicionalmente, as informações de origem de uma lista de materiais eram obtidas das propriedades dos componentes posicionados no projeto. Isso pode resultar em uma grande quantidade de informações associadas a um esquemático que são usadas apenas para a BOM.

Além das informações derivadas dos componentes do esquemático, o Report Manager também pode extrair informações de fontes de dados conectadas, incluindo:

um Workspace (para componentes da biblioteca do Workspace)

os Altium Cloud Services (para componentes posicionados a partir do painel Manufacturer Part Search)

um banco de dados, para componentes vinculados a esse banco de dados

a PCB

os parâmetros do documento esquemático

Habilite o Sources necessário na aba Columns do Report Manager e, em seguida, habilite os parâmetros necessários na lista Columns.

Para agrupar os parâmetros na lista Columns por origem, clique na seção sem rótulo do cabeçalho Data Source, conforme mostrado abaixo.

Inclusão de informações do banco de dados

Tradicionalmente, as informações de origem de uma lista de materiais (BOM) eram obtidas dos parâmetros dos componentes posicionados no projeto. No entanto, isso pode resultar em uma grande quantidade de informações associadas a um esquemático que são usadas apenas para a BOM. Se os componentes estiverem vinculados a um banco de dados externo por meio de um arquivo de biblioteca de banco de dados, o Report Manager poderá extrair diretamente desse banco de dados quaisquer outras informações dos registros que não tenham sido adicionadas aos componentes como parâmetros de projeto. Clique no botão na região Sources da aba Columns para habilitar bancos de dados como fonte. Essa opção só estará disponível se um ou mais componentes do projeto estiverem vinculados a um banco de dados externo.

Os parâmetros de banco de dados podem ser incluídos a partir de um banco de dados externo, independentemente do método utilizado para estabelecer o vínculo com esse banco de dados: *.DbLib, *.SVNDbLib ou *.DbLink. Procure o ícone na lista Columns para identificar um parâmetro existente no banco de dados externo vinculado para um ou mais componentes posicionados e que pode ser incluído na BOM. Clique no ícone de visibilidade para que ele se torne um olho (), incluindo assim essa coluna (parâmetro) na BOM.

Inclua informações adicionais de componentes que existem apenas em um banco de dados externo.
Inclua informações adicionais de componentes que existem apenas em um banco de dados externo.

Em um projeto que inclui Variantes, os parâmetros usados para consultar o banco de dados são alterados na caixa de diálogo Variant Management. Como esses valores de parâmetros existem apenas na caixa de diálogo Variant Management, eles só são usados para consultar e encontrar registros correspondentes no banco de dados quando uma BOM está sendo configurada para geração. Para isso, certifique-se de que a subopção - Include DB Parameters in Variations - esteja habilitada na aba General das propriedades do Report Manager.

Inclusão de informações da PCB

As informações de origem de uma lista de materiais podem incluir informações de propriedades extraídas da PCB, caso o projetista precise personalizar e usar a geração de relatórios para uma BOM com finalidade específica. Um exemplo seria a geração de um arquivo de pick and place, em que o operador da máquina de montagem deseja obter dados da PCB (como as coordenadas X e Y), juntamente com outros parâmetros específicos dos componentes, organizados em uma ordem específica de colunas e em um formato de arquivo específico.

Clique no botão na região Sources da aba Columns para habilitar a PCB como fonte. Essa opção só estará disponível se houver um documento PCB no arquivo do projeto. Se o projeto incluir vários documentos PCB, a caixa de diálogo Choose PCB to Use será exibida.

Escolha qual PCB usar como fonte para a BOM.Escolha qual PCB usar como fonte para a BOM.

Para alternar para outro documento PCB, clique no botão na região Sources para desabilitar essa PCB como fonte e, em seguida, clique nele novamente para reabrir a caixa de diálogo Choose PCB to Use e selecionar outra PCB.

Inclusão de dados de fornecedores na BOM

Poder calcular o custo de um projeto e determinar as quantidades de componentes a serem encomendadas de fornecedores/distribuidores é uma parte essencial do processo de projeto como um todo. Se os componentes do projeto tiverem sido inseridos a partir de um Workspace (e tiverem opções de peças definidas) ou do painel Manufacturer Part Search, esses componentes incluirão vínculos com a cadeia de suprimentos. Se tiverem vínculos com a cadeia de suprimentos, os dados dos fornecedores vinculados — incluindo informações de preços e estoque — poderão ser incluídos na lista de materiais no momento da liberação do projeto, habilitando as colunas de parâmetros apropriadas.

Os dados de fornecedores só estão disponíveis ao gerar uma lista de materiais para o projeto. Eles não estão disponíveis ao gerar uma lista de materiais para um documento PCB e também não são incluídos ao gerar uma BOM simples.

Os seguintes dados de fornecedores podem ser incluídos em uma lista de materiais marcando a caixa de seleção de cada item desejado na região Columns:

  • Manufacturer n - nome do fabricante.
  • Manufacturer Lifecycle n - status do ciclo de vida do fabricante, se disponível.
  • Manufacturer Part Number n - código da peça do fabricante.
  • Supplier n - nome do fornecedor.
  • Supplier Currency n – código alfabético da moeda escolhida para os dados de preços.
  • Supplier Order Qty n – o maior valor entre: (Quantity do item * Production Qty) ou Minimum Order Qty (MOQ)
  • Supplier Part Number n – código da peça do item do fornecedor.
  • Supplier Stock n – quantas unidades do item o fornecedor tem em estoque.
  • Supplier Subtotal per Board n – Supplier Unit Price multiplicado por Quantity do item, resultando no subtotal desse item. Observe que esse valor não considera a MOQ.
  • Supplier Subtotal n – Supplier Unit Price multiplicado por Supplier Order Quantity, resultando no subtotal desse item considerando a MOQ.
  • Supplier Unit Price n – custo por unidade do item do fornecedor (sem considerar qualquer MOQ).
A BOM usa conjuntos indexados de dados relacionados a fornecedores para contemplar componentes que têm mais de um item de fornecedor vinculado, por exemplo, Supplier 1, Supplier Currency 1 etc., Supplier 2, Supplier Currency 2 etc., e assim por diante.

As informações de preços e estoque são obtidas diretamente dos provedores de peças habilitados. Adicionar esses parâmetros aos componentes não afeta o preenchimento dos dados na BOM.

Para saber mais, consulte a página Vinculação a dados da cadeia de suprimentos de peças.

Especificação da quantidade de produção

Você pode calcular o custo total de um projeto com base no número de unidades do produto que se pretende produzir, ou seja, a Production Quantity. Use o campo Production Quantity na região Supply Chain de Report Manager para especificar o valor necessário. É importante definir esse campo, pois ele é usado durante a pesquisa na cadeia de suprimentos para verificar a disponibilidade dos componentes e também o preço por unidade para as faixas de desconto por quantidade disponíveis dos fornecedores.

O valor inserido no campo Production Quantity é usado para determinar a Supplier Order Qty – a quantidade do componente que precisaria ser encomendada para produzir a quantidade especificada do produto. Ela é calculada multiplicando Quantity (de cada componente específico) pela Production Quantity especificada. Observe que, para componentes que têm uma quantidade mínima de pedido (MOQ), a quantidade a encomendar do fornecedor é o maior valor entre: (Quantity do item * Production Qty) ou Minimum Order Qty (MOQ).

Por sua vez, a Supplier Order Qty é usada para determinar o Supplier Unit Price aplicável. Lembre-se de que os fornecedores normalmente oferecem vários níveis de preços por quantidade (faixas de desconto), dependendo de quantas unidades de um item são compradas.

Alteração da moeda do fornecedor

A moeda usada para os dados relacionados a preços em uma lista de materiais pode ser especificada entre as moedas compatíveis. Escolha a moeda desejada na região Supply Chain de Report Manager. . A moeda escolhida afetará as seguintes colunas de dados, que também podem ser incluídas na BOM:

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

Escolha uma opção na lista de moedas compatíveis ao incluir dados de preços em uma lista de materiais.Escolha uma opção na lista de moedas compatíveis ao incluir dados de preços em uma lista de materiais.

Uso de dados de preços em cache nos parâmetros da BOM ao trabalhar offline

Ao trabalhar online (conectado à internet e com uma sessão iniciada em uma conta Altium Live), os dados de preços dos componentes com vínculos ativos com dados de fornecedores serão atualizados. Ao gerar uma BOM, serão usados os preços mais recentes disponíveis naquele momento. Para moedas específicas, as taxas de câmbio são atualizadas diariamente.

Ao trabalhar offline, você pode usar os últimos dados de preços armazenados em cache nos parâmetros de preços da BOM. Para fazer isso a partir de Report Manager, clique no botão Cached na região Supply Chain Data da caixa de diálogo.

Suporte a variantes

Se houver variantes definidas para o projeto, você poderá gerar uma lista de materiais com base em uma variante escolhida.

Para isso, selecione a variante desejada na lista suspensa de variantes disponível na parte superior da caixa de diálogo Report Manager. O banner Report Manager indicará a variante selecionada no momento.

Baseie o relatório da BOM em uma variante específica; o banner da caixa de diálogo mostra qual variante está sendo usada no momento.Baseie o relatório da BOM em uma variante específica; o banner da caixa de diálogo mostra qual variante está sendo usada no momento.

Volte a usar o projeto base escolhendo a opção [No Variations] na lista suspensa.

A região de dados da caixa de diálogo será atualizada de acordo:

  • Os componentes definidos como Not Fitted para a variante escolhida serão removidos, a menos que a opção Show Not Fitted esteja habilitada.
  • Os valores dos parâmetros serão atualizados com os da variante escolhida nos casos em que forem diferentes dos valores do projeto base.

Para manter na BOM os componentes que são Not Fitted e marcá-los explicitamente como tal, habilite a opção Show Not Fitted e também a coluna Fitted na aba Columns da caixa de diálogo. Para cada componente, uma entrada nessa coluna indica se ele é Fitted ou Not Fitted para a variante escolhida. O valor inserido na coluna Quantity para um componente que é Not Fitted na variante escolhida é zero (0).

Suporte a variantes quando a fonte é um BomDoc

Se o Report Manager estiver usando um BomDoc como fonte, será possível gerar uma única BOM para todas as variantes. Isso é chamado de BOM consolidada; para exibi-la, defina View Mode como Consolidated View.

Duas colunas adicionais específicas de variante são exibidas automaticamente para cada variante:

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

Essas colunas específicas de variantes recebem automaticamente nomes de alias, no formato <VariantName> - Qty e <VariantName> - Price.

Exportação da BOM

Depois que o conteúdo da BOM estiver definido e organizado conforme necessário, o relatório poderá ser gerado — impresso ou exportado para um dos vários formatos de arquivo.

Os controles para exportar os dados da BOM estão localizados na região Export Options do Report Manager.

Para exportar a lista de materiais, execute as seguintes etapas:

  1. Use o menu suspenso File Format para escolher o formato de exportação dos dados da BOM. Os seguintes formatos são compatíveis:

    • CSV (delimitado por vírgulas) (*.csv)

    • Texto delimitado por tabulações (*.txt)

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

    • XLS genérico (*.xls, *.xlsx) (usa um gerador de arquivos no formato XLS integrado, permitindo gerar esse formato sem ter o Microsoft Excel instalado)

    • Portable Document Format (*.pdf)

    • Página da Web (*.htm, *.html)

    • Planilha XML (*.xml)

  2. Se o formato de exportação for Excel, um modelo do Excel poderá ser aplicado aos dados exportados.

    Consulte a seção Disponibilização de um modelo de BOM baseado no Excel para uso abaixo para saber como disponibilizar um modelo de BOM no seu Workspace.

    Um modelo de BOM do Workspace também pode ser usado como um item de dados de configuração em uma ou mais Environment Configurations definidas. Uma configuração de ambiente é usada para restringir o ambiente de trabalho de um projetista ao uso exclusivo de elementos de projeto aprovados pela empresa. As configurações de ambiente são definidas e armazenadas no Team Configuration Center — um serviço fornecido pelo Workspace. Depois que você se conectar ao Workspace e escolher (se aplicável) uma das configurações de ambiente disponíveis, o Altium Designer será configurado quanto ao uso de modelos de BOM. Se a configuração de ambiente escolhida tiver um ou mais modelos de BOM definidos, only esses modelos definidos poderão ser usados. Se a configuração de ambiente escolhida aplicável a você não tiver nenhum modelo de BOM especificado/adicionado, ou estiver definida como Do Not Control, eles continuarão podendo ser definidos manualmente. Em outras palavras, você poderá usar modelos locais baseados em arquivos. Para obter mais informações, consulte Environment Configuration Management (Workspace do Altium 365, Workspace do Enterprise Server).

  3. Para abrir o arquivo exportado no aplicativo associado, habilite a opção Open Exported.

  4. Para adicionar o relatório gerado ao projeto após sua criação, habilite a opção Add to Project.

  5. Habilite a opção Report BOM Violations in Messages para executar uma verificação do ActiveBOM durante a geração da BOM. As violações detectadas serão detalhadas no painel Messages.

  6. Clique no botão Export e use a caixa de diálogo exibida para especificar onde e com qual nome o relatório da BOM será salvo. Clique em Save para criar a exportação.

Vários modelos de exemplo são fornecidos com o Altium Designer na pasta \Templates dos arquivos de usuário da instalação.

Mapeamento de dados do projeto para a BOM

Uma abordagem comum para a geração da BOM é exportar os dados da BOM do Altium Designer para uma planilha no formato Excel preferido pela empresa. Os dados do Altium Designer são mapeados para a planilha por meio da inclusão de instruções especiais Field e Column no modelo do Excel. Isso pode ser usado para especificar o layout desejado. A instrução Field é usada para mapear um único parâmetro, por exemplo, um parâmetro de documento chamado Title. A instrução Column é usada para mapear parâmetros por componente, por exemplo, o parâmetro de componente Designator.

Campos

A instrução Field é usada para mapear um parâmetro de documento ou de projeto (são aceitos parâmetros de projeto locais e do Workspace), por exemplo, Title, para a BOM. A declaração Field é substituída pelo valor passado, conforme mostrado nas imagens abaixo.

Os campos são usados no formato:

Field=<FieldName>

Um exemplo é Field=Currency

Os campos devem ser definidos acima ou abaixo da região Column do modelo.

Colunas

As declarações Column são usadas para mapear parâmetros por componente, por exemplo, o Designator, o Description, os parâmetros definidos pelo usuário de cada componente e assim por diante. Isso também pode incluir: números de linha, dados de localização na PCB e dados de colunas personalizadas inseridos no BomDoc, caso haja um BomDoc no projeto. A declaração Column no modelo é substituída pela string ColumnName, e cada linha abaixo é preenchida com o valor dessa coluna para cada item da BOM, conforme mostrado nas duas imagens abaixo.

As colunas são usadas no formato:

Column=<ColumnName>

Um exemplo é Column=Designator

Observações:

  • Cada coluna definida no modelo deve ser exibida no Report Manager para que os dados dessa coluna sejam transferidos. Por exemplo, nas imagens abaixo, a coluna Line # é exibida no Report Manager e, portanto, pode ser incluída na BOM (usando a sintaxe Column=Line #). Observe que a coluna Line # só está disponível como uma coluna configurável pelo usuário ao gerar relatórios a partir de um BomDoc do ActiveBOM.
  • Os dados serão apresentados na planilha do Excel na mesma ordem de linhas do Report Manager. Use o recurso de classificação e subclassificação de colunas do Report Manager's para ordenar as linhas conforme necessário.

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

  • Modelos de exemplo estão incluídos na pasta \Templates dos arquivos de usuário da instalação.

  • Os modelos disponíveis são configurados na página Data Management - Templates da caixa de diálogo Preferences.

  • O local padrão para modelos não gerenciados (locais) é configurado no campo Local Templates folder dessa página na caixa de diálogo Preferences.

  • Para um projeto gerenciado, os modelos disponíveis (do servidor) são armazenados na pasta \Templates\BOM Templates do seu Altium Workspace (servidor de conteúdo gerenciado). Eles só são listados na caixa de diálogo Preferences quando você está conectado a um Workspace.

  • A lista de modelos disponíveis no menu suspenso Report Manager Template se baseia na configuração atual dos modelos na caixa de diálogo Preferences. Certifique-se de que a opção Templates visibility esteja configurada para atender às suas necessidades.

  • Os modelos do Excel permitem ocultar linhas ou colunas. Esse recurso foi usado em alguns dos modelos de exemplo para ocultar as declarações Column = <ColumnName>. Para exibir linhas ou colunas ocultas no Excel, selecione todas as células do modelo, clique com o botão direito do mouse em qualquer lugar da planilha e escolha o comando Unhide (mostrar imagem).

Mapeamento de informações de nível de projeto no cabeçalho da BOM

As informações de nível de projeto normalmente são mapeadas usando a instrução Field= no cabeçalho do documento da BOM.

Mapeamento de parâmetros de documento e de projeto

Além das instruções Field listadas acima, os parâmetros de documento esquemático (tanto os parâmetros padrão quanto os definidos pelo usuário inseridos no painel Properties do documento esquemático) e os parâmetros de projeto (caixa de diálogo Options for PCB Project) também podem ser usados como campos ou como colunas.

Mapeamento das informações dos itens da BOM

A região principal de uma BOM é a grade de itens da BOM, que normalmente usa uma linha para cada componente. Cada coluna dessa grade representa uma propriedade do componente, como o designador, o valor e assim por diante. As colunas são definidas inserindo a propriedade/o parâmetro do componente (cabeçalho da coluna da BOM), no formato:

Column=ColumnName

Um exemplo seria Column=Description, ou Column=Designator

As informações das colunas podem ser obtidas de várias fontes, incluindo:

Disponibilização de um modelo de BOM baseado em Excel para uso

Um modelo de BOM baseado em Excel (preparado conforme descrito na seção Mapeamento de dados de projeto na BOM acima) pode ser disponibilizado para uso ao preparar uma BOM para exportação, carregando o arquivo de modelo do Excel correspondente (*.xls, *.xlsx, *.xlt, *.xltx) no seu Workspace. Para isso, abra a guia Templates da página Data Management – Templates da caixa de diálogo Preferences e selecione o comando BOM ou Load from File no menu do botão Add ou no menu de contexto Add da grade de modelos. Na caixa de diálogo Open que se abre (uma caixa de diálogo padrão do Windows para abertura de arquivos), selecione a opção Microsoft Excel File (*.xlt;*.xltx;*.xltm;*.xls;*.xlsx;*.xlsm) na lista suspensa à direita do campo File name e use a caixa de diálogo para localizar e abrir o arquivo desejado, que será carregado na revisão inicial do novo modelo de BOM do Workspace, criado automaticamente em uma pasta do Workspace do tipo BOM Templates.

Se o arquivo de modelo do Excel desejado estiver em Local Template folder (definido na parte inferior da página Data Management – Templates da caixa de diálogo Preferences) e estiver listado na entrada Local da grade de modelos, ele poderá ser migrado para um novo modelo de BOM do Workspace clicando nele com o botão direito do mouse e selecionando o comando Migrate to Server. Clique no botão OK na caixa de diálogo Template migration para prosseguir com o processo de migração — conforme indicado nessa caixa de diálogo, o arquivo de modelo do Excel original será adicionado a um arquivo Zip na pasta local de modelos (e, portanto, não ficará visível na lista de modelos Local).

Se precisar alterar o modelo do Excel armazenado em um modelo de BOM do Workspace, carregue o novo arquivo do Excel desejado nesse modelo do Workspace. Na guia Templates da página Data Management – Templates da caixa de diálogo Preferences, clique com o botão direito na entrada do modelo e escolha o comando Upload no menu de contexto. Na caixa de diálogo Open, localize e selecione o arquivo desejado. O novo modelo será armazenado na próxima revisão desse modelo do Workspace.

  • Para abrir o arquivo de modelo de BOM do Excel armazenado em uma revisão de um modelo de BOM do Workspace, navegue até essa revisão no painel Explorer e selecione o arquivo na guia de visualização Details da revisão. Em seguida, clique com o botão direito e escolha o comando Open no menu de contexto. O arquivo será aberto no Excel, se estiver instalado.
  • Para baixar o arquivo de modelo de BOM do Excel armazenado em uma revisão de um modelo de BOM do Workspace, navegue até essa revisão no painel Explorer e selecione o arquivo na guia de visualização Details da revisão. Em seguida, clique com o botão direito e escolha o comando Download no menu de contexto. Na caixa de diálogo Choose destination folder exibida em seguida, indique a pasta de destino para receber o arquivo.

Geração da BOM a partir de um Output Job

Uma lista de materiais também pode ser configurada e gerada como parte de um arquivo de configuração de Output Job (*.OutJob). Adicione um Output Job ao projeto pelo menu New ou clique com o botão direito no projeto no painel Projects.

Para adicionar um gerador de saída de BOM a um arquivo de Output Job aberto, clique em Add New Report Output na categoria Report Outputs e escolha Bill of Materials no menu pop-up. Um segundo menu permite especificar a fonte de dados (quais documentos de origem serão usados quando o relatório de BOM for gerado). Somente as fontes de dados aplicáveis ficam disponíveis, reduzindo a possibilidade de erros.

A fonte de dados de uma BOM pode ser um único documento esquemático de origem específico, o documento de projeto da PCB, todos os documentos esquemáticos de origem (a entrada [Project]) ou um documento ActiveBOM.

Após adicioná-la, clique duas vezes na nova entrada para acessar o Report Manager e personalizar a BOM conforme descrito neste documento. Depois de configurar o gerador de saída, vincule-o aos contêineres de saída correspondentes. Um relatório de BOM pode ser gerado como arquivo ou publicado em PDF. Ele também pode ser impresso por envio direto a um dispositivo de impressão, como cópia impressa (por meio de um trabalho de impressão configurado).

Habilite a saída para o contêiner de saída selecionado e clique em Change para configurá-la, deixando tudo pronto para gerar um relatório de BOM a partir de um arquivo de Output Job.Habilite a saída para o contêiner de saída selecionado e clique em Change para configurá-la, deixando tudo pronto para gerar um relatório de BOM a partir de um arquivo de Output Job.

As configurações definidas no Report Manager ao gerar uma BOM a partir do esquemático ou da PCB são armazenadas no arquivo do projeto e são distintas daquelas definidas para os mesmos tipos de saída em um arquivo de Output Job. Embora a geração a partir do editor de origem possa ser útil para testes rápidos, o arquivo de Output Job oferece uma solução portátil que pode ser usada em vários projetos sem precisar configurar repetidamente sua personalização preferida de BOM.
Para uma análise detalhada dos arquivos de Output Job, incluindo todos os aspectos de sua configuração e operação, consulte a página Preparação de dados de fabricação com Output Jobs.

Publicação em PDF com base em um modelo do Excel

A partir de um arquivo de Output Job, o relatório de BOM também pode ser publicado em formato PDF com base em um modelo do Excel especificado, seguindo estas etapas:

  • Ao configurar o gerador de saída de BOM:
    • Defina o File Format na região Export Options como Planilha do Microsoft Excel (*.xls, *.xlsx, *.xlt, *.xltx).
    • Especifique o modelo do Excel desejado usando o campo Template na região Excel Options.
  • Vincule o gerador de saída de BOM ao contêiner de saída PDF desejado (e configurado), conforme mostrado na imagem acima. As seguintes regras são aplicadas para determinar o tamanho da planilha a ser impressa em PDF:
    • As células à direita do cabeçalho de coluna mais à direita não são incluídas na saída.
    • As células abaixo da última célula com texto não são incluídas, a menos que contenham bordas horizontais e/ou cores de fundo e não estejam separadas da seção principal da BOM por mais de dez linhas em branco.

Preparação de um relatório de referência cruzada de componentes

O relatório de referência cruzada de componentes é uma lista de componentes baseada na folha esquemática em que eles se encontram no projeto. Selecione Reports » Component Cross Reference em um documento esquemático ou clique duas vezes em um relatório de referência cruzada de componentes adicionado a um OutJob para acessar a caixa de diálogo Component Cross Reference Report, na qual o relatório pode ser configurado.

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.

Contents