Улучшения средства Library Migrator

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

Таким образом, обычные файловые библиотеки можно преобразовать в управляемые серверные компоненты в один этап, поскольку средство миграции автоматически берет на себя классификацию компонентов по типам, определение целевых папок, определение типов значений параметров и передачу всех соответствующих данных – см. информацию по режиму Simple Mode ниже. Библиотеки, которые включают в себя множество типов компонентов (монолитные библиотеки), также определяются и обрабатываются автоматически.

Помимо автоматизированного способа, позволяющего преобразовывать библиотеки в один клик, обновленное средство Library Migrator также предлагает расширенные опции настройки через панель Properties. Эти опции обеспечивают полный контроль над процессом миграции для каждой исходной библиотеки, что позволяет точно настроить преобразование библиотек в соответствии с вашими потребностями.

Средство Library Migrator доступно при входе на сервер Altium, и его можно открыть следующими способами:

• Выберите файловую библиотеку в столбце Categories панели Components, а затем выберите команду Migrate Library из меню кнопки .
• Щелкните ПКМ по файлу библиотеки в панели Projects и выберите команду Migrate Library из контекстного меню.
• Выберите команду Tools » Migrate Library в редакторе схемных библиотек или в редакторе библиотек посадочных мест.
• Перетащите с зажатой ЛКМ библиотеку из Проводника Windows в панель Explorer.
• Выберите команду File » Library Migrator из главного меню.

Первые четыре способа откроют средство миграции в его простом режиме, который предлагает опции для немедленного преобразования выбранной библиотеки () или открытия средства Library Migrator в режиме полного интерфейса ().

Simple Mode – Простой режим

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

Примечания касательно этого процесса:

• Полная, готовая к использованию миграция основана на доступности шаблона компонента, который соответствует типу исходного компонента. Подходящие шаблоны доступны на сервере, если в процессе установки сервера был включен параметр Install sample data.
• Исходная библиотека с компонентами нераспознаваемых (неопределяемых) типов будет преобразована без интерпретации в виде компонентов неназначенного типа в серверной папке Components/Uncategorized. Перед началом миграции эти ситуации можно устранить, применив сопоставление позиционных обозначений или группирование параметров в расширенном режиме (полный интерфейс).
• Монолитные библиотеки автоматически разделяются на подгруппы, где каждая группа представляет тип компонентов в этой библиотеке. Группы обрабатываются как отдельные библиотеки.
  
• Все компоненты с нарушениями валидации будут пропущены.
• Все ошибки, обнаруженные в процессе, могут быть отображены в отчете Migration Report, доступном с помощью кнопки по завершении миграции.

Результат миграции библиотек, т.е. созданные управляемые компоненты, можно увидеть в панелях Explorer и Components. Мигрированные компоненты включают в себя все модели, параметры, преобразованные примененными шаблонами компонентов, варианты выбора, полученные из исходных данных о цепочке поставок, а также все ссылки и файлы.

Advanced Mode – Расширенный режим

Полный интерфейс пользователя средства Library Migrator отображается в его расширенном (Advanced) режиме, который предоставляет полный контроль над библиотеками, типами компонентов и их параметрами. В сочетании с панелью Properties, миграция библиотек компонентов на сервер может быть настроена в соответствии с индивидуальными требованиями.

Расширенный режим включается при открытии средства Library Migrator с помощью команды File » Library Migrator либо по нажатию кнопки в простом режиме. Библиотеки добавляются в раздел SOURCE LIBRARIES средства миграции (если он еще не заполнен) с помощью кнопки или путем перетаскивания файла библиотеки в эту область. Используйте контекстное меню для исключения выбранной библиотеки или извлеченной подбиблиотеки из процесса миграции.

В разделе MIGRATION PREVIEW приводится список групп по типам компонентов, определенных из исходных библиотек – по типам компонентов (Component Types, ) или по предложенной структуре папок (Folder Structure, ) – и включает в себя табличный вид этих компонентов с их параметрами (Components). Значения параметров в таблице можно изменять на лету, что избавляет от необходимости открывать и редактировать исходную библиотеку. Область Details ниже включает в себя дополнительную информацию, взятую из выбранного в данный компонента: варианты выбора компонента, модели и даташиты.

Несмотря на наличие более подробных опций и данных, представленных в интерфейсе, расширенный режим средства миграции можно использовать тем же образом, что и простой режим – просто нажмите кнопку , чтобы запустить процесс миграции без вмешательства. Как и в простом режиме, средство миграции проанализирует библиотеку, определит тип компонентов в ней и применит необходимый шаблон компонента. В свою очередь, шаблон определяет целевую серверную папку, применимые схемы именования и определения жизненных циклов, а также сопоставление/интерпретацию параметров.

Экспорт и импорт конфигурации

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

Сохранение файла настройки миграции с расширением *.lmcfg осуществляется с помощью команды File » Export » Migration Config, и этот файл можно применить в любой момент с помощью команды File » Import » Migration.

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

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

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

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

Компоненты вне категорий

Обратите внимание, что на изображении выше одна из библиотечных подгрупп названа Uncategorized (а соответствующая запись в столбце Component Types – Uncategorized), что означает, что средство миграции не может определить и назначить тип для данной группы компонентов – тип компонентов задан None. В этом примере, неопределенные компоненты (логические микросхемы) используют неопознанный префикс позиционного обозначения (U?), и их параметры не содержат ключевые слова, такие как IC, logic и т.п.

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

Когда в диалоговом окне включен параметр Custom Designator Mapping, нажмите кнопку , чтобы создать новую запись для сопоставления, выберите нужный вариант строки позиционного обозначения для компонентов вне категорий из выпадающего списка Designator (в который включены все доступные позиционные обозначения), а затем выберите нужный тип компонентов из выпадающего меню Component Type. Подтвердите сопоставление типов компонентов и позиционных обозначений (позиционные обозначения U? в тип компонентов Logic) с помощью кнопки . Обратите внимание, что при необходимости вы можете вручную ввести множество типов позиционных обозначений, разделенных запятой.

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

Ошибки и предупреждения

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

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

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

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

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

• Удаление компонента из процесса миграции – щелкните ПКМ по записи компонента и выберите команду Exclude from Migration.
• Изменение вызывающего нарушение значения параметра – найдите и измените его ячейку до совместимого формата.
• Изменение типа (Type) сопоставленного параметра, заданного примененным шаблоном компонента, с Voltage на неинтерпретируемый Text – выберите исходную библиотеку в интерфейсе мигратора, затем измените тип (Type) для Forward Voltage в списке Parameter Mapping панели Properties (на вкладке General).

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

• Добавление ненайденного файла в ожидаемое расположение.
• Исключение компонента из процесса миграции библиотеки, как описано выше.
• Отключение миграции файлов даташитов – измените параметр Migrate в разделе Datasheet панели Properties (на вкладке Advanced).

Используйте поле Search (вверху справа), если вы хотите найти записи определенных компонентов. Поиск отфильтрует список объектов по совпадающим значениям параметров для выбранного типа компонентов – выберите All в столбце Component Types, чтобы провести поиск по всем компонентам в доступных исходных библиотеках.

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

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

С настройками средства миграции по умолчанию, этап валидации () отобразит предупреждение (Warning), если на целевом сервере будет обнаружен компонент с таким же именем (Name) или вариантами выбора (Part Choices), т.е. потенциальный дубликат компонента. Сообщение о предупреждении/ошибке включает в себя тип дублирования (параметр или вариант выбора компонента), название библиотечного компонента с нарушением и компонент на сервере (его ID), с которым возникает конфликт.

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

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

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

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

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

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

Такая ситуация с единой общей моделью обнаруживается средством Library Migrator, и он затем переносит только одну модель, которая применяется ко всем мигрируемым компонентам, вместо применения отдельного символа с собственным именем к каждому компоненту. Мигрируемый символ принимает общее название Symbol, все параметры компонента остаются неизменными.

Мигрированный библиотечный символ (с именем Symbol и пустым полем описания) можно изменить в соответствии с собственными требованиями. В панели Explorer используйте команду Edit контекстного меню для этого. Выберите команду Update items related to <ID_символа> в диалоговом окне Create Revisions for Item, чтобы обеспечить использование новой ревизии символа смигрированными компонентами.

Миграция только моделей

Средство Library Migrator можно переключить в специальный режим миграции Models Only (Только модели), который обнаруживает и обрабатывает доступные модели компонентов в исходной библиотеке. Чтобы переключиться в этот режим миграции, включите параметр LibraryMigrator.ModelsOnlyMode в диалоговом окне Advanced Setting, доступного со страницы System – General диалогового окна Preferences.

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

При переключении средства Library Migrator в расширенный режим () либо при его открытии в расширенном режиме (File » Library Migrator), становятся доступной вся подробная информация о планируемой миграции моделей. В области Migration Preview показана структура папок (Folder Structure), которая будет использоваться на целевом сервере. Ее настройку по умолчанию можно изменить в поле Folder панели Properties для каждого из типов моделей. Применяемые схемы именования и определение жизненного цикла для каждой модели можно выбрать из доступных системных типов (см. раздел Панель Properties ниже).

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

После того, как средство Library Migrator настроено, нажмите кнопку , чтобы завершить миграцию приведенных в списке моделей компонентов. Результаты можно просмотреть в лог-файле миграции, доступного из диалогового окна Library Migrator () или при просмотре мигрированных моделей в панели Explorer.

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

Типы компонентов, зарегистрированные в системе, т.е. на подключенном сервере, доступны для просмотра и управления ими на странице Data Management – Component Types диалогового окна Preferences. Вместе с типами приводятся связанные с ними шаблоны компонентов (Template) и серверные папки (Folder), и этот список будет включать в себя все новые типы, созданные после миграции файлов библиотек на сервер с помощью средства Library Migrator.

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

Вместо того, чтобы вручную изменять тип каждого компонента, страница Component Types диалогового окна Preferences позволяет объединить выделенные типы в одну указанную запись. Для этого выберите все записи типов, которые необходимо объединить, в том числе целевой тип, и затем щелкните ПКМ по выделенным записям и выберите команду Merge из контекстного меню. В открывшемся диалоговом окне Merging выберите целевой тип компонентов из выпадающего списка Merge to и нажмите кнопку для подтверждения. На изображении ниже это показано для набора мигрированных типов компонентов – резисторов.

Процесс изменит тип компонентов, участвующих в объединении (например, Resistor-0402, Resistor-0603 и т.д.) на целевой тип – Resistors в этом примере. Одним из полезных результатов является то, что все компоненты определенного типа теперь будут доступны при выборе этого типа в области Categories панели Components. Обратите внимание, что записи компонентов не изменяются каким-либо другим образом. Они остаются в своих существующих папках, которые связаны с шаблонами компонентов, созданными в процессе миграции, и сами шаблоны останутся доступными.

После объединения, на странице Data Management – Component Types будет показано, что тип компонентов Resistors является умолчательным для множества шаблонов, а именно – для шаблона Resistors и всех связанных с новым объединенным типом компонентов (шаблон Resistor_0402 и др.). Запись Folder для типа компонентов Resistors соответствует целевым папкам для этого множества шаблонов.

Результатом этого является то, что когда в средстве миграции в качестве типа мигрируемых компонентов выбран Resistors, он будет применен при выборе любого из объединенных шаблонов (Resistor_0402 и т.д.) в качестве альтернативы. При создании нового компонента (File » New » Component), эти шаблоны предлагаются в качестве подзаписей для типа компонентов Resistors в диалоговом окне Create new Component.

Назначения шаблонов

Диалоговое окно Edit Templates, которое открывается с помощью кнопки , позволят изменить сопоставление шаблонов и типов компонентов, обозначенное на странице Data Management – Component Types. Это сопоставление, которое отображается в столбцах диалогового окна, показывает, какой тип компонента (Component Type) будет применен при использовании соответствующего шаблона (Template) – и наоборот, какой шаблон используется при выборе типа компонента (например, при создании нового компонента).

Для выбранной в диалоговом окне записи шаблона, изменение сопоставления осуществляется путем выбора альтернативного типа компонентов из выпадающего меню это записи. При последующем закрытии диалогового окна и страницы, значение параметра ComponentType шаблона и его настройка Default Folder будет изменена на соответствующие указанному типу. Это эквивалентно изменению шаблона вручную.

Результат обновленного сопоставления шаблонов и типов отображается на странице Data Management – Components Types, где показан список типов компонентов (столбец Name). Здесь обозначено, что с типом компонентов Resistor связано множество различных типов (Resistor_0402, Resistor_0603 и т.д.).

Панель Properties

Настройки в связанной со средством Library Migrator панели Properties обеспечивают расширенный контроль над миграцией выбранной библиотеки (или группы подбиблиотек). Настройки панели определяются системными настройками по умолчанию или теми настройками, которые указаны в применяемом шаблоне компонента, который, в свою очередь, определяется типом компонента – LED в примере показанном ниже. Эти настройки также доступны для изменения пользователем, что позволяет определять процесс миграции необходимым образом, и их можно восстановить до настроек по умолчанию с помощью ссылки Reset to Default (вверху справа).

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

• General (Общее) – тип компонентов, обнаруженный средством миграции для выбранной библиотеки (Component Type) и соответствующий применяемый шаблон (Component Template). Переопределите эти настройки, введя значение в поле, что создаст новый тип компонентов, или выбрав альтернативный тип или шаблон с помощью кнопок – это еще один способ устранить проблему компонентов вне категорий. Задайте параметру Component Template значение Create new для автоматического создания шаблона на основ параметров исходной библиотеки и текущих настроек средства Library Migrator.
• Parameter Mapping (Сопоставление параметров) – соответствие параметров между библиотечными параметрами и теми параметрами, которые находятся в шаблоне компонента, а также тип значения для каждого параметра (текстовый или с единицами измерения). Используйте выпадающие меню в столбце Source Library Parameter для внесения изменений в сопоставление и выпадающие меню в столбце Type для переопределения существующих настроек, заданных шаблоном. Вы можете изменять имена параметров, а также добавлять, изменять и удалять наборы параметров.
• Part Choice Mapping (Сопоставление вариантов выбора компонентов) – список параметров вариантов выбора (или ссылок на поставщиков), распознанных средством миграции. Используйте выпадающие меню для переопределения сопоставления, а также для добавления и удаления наборов сопоставлений.
• Migration Checks (Проверки миграции) – просматривайте и настраивайте отчеты средства миграции об ошибках/предупреждениях для нарушений правил миграции. Используйте выпадающее меню Report Mode для изменения отчета и иконки для записи Violation Type. Обратите внимание, что если выбран режим отчета Fatal Error, то при обнаружении этого нарушения процесс миграции будет приостановлен.

Вкладка Advanced панели предлагает настройки для всех объектов мигрируемых данных, заданных системными настройками по умолчанию или применяемым шаблоном компонента. Эти настройки включают в себя модели компонентов, файлы даташитов и все созданные шаблоны компонентов. Настройки для каждого объекта (кроме Datasheet, который представляет собой переключатель) включает в себя следующие разделы:

• Folder (Папка) – целевая серверная папка для мигрируемого объекта, которую можно изменить вручную или выбрать с помощью кнопки .
• Naming Scheme (Схема именования) – серверное именование объекта, определенное шаблоном компонента. При отсутствии активного шаблона, схема определяется целевой папкой (или вводится вручную).
• Revision Naming Scheme (Схема именования ревизий) – схема именования, используемая для ревизий объекта на сервере, которая определена шаблоном или выбрана из выпадающего меню записи. Для выбора будут доступны только схемы, включенные системой.
• Lifecycle Definition (Определение жизненного цикла) – система жизненных циклов, используемая для объекта, которая определена шаблоном или выбрана из выпадающего меню записи. Для выбора будут доступны только определения, включенные системой.