Altium NEXUS Documentation

Включение проектных данных в BOM формата Excel_AD

Created: 25.05.2021 | Updated: 17.06.2021

Распространенным подходом к формированию BOM является экспорт данных BOM из Altium NEXUS в электронную таблицу формата Excel. Формирование BOM осуществляется из Report Manager, который можно открыть из следующих расположений:

  • Меню Report редактора ActiveBOM
  • Меню Report редактора схем или плат
  • Выходной отчет BOM, настроенный в файле OutputJob
  • Узнайте больше о Настройке BOM в менеджере отчетов.
  • Для полного контроля над процессом формирования BOM, в том числе для интерактивного представления информации о цепочке поставок, а также пользовательских строк и столбцов BOM, добавьте в проект документ ActiveBOM (BomDoc). Документ BomDoc позволяет быстро увидеть данные о цепочке поставок компонентов, и он также поддерживает заданные пользователем строки и столбцы, что идеально подходит для включения таких дополнительных объектов, как клей, наклейки и т.п. Создание BOM и управление им с помощью документа BomDoc является рекомендуемым подходом к управлению составом изделия в Altium NEXUS.

Раздел Export Options в Report Manager включает в себя два варианта формата файла XLS в меню File Format:

  • MS-Excel (*.xls, *.xlsx) – использует Microsoft Excel
  • Generic XLS (*.xls, *.xlsx) – использует встроенный генератор файлов формата XLS, Microsoft Excel не требуется

Выберите нужный формат файла Excel и нужный шаблон Excel

Когда выбрана одна из опций формата Excel, в выпадающем списке Template может быть выбран предварительно определенный шаблон Excel. При нажатии в Report Manager кнопки Export данные BOM формируются и выгружаются в новую книгу Excel с использованием формата, определенного в выбранном шаблоне Excel.

Источник списка шаблонов, доступных в выпадающем списке, зависит от следующего:

  • Для неуправляемого проекта – расположение по умолчанию настраивается на странице Data Management - Templates диалогового окна Preferences. Несколько примеров шаблонов доступно в папке \Templates пользовательских файлов установки.
  • Для управляемого проекта – доступные шаблоны хранятся в папке \Templates\BOM Templates вашего сервера управляемых данных.

Передача проектных данных в шаблон Excel

Данные Altium NEXUS передаются в электронную таблицу путем включения объявлений Field и Column в шаблон Excel. Объявление Field используется для передачи одного параметра, например параметра Title документа. Объявление Column используется для передачи параметров компонентов, например параметра Designator компонента.

Поля

Объявление поля используется для передачи в BOM параметра документа или проекта, например Title. Объявление поля заменяется переданным значением, как показано на изображении ниже.

Поля используются в формате:

Field=<ИмяПоля>

Пример: Field=Currency

Поля должны быть определены выше или ниже раздела столбцов шаблона.

Столбцы

Объявления столбцов используются для передачи параметров компонентов, например параметров Designator и Description компонентов, пользовательских параметров и т.д. Также это могут быть: номера строк, координаты на плате, данные пользовательских столбцов, введенные в документе BomDoc, если он присутствует в проекте. Объявление столбца в шаблоне заменяется строкой названия столбца, и в каждую строку под ним передается значение столбца из каждого объекта BOM, как показано на двух изображениях ниже.

Столбцы используются в формате:

Column=<ИмяСтолбца>

Пример: Column=Designator

Примечания:

  • Для передачи данных столбцов, определенных в шаблоне, они должны быть отображены в Report Manager.
  • Данные будут представлены в таблице Excel в том же порядке строк, что и в Report Manager. Используйте возможности сортировки в Report Manager для сортировки строк нужным образом.

Пример простого шаблона Excel, показывающий, как проектные параметры передаются в шаблон

Пример BOM, созданного из простого шаблона Excel, который показана на предыдущем изображении

  • В Altium NEXUS включено несколько примеров шаблонов. Они находятся в папке \Templates пользовательских файлов установки.
  • Расположение шаблонов по умолчанию для неуправляемого проекта настраивается на странице Data Management - Templates диалогового окна Preferences.
  • Для управляемого проекта, доступные шаблоны хранятся в папке \Templates\BOM Templates вашего сервера управляемых данных.
Шаблоны Excel поддерживают скрытые строки или столбцы. Эту возможность используется в определенных версиях образцов шаблонов, включенных в системы, для скрытия объявлений Column = <ИмяСтолбца>. Для отображения всех строк или столбцов в Excel выделите все ячейки в шаблоне, щелкните ПКМ где-либо на листе и выберите команду Unhide.

Передача информации уровня проекта в шапку BOM

Информация уровня проекта, как правило, передается в шапку документа BOM с помощью объявления Field=.

Поле Описание
Currency Валюта, которая была выбрана в разделе Supplier Options диалогового окна Report Manager.
DataSourceFileName Имя файла источника, используемого для данных BOM.
DataSourceFullPath Полный путь + имя файла источника, используемого для данных BOM.
GeneratorDescription Для BOM это поле отображает Bill of Materials.
GeneratorName Название генератора – BOM при формировании выходного документа через Report Manager.
OutputName Название BOM, как оно отображено в Report Manager (кроме текста "For BOM Document [<DataSourceFileName>]").
OutputType Для BOM это поле отображает BOM_PartType.
PCBDataSourceFileName Имя файла источника данных платы.
ProductionQuantity Объем продукции, определенный в диалоговом окне Report Manager.
ProjectFileName Имя файла PrjPcb (с расширением файла).
ProjectFullPath Полный путь + имя файла проекта.
ReportDate Дата создания отчета.
ReportDateTime Дата и время создания отчета.
ReportTime Время создания отчета.
TotalQuantity Сумма значений в столбце Quantity объектов BOM.
Title Заголовок, отображенный вверху диалогового окна BOM Reports.
VariantName Название варианта, заданное в диалоговом окне Variant Management.
VersionControl_RevNumber Текущая ревизия документа BomDoc.
VersionControl_ProjFolderRevNumber Текущая ревизия проекта (увеличивается при выполнении фиксации всего проекта).
<ПользовательскийПараметрПроекта_n> Отображает значение, назначенное пользовательскому параметру ПользовательскийПараметрПроекта-n.

Передача параметров документа и проекта

Помимо объявлений полей, приведенных выше, в качестве полей и столбцов могут использоваться параметры документа схемы (как по умолчанию, так и заданные пользователем параметры, добавленные в панели Properties документа схемы) и параметры проекта (диалоговое окно Options for PCB Project).

Address1 Address2 Address3
Address4 ApprovedBy Author
CheckedBy CompanyName ConfigurationParameters
CurrentDate CurrentTime Date
DocumentFullPathAndName DocumentName DocumentNumber
DrawnBy Engineer ImagePath
Index ModifiedDate Organization
Revision Rule SheetNumber
SheetTotal Time  
Если один и тот же параметр существует как параметр документа и параметр проекта, приоритет будет у параметра проекта. Если один и тот же параметр документа существует во множестве документов, приоритет будет у параметра документа, который находится выше в иерархии проекта.

 

Передача информации объекта BOM

Основной областью BOM является таблица объектов BOM, где каждый компонент обычно отображается в отдельной строке. Каждый столбец в таблице представляет свойства компонентов, такие как позиционные обозначения, номиналы и т.д. Столбцы определяются путем ввода свойства/параметра компонента (заголовка столбца BOM) в формате:

Column=ИмяСтолбца

Примеры: Column=Description, Column=Designator

Информация для столбца может быть взята из различных источников, в том числе:

Эти имена столбцов доступны для всех компонентов.

Comment ComponentKind Description
Designator DesignItemId Footprint
LibRef LogicalDesignator PartType
PhysicalPath Quantity UniqueIdName
UniqueIdPath <ПользовательскийПараметр_n>  

Также может быть включена информация о положении компонента на плате. Для использования этих столбцов, в диалоговом окне Report Manager должна быть включена опция Include Parameters From PCB.

Center-X(Mil) Center-Y(Mil) Center-X(mm) Center-Y(mm)
Pad-X(Mil) Pad-Y(Mil) Pad-X(mm) Pad-Y(mm)
Ref-X(Mil) Ref-Y(Mil) Ref-X(mm) Ref-Y(mm)
Layer Rotation    

Можно извлечь онлайн-данные от поставщиков и включить их в BOM. Обратите внимание, что эти данные обновляются динамически, и они извлекаются при формировании BOM. Для каждого компонента может быть задано множество поставщиков. В таблице ниже они описаны как Информация от поставщика x – замените x подходящим числом.

Manufacturer x Manufacturer Part Number x Supplier x
Supplier Currency x Supplier Order Qty x Supplier Part Number x
Supplier Stock x Supplier Subtotal x Supplier Unit Price x

Добавление пользовательских столбцов осуществляется таким же образом:

Column=ИмяСтолбца

Обнаружили проблему в этом документе? Выделите область и нажмите Ctrl+Enter, чтобы оповестить нас.

Связаться с нами

Связаться с нашими Представительствами напрямую

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
Вы сообщаете о проблеме, связанной со следующим выделенным текстом
и/или изображением в активном документе: