Управление содержимым с помощью менеджера элементов

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

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

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

• Migration – во-первых, оно позволяет преобразовать проект из использования компонентов и листов схем, основанных на традиционных подходах, к использованию сущностей Workspace (компонентов и управляемых листов). В этом смысле его можно рассматривать как функцию «преобразовать для использования данных Workspace».
• Synchronization – во-вторых, после преобразования проекта для использования содержимого Workspace, Item Manager предоставляет простой способ синхронизировать содержимое, используемое в проекте, с соответствующим исходным содержимым в Workspace, которое было обновлено. В этом смысле его можно рассматривать как функцию «обновить из данных Workspace».

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

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

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

Кроме того, компоненты можно заменять через документ ActiveBOM проекта (BomDoc).

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

Доступ к Item Manager

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

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

Откройте Item Manager из основного Tools menu редактора схем. Диалоговое окно автоматически заполнится компонентами текущего проекта (и листами схем).

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

Столбцы

Чтобы настроить, какие столбцы отображаются в Item Manager, щелкните правой кнопкой мыши в области заголовков столбцов диалогового окна и выберите Columns » Select Columns в контекстном меню. Диалоговое окно Select columns предложит все доступные параметры, включая относящиеся непосредственно к локальному проекту ([Current Settings]) и содержимому в Workspace ([New Settings]). Используйте значок «глаз» слева от записи, чтобы показывать столбец () или скрывать его ().

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

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

Группировка

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

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

Переход на проектное содержимое Workspace

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

Ручной выбор содержимого Workspace

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

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

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

Сведения о выбранном Item Workspace отображаются в области New Settings таблицы, перечисленные на вкладке Managed.

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

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

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

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

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

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

Сложные правила с несколькими параметрами требуют, чтобы все указанные параметры компонента совпадали с параметрами компонента в Workspace.

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

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

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

Если совпадение не найдено, запись будет отображаться со значком состояния , красным текстом и с указанием причины ошибки или сбоя сопоставления — для успешного сопоставления таких компонентов потребуется создать другое или дополнительное правило. Также обратите внимание, что правило может обнаружить в Workspace более одного компонента как совпадение; это считается успешным результатом, но требует ручного вмешательства для разрешения. Такой конфликт считается «неоднозначным» результатом и может быть устранен в диалоговом окне Item Manager — см. ниже.

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

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

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

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

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

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

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

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

Используйте кнопку Add Rule в диалоговом окне Item Manager Options, чтобы создать новое правило, и связанный элемент , чтобы применить несколько условий сопоставления параметров. Нажмите , чтобы удалить выбранное значение. По мере добавления каждого условия параметра правило становится все более специфичным, и для успешного совпадения должны выполняться все условия — фактически это логическое условие И. Нажмите кнопку Remove, чтобы удалить выбранное правило сопоставления.

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

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

Параметры обновления

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

Область Matching rules отображает текущие правила, определенные для сопоставления. Подробнее см. в разделе Automatching Components. 

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

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

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

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

Можно точно указать, какие параметры компонента обновляются. Щелкните правой кнопкой мыши, чтобы открыть параметры отметки.

Поведение замены (или добавления) параметров определяется двумя нижними параметрами в диалоговом окне:

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

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

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

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

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

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

Item Manager, показывающее новые текущие настройки содержимого проекта в PCB-проекте. Ранее локальные компоненты проекта были полностью заменены компонентами Workspace.

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

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

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

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

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

Для отдельно выбранного компонента или символа листа соответствующий режим Component или Sheet Symbol панели Properties сразу покажет, что объект устарел относительно исходных данных в Workspace. Используйте связанную кнопку или , чтобы обновить данные этого объекта из исходного Workspace.

Состояние устаревания компонента или управляемого листа схемы отображается на панели Properties, когда объект выбран. Предусмотрена кнопка для обновления выбранного объекта до его последней ревизии.

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

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

Обратите внимание на все компоненты и управляемые листы схемы, которые были определены как Out of Date, выберите их, затем щелкните правой кнопкой мыши и выполните Update.

Обновление содержимого

Чтобы привести устаревшее содержимое в актуальное состояние, его необходимо выбрать, а затем применить команду Update to latest revision из контекстного меню по правому щелчку. После этого область New Settings диалогового окна покажет сведения о каждой новой Item-Revision.

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

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

Выберите устаревшее содержимое и используйте команду Update to latest revision по правому щелчку, чтобы загрузить в область New Settings сведения об обновленной ревизии. Затем примените обновление — через ECO — к компоненту(ам) и управляемому(ым) листу(ам) схемы обратно в проекте.

Проверить, что замена действительно прошла успешно, можно на уровне отдельного компонента/символа листа на листах схемы проекта платы. Откройте панель Properties для выбранного элемента — теперь она будет показывать ссылку на соответствующий исходный управляемый Item. Либо проверку можно быстро выполнить обратно в Item Manager, который обновится, чтобы отразить новые настройки элементов проекта платы в области Current Settings сетки.

Отчет Item Manager

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

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