Search In: Doc:Documentation: Altium Designer
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany DashboardAltium Infrastructure Server
Close
Поиск Search on Documentation

Searching for Components in Database & File-based Libraries

Created: февраля 21, 2024 | Updated: апреля 29, 2025
Altium Training

Altium Essentials: Schematic Capture

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

Watch Now

Управление доступными библиотеками на основе баз данных и файлов

В Altium Designer компоненты из библиотек на основе баз данных и файлов можно размещать только из тех библиотек, которые в данный момент доступны. К ним относятся:

  • Libraries in the current project – если библиотека является частью проекта, её компоненты автоматически доступны для размещения в рамках этого проекта.

  • Installed libraries – эти библиотеки установлены в Altium Designer; их компоненты доступны для использования в любом открытом проекте.

  • Libraries on a defined search path – также можно задать путь поиска к папке с несколькими библиотеками. Поскольку все файлы по пути поиска просматриваются каждый раз при выборе нового компонента в панели, этот подход рекомендуется только для небольших библиотек с простыми определениями моделей, например для моделей симуляции. Пути поиска не рекомендуются для сложных моделей, например посадочных мест, включающих 3D‑модели.

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

Диалог Libraries Preferences содержит три вкладки. Все библиотеки и расположения моделей, заданные на этих вкладках, объединяются в общий список доступных библиотек. Когда выполняется действие, требующее поиска модели (например, перенос проекта из схемы в разводку PCB), библиотеки просматриваются в порядке вкладок, а затем внутри каждой вкладки — в порядке, в котором перечислены библиотеки/модели. Как только нужная модель найдена, поиск прекращается. 

Библиотеки проекта

Библиотеки, входящие в активный проект, перечисляются на вкладке Project диалога Libraries Preferences, когда этот проект является активным в программе. Преимущество библиотек проекта в том, что модели/библиотеки автоматически становятся доступными при каждом открытии проекта. Недостаток в том, что если модели/библиотеки не хранятся в той же структуре папок проекта, что и файлы проекта, о них легко забыть при переносе файлов проекта.

Вкладка Project предоставляет список доступных библиотек в текущем проекте.
Вкладка Project предоставляет список доступных библиотек в текущем проекте.

Любая библиотека может быть библиотекой проекта; ей не обязательно находиться в папке проекта. Чтобы включить библиотеки в проект, щёлкните правой кнопкой мыши по имени проекта в панели Projects и выберите команду Add Existing to Project .

Установленные библиотеки

Библиотеки и модели, которые были сделаны доступными в вашей установке программы, называются установленными библиотеками. Они перечислены на вкладке Installed диалога Libraries Preferences.

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

Установленные библиотеки можно указывать с использованием абсолютного пути или пути, относительного к настройке Library Path Relative To . Преимущество относительного пути в том, что он позволяет создать общую под‑среду на нескольких ПК, упрощая перенос файлов проекта между ними. Кроме того, установленные библиотеки можно временно деактивировать, сняв флажок Activated, а не удаляя их.

Из панели Components доступны только библиотеки Activated.

На вкладке Installed перечислены библиотеки, которые были сделаны доступными в данной установке Altium Designer.
На вкладке Installed перечислены библиотеки, которые были сделаны доступными в данной установке Altium Designer.

При подключении к Altium 365 Workspace также отображается сводка о состоянии (health) вашей Workspace Library. Она показывает, с первого взгляда, количество полностью исправных компонентов и количество компонентов, у которых есть хотя бы одна проблема. Нажмите элемент управления See Details , чтобы открыть страницу Components  интерфейса браузера Workspace в веб‑браузере по умолчанию.

При подключении к Altium 365 Workspace вы можете импортировать установленную библиотеку, выбранную в области таблицы диалога, в Workspace, нажав Import в крайнем правом столбце. Откроется Library Importer in its Simple mode с загруженной выбранной библиотекой.

Путь поиска

Вкладка Search Path отображает список библиотек, найденных согласно настройкам путей, заданным на вкладке Search Paths tab of the Project Options dialog, которая открывается нажатием кнопки Paths. Каждый путь поиска задаёт папку и может включать подпапки, если включена опция Recursive (доступна на вкладке Search Paths диалога Project Options после добавления пути). Все файлы моделей и библиотек, найденные по пути поиска, будут доступны. Пути поиска сохраняются вместе с проектом.

Нажмите кнопку Refresh , чтобы обновить список на основе актуальных путей поиска (заданных на вкладке Search Paths диалога Project Options ).

На вкладке Search Path перечислены библиотеки, найденные в заданных путях поиска.
На вкладке Search Path перечислены библиотеки, найденные в заданных путях поиска.

Вкладка Search Paths диалога Project Options доступна, когда опция UI.ProjectOptions.SearchPaths включена в диалоге Advanced Settings dialog.

Получение моделей через пути поиска может быть медленным, если в папке(ах) пути поиска находится большое количество файлов. По этой причине не рекомендуется использовать этот подход для библиотек PCB, так как они могут быть большими файлами, содержащими множество посадочных мест. Эта функция была разработана как способ ссылаться на доступные модели симуляции и модели целостности сигнала.

Хотя программа предоставляет гибкость и контроль над конкретными расположениями моделей/библиотек, она требует использования правильного расширения файла для каждого типа модели. Например, посадочное место будет найдено только если оно находится в файле с расширением .Lib или .PcbLib. Аналогично, SPICE *.SUBCKT будет найден только если он находится в файле  .ckt, а SPICE *.MODEL — только если он находится в файле .mdl. Если поиск модели не даёт совпадения, в панели Messages появляется ошибка. 

Локализованное кэширование символов и моделей, используемых библиотеками SVN Database Libraries

Когда файл SVNDbLib добавляется в список доступных библиотек, библиотеки символов и моделей из репозитория кэшируются во временной папке на компьютере, где установлен Designer. Когда какое‑либо действие в программе требует использования условного графического обозначения или модели, этот символ/модель извлекается из локального кэша.

Автоматическое обновление кэша

Библиотеки в кэше будут автоматически обновляться до актуальной версии из репозитория системы контроля версий при выполнении в программе любого из следующих действий:

  • Размещение компонента из установленного файла SVNDbLib (из панели Components panel).

  • Выполнение переноса проекта (т.е. обновление PCB).

  • Использование команды Tools » Update From Libraries в редакторе схем. Использование команды Tools » Update From PCB Libraries в редакторе PCB.

Хотя обновление выполняется автоматически, им можно управлять с помощью опции Do not check files more often than xx minutes на странице Data Management - SVN Libraries page диалога Preferences . Эта опция по сути задаёт «таймер обновления» для локального кэша. Если с момента последнего обновления кэша прошло указанное время, то кэш будет обновлён автоматически при выполнении одного из перечисленных действий. Если действие выполняется в пределах этого времени, будет использовано текущее содержимое кэша, которое может быть устаревшим по сравнению с содержимым репозитория.

Принудительное обновление кэша вручную

Иногда может потребоваться принудительно обновить локальный кэш, чтобы убедиться, что у вас самые актуальные библиотеки, которые в данный момент хранятся в репозитории системы контроля версий. Например, при подготовке к переносу проекта из схемы на PCB.

Вы можете принудительно обновить кэш вручную одним из следующих способов:

  • Используя одну из Refresh команд, доступных в контекстном меню (по щелчку правой кнопкой) в панели Components.
  • Удалив и заново установив файл SVNDbLib в списке Available Libraries.
При каждом перезапуске Altium Designer локальный кэш будет автоматически обновляться последними версиями библиотек, хранящихся в SVN-репозитории.

Поиск компонентов в библиотеке базы данных и файловых библиотеках

Чтобы упростить поиск компонента в файловых (как установленных, так и не установленных в данный момент) и библиотечных базах данных, в Altium Designer предусмотрена функция поиска по библиотекам.

Поиск компонента в библиотеке базы данных и файловых библиотеках возможен с помощью поля Search в панели Components. Введите строку и нажмите Enter, чтобы выполнить поиск этой строки в текущей библиотеке — в любом месте среди видимых параметров компонента.

Вы также можете выполнять поиск непосредственно в панели Components.Вы также можете выполнять поиск непосредственно в панели Components.

Диалог File-based Libraries Search позволяет выполнять более детальный поиск. Он открывается нажатием кнопки Components panel menu на панели Components и выбором File-based Libraries Search в меню. Верхняя половина диалога используется для определения what, что именно вы ищете; нижняя — для определения where, где искать.

Выполняйте поиск по установленным библиотекам (Available libraries) или по библиотекам на жестком диске (Libraries on path).Выполняйте поиск по установленным библиотекам (Available libraries) или по библиотекам на жестком диске (Libraries on path).Процесс поиска можно кратко описать так:

  • Поиск выполняется путем задания Filters, которые применяются ко всем библиотекам, доступным для поиска в соответствии с текущими настройками Scope.

  • Scope включает тип библиотек, по которым выполняется поиск. Одновременно можно искать только по одному типу.

  • Чтобы включить поиск по компонентам базы данных, установите поле Search in в значение Database Components и выберите требуемую Table. Обратите внимание: доступные Fields в раскрывающемся списке выше изменятся в соответствии с заголовками столбцов, доступными в выбранной таблице. Остальные параметры диалога станут неактивными, поскольку они не относятся к поиску в библиотеке базы данных.

  • Scope определяет, по каким библиотекам будет выполняться поиск: либо по библиотекам, к которым ПО имеет доступ в данный момент (Available libraries), либо по всем библиотекам в папке (Libraries on path).

  • При поиске библиотек по пути целью является конкретная папка, и также можно Include Subdirectories.

  • Вы также можете выполнять поиск внутри результатов поиска, установив Scope в Refine last search.

  • Нажмите Clear чтобы очистить введенные параметры поиска.

Настройка фильтра поиска

Область Filters используется для задания текстовых строк, применяемых при поиске. Настраиваются три области:

  • Field – это атрибут компонента, по которому выполняется поиск. Это может быть любой атрибут компонента или посадочного места, включая Name, Description, Comment, Footprint или любой параметр, добавленный к компоненту. Выберите доступное поле из раскрывающегося списка или введите поле в текстовое поле.

  • Operator – определяет, как устанавливается совпадение. Это может быть, когда значение equals, contains, starts with или ends with. Обратите внимание: equals требуют точного совпадения строки, поэтому их следует использовать только тогда, когда вы уверены, что строка поиска корректна и полностью задана.

  • Value – символы, которые нужно найти в выбранном Field, сопоставляемые согласно выбранному Operator. Выберите доступное значение из раскрывающегося списка или введите значение в текстовое поле.

По умолчанию задано три ограничения фильтра; с помощью элемента управления Add Row можно добавить до семи дополнительных строк — всего до 10 строк. Последнюю добавленную строку ограничения фильтра можно удалить с помощью Remove Row. Вы можете удалять неиспользуемые строки.

Настройка области поиска (Scope)

По сути, есть два подхода к поиску:

  • Библиотеки, доступные в данный момент – это список библиотек, показанный в раскрывающемся списке в верхней части панели Components .

  • Библиотеки, хранящиеся в указанной папке, вместе с подкаталогами, если опция включена.

Поиск вернет все элементы выбранного типа поиска из раскрывающегося списка Search in (Components/Footprints/3D Models/Database Components), найденные во всех библиотеках, подпадающих под заданный Scope:

  • Available libraries - включите, чтобы искать указанные типы моделей только среди доступных библиотек.
  • Libraries on path - включите, чтобы искать указанные типы моделей среди доступных библиотек в указанной(ых) папке(ах). В области Path диалога, которая становится доступной при выборе параметра области Libraries on path , можно задать путь, включить подкаталоги и указать маску файлов библиотек, чтобы уточнить критерии поиска:
    • Path - отредактируйте, чтобы задать папку, в которой можно искать библиотеки, или нажмите значок обзора в конце поля, чтобы выбрать папку.
    • Include Subdirectories - включите, если хотите искать библиотеки по указанному пути и его подпутям.

    • File Mask - введите строку маски файла или выберите одну из существующих масок из раскрывающегося списка. Поиск фильтруется по файлам, соответствующим строке. В строке можно использовать подстановочный символ * (любой символ). Например, введите * , чтобы искать все файлы, и введите M, чтобы искать все файлы, начинающиеся с буквы M.

Включите Refine last search , чтобы дополнительно уточнить критерии запроса поиска на основе списка Query Results, полученного в результате предыдущего поиска. Например, если вы искали посадочные места PCB с именем на основе DIP и хотите найти и вернуть только те посадочные места, у которых задана высота менее 100 mil, включите эту опцию. Введите новое выражение запроса и затем нажмите Search. Подмножество результатов предыдущего запроса будет отображено как новый список Query Results в панели Components .

Например, если вы хотите найти компонент, который, как вы предполагаете, находится в библиотеке в определенных папках на жестком диске, и эта библиотека в данный момент не указана в Available File-based Libraries, задайте поиск следующим образом:

  1. В области Scope установите Search in в Components и выберите Libraries on path.
  2. В области Path установите Path, указав папку, содержащую библиотечный документ, в котором нужно выполнить поиск.
  3. Нажмите Search. Результаты отображаются в панели Components по мере выполнения поиска.

Размещать компоненты можно только из библиотек, установленных в Altium Designer. Если вы попытаетесь разместить компонент из библиотеки, которая в данный момент не установлена, потребуется подтвердить ее установку.

Расширенный режим поиска

Поиск по библиотекам фактически выполняется с использованием запросов. В диалоге File-based Libraries Search переключитесь в режим Advanced, чтобы просмотреть запрос. 

В режиме Advanced этого диалога вы также можете создавать собственные запросы, используя ключевые слова языка запросов, чтобы выполнять поиск на основе запросов. См. раздел ниже, чтобы узнать больше о доступных ключевых словах языка запросов.

Используйте следующие дополнительные элементы управления, когда выбран режим Advanced:

  • Helper - нажмите, чтобы открыть диалог Query Helper, позволяющий легко построить запрос поиска по библиотекам с использованием предопределенных библиотечных и системных функций. Также можно использовать кнопки History и Favorites , чтобы выбрать недавно примененный или предопределенный библиотечный запрос.

  • History - нажмите, чтобы открыть диалог Expression Manager и выбрать одно из ранее примененных выражений запроса для использования в поиске по библиотекам. Также можно использовать кнопку Favorites , чтобы применить предопределенный запрос для указанного поиска по библиотекам.

  • Favorites - нажмите, чтобы открыть диалог Expression Manager и выбрать одно из ваших избранных выражений запроса для использования в поиске по библиотекам. Также можно изменить список Favorites , удаляя, переименовывая или копируя выражения из списка History .

При поиске среди Database Components режим Advanced позволит выполнять поиск с помощью SQL-запросов. Этот уровень поиска обеспечивает «тонкий» поиск на основе заданного выражения запроса, где вы можете ввести SQL-запрос непосредственно в область редактора запросов диалога.

Нажмите Advanced для доступа к мощному поиску на основе SQL-запросов. Нажмите Advanced еще раз, чтобы вернуться к простому поиску.

Функции запросов компонентов и библиотек

Функции запросов компонентов и библиотек в диалоге Query Helper
Функции запросов компонентов и библиотек в диалоге Query Helper

В основе редакторов схем и PCB в Altium Designer лежит мощный механизм запросов. Вводя запросы в этот механизм, вы можете логически и точно ограничивать выбор именно теми объектами, которые вам нужны.

Запрос — это строка, которую вы вводите с использованием определенных ключевых слов и синтаксиса; в результате будут возвращены целевые объекты. Доступно множество ключевых слов, позволяющих выбирать объекты по их типу, свойствам или по обоим признакам.

Для подробного обзора использования языка запросов см. Working with the Query Language.

Разделы ниже подробно описывают ключевые слова языка запросов, доступные при поиске компонентов из базы данных и файловых компонентов в Altium Designer. Чтобы получить справку по конкретному ключевому слову запроса, используйте следующие сворачиваемые разделы или выделите (или щёлкните внутри) любое ключевое слово — в Query Helper.

Чтобы получить доступ к функциям запросов по компонентам и библиотекам, нажмите кнопку Helper, расположенную в диалоговом окне File-based Libraries Search.

Компоненты

Все

Посадочные места

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Доступность функциональных возможностей

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

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

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

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

Content