Working with Items

В подключенном Workspace каждая сущность проекта, которую можно хранить, управлять ею и повторно использовать, представлена определенным типом Item. Чтобы поддерживать возможность обновления Item с течением времени, в Workspace фактически хранится серия ревизий Item (Item Revisions) — конкретных ревизий этого Item, имя которых формируется на основе выбранной схемы именования ревизий. Каждый новый Item создается в папке, и после того как вы определили необходимые папки в Workspace, вы можете создавать новые Items в выбранной папке в области Items панели Explorer.

Поддерживаемые типы содержимого

Разные Items используются для хранения и представления разных типов данных. Один Item может представлять условное графическое обозначение на схеме, другой — модель PCB-компонента, а еще один — сгенерированные производственные данные из выпущенного проекта платы. Чтобы указать, какой тип содержимого будет хранить Item (точнее, его ревизии), необходимо задать его свойство Content Type при создании или редактировании этого Item. Иными словами, по сути вы задаете Item Type.

В следующей таблице перечислены различные типы содержимого (типы Item), которые пользователь может вручную создавать в подключенном Workspace, а также:

• Associated Folder Type – специально предназначенный тип папки, если он доступен, в которой можно хранить содержимое данного типа. Это никак не влияет на содержимое папки. Это лишь дает визуальную «подсказку» о том, что хранится в папке, и может быть полезно при просмотре Workspace в поиске определенного содержимого. Содержимое можно хранить в папке любого типа, включая Generic Folder.

• Content Type Code – код, используемый при назначении уникального идентификатора создаваемому Item данного типа содержимого, если схема именования Item родительской папки использует запись $CONTENT_TYPE_CODE.

• Folder Type Code – код, используемый при назначении уникального идентификатора создаваемому Item данного типа содержимого, если схема именования Item родительской папки использует запись $FOLDER_TYPE_CODE.

Ревизии Item

Item может иметь любое количество ревизий, которые по сути отражают развитие этого Item с течением времени. Вносятся изменения, и новое содержимое данных сохраняется/загружается/выпускается в новую ревизию, что гарантирует невозможность перезаписи любой существующей ревизии и тем самым обеспечивает максимальную целостность. Поэтому данные, хранящиеся в каждой ревизии Item, обычно различаются. Для различения этих ревизий Item используется идентификатор ревизии (ID), который в сочетании с ID Item создает уникальный идентификатор для каждого выпуска Item. Это дает нам Item-Revision.

Таким образом, полный ID Item-Revision просто идентифицирует конкретную ревизию родительского Item. У Item всегда будет как минимум одна ревизия (первый выпуск), но их может быть много — в зависимости от того, сколько раз данные для этого Item сохранялись/загружались/выпускались. Здесь важно отметить, что выпуск в конкретный Item-Revision можно выполнить только один раз. Если есть изменения, необходимо создать новый Item-Revision. Это обеспечивает максимальную целостность, поскольку данные, содержащиеся в данной ревизии, никогда не могут быть перезаписаны повторным выпуском в ту же ревизию. Для повторного выпуска необходимо использовать новый Item-Revision.

Самый простой способ понять концепцию Item и его ревизий — представить себе «коробку», в которую помещаются все данные для конкретной ревизии конкретного Item. Когда Item выпускается, данные помещаются в коробку, и коробка закрывается. ID Item и ID Revision становятся метками на боковой стороне этой коробки — они позволяют мгновенно понять, для чего предназначено содержимое коробки. Если данные нужно обновить и выпустить повторно, ID Revision увеличивается, создавая новую коробку.

«Коробка» Item-Revision — с метками ID Item и ID Revision. Содержимое — это данные, необходимые для создания или представления этой ревизии данного Item. Действие выпуска закрывает коробку, предотвращая выпуск любых других данных в эту ревизию в будущем. Полный ID Item-Revision в этом случае будет: D-820-1001-01.A.1.

Формат ID ревизии определяется Revision Naming Scheme для родительского Item. Конкретный формат, используемый в схеме, настраивается и зависит от потребностей каждой организации.

Примечания к изменению состояния и выпуску

Для расширения аудиторского следа содержимого в Workspace Altium Designer предоставляет возможность вводить примечания при изменении состояния жизненного цикла Item-Revision и, для многих типов содержимого, при выпуске исходных данных в запланированные ревизии в Workspace.

Примечания к изменению состояния

При изменении состояния жизненного цикла Item-Revision в Workspace используйте область State change note в последующем диалоговом окне изменения состояния, чтобы ввести соответствующее примечание для этого изменения.

Добавление примечания для пояснения изменения состояния жизненного цикла Item-Revision.

Примечания к выпуску

При выпуске исходных данных в новую запланированную ревизию Item в Workspace используйте область Release notes в последующем диалоговом окне Create Revision, чтобы ввести соответствующее примечание к этому выпуску. Эта возможность доступна при повторном выпуске любого типа Item, поддерживающего парадигму Direct Editing.

Пример добавления примечания к выпуску при повторном выпуске стека слоев в целевой Workspace.

Просмотр примечаний, связанных с ревизиями Item

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

• Detailed Item view – просматривайте связанное примечание к выпуску и примечания к изменениям состояния ревизии в столбце Note в области Timeline. Для каждого состояния в жизненном цикле ревизии соответствующее примечание (если оно было добавлено) также можно увидеть в графическом представлении жизненного цикла ревизии.
• Explorer panel – переключитесь на вкладку представления аспектов Lifecycle для выбранной редакции элемента. Для каждого состояния в жизненном цикле редакции соответствующее примечание (если оно добавлено) можно увидеть в графическом представлении жизненного цикла редакции. Кроме того, связанное примечание к выпуску и примечание к последнему изменению состояния редакции можно просмотреть в столбце Note в основной области Item панели (возможно, потребуется включить отображение этого столбца).

Просмотр примечаний, связанных с редакциями компонента.

Общие команды элемента

Помимо параметров просмотра, область параметров панели Explorer также включает кнопку команды Add <item>, которая применяется к текущему выбранному типу папки.

Эта команда запускает создание нового элемента Workspace выбранного типа. Например, когда на панели выбран тип папки компонента, предлагается кнопка . Она откроет вновь созданный компонент этого типа в редакторе Component Editor. Аналогично, кнопка отображается, когда выбран тип папки Output Job, и так далее. Кнопка будет доступна после поиска компонента, введенного в поле пути к компоненту в верхней части панели; она создает действие Part Request, относящееся к компоненту, выбранному в результатах поиска.

Размещение перетаскиванием

Размещение некоторых элементов Workspace в проекте PCB в Altium Designer упрощено благодаря возможности перетаскивать редакции этих типов элементов на активный (и подходящий) документ непосредственно из панели Explorer. Поддерживается перетаскивание:

• редакции Component Item на активный схематический документ (или документ PCB). Соответствующая модель для выбранной области будет отображаться на курсоре.
• редакции Managed Schematic Sheet Item на активный схематический документ. Символ листа, ссылающийся на этот лист, будет прикреплен к курсору.
• редакции 3D Model Item на документ PCB или PCB Library, создавая объект 3D Body, который ссылается на эту редакцию элемента.

Найдите в Workspace нужный элемент для размещения. Размещение выполняется для конкретной редакции этого элемента, поэтому обязательно разверните основную запись элемента, чтобы отобразить список всех доступных редакций (нажмите кнопку в правом верхнем углу панели и отключите параметр Show only latest, чтобы увидеть все предыдущие редакции). Затем щелкните нужную редакцию и перетащите ее экземпляр на документ проекта.

Кроме того, Altium Designer поддерживает доступ к компонентам и их размещение из панели Components panel.

Загрузка данных содержимого

Загрузите данные, хранящиеся в редакции элемента, щелкнув правой кнопкой мыши по этой редакции и выбрав команду Operations » Download в контекстном меню. Связанные данные будут загружены в подпапку внутри выбранного каталога, имя которой формируется по идентификатору редакции элемента. Файлы можно найти во вложенной папке Released.

Тип содержимого Binary File

Altium Designer совместно с подключенным Workspace поддерживает возможность хранения произвольных файлов в специальном типе содержимого — элементе Binary File. Такие элементы можно создавать для размещения одного или нескольких файлов любого формата. Это позволяет эффективно использовать защищенную природу Workspace и подчеркивает, что Workspace является идеальным местом для хранения чего угодно, включая исходные бинарные файлы, объединенные в одну сущность. Для упрощения потока файлов данных также предусмотрена двунаправленная функция drag-and-drop, позволяющая быстро перемещать файлы между папками в Workspace и папками в Windows Explorer.

• Создайте в Workspace элемент типа содержимого Binary File. Новую редакцию элемента Binary File можно создать, загрузив соответствующий файл или файлы. Это можно сделать несколькими способами — подробнее см. в разделе Uploading Data into a New Revision of an Item.
• Если необходимо изменить файл или файлы, хранящиеся в элементе Binary File, загрузите в этот элемент новые нужные файлы — они будут сохранены в следующей редакции этого элемента.
• Чтобы открыть файл, хранящийся в редакции элемента Binary File, выберите этот файл на вкладке представления аспектов Details для редакции, затем щелкните правой кнопкой мыши и выберите команду Open в контекстном меню. Для отображения файла будет использовано соответствующее приложение (или сам Altium Designer), если это применимо.

Использование Binary File с настройками шаблонов

В рамках настроек Altium Designer можно определить документы шаблонов по умолчанию, используемые при создании нового документа определенного типа. Это выполняется на вкладке Defaults страницы Data Management – Templates page диалогового окна Preferences. Документ шаблона по умолчанию может быть файловым или из подключенного Workspace.

Для некоторых типов документов (ActiveBOM Document, Out Job File, Multi-board Schematic и Multi-board Assembly) документ шаблона по умолчанию на основе Workspace может быть получен только из бинарного файла. Поэтому необходимо загрузить требуемый документ шаблона в редакцию бинарного файла, а затем использовать его как значение по умолчанию для нового документа.

Загрузите нужный документ (например, файл OutputJob) в начальную редакцию нового бинарного файла.

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

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