Управление объектами с помощью Item Manager

Altium Designer в сочетании с сервером управляемых данных, предлагает возможность обновлять компоненты в существующем проекте платы для использования управляемых компонентов, которые находятся на этом сервере. Локальные "неуправляемые" компоненты могут быть изменены на серверные управляемые объекты компонентов по отдельности либо массово, с помощью автоматизированного сопоставления параметров через Item Manager в Altium Designer.

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

Диалоговое окно Item Manager предоставляет две ключевые функции для компонентов и листов повторно используемых схем в проектах плат:

• Миграция – прежде всего, доступен переход от использования в проекте компонентов и листов схем, основанных на традиционных неуправляемых файлах, до применения полностью управляемых серверных сущностей (управляемых компонентов и управляемых листов). С этой точки зрения, Item Manager можно рассматривать как средство "преобразования для использования серверных данных".
• Синхронизация – после того, как проект преобразован для использования управляемых (серверных) объектов, в диалоговом окне Item Manager вы можете легко синхронизировать объекты, используемые в проекте, с соответствующими исходными объектами на сервере. С этой точки зрения, Item Manager можно рассматривать как средство "обновления данных с сервера".

Обратите внимание, что отдельный компонент в проекте можно изменить на серверный компонент непосредственно из панели Properties в редакторе схем. Для этого, выберите компонент в рабочей области и используйте выпадающее меню Source в панели, чтобы выбрать сервер управляемых данных в качестве источника данных – для этого должен быть осуществлен вход на сервер. В открывшемся диалоговом окне Component source вы можете выбрать целевой компонент на сервере или связать компонент с сервером, при этом сохранив или заменив идентификатор компонента (Design Item ID).

Если был выбран серверный компонент, его данные заменят существующий компонент и модели и обновят параметры компонента. В панели будет также показано текущее состояние ревизии (Revision State) и статус синхронизации, как показано ниже.

Локальные неуправляемые компоненты можно преобразовать в серверные управляемые компоненты по отдельности или массово, с помощью Item Manager. Здесь показан изначальный неуправляемый компонент. Наведите курсор мыши на изображение, чтобы увидеть этот компонент, измененный на управляемый.

Поскольку такой способ может быть трудоемким при обновлении всех неуправляемых компонентов на управляемые даже в небольшом проекте, диалоговое окно Item Manager предоставляет простой автоматизированный способ, использующий подход расширенного сопоставления параметров (Automatching) и пакетное обновление. Типовым применением Item Manager может быть обновление существующего проекта платы для использования управляемых компонентов и управляемых листов схем, которые были мигрированы на сервер управляемых данных из библиотек компании.

► Для получения информации по преобразованию библиотек компонентов в серверные управляемые компоненты перейдите на страницу по средству Library Migrator в Altium Designer.

Доступ к Item Manager

Диалоговое окно Item Manager открывается из главного меню Tools активного документа схемы (Tools » Item Manager). Здесь будут представлены все компоненты и символы листов активного проекта платы.

Выберите вкладку Unmanaged или Components в нижней части диалогового окна, чтобы отобразить список компонентов текущего проекта. Слева показаны настройки компонентов активного проекта (Current Settings), а справа – как они будут изменены после выбора нужных управляемых компонентов с сервера (New Settings). Чтобы отобразить символы листов, выберите вкладку Sheet Symbols.

Доступ к Item Manager из главного меню Tools редактора схем. В диалоговом окне будут автоматически собраны компоненты (и схемные листы) текущего проекта.

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

Столбцы

Чтобы задать отображаемые столбцы в Item Manager, щелкните ПКМ по области заголовков столбцов и выберите Columns » Select Columns из контекстного меню. Будет открыто диалоговое окно Select Columns со всеми доступными параметрами из текущих настроек в локальном проекте ([Current Settings]) и новыми настройками управляемых объектов на сервере управляемых данных ([New Settings]). Используйте элемент управления с изображением глаза слева от записи, чтобы отображать этот столбец () или нет ().

Отображаемые столбцы и их порядок можно настроить в соответствии со своими предпочтениями.

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

Группирование

Чтобы сгруппировать данные приведенных в списке объектов по определенному столбцу параметров, например, по категории компонента или схемному документу, перетащите мышью запись заголовка нужного столбца в верхнюю строку диалогового окна (обозначенную текстом Drag a column header here to group by that column). Список объектов будет сгруппирован по записям этого столбца параметров.

В верхнюю строку диалогового окна можно перетащить заголовок любого столбца данных для группирования списка по соответствующему параметру.

Миграция в управляемые проектные объекты

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

Выбор серверных объектов вручную

Чтобы вручную заменить локальный компонент (или лист схемы) на его управляемую версию с сервера, выберите его запись в списке в Item Manager и используйте команду Choose manually из контекстного меню. В открывшемся диалоговом окне Replace Component найдите и выберите подходящий управляемый объект на сервере (будет использоваться самая новая ревизия этого объекта).

Пример ручного выбора управляемого компонента для его использования в качестве источника существующего в проекте компонента.

При закрытии этого диалогового окна (OK) информация о выбранном управляемом компоненте будет отображена в области New Settings списка. Обратите внимание, что поскольку эта запись теперь будет управляемой сущностью, она перейдет из списка на вкладке Unmanaged в список на вкладке Managed.

Информация о выбранном управляемом объекте появится в области New Settings таблицы, на вкладке Managed.

Автоматическое сопоставление объектов компонентов

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

Основой возможностей Item Manager по автоматическому сопоставлению параметров являются правила и настройки обновления, доступные в диалоговом окне Item Manager Options. Чтобы открыть его из Item Manager, используйте кнопку . Настраиваемые правила определяют, какие параметры компонентов в активном (локальном) проекте необходимо сопоставить с параметрами управляемых компонентов на выбранном исходном сервере (Source server).

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

Эффективность этих правил сопоставления компонентов будет зависеть от доступных параметров компонентов. В самом простом, но маловероятном случае, у локальных и эквивалентных серверных компонентов будут соответствовать параметры Comment или Component Name. В идеале, локальные и серверные компоненты будут использовать одни и те же внутренние номера или номера компонентов производителей.

Чтобы создать, например, правило по номеру компонента, выберите и измените существующее правило (которое также можно переименовать) или используйте кнопку , чтобы создать новое правило. Для редактирования правила оно должно быть выбрано (отмечено флажком). Обратите внимание, что выпадающие списки Local Parameter и Server Parameter не зависят друг от друга, что позволяет указывать разноименные параметры – например, локальный параметр Library Reference и серверный параметр Part Number, которые представляют номер компонента в компании.

Для сложных правил со множеством параметров необходимо, чтобы все указанные параметры компонентов соответствовали таковым в управляемом компоненте.

При запуске правила сопоставления по номеру компонента, скорее всего, будет найдено соответствие для всех локальных и серверных компонентов. Когда правило задано, процесс сопоставления запускается нажатием кнопки в диалоговом окне Item Manager.

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

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

Если сопоставление не может быть найдено, запись будет отображена красным цветом, у нее будет отображена иконка , а также будет обозначена причина ошибки или сбоя сопоставления. Для успешного сопоставления необходимо создать другое или дополнительное правило. Также обратите внимание, что правило может обнаружить больше одного серверного объекта (компонента), что считается успешным результатом, но требует ручного вмешательства для решения. Эту ситуацию с "избыточным" результатом можно устранить в диалоговом окне Item Manager – см. ниже.

По завершении процесса автоматического сопоставления закройте диалоговое окно Automatching Items (OK). В диалоговом окне Items Manager будут представлены новые планируемые настройки компонентов. Ожидающие управляемые объекты, которые будут применены соответствующим записям, перечислены в области New Settings на вкладке Managed диалогового окна, а также на вкладке Components вместе с компонентами, которые не были сопоставлены.

Ожидающие замены на серверные управляемые объекты обозначены в области New Settings диалогового окна.

Чтобы устранить проблему избыточных объектов, появившуюся, как правило, из-за множественного сопоставления, перейдите на вкладку Ambiguous Items (или Ambiguous Footprints) и в области New Settings диалогового окна выберите нужный объект в выпадающем меню Not selected – обратите внимание, что множественные сопоставления и, соответственно, доступные варианты выбора могут на самом деле относиться к различным ревизиям одного объекта компонента. Когда проблема будет устранена (решение больше не будет избыточным), запись компонента перейдет в список на вкладке Managed/Components.

Если правило обнаружит больше одного сопоставления, вкладка Ambiguous Items позволит указать нужный объект. Если будет найдено больше шести сопоставлений, возникнет ошибка правила.

Расширенные правила сопоставления

Как обозначено выше, правила в Item Manager задают сопоставления параметров между локальными компонентами в проекте и управляемыми компонентами на сервере. Может быть создано любое количество правил, которые будут работать по принципу убывающего приоритета. Если первое (верхнее) правило не срабатывает, применяется следующее правило – по сути, соответствие на основе последовательного логического условия ИЛИ. Правило является активным только когда включен соответствующий флажок.

При запуске процесса автоматического сопоставления, в столбце State Notes диалогового окна Automatching Options обозначается, какое правило не сработало при поиске сопоставления. В этом случае, для сопоставления по доступным параметрам необходимо другое правило или новое правило.

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

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

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

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

Настройки обновления

Диалоговое окно Item Manager Options позволяет задать настройки обновления объектов для определения того, как автоматически сопоставленные управляемые компоненты будут применены для проекта платы.

Настройки обновления в Item Manager позволяют гибко задать, какие параметры будут обновлены и при каких условиях.

Эти настройки будут применены к текущему проекту в ходе процесса ECO следующим образом:

• Update ‘Lock Designator’ field – когда эта настройка включена, состояние Locked поля Designator локального компонента будет переопределено его состоянием в управляемом компоненте.
• Update ‘Lock Part-ID’ field – когда эта настройка включена, состояние Locked селектора ID многосекционного локального компонента примет это состояние из управляемого компонента.
• Update Parameters – включите эту настройку, чтобы разрешить обновление параметров компонентов до параметров в управляемом компоненте. При включении станут активными следующие настройки:
  • Кнопка – открывает диалоговое окно Library Update Settings (см. ниже).
  • Preserve parameter location – когда эта настройка включена, положение видимых параметров в рабочей области остается неизменным, в противном случае оно будет сброшено до положения по умолчанию, заданному в управляемом компоненте.
  • Preserve parameter visibility – когда эта настройка включена, состояние Visible параметров остается неизменным, в противном случае будет принято состояние из управляемого компонента.

Диалоговое окно Library Update Settings включает в себя список всех доступных параметров из всех компонентов в проекте платы (щелкните ПКМ для доступа к командам для массового включения/отключения). Параметры, которые отмечены в списке, будут обновлены, когда локальный компонент будет обновлен/заменен на управляемый компонент – поведение этого обновления определяется настройками, обозначенными ниже.

Вы можете точно задать, какие параметры компонентов будут обновлены. Щелкните ПКМ, чтобы открыть команды выбора.

Замена (или добавление) параметров определяется двумя параметрами в нижней части диалогового окна:

• Library parameters not in sheet – определяет поведение обновления, когда параметр управляемого компонента отсутствует в локальном неуправляемом компоненте.
  • Add – параметр будет добавлен в компонент при обновлении.
  • Do not add – параметр не будет добавлен в компонент при обновлении.
  • Add if not blank – параметр будет добавлен при обновлении лишь в том случае, если у него есть валидные данные (его значение не является пустым).
• Sheet parameters not in library – определяет поведение обновления, когда параметр в локальном неуправляемом компоненте отсутствует в управляемом компоненте.
  • Remove – существующий (локальный) параметр будет удален из компонента при обновлении.
  • Do not remove – существующий параметр будет удален из компонента при обновлении.
  • Remove if blank – существующий параметр будет удален из компонента при обновлении, если у него нет валидных данные (его значение является пустым).

Применение обновлений

Запланированные изменения, которые были заданы в диалоговом окне Item Manager, применяются к текущему проекту платы путем формирования и выполнения перечня запросов на инженерные изменения – Engineering Change Order (ECO). Выберите в списке набор компонентов, которые вы хотите обновить, затем нужный вариант запуска ECO из меню кнопки . Доступные варианты:

• Generate ECO – используйте эту команду для формирования и выполнения перечня ECO через диалоговое окно Engineering Change Order. В этом диалоговом окне вы можете просмотреть действия, которые будут применены для реализации этих изменений, и отключить действия, которые не нужны. Когда перечень настроен нужным образом, выполните ECO, и изменения будут применены.
• Apply ECO – используйте эту команду, чтобы создать и выполнить ECO в "тихом" режиме (без открытия диалогового окна Engineering Change Order).

Изменения применяются через механизм Engineering Change Order, который можно запустить в тихом режиме или через диалоговое окно (как показано здесь).

Запущенный процесс ECO обновит компоненты в проекте соответствующим образом, и они будут отображены в диалоговом окне Item Manager как используемые в данный момент управляемые компоненты. Обратите внимание, что предыдущая иконка, которая использовалась для записей в списке (), будет заменена на ту, которая указывает на использование управляемых компонентов ().

Диалоговое окно Item Manager показывает новые актуальные настройки объектов в проекте платы. Используемые ранее неуправляемые компоненты были полностью заменены на управляемые объекты компонентов с сервера управляемых данных.

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

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

Синхронизация с измененными данными на сервере

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

Определение необходимости обновления

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

Помимо того, что Item Manager позволяет находить компоненты, которые в данный момент являются неуправляемыми (обозначены записью [Not Managed], и их источником не является сервер управляемых данных), он также используется для поиска любых неактуальных объектов и управления ими.

При открытии Item Manager происходит автоматическая компиляция проекта, поиск и отображение всех компонентов (с указанием, являются они управляемыми или нет) и сравнение ревизий объектов всех управляемых компонентов на схеме с доступными ревизиями этих объектов на сервере управляемых данных. Если на сервере доступны объекты с более новыми ревизиями, эти объекты обозначаются в столбце Revision Status как Out of date.

Обратите внимание на компоненты, которые были обнаружены как неактуальные (Out of Date), выберите их и выполните обновление через контекстное меню.

Обновление объектов

Чтобы обновить неактуальные объекты, выберите их и используйте команду Update to latest revision контекстного меню. В области New Settings диалогового окна будет показана информация о новых ревизиях объектов. Выберите Apply ECO из меню кнопки ECO, чтобы сформировать перечень ECO и применить новые ревизии к компонентам в проекте без открытия диалогового окна ECO.

Выберите неактуальные объекты (с помощью сочетания Shift+ЛКМ) и используйте команду Update to latest revision контекстного меню, чтобы загрузить информацию об обновленных ревизиях в область New Settings. Затем с помощью ECO примените обновления к компонентам в проекте.

Обратите внимание, что в процессе обновления ревизии (синхронизации) параметры объектов будут обновлены в соответствии с настройками Update Options в диалоговом окне Item Manager Options (открывается при нажатии кнопки – см. раздел Настройки обновления выше).

Отчет Item Manager

Перед запуском процесса обновления или изменения компонентов в Item Manager может быть полезно создать слепок текущей информации в списке с помощью функции Export. Для этого щелкните ПКМ где-либо в Item Manager и выберите Export из контекстного меню, затем задайте нужное место сохранения и название отчета. Отчет будет сформирован как HTML-файл с той же структурой, которая отображается в Item Manager.

Выберите Export из контекстного меню, чтобы сформировать отчет из Item Manager. Отчет формируется в формате HTML и представляет слепок данных всего списка из Item Manager.