Функция 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 в контекстном меню.
Выбор записи верхнего уровня для элемента (Item) загрузит в Cart последнюю ревизию этого элемента.
Также можно открыть Content Cart из различных представлений аспектов в панели Explorer panel, включая представления аспектов Where-used и Children. Также доступ возможен из окна Search Results.
Пример доступа к 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
Что следует учитывать при получении данных:
Обратите внимание: параметр 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 выполнено не будет.
Дочерняя ревизия элемента (Item Revision), используемая несколькими родительскими элементами — например, общий Symbol Item или Footprint 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.
Используйте параметры в диалоге Content Cart Structure, чтобы изменить настройки получения по умолчанию в соответствии со схемами, применяемыми (и предпочтительными!) для этих типов Items на целевом сервере. По умолчанию эти настройки определены так, чтобы получать каждый тип Item в отдельную папку под корневой папкой, которая называется именем Content Cart. Имя по умолчанию имеет формат Content Cart – <Current Date> – <Current Time> и отображается в диалоге Content Cart dialog.
При необходимости его можно изменить на более осмысленное. Либо можно выбрать папку на целевом сервере, в которую должен быть доставлен контент из Cart. Это может быть существующая папка или совершенно новая, созданная «на лету». Настройки получения в диалоге Content Cart Structure dialog — это укрупненные значения по умолчанию; при необходимости можно задать свойства на уровне отдельных Items, получив более тонкий контроль.
Если ревизия элемента уже была получена и исходный элемент не был повторно перевыпущен (re-released) после этого получения, ее
Status будет
Already Exists, чтобы отразить это. Поскольку никаких действий выполнять не нужно, поле
Action будет отображаться как
Nothing to do. Обратите внимание: ревизии элементов в
Trash определяются как полученные (
Already Exist).
Полученные точки данных возвращаются к своему исходному источнику. Эту информацию о «родословной» связи можно увидеть, переключив вкладку представления аспектов для целевой ревизии Item на вкладку представления аспектов Origin.
Указание исходного и целевого Workspace
Два Workspace, участвующие в получении данных, задаются в верхней области диалога Content Cart. Исходный Workspace автоматически определяется по месту размещения ревизии(й) Item, которые вы указали для получения — как правило, это Workspace, в который вы сейчас вошли (Company Workspace в этом примере). Если вы подключены к нескольким Workspace, щелкните имя целевого Workspace или элемент управления 
справа от него, чтобы открыть раскрывающийся список текущих подключенных Workspace. При необходимости переключайте Workspace.
-
Хотя вы можете быть подключены более чем к одному Workspace, помните, что одновременно вы можете быть выполнены входом только в один Workspace — это и будет ваш Active Server.
-
Раскрывающееся меню, связанное с целевым Workspace, также предоставляет быстрый доступ к странице Data Management – Servers page диалога Preferences через пункт Server Administration. Это может быть полезно, если вы еще не подключились/не вошли в предполагаемый целевой 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 можно именовать как угодно. Либо измените имя корзины (тогда доставка будет выполнена в папку верхнего уровня с этим именем), либо выберите размещение содержимого корзины в конкретной папке.
При получении данных в целевой Workspace можно создать любое количество «папок» Content Cart, что дает максимальную гибкость в выборе места хранения полученного контента. Помните: независимо от того, где в структуре папок целевого Workspace изначально размещены полученные данные, вы можете перемещать Items и папки как угодно.
Указание 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 можно удалить из списка, выделив ее и нажав кнопку
.
Подготовка корзины
После выбора исходных ревизий Item Content Cart необходимо «подготовить к доставке» в целевой Workspace. Для этого нажмите кнопку 
. Это подготавливает целевой Workspace к получению — проверяется статус выбранных ревизий Item (на случай, если они уже получались ранее), связи родитель–потомок, и предлагается действие, которое нужно выполнить. Результаты этапа подготовки отображаются в основной таблице получения.
Пример Content Cart, подготовленного и готового к доставке в целевой Workspace.
Для каждой ревизии Item, участвующей в получении, область Source таблицы разворачивается и показывает все применимые дочерние ревизии Item и, при необходимости, папку, в которой они находятся в исходном Workspace. Для каждой ревизии Item (как родительской, так и дочерней) в области Target таблицы может отображаться следующая информация:
Обратите внимание: процесс получения также обнаружит элемент, находящийся в целевом
Workspace Trash; он считается полученным и получает статус
Already Exists. Очистите корзину (Trash) и запустите процесс получения снова, если вы хотите получить этот Item повторно.
Щелкните заголовок столбца, чтобы отсортировать данные по этому столбцу по возрастанию. Щелкните еще раз — для сортировки по убыванию. Перетащите заголовок столбца, чтобы изменить порядок самих столбцов — допустимые позиции отмечаются вертикальными стрелками. Щелкните правой кнопкой мыши, чтобы открыть элементы управления для включения/отключения отображения столбцов данных в областях Source и Target (некоторые из перечисленных выше столбцов могут быть отключены по умолчанию).
Структура корзины
В рамках этапа подготовки корзина использует настройки по умолчанию, определенные для каждого типа Item, который может быть получен. Эти настройки задаются в диалоге Content Cart Structure, который открывается нажатием элемента управления Change Settings в правом нижнем углу диалога Content Cart.
Настройки получения по умолчанию задаются в диалоге Content Cart Structure.
Эти настройки используются для определения свойств вновь создаваемых ревизий Item в целевом Workspace — они создаются заранее, в состоянии planned, чтобы принять данные из исходных ревизий Item в исходном Workspace. Они включают папку по умолчанию в целевом Workspace, а также определения жизненного цикла по умолчанию, схемы именования Item и ревизий и начальный индекс. Также задается заметка по умолчанию в формате Acquired from <SourceWorkspaceName>.
Что касается папок назначения в целевом Workspace, каждый тип Item будет получаться в отдельную папку внутри:
Изменяйте эти настройки получения по умолчанию в соответствии со схемами, применяемыми (и предпочтительными!) для этих типов Item в вашем целевом Workspace. Щелкните ячейку, чтобы открыть элементы редактирования.
-
Обратите внимание: Part Choices, связанные с компонентом, автоматически переносятся в целевой Workspace. Пункт Part Choice List в диалоге Content Cart structure относится только к устаревшему Altium Vault и более ранним версиям Altium Designer.
-
Восстановите настройки структуры к значениям по умолчанию, нажав кнопку
.
Настройки получения данных в диалоге Content Cart Structure являются грубыми значениями по умолчанию верхнего уровня. Для элементов (Items), которые ранее никогда не получались — то есть когда родительский Item и начальная ревизия создаются заново (Action = Transfer new revision and item) — при необходимости можно задать свойства на уровне конкретного Item, обеспечив более тонкий контроль. Для этого выберите ревизию Item в основной таблице получения и нажмите кнопку 
. Откроется диалог Edit Item, где вы сможете изменить свойства Item по мере необходимости, переопределив настройки по умолчанию.
Для более точного управления можно задавать свойства на уровне отдельного Item.
Любые изменения имени корзины, её настроек структуры по умолчанию или самих отдельных Items требуют повторного выполнения подготовки — чтобы обновить таблицу получения с учётом этих изменений.
Доставка корзины
После завершения подготовки нажмите кнопку 
, чтобы перейти к получению данных. Появится диалог подтверждения, уведомляющий, что Content Cart будет перенесён из исходного Workspace в целевой — нажмите Yes, чтобы продолжить. Второй диалог подтверждения сообщит результат получения; полученные Items будут доступны для просмотра в целевом Workspace через панель Explorer.
Если перед закрытием диалога
Content Cart вы снова выполните подготовку, нажав
, поля
Status и
Action обновятся, отражая результат — показывая
Already Exists и
Nothing to do соответственно.
Полученные данные содержат ссылку на исходный источник. Эту информацию о «родительской» связи можно увидеть, переключившись на вкладку представления аспектов
Origin для целевой ревизии Item. Чтобы быстро перейти к исходной ревизии Item, нажмите кнопку
.
Получение данных в формате 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.
Локализовано с помощью ИИ