Получение данных Workspace с помощью Content Cart
Функция Data Acquisition в Workspace предоставляет удобный инструмент, позволяющий фактически копировать данные между двумя Workspace (см. информацию о совместимости). Средством, с помощью которого это выполняется — вашим интерфейсом к службе Data Acquisition Service — является Content Cart. Это центральный пункт управления для определения того, что нужно получить из исходного Workspace и перенести в выбранный целевой Workspace — надежный «фургон для переезда», который «перевозит» выбранные вами данные между уже обжитыми «адресами» Workspace.
Нет лучшего способа показать, как работает функция, чем на примере. Поэтому, чтобы продемонстрировать все нюансы Content Cart и его использование для получения данных, в этой статье рассматривается получение некоторых компонентов между следующими Workspace:
-
Source Server – Workspace с именем
Company Workspace. -
Target Server – второй Workspace с именем
Secondary Company Workspace.
Доступ к Cart
Доступ к диалоговому окну Content Cart выполняется из панели Explorer panel. Просматривая исходный Workspace, из которого вы хотите получить данные, щелкните правой кнопкой мыши по ревизии элемента (Item Revision), которую нужно получить, и выберите команду Operations » Add to Content Cart в контекстном меню. Можно добавить одну или несколько выбранных ревизий элементов (Item Revisions) или даже папку с элементами (Items). При первом открытии Cart он загружается ревизией(ями) элемента(ов), выбранной(ыми) в исходном Workspace на момент открытия:
- Одна конкретная ревизия элемента (Item).
- Несколько конкретных ревизий одного и того же элемента.
- Последние ревизии нескольких элементов.
- Последние ревизии всех элементов в выбранной папке (и во всей ее дочерней структуре). Это позволяет загрузить в Cart целую папку, сохранив ее структуру. Чтобы получить папку (и ее дочернюю структуру), выберите ее в области Server Folders исходного Workspace (в панели Explorer panel), затем щелкните правой кнопкой мыши и выберите команду Operations » Add to Content Cart в контекстном меню.

Пример доступа к Content Cart.
Items That Can Be Acquired
Следующие типы Items можно получить из исходного Workspace в целевой Workspace с помощью функции Data Acquisition:
- 3D Model
- Altium Designer Preferences
- Component (включая связанные Part Choices)
- Component Template
- Datasheet
- Footprint
- Managed Schematic Sheet
- Outputjob
- Schematic Template
- Script
- Simulation Model
- Symbol
Кроме того, при получении папки элементов из исходного Workspace поддерживаются следующие типы папок:
- Components
- Generic Folder
Acquisition Considerations
Что следует учитывать при получении данных:
- Можно получать только те элементы данных (data Items), которые в исходном Workspace находятся в состоянии released.
- Получается только выбранная ревизия исходного элемента, а не все ревизии, которые могут существовать для этого элемента.
-
При получении ревизии исходного элемента Component или Managed Schematic Sheet также будут получены все связанные дочерние элементы:
- Component Item – применимые ревизии следующих связанных дочерних объектов: Symbol Item, Footprint Item(s), 3D Model Item(s), Simulation Model Item, Component Template Item, Datasheet Item(s), связи Part Choice.
Обратите внимание: параметр Component Type не переносится в процессе получения, поэтому перенесенные компоненты будут отображаться в целевом расположении Uncategorized как в панели Altium Designer Components panel, так и на странице Workspace Components page. Вы можете применить нужный Component Type к одной или нескольким записям компонентов с помощью операции Change Component Type operation в панели Altium Designer Explorer panel.
- Managed Schematic Sheet Item – применимые ревизии следующих связанных дочерних объектов: Component Item(s), Symbol Item(s), Footprint Item(s), 3D Model Item(s), Simulation Model Item(s), Component Template Item(s), Datasheet Item(s), Schematic Template Item.
- Жизненный цикл полученной ревизии исходного элемента будет установлен в начальное «послерелизное» состояние, определяемое назначенным определением жизненного цикла (lifecycle definition) для целевого элемента. Любая история жизненного цикла для ревизии исходного элемента будет просто проигнорирована.
- Если дочерний элемент выбранного исходного Component/Managed Schematic Sheet Item по какой-либо причине не может быть получен, то получение этого выбранного Component/Managed Schematic Sheet Item выполнено не будет.
Acquiring Data Process - Summary
Используйте Content Cart, чтобы получить весь необходимый контент данных. Процесс получения data Items с исходного сервера прост и может быть кратко описан следующими шагами:
-
Исходный сервер автоматически определяется как текущий активный сервер, но его можно изменить на другой подключенный сервер через меню выбора, доступное в левом верхнем углу панели Explorer panel.
-
Используйте выпадающее меню имени целевого сервера в Content Cart (выделено синим), чтобы выбрать альтернативный целевой сервер из списка, который заполняется текущими подключенными серверами — выберите опцию Server Administration, чтобы включать/отключать подключения к серверам. Для Components в качестве цели также можно указать файл Integrated Library (IntLib), сохраненный локально.
-
Исходная ревизия элемента отображается в основной таблице. В Cart можно добавить любое количество дополнительных ревизий элементов. Для этого нажмите элемент управления Add More Items в правом верхнем углу диалога и выберите пункт Select, чтобы открыть диалог Choose Item (вариант панели Explorer panel). Здесь можно просматривать исходный сервер в поисках дополнительных Items, добавляя их по одному или пакетно, используя стандартные средства множественного выбора. Либо выберите пункт Add manually, чтобы открыть Add new items dialog. Этот диалог позволяет вставить внешний список нужных элементов (по одному элементу в строке), после чего выполнить поиск по исходному серверу с использованием выбранного критерия поиска (GUID, Item ID, Name или MPN). Выбирайте и удаляйте ревизии элементов из списка (нажмите кнопку , если вы решили, что их не нужно получать.
-
Нажмите элемент управления Change Settings в правом нижнем углу диалога Content Cart, чтобы открыть диалог Content Cart Structure dialog. Здесь можно задать параметры по умолчанию для каждого типа Data Item, поддерживаемого для получения этой функцией. Это включает указание папки по умолчанию на целевом сервере, а также Lifecycle Definition по умолчанию, схем именования Item и Revision и начального индекса. Также можно добавить примечание, которое может быть полезно другим при просмотре полученного контента.
-
После выбора нужных исходных Items нажмите кнопку
. Это подготавливает целевой сервер к получению, проверяя статус выбранных ревизий элементов (на случай, если они уже получались ранее), связи родитель–дочерний элемент и предлагая требуемое действие, которое для новых получений будет Transfer new revision and item. Хотя ранее заданные параметры получения по умолчанию применяются на этапе подготовки, свойства предлагаемых целевых Items при необходимости можно изменить индивидуально. Для этого выберите элемент в списке и нажмите кнопку
.
-
После завершения подготовки нажатие кнопки
запустит получение. Появится начальный диалог подтверждения — нажмите Yes, чтобы продолжить перенос контента между исходным и целевым серверами. Второй диалог подтверждения сообщит результат получения — просматривайте полученные Items на целевом сервере через панель Explorer panel.
Полученные точки данных возвращаются к своему исходному источнику. Эту информацию о «родословной» связи можно увидеть, переключив вкладку представления аспектов для целевой ревизии Item на вкладку представления аспектов Origin.
Указание исходного и целевого Workspace
Два Workspace, участвующие в получении данных, задаются в верхней области диалога Content Cart. Исходный Workspace автоматически определяется по месту размещения ревизии(й) Item, которые вы указали для получения — как правило, это Workspace, в который вы сейчас вошли (Company Workspace в этом примере). Если вы подключены к нескольким Workspace, щелкните имя целевого Workspace или элемент управления
справа от него, чтобы открыть раскрывающийся список текущих подключенных Workspace. При необходимости переключайте Workspace.

Указание исходного и целевого Workspace, участвующих в получении данных.
Присвоение имени корзине
Полученные данные из исходного Workspace будут скопированы в новые ревизии Items в целевом Workspace. По умолчанию эти Items будут размещены в определенной, и вновь созданной, структуре папок внутри целевого Workspace. Папка верхнего уровня для этого полученного контента именуется по имени самой корзины. Имя по умолчанию имеет формат Content Cart - <Current Date> - <Current Time> и определяется в момент открытия корзины. При необходимости его можно изменить на более осмысленное, щелкнув элемент управления Change справа от имени корзины.
Используйте последующий диалог Content Cart Name Selection, чтобы напрямую ввести предпочтительное имя корзины. Либо можно выбрать папку в целевом Workspace, в которую должен быть доставлен контент из корзины. Это может быть существующая папка или совершенно новая, созданная «на лету». Перейдите к существующей папке и выберите ее для корзины с помощью диалога Choose Folder — он открывается нажатием кнопки
в крайней правой части поля Content Cart Name. Или создайте новую папку в структуре папок, используя команды контекстного меню (правый клик).

Content Cart можно именовать как угодно. Либо измените имя корзины (тогда доставка будет выполнена в папку верхнего уровня с этим именем), либо выберите размещение содержимого корзины в конкретной папке.
Указание Items для получения
Основная область диалога Content Cart представляет «таблицу получения» (acquisition grid) — список всех ревизий Item, которые вы выбрали для получения из исходного Workspace. Любое количество ревизий Data Item можно «загрузить» в Content Cart для получения из исходного Workspace. При первом открытии корзина загружается ревизией(ями) Item, выбранной(ыми) в исходном Workspace на момент открытия, но можно добавить любое количество дополнительных Items. Для этого нажмите элемент управления Add More Items в правом верхнем углу диалога и выберите пункт Select, чтобы открыть диалог Choose Item (это «урезанная» версия панели Explorer panel). Здесь можно просматривать исходный Workspace и выбирать дополнительные Items. Помните, вы можете добавить:
- Одну конкретную ревизию Item.
- Несколько конкретных ревизий одного и того же Item.
- Последние ревизии нескольких Items.
- Последние ревизии всех Items в выбранной папке (и во всей ее вложенной структуре).
Либо выберите пункт Add manually, чтобы открыть диалог Add new items. Этот диалог позволяет вставить внешний список нужных элементов (по одному элементу в строке), после чего выполнить поиск по ним в исходном Workspace, используя выбранный критерий поиска (GUID, Item ID, Name или MPN).

Основная таблица получения, в которой перечислены все ревизии Item, выбранные для получения из исходного Workspace.
Подготовка корзины
После выбора исходных ревизий Item Content Cart необходимо «подготовить к доставке» в целевой Workspace. Для этого нажмите кнопку
. Это подготавливает целевой Workspace к получению — проверяется статус выбранных ревизий Item (на случай, если они уже получались ранее), связи родитель–потомок, и предлагается действие, которое нужно выполнить. Результаты этапа подготовки отображаются в основной таблице получения.

Пример Content Cart, подготовленного и готового к доставке в целевой Workspace.
Для каждой ревизии Item, участвующей в получении, область Source таблицы разворачивается и показывает все применимые дочерние ревизии Item и, при необходимости, папку, в которой они находятся в исходном Workspace. Для каждой ревизии Item (как родительской, так и дочерней) в области Target таблицы может отображаться следующая информация:
- Revision ID – полный идентификатор ревизии Item в целевом Workspace, сформированный на основе заданных схем именования Item и ревизий для данного типа Item.
- Folder – папка назначения в целевом Workspace, в которой будет создана/доставлена полученная ревизия Item.
- Life Cycle – определение жизненного цикла (lifecycle definition), заданное для родительского Item.
- Naming Scheme – схема именования ревизий, заданная для идентификации ревизий родительского Item.
- Note – необязательная заметка, которую можно использовать, чтобы предоставить другим полезную информацию о получении данных при просмотре полученного контента в вашем Workspace.
-
Status – текущее состояние ревизии Item в целевом Workspace. Возможные состояния:
-
Not found– ревизия Item никогда ранее не получалась. -
Already Exists– ревизия Item уже получалась ранее.
-
-
Action – действие, которое необходимо выполнить для синхронизации исходного и целевого Workspace. Возможные действия:
-
Transfer new revision and item– для полностью новых получений, когда Item никогда ранее не получался. Иными словами, создать Item этого типа и новую планируемую ревизию, чтобы разместить исходные данные. -
Transfer new revision of existing item– при получении очередной ревизии Item, когда ревизия этого Item уже получалась ранее. -
Nothing to do– выбранная ревизия Item уже была получена ранее.
-
Структура корзины
В рамках этапа подготовки корзина использует настройки по умолчанию, определенные для каждого типа Item, который может быть получен. Эти настройки задаются в диалоге Content Cart Structure, который открывается нажатием элемента управления Change Settings в правом нижнем углу диалога Content Cart.

Настройки получения по умолчанию задаются в диалоге Content Cart Structure.
Эти настройки используются для определения свойств вновь создаваемых ревизий Item в целевом Workspace — они создаются заранее, в состоянии planned, чтобы принять данные из исходных ревизий Item в исходном Workspace. Они включают папку по умолчанию в целевом Workspace, а также определения жизненного цикла по умолчанию, схемы именования Item и ревизий и начальный индекс. Также задается заметка по умолчанию в формате Acquired from <SourceWorkspaceName>.
Что касается папок назначения в целевом Workspace, каждый тип Item будет получаться в отдельную папку внутри:
- Родительской папки верхнего уровня, названной по имени самого Content Cart
- Существующей папки, заданной через диалог выбора имени Content Cart Name selection dialog.
Изменяйте эти настройки получения по умолчанию в соответствии со схемами, применяемыми (и предпочтительными!) для этих типов Item в вашем целевом Workspace. Щелкните ячейку, чтобы открыть элементы редактирования.
Настройки получения данных в диалоге Content Cart Structure являются грубыми значениями по умолчанию верхнего уровня. Для элементов (Items), которые ранее никогда не получались — то есть когда родительский Item и начальная ревизия создаются заново (Action = Transfer new revision and item) — при необходимости можно задать свойства на уровне конкретного Item, обеспечив более тонкий контроль. Для этого выберите ревизию Item в основной таблице получения и нажмите кнопку
. Откроется диалог Edit Item, где вы сможете изменить свойства Item по мере необходимости, переопределив настройки по умолчанию.

Для более точного управления можно задавать свойства на уровне отдельного Item.
Доставка корзины
После завершения подготовки нажмите кнопку
, чтобы перейти к получению данных. Появится диалог подтверждения, уведомляющий, что Content Cart будет перенесён из исходного Workspace в целевой — нажмите Yes, чтобы продолжить. Второй диалог подтверждения сообщит результат получения; полученные Items будут доступны для просмотра в целевом Workspace через панель Explorer.
Получение данных в формате IntLib
Также вы можете получать компоненты из вашего Workspace в интегрированную библиотеку (*.IntLib). При размещении компонентов из такой интегрированной библиотеки фактические ссылки ведут обратно к компонентам в Workspace. Это позволяет эффективно использовать компоненты Workspace вашей компании в офлайн-режиме, при этом гарантируя, что проект сохраняет реальную связь с этими компонентами в исходном Workspace.
Получение в IntLib
В диалоге Content Cart процесс получения в IntLib выглядит следующим образом:
-
Нажмите ссылку Select target server и выберите в меню IntLib file.

Установите в качестве цели для Content Cart файл IntLib. -
Укажите имя и расположение для создаваемого файла IntLib. По умолчанию файл будет назван в формате
Integrated_Library - <Date> - <Time>.IntLibи создан в расположении\Users\Public\Documents\Altium\AD<Version>\Library\ExportCmpLib. Измените это при необходимости через диалог Save As, который открывается нажатием ссылки Change .
Примите целевую папку и имя файла по умолчанию или измените при необходимости. - Если нужно получить дополнительные компоненты в тот же IntLib, нажмите ссылку Add More Items и выберите пункт Select, чтобы открыть диалог Choose Item ( «урезанную» версию панели Explorer panel). Здесь можно просматривать исходный Workspace в поисках дополнительных Items. Либо выберите пункт Add manually, чтобы открыть диалог Add new items. Этот диалог позволяет вставить внешний список нужных элементов (по одному элементу в строке), после чего выполнить поиск по ним в исходном Workspace, используя выбранный критерий поиска (GUID, Item ID, Name или MPN).
-
Когда всё готово, нажмите кнопку
, чтобы запустить создание IntLib. Будет создан временный пакет Integrated Library Package (*.LibPkg), в который будут сгенерированы и добавлены исходные файлы SchLib (с символами, параметрами и ссылками на модели) и PcbLib (с моделями посадочных мест). Затем выполняется компиляция, в результате которой формируется файл IntLib, создаваемый в указанной папке. Информационный диалог подтвердит успешное создание файла.
Доставьте корзину в целевую папку, которая будет содержать требуемый файл Integrated Library.
Использование IntLib
После генерации IntLib можно добавить в список доступных библиотек, не относящихся к Workspace, для программного обеспечения (через вкладку Installed диалога Available File-based Libraries dialog). После этого библиотека будет доступна для использования из панели Components panel. Размещайте компоненты из IntLib в проекте по мере необходимости. Несмотря на то, что работа с компонентами фактически ведётся «офлайн», ссылки на исходные компоненты Workspace обеспечивают непрерывность, когда вы возвращаетесь к работе «онлайн» напрямую из вашего Workspace.