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

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

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

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 меню при активном документе схемы (Tools » Item Manager) и отображает все компоненты и символы листов, найденные в активном проекте платы.

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

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

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

Столбцы

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

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

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

Группировка

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

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

Миграция на содержимое проекта в Workspace

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

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

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

Когда диалог закрыт (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 будут иметь общий корпоративный идентификатор или параметр номера детали производителя (manufacturer part number).

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

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

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

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

Пример успешного сопоставления «локальный → Workspace» для многих компонентов с использованием одного правила на основе общего номера детали.

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

Когда процесс автоматического сопоставления завершён, закройте диалог 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. Можно создать любое количество правил; они работают по убывающему приоритету. Если первое (верхнее) правило не срабатывает, применяется следующее — фактически это последовательная логическая связь OR (ИЛИ). Правило активно только тогда, когда включён связанный с ним флажок.

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

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

Используйте кнопку Add Rule в диалоге Item Manager Options, чтобы создать новое правило, и связанный элемент  для применения нескольких условий сопоставления параметров. Нажмите  , чтобы удалить выбранное значение. По мере добавления каждого условия параметра правило становится всё более специфичным, и для успешного сопоставления должны быть выполнены все условия — фактически это логическое условие AND (И). Нажмите кнопку 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.

Пример, показывающий успешную замену локального компонента, где панель 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 — к компоненту(ам) и управляемому(ым) листу(ам) схемы обратно в проекте.

Обратите внимание: во время обновления ревизии (синхронизации) параметры Item Parameters будут обновлены в соответствии с текущими настройками Update Options в диалоге Item Manager Options (открывается кнопкой в Item Manager) — см. Update Options выше.

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

Отчет Item Manager

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

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