Importing Existing Libraries to Your Connected Workspace

Altium Designer в сочетании с вашим connected Workspace предоставляет упрощённый и в высокой степени автоматизированный процесс, позволяющий быстро импортировать существующие библиотеки в этот Workspace. Интерфейс этого процесса – Library Importer – предлагает решение «в один клик», которое автоматически анализирует выбранные библиотеки и импортирует их в Workspace, к которому вы в данный момент подключены.

Поддерживая все типы библиотек, относящиеся к более старым методологиям управления компонентами (SchLib, PcbLib, IntLib, DbLib, SVNDbLib), Library Importer является специализированным решением для быстрого построения корпоративной Workspace component library — чтобы вы могли воспользоваться её многочисленными преимуществами: централизованным хранением и управлением с высокой целостностью данных, удобством повторного использования в проектировании, информацией по цепочке поставок в реальном времени.

Library Importer предлагает минималистичный Simple режим интерфейса, в котором выбранные компонентные библиотеки на основе баз данных и файлов импортируются в компоненты Workspace за один шаг, при этом importer автоматически выполняет классификацию типов, выбирает целевую папку-источник, настраивает включение параметров и тип значений, а также переносит все релевантные данные. Интерфейс также доступен в режиме Advanced, который предоставляет полный предварительный просмотр предлагаемого импорта библиотеки и доступ к связанным данным и настройкам. И хотя по умолчанию импорт выполняется «в один клик», importer также предлагает расширенные параметры конфигурации через панель Properties panel для более точного контроля того, как именно выполняется импорт.

Что импортируется?

Вся информация, присутствующая в исходной библиотеке-источнике, импортируется в компоненты Workspace включая все ссылочные доменные модели (условные графические обозначения, посадочные места PCB, модели симуляции), параметрическую информацию, назначенные варианты Part Choices, файлы даташитов и т. д. При необходимости также создаются Component Templates, которые затем можно доработать и использовать для последующих импортов библиотек.

Если в исходных компонентах определено несколько посадочных мест PCB, Library Importer перенесёт эти модели и сохранит текущее посадочное место по умолчанию. А если вы работаете только с PCB-библиотеками — и вас интересует лишь разводка платы — то Library Importer поддерживает импорт только этих библиотек, либо его можно переключить в режим импорта только моделей, при котором указанные типы моделей импортируются из интегрированных или базовых библиотек. Библиотеки, включающие несколько типов компонентов (монолитные библиотеки), также автоматически обнаруживаются и обрабатываются.

Поскольку процесс импорта библиотек должен работать с источниками библиотек на основе баз данных и файлов, которые могут использовать различные стандарты форматирования, автоматизированные процедуры анализа определяют типы компонентов в исходной библиотеке (резистор, конденсатор и т. п.), а также имена параметров и типы их значений (Вольты, Омы и т. п.). Система выполняет и обрабатывает ряд проверок, например, чтобы гарантировать отсутствие дублирующихся ID у результирующих компонентов библиотеки Workspace, либо чтобы не создавались дублирующиеся модели или шаблоны компонентов, и чтобы такие сущности при необходимости переиспользовались (связывались) между компонентами. Если же возникают проблемы, система помечает их и предлагает способы решения, стремясь как можно быстрее и более плавно вернуть импорт в рабочее русло.

Типы библиотек, которые можно импортировать:

  • Библиотека схемных символов (*.SchLib).

  • Библиотека посадочных мест PCB (*.PcbLib).

  • Интегрированная библиотека (*.IntLib)

  • Библиотека базы данных (*.DbLib).

  • SVN-библиотека базы данных (*.SVNDbLib).

Импорт информации о сопоставлении выводов (для моделей симуляции) в настоящее время не поддерживается.

Доступ к Library Importer

Library Importer доступен, когда вы подключены к Workspace. Чтобы открыть importer в режиме Simple :

  • В панели Components panel выберите пункт Import Library в меню  . Если в столбце Categories панели (или в верхнем выпадающем меню, когда панель находится в компактном режиме) в данный момент выбрана библиотека на основе базы данных или файла, Library Importer откроется для этой библиотеки. Когда выбран тип компонента библиотеки Workspace, откроется стандартное диалоговое окно Windows Open для перехода к файлу библиотеки и выбора его для импорта.

    Библиотеки на основе баз данных и файлов, которые в данный момент доступны программному обеспечению, можно просматривать и управлять ими в диалоге Libraries Preferences dialog, который открывается через пункт Libraries Preferences в меню кнопки  в панели Components panel.

    Также вы можете просматривать и управлять установленными в данный момент файловыми библиотеками на странице Data Management – File-based Libraries page диалога Preferences.

  • Щёлкните правой кнопкой мыши по файлу библиотеки в панели Projects panel и выберите Import Library в контекстном меню.

  • Выберите Tools » Import Library в редакторе схемных символов или посадочных мест PCB, когда открыт локальный файл библиотеки.

  • Выберите File » Import Library или Tools » Import Library  в редакторе Database Library Editor.

  • В диалоге Libraries Preferences dialog выберите запись библиотеки на вкладке Installed и затем нажмите элемент управления Import .

  • Перетащите файл библиотеки из папки Windows в панель Explorer panel.

Режим Simple предоставляет варианты немедленного импорта выбранной библиотеки () или открытия Library Importer в полном режиме GUI ().

Library Importer при открытии в режиме импорта «в один клик» Simple.
Library Importer при открытии в режиме импорта «в один клик» Simple.

Чтобы напрямую открыть Library Importer в режиме интерфейса Advanced, выберите File » Library Importer в главном меню.

Library Importer при открытии в полном режиме интерфейса Advanced также поддерживает процесс импорта «в один клик».
Library Importer при открытии в полном режиме интерфейса Advanced также поддерживает процесс импорта «в один клик».

Режим Simple

В режиме Simple Library Importer заранее выбирает все аспекты процесса импорта на основе анализа исходной библиотеки и подключённого Workspace. Затем диалог Library Importer показывает сводку структуры импорта, включая общее количество для каждого типа элементов. Импорт библиотеки выполняется одним шагом командой .

Этот простой режим интерфейса подходит для большинства распространённых форматов исходных библиотек, которые обычно содержат типовые компоненты (резисторы, конденсаторы, микросхемы и т. п.) и стандартизированные значения параметров. В ходе первоначального анализа система определяет тип компонентов в библиотеке по ключевым словам в Designator или параметрах (LD?, LED и т. п.), затем находит соответствующий Component Template в целевом Workspace (LED). Этот Template применяется при импорте таких компонентов и задаёт настройки импорта, такие как целевая папка (Components/LED), сопоставление параметров, единицы значений параметров и т. д. — подходящие шаблоны доступны в Workspace, если при activation of an Altium 365 Workspace или installation of Altium On-Prem Enterprise Server была выбрана опция добавления примерных данных.

Результаты импорта библиотеки в виде вновь созданных компонентов Workspace можно увидеть как в панели Explorer, так и в панели Components. Импортированные компоненты включают все модели, параметры в интерпретации применённых Component Template(ов), Part Choices, полученные из исходных данных Supplier Link, а также любые ссылочные связи или файлы.

Любые Component Templates, созданные Library Importer, доступны в папке Managed Content\Templates\Component Templates панели Explorer.

Если по какой-либо причине — например, из-за неудовлетворительного результата импорта — вы хотите удалить набор компонентов, выбранные в панели Components panel можно корректно удалить, выбрав пункт Delete в контекстном меню по правому клику. Вместе с выбранными компонентами также могут быть удалены связанные с ними модели (если они не используются другими компонентами).

Важные моменты, касающиеся процесса импорта библиотек:

  • Монолитные библиотеки (содержащие несколько типов компонентов) автоматически разделяются на подгруппы, где каждая группа представляет тип компонентов, найденный в этой библиотеке. Группы обрабатываются как отдельные библиотеки.

  • Исходная библиотека с нераспознаваемым (не обнаруженным) типом компонента будет импортирована без интерпретации — как неназначенные типы компонентов в папку Components/Uncategorized Workspace. До запуска импорта это можно исправить, применив Designator Mapping or Parameter Grouping в режиме Advanced (полный UI). Либо вы можете продолжить импорт и затем изменить настройки компонента и его папку позже через панель Explorer panel.
  • Процесс импорта библиотек включает автоматический этап Validation компонентов. Компоненты, вызвавшие ошибку валидации, будут пропущены.
  • Если в импортируемой исходной библиотеке обнаружены дублирующиеся модели, будет импортирована только одна из этих моделей и связана с получившимися компонентами в целевом Workspace. Соответствующее уведомление будет показано в верхней части диалога Library Importer.
  • Все ошибки, с которыми столкнулся процесс, можно просмотреть в Importing Report, доступном по кнопке после завершения импорта .

Режим Advanced

Полный GUI Library Importer отображается в режиме Advanced, который предоставляет детальный контроль над управлением библиотеками, типами компонентов и параметрами компонентов. В сочетании с панелью Properties panel импорт компонентных библиотек в Workspace можно настроить под ваши конкретные требования. Обратите внимание, что настройки importer можно сохранять и восстанавливать путём exporting/importing configuration files.

Расширенный режим включается, когда Library Importer открывается из команды File » Library Importer , или когда в простом режиме нажата кнопка . Библиотеки добавляются в раздел импортера SOURCE LIBRARIES (если он ещё не заполнен) путём перетаскивания файла библиотеки в эту область, щелчком правой кнопкой по <All Libraries> с последующим выбором Add Library в контекстном меню, либо нажатием кнопки .

Раздел Import Preview содержит группы типов компонентов, определённые из исходных библиотек — как Types () или предлагаемый Folder Structure () — и включает табличное представление этих компонентов на основе параметров (Components). Значения параметров в таблице можно редактировать «на лету», что избавляет от необходимости открывать и править исходную библиотеку. Нижняя область Details содержит дополнительную информацию по текущему выбранному компоненту — Part Choices, Models и Datasheets.

Вы можете изменить тип компонента, щёлкнув правой кнопкой по типу в списке Types и выбрав команду Change Component Type.

Независимо от детальных опций и данных, представленных в интерфейсе, расширенный вид импортера можно использовать так же, как и простой — просто нажмите кнопку , чтобы запустить процесс импорта без вмешательства. Как и в процессе простого вида, импортер проанализировал библиотеку, определил тип содержащихся в ней компонентов и применил корректный Component Template. В свою очередь, шаблон определяет целевую папку Workspace, применяемые Naming Schemes и Lifecycle Definitions, а также сопоставление/интерпретацию параметров.

  • Используйте кнопку (вверху слева), чтобы обновить Library Importer. Это заново загрузит все исходные библиотеки и данные Workspace, чтобы учесть любые изменения, произошедшие с момента открытия импортера.
  • Используйте поле Search field (вверху справа), чтобы отфильтровать записи Components по совпадающему значению параметра.

Монолитные библиотеки

Исходные библиотеки, содержащие несколько типов компонентов, обнаруживаются процедурами анализа импортера и разделяются на подгруппы под-библиотек, где их можно обрабатывать как отдельные библиотеки по типам. Определение типа компонентов основано на позиционных обозначениях (Designators) исходных компонентов (R?, C? и т. п.), а также на ключевых словах (Resistor, Res и т. п.), содержащихся в других основных параметрах компонента (Description, ID и т. п.).

В примере ниже исходная библиотека (ProjectABC.IntLib) была автоматически «разделена» в соответствии с обнаруженными типами компонентов (Capacitors, Resistors и т. п.), которые можно выбрать в колонке Folder Structure (или колонке Types) для предварительного просмотра входящих в них записей компонентов в таблице Components.

Типы компонентов, которых в данный момент нет в Workspace, но которые будут созданы в процессе импорта, помечаются значком .

Обратите внимание, что отображение списка Components можно изменить несколькими способами:

  • Щёлкните по заголовку столбца, чтобы упорядочить список по этому столбцу параметра, и щёлкните ещё раз, чтобы изменить порядок на обратный.

  • В контекстном меню заголовка (правый клик):

    • Выберите Clear Sorting, чтобы вернуть порядок списка к настройке по умолчанию (по столбцу Name в порядке возрастания).

    • Выберите Best Fit, чтобы подогнать ширину выбранного столбца под его содержимое.

    • Выберите Select Best Fit All Columns, чтобы подогнать все доступные столбцы под ширину их содержимого.

    • Выберите Select Columns, чтобы открыть диалог Select Columns, где можно включать/отключать столбцы параметров и менять их порядок в списке.

  • Нажмите значок фильтра () в заголовке, чтобы ограничить список доступным значением параметра, пустыми/непустыми значениями или настройкой фильтра Custom. Применённый фильтр отображается внизу списка, где его можно включать/отключать (с помощью связанного флажка), изменять в Filter Editor или удалять. Выбор All через значок фильтра заголовка () также удалит применённый фильтр.

Компоненты без категории

Если одна запись подгруппы библиотеки называется Uncategorized (и отображается как Uncategorized в разделе Types или Folder Structure и сопровождается значком ), это означает, что импортер не смог обнаружить и назначить тип этой группе компонентов — тип компонента фактически установлен в None. В этом случае нераспознанные компоненты (инверторные логические ИС) используют неизвестный префикс Designator (U?), а их параметры не содержат обнаруживаемых ключевых слов, таких как IC, logic и т. п.

Если запустить импорт , компоненты будут импортированы как тип без категории, без интерпретации. Однако если присутствуют какие-либо ключевые/стандартные параметры (например, Resistance, Capacitance, Tolerance и т. п.), импортер автоматически назначит им подходящий тип единиц параметра (Ohm, Farad, Percent и т. п.).

Эту проблему можно решить, вручную сопоставив позиционные обозначения (designators), используемые для этих компонентов, с нужным типом компонента в диалоге Library Splitting, который открывается кнопкой — она доступна, когда выбрана исходная библиотека (ProjectABC.IntLib). Диалог Library Splitting (со значениями по умолчанию) предоставляет элементы управления для задания пользовательских параметров группировки библиотеки для компонентов без категории на основе сопоставления designator’ов по типам компонентов и разделения по параметрам.

При выбранной опции Map Designators  в диалоге выберите вариант типа компонента, который относится к компонентам без категории, из выпадающего списка Component Type (включены все доступные типы компонентов). Подтвердите выполненное сопоставление «тип–designator» (тип компонента Logic к designator’ам U?) кнопкой .

Теперь, когда тип компонента задан применённым сопоставлением, импортер будет использовать соответствующий Component Template (Logic) для настройки импорта библиотеки согласно параметрам шаблона (папка, именование и т. п.).

  • Диалог Library Splitting также включает опцию группировать разделённые компоненты по указанному значению параметра (например, из параметра Category или Component_Type), если это определено в исходной библиотеке. Для этого выберите опцию Parameter Grouping в диалоге, а затем подходящий параметр в выпадающем меню.
  • В качестве альтернативы тип компонента библиотеки можно выбрать вручную в разделе General панели Properties panel.
  • Чтобы изменить Component Type отдельной записи в списке Components, щёлкните в её ячейке Component Type, затем выберите альтернативный тип из выпадающего меню, либо щёлкните правой кнопкой по типу компонента и выберите Change Component Type в контекстном меню.

Обратите внимание: благодаря гибкости настроек Library Importer новый (без категории) тип библиотеки компонентов можно импортировать вместе со всей инфраструктурой, необходимой для будущих импортов этого типа библиотек. Выбрав подходящую конфигурацию импорта — новый Component Type, Component Template, целевую папку, сопоставление параметров и типы единиц значений параметров — единственным требованием для следующего импорта библиотеки этого типа будет выбор ранее определённого Component Type. Выбранный Component Type затем определит все остальные аспекты импорта.

Исключить из импортера

Вы также можете исключить определённые типы компонентов из импорта. Чтобы исключить тип компонента, в списке Types щёлкните правой кнопкой по типу, который нужно исключить, затем выберите Exclude from Importer в контекстном меню — при желании измените отображение столбца с Folder Structure на Types ().

Исключённый тип компонента будет отображаться серым в списке Types. Чтобы просмотреть исключённые компоненты в таблице, нажмите Show Excluded Component (n), где n обозначает количество исключённых компонентов.

Включить в импортер

Если вы исключили тип компонента из импорта с помощью описанной выше команды Exclude from Importer и всё же нужно включить этот тип, щёлкните правой кнопкой по серому типу компонента в списке Types (или Folder Structure), затем выберите Include to Importer в контекстном меню. Тип компонента снова будет отображаться в списке Types, что означает, что он не исключён.

Ошибки и предупреждения валидации

Компоненты, которые не будут корректно импортированы в Workspace или не будут импортированы вовсе, помечаются тегами предупреждений или ошибок в расширенном интерфейсе, когда запускается Library Importer () или выполняется проверка импорта (Validation) (). Валидация также проверяет пустые пути папок Workspace, конфликтующие системные параметры и дублирующиеся модели. Фатальная ошибка блокирует импорт.

При попытке выполнить импорт панель Messages заполняется обнаруженными нарушениями, а диалог предложит выбор: отменить или продолжить с текущей конфигурацией импорта. В последнем случае некорректные компоненты не импортируются, либо процесс импорта завершится ошибкой.

В случае отменённого импорта или при запуске ручной Validation любые компоненты, не прошедшие проверки импорта, связываются со значками ошибок/предупреждений и дополнительной информацией в нижней области Details. Значки в колонке предварительного просмотра Status указывают конкретные записи компонентов, нарушающие правила проверок импорта.

Ниже перечислены доступные встроенные проверки валидации.

Пользовательские проверки настраиваются в области Import Checks панели Properties. Используйте раскрывающееся меню Report Mode, чтобы выбрать другой уровень отчёта для соответствующего типа нарушения. Эти проверки перечислены ниже.

Устранение ошибок и предупреждений

Ошибки параметров, например как в показанном здесь примере, где значение Forward Voltage компонента невозможно интерпретировать как корректное напряжение, можно устранить следующим образом:

  • Отредактировать проблемное значение параметра (Value) — найдите и отредактируйте соответствующую ячейку, приведя значение к допустимому формату.

  • Изменить единицы измерения сопоставленного параметра Type, определяемые применённым Component Template, с Voltage на «не интерпретировать» Text — выберите Source Library в интерфейсе импортера, затем измените Forward Voltage Type в списке панели Properties panel Parameter Mapping (на вкладке General).

  • Удалить компонент из процесса импорта — щёлкните правой кнопкой по его записи и выберите параметр Exclude from Importer .

Ошибка отсутствующего файла, например показанный здесь недоступный файл Datasheet, может быть устранена следующим образом:

  • Очевидное решение — найти и восстановить отсутствующий файл в ожидаемом расположении.
  • Отключить импорт файлов datasheet — измените параметр Migrate в разделе Properties panel Datasheet (на вкладке Advanced).
  • Исключить компонент из процесса импорта библиотеки — как описано выше.

Используйте поле Search (вверху справа), если нужно найти конкретные записи компонентов. Поиск фильтрует список элементов по совпавшим значениям параметров для текущего выбранного типа компонента — выберите All в разделе Types (Folder Structure), чтобы поиск применялся ко всем компонентам в доступных исходных библиотеках.

Импорт библиотек схем

Если при попытке импортировать библиотеку схем вы сталкиваетесь с ошибкой «model not found» (например, Footprint <footprint name> not found in available libraries), это означает, что Library Importer не может найти модели, связанные с компонентами внутри SCHLIB.

В режиме Simple Mode такие ошибки будут показаны в HTML-отчёте Importing Report, доступном по кнопке , которая появляется после выполнения импорта. В режиме Advanced Mode ошибки обозначаются значками статуса в основном интерфейсе () и как записи на панели Messages — это происходит при выполнении проверки валидации () или при попытке импортировать библиотеку ().

Отсутствующие посадочные места (footprints) корректно обнаруживаются процессом Validation, который также предоставляет опцию Choose a Library в отчёте об ошибках (в раскрывающемся списке Details). В случае, когда обнаружено отсутствие посадочных мест более чем у одного компонента, диалог Apply PcbLib Selection предлагает варианты использовать указанную PcbLib для данного случая или для всех компонентов с отсутствующими посадочными местами.

Ещё один способ устранить (или избежать) эту проблему — убедиться, что требуемые файлы библиотек моделей доступны из Altium Designer. Библиотеки устанавливаются на странице Data Management – File-based Libraries page диалога Preferences.

Либо, если вы не хотите устанавливать несколько библиотек моделей, вам потребуется найти их в пути библиотек по умолчанию (или изменить этот путь) и проверить, что для компонентов Schematic Library указана исходная библиотека моделей:

  • Выполните включение библиотеки моделей в расположение пути поиска по умолчанию, используемого программой. Добавьте библиотеку моделей, например соответствующую PCB-библиотеку, в расположение, заданное системным путем библиотек по умолчанию. Чтобы проверить это расположение, см. запись Library Path на странице System – Default Locations page диалога Preferences. Если файл библиотеки был добавлен/скопирован в это расположение пути, может потребоваться перезапустить Altium Designer, чтобы изменение было зарегистрировано.
  • Укажите имя целевой библиотеки моделей для компонентов Schematic Library. Чтобы библиотека моделей, на которую ссылается компонент библиотеки схем, была известна Library Importer, укажите ее имя в диалоге PCB Model dialog.

Обратите внимание, что импортировать PCB Library вместе с соответствующей Schematic Library не требуется и даже нежелательно, поскольку необходимый импорт моделей и их связывание выполнит сам Library Importer. Процесс импорта определяет, находит и переносит корректные модели для каждого компонента, чтобы создать единый компонент в целевом Workspace.

Обнаружение дубликатов

Library Importer также включает механизмы, предотвращающие создание дублирующихся компонентов в целевом Workspace. Это достигается на этапе проверки путем сравнения параметров-идентификаторов компонентов исходной библиотеки и Part Choices с параметрами компонентов в целевом Workspace и в исходных библиотеках, предназначенных для импорта. При настройках импортера по умолчанию шаг Validation () помечает сообщением Warning ситуацию, когда обнаружен один и тот же компонент Name или запись Part Choices (что указывает на потенциальный дубликат компонента). Отображаемое предупреждение/сообщение об ошибке включает тип нарушения дублирования (параметр или Part Choice), имя компонента-нарушителя из библиотеки и компонент (по ID), с которым возникло нарушение.

Два потенциальных дубликата, обнаруженных процессом Validate, когда Name компонента (верхнее изображение) или его Part Choice (нижнее изображение) уже существуют в компонентах Workspace.
Два потенциальных дубликата, обнаруженных процессом Validate, когда Name компонента (верхнее изображение) или его Part Choice (нижнее изображение) уже существуют в компонентах Workspace.

Пара «имя-значение» параметра, используемая для обнаружения нарушений дублирования, задается в области Duplicates Detection панели Properties на вкладке Advanced. Используйте раскрывающееся меню Unique Field (по умолчанию установлено в Name), чтобы выбрать один из параметров, доступных в исходной библиотеке. Этот выбор особенно полезен для конфигураций корпоративных библиотек, где используется собственное поле-идентификатор, связанное с более широкой корпоративной системой.

Обнаружено нарушение дублирования, когда значение указанного параметра (ERP-REF) совпадает для компонента локальной библиотеки и компонента Workspace.
Обнаружено нарушение дублирования, когда значение указанного параметра (ERP-REF) совпадает для компонента локальной библиотеки и компонента Workspace.

Для нарушений дублирования можно установить другой тип статусного флага, выбрав альтернативный Report Mode в области Import Checks на вкладке General панели Properties.

Обнаружение дубликатов также выполняется для символьных моделей компонентов. Если импортируемые компоненты имеют символьные модели с одинаковой геометрией в исходных библиотеках, будет импортирована только одна из этих моделей.

Эта функция доступна, когда опция LibraryMigrator.DuplicatedModelCheck включена в диалоге Advanced Settings dialog.

Библиотеки с одной моделью

Автоматическое обнаружение дубликатов также используется для обработки исходных библиотек, в которых для всех компонентов применяется общая символьная модель. Такие библиотеки обычно состоят из одного типа компонентов с различающимися стилями и значениями, например резисторов определенного форм-фактора корпуса, где символ для каждого — это стандартная графическая модель.

Это условие единой общей модели обнаруживается Library Importer, после чего импорт настраивается так, чтобы перенести одну символьную модель, применимую ко всем импортируемым компонентам, — вместо соответствующего индивидуально именованного символа для каждого компонента. Импортируемый символ принимает имя одного из импортируемых символов, при этом все параметры компонентов остаются без изменений.

Импортированный символ библиотеки (имеющий общее имя и пустое поле Description) можно отредактировать под ваши нужды. В панели Components panel используйте команду Edit в контекстном меню (правый клик), чтобы вызвать действие. В процессе выберите опцию Update items related to <symbol ID> в диалоге Create Revisions for Item, чтобы гарантировать, что импортированные компоненты будут использовать новую ревизию символа.

Объединение типов компонентов

Диапазон Component Types, зарегистрированных в системе — или на практике, в подключенном Workspace — можно просматривать и управлять им на странице Data Management – Component Types page диалога Preferences. Типы перечислены вместе с соответствующими Template компонента и Folder Workspace и будут включать любые новые типы, созданные, когда Library Importer импортировал файлы библиотек в Workspace.

Создание нескольких новых Component Types обычно может происходить, когда конфигурация Library Importer использовала Parameter Grouping (значение выбранного параметра компонента) для определения Type каждого импортируемого компонента. Например, параметр Categories может быть Resistor-0608 для одной группы импортируемых компонентов и Resistor-0402 для другой и т. д. В таком случае все их лучше сгруппировать под единым типом компонентов Resistors для дальнейшего использования.

Вместо ручного изменения всех Component Types в таких обстоятельствах страница Component Types page в Preferences позволяет объединить выбранные записи Type в одну указанную запись. Подробнее см. в разделе Merging Component Types на странице Component Types.

Результат такого объединения заключается в том, что когда Resistors выбирается как тип импортируемого компонента в Library Importer, он будет применен, если вы выберете любой из объединенных Templates (Resistor_0402 и т. д.) в качестве альтернативы.

Импорт только моделей

Library Importer можно переключить в специальный режим импорта Models Only, который обнаруживает и обрабатывает доступные модели компонентов в исходной библиотеке.

Эта функция доступна, когда опция LibraryMigrator.ModelsOnlyMode включена в диалоге Advanced Settings dialog.

В режиме Models Only процесс анализа импортера обнаружит все модели Symbol, Footprint и Simulation, доступные в исходной библиотеке (IntLib, SchLib, PcbLib и т. д.), затем импортирует эти модели в Workspace, используя системные расположения по умолчанию, схемы именования и определения жизненного цикла.

Когда Library Importer переключен в Advanced mode () или открыт в Advanced mode (File » Library Importer), доступны полные сведения о предлагаемом импорте моделей. Область Import Preview показывает Folder Structure, которые будут использоваться в целевом Workspace, и которые можно изменить относительно настроек по умолчанию в поле Folder для каждого типа модели в панели Properties. Применяемые схемы именования и определение Lifecycle для каждой модели можно выбрать из доступных системных типов (см. Properties panel ниже).

При необходимости импорт моделей компонентов в Workspace можно ограничить по типам, отключив (или включив) конкретные типы моделей в панели Properties с помощью соответствующих кнопок .

После настройки Library Importer нажмите кнопку , чтобы завершить импорт перечисленных моделей компонентов. Результаты можно просмотреть в файле журнала импорта, который предлагается диалогом прогресса Library Importer (), либо просмотрев импортированные модели в панели Components panel.

Импорт только компонентов

Аналогично режиму импорта Models Only, описанному выше, Library Importer можно переключить в специальный режим импорта Components Only, который позволяет импортировать доступные компоненты из исходной библиотеки без связанных с ними моделей.

Эта функция доступна, когда опция LibraryMigrator.ReleaseComponentsWithoutModels включена в диалоге Advanced Settings dialog.

В режиме Components Only процесс анализа импортера обнаружит все компоненты, параметры и Part Choices в исходной библиотеке, затем импортирует эти компоненты в Workspace, используя системное расположение по умолчанию, схему именования и определение жизненного цикла.

Когда Library Importer переключен в Advanced mode () или открыт в Advanced mode (File » Library Importer), доступны полные сведения о предлагаемом импорте компонентов. Применяемую папку, схемы именования и определение Lifecycle можно выбрать из доступных системных типов (см. Properties panel ниже).

После настройки Library Importer нажмите кнопку , чтобы завершить импорт перечисленных компонентов. В Workspace будут созданы только элементы компонентов, без каких-либо связанных моделей. Результаты можно просмотреть в файле журнала импорта, который предлагается диалогом прогресса Library Importer (), либо просмотрев импортированные компоненты в панели Components panel

Панель Properties

Связанные настройки панели Properties импортера Library Importer обеспечивают расширенное управление конфигурацией импорта для выбранной библиотеки (или подгруппы библиотек). К панели можно получить доступ из Advanced mode Library Importer, выбрав опцию Properties в меню кнопки (в правом нижнем углу рабочей области), нажав кнопку в правом верхнем углу представления Library Importer или нажав кнопку рядом с <All Libraries> либо с записью конкретной категории в списке Source Libraries.

Параметры опций панели определяются системными настройками по умолчанию или теми, что заданы применённым Component Template, который, в свою очередь, выбирается на основе обнаруженного типа компонента в библиотеке — LED в показанном здесь примере. Эти настройки также можно редактировать вручную, что позволяет настроить процесс импорта под свои требования; при необходимости их можно восстановить с помощью ссылки Reset to Default (вверху справа).

Разделы вкладки General панели следующие:

  • General:
    • Component Type — тип компонента, определённый импортёром для выбранной библиотеки, и, соответственно, применяемый шаблон (см. Component Template ниже). Переопределите этот параметр, отредактировав поле (что создаст новый component type), либо выберите альтернативный тип в выпадающем списке (или через кнопку ) — это ещё один способ решить проблему uncategorized component issue. Выберите опцию [LibraryName], чтобы установить тип равным имени выбранной библиотеки.
    • Component Template — Workspace Component Template, который будет применён к импортируемым компонентам и, соответственно, к их настройке Component Type. Переопределите этот параметр, выбрав другой шаблон в выпадающем списке (или через кнопку ). Установите эту опцию в [Create new] для автоматического создания шаблона, производного от параметров исходной библиотеки и текущих настроек Library Importer, либо выберите [No Template], чтобы запретить применение или создание шаблона.

      Обратите внимание: настройки Component Type и Component Template фактически связаны между собой, когда установлены на доступную пару Type/Template — например, если одна из них установлена в Capacitors, то другая автоматически устанавливается в Capacitors. Однако если в этом случае настройка Component Template будет изменена на [Create New], будет создан ещё один шаблон Capacitors (с соответствующим суффиксом версии/ревизии), чтобы соответствовать текущим настройкам. Существующие Component Template в процессе импорта не изменяются.
  • Parameter Mapping — сопоставление параметров между параметрами библиотеки и параметрами в применённом шаблоне компонента (или настройками по умолчанию, если шаблон недоступен), а также тип значения для каждого параметра (Text или тип с учётом единиц измерения). Используйте параметры выпадающего меню в столбце Source Library Parameter, чтобы изменить сопоставление, и параметры меню в столбце Type, чтобы переопределить существующую настройку, заданную шаблоном или значениями по умолчанию. Выберите опцию <Skip>, чтобы не включать параметр. Любой параметр, который не был автоматически сопоставлен с параметром исходной библиотеки (системой установлен в <Skip>), можно вручную сопоставить с подходящим параметром шаблона — например, исходный параметр ROHS можно выбрать для соответствия параметру RoHS Compliant, определённому шаблоном Workspace. Имена параметров можно редактировать, а наборы параметров — добавлять, изменять и удалять. Базовые параметры компонента (ID, Name, Description) можно переназначать, но в остальном они доступны только для чтения.

    Для параметра Workspace ID параметр исходной библиотеки установлен в <Auto>. В результате идентификаторы компонентов автоматически создаются на основе Naming Template, указанного в разделе Component панели, который находится на вкладке Advanced панели. Сопоставление ID можно изменить так, чтобы использовать любой параметр исходной библиотеки (уникальный для каждой записи компонента), выбрав альтернативу в выпадающем списке Source Library Parameter. Обратите внимание: базовые параметры компонента (ID, Name, Description) можно переназначать, но в остальном они доступны только для чтения.
  • Part Choice Mapping — список параметров manufacturer part или supplier link, распознанных импортёром, которые будут использованы для формирования записей Part Choices для импортируемых компонентов. Используйте параметры выпадающего меню, чтобы переопределить сопоставление, либо добавляйте и удаляйте наборы сопоставления. Обратите внимание: по умолчанию параметры manufacturer part и supplier link не включаются (пропускаются) в процессе импорта. Если для компонента библиотеки указано несколько supplier link, в записях поля Part Choices используется основной идентификатор поставщика (Supplier 1 / Supplier Part Number 1).
  • Import Checks — просмотр или настройка реакции импортёра (ошибка/предупреждение) на нарушения правил валидации импорта. Используйте выпадающее меню Report Mode, чтобы изменить реакцию и значок для записи Violation Type. Обратите внимание: если выбран режим отчёта Fatal Error, процесс импорта будет заблокирован при обнаружении этого нарушения.

Вкладка Advanced панели предлагает настройки для всех элементов объектов данных импортёра, заданные системными значениями по умолчанию или применённым Component Template. К ним относятся модели компонентов, файлы Datasheet и любые создаваемые Component Template. За исключением опции Datasheet (переключатель включить/выключить), настройки для каждого импортируемого объекта включают:

  • Folder — целевая папка Workspace для импортируемого объекта; её можно отредактировать вручную (например, чтобы создать новую целевую папку) или выбрать через кнопку обзора ().
  • Naming Scheme — спецификация именования объекта в Workspace, определённая Component Template, либо, при отсутствии активного шаблона, схема, заданная для целевой папки (или введённая вручную). Используйте выпадающее меню, чтобы выбрать одну из доступных Naming Schemes. Обратите внимание: изменение пути целевой папки (Folder) может сопровождаться изменением применяемой Naming Scheme — в соответствии с настройками самой папки или применённого/связанного Component Template.
  • Revision Naming Scheme — схема именования, используемая для Workspace revisions объекта, заданная применённым шаблоном или выбранная из параметров выпадающего меню записи. В качестве опций будут доступны только те схемы, которые включены в системе.
  • Lifecycle DefinitionLifecycle system, используемая для объекта, заданная применённым шаблоном или выбранная из параметров выпадающего меню записи. В качестве опций будут доступны только те определения, которые включены в системе.
Раздел объекта Component включает настройку для Duplicates Detection, как описано выше.

Export-Import Configuration

Library Importer предоставляет возможность экспортировать подробный текстовый файл, фиксирующий текущую конфигурацию, включая все настраиваемые параметры импорта, такие как целевые пути, сопоставление параметров, схема именования, определения жизненных циклов, целевые типы компонентов и т. п.

Файл Importer Configuration сохраняется командой File » Export » Importer Config как тип файла *.lmcfg и может быть восстановлен в любое время через пункт меню File » Import » Importer Config .

Возможность восстановления конфигурации особенно полезна, когда исходная база данных или файловая библиотека была обновлена и эти изменения нужно импортировать в Workspace. Если конфигурация была экспортирована при первом импорте библиотеки, восстановленная (импортированная) конфигурация заново установит точные параметры, которые использовались ранее, что гарантирует согласованную схему переноса данных для этой библиотеки (или библиотек).

Обратите внимание: экспортированный (сохранённый) файл Importer Configuration содержит ссылки на файлы библиотек, которые были открыты как исходные библиотеки на момент экспорта конфигурации. Когда этот файл Importer Configuration впоследствии импортируется (загружается повторно), одна или несколько библиотек, на которые он ссылается, должны быть доступны — то есть в данный момент должны быть доступны как исходные библиотеки в Library Importer.
AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Доступность функциональных возможностей

Набор доступных функциональных возможностей зависит от вашего решения Altium – Altium Develop, редакция Altium Agile (Agile Teams или Agile Enterprise) или Altium Designer (на активной подписке).

Если вы не видите в своем ПО функцию, описанную здесь, свяжитесь с отделом продаж Altium, чтобы узнать больше.

Устаревшая документация

Документация Altium Designer больше не разделена по версиям ПО. Если вам необходим доступ к документации по старым версиям Altium Designer, посетите раздел Устаревшая документация на странице Прочие установщики.

Content