Working with Items

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

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

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

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

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

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

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

Ревизии Item

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

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

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

«Коробка» Item-Revision — с метками Item ID и Revision ID. Содержимое — это данные, необходимые для изготовления или представления этой ревизии данного Item. Действие выпуска закрывает коробку, предотвращая выпуск любых других данных в эту ревизию в будущем. Полный Item-Revision ID в этом случае будет: 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.

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

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

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

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

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

Общие команды Item

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

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

Размещение перетаскиванием (Drag & Drop)

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

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

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

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

Загрузка данных контента

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

Тип контента Binary File

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

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

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

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

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

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

Теперь, когда вы попытаетесь определить новый документ по умолчанию из подключённого Workspace, вы сможете найти этот binary file, и запись в preferences будет заполнена соответствующим образом.

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