Главная страница: Работа с управляемыми компонентами
Функциональные возможности получения данных (Data Acquisition) сервера управляемых данных предоставляют удобный способ копирования данных между двумя серверами. Инструментом, с помощью которого это осуществляется, т.е. интерфейсом службы Data Acquisition Service, является Content Cart. Это центр управления для определения того, что необходимо получить с исходного сервера и передать на указанный целевой сервер – своего рода, надежный фургон для перевозки данных между серверами.
Лучше всего показать работу этой функциональной возможности на примере. Для демонстрации подробностей использования Content Cart и его использования для получения данных, в этой статье рассмотрено получение объектов компонентов (Component Item) между следующими серверами:
- Source Server (Исходный сервер) – сервер управляемых данных под названием
Company Server.
- Target Server (Целевой сервер) – второй сервер управляемых данных под названием
Secondary Company Server.
Доступ к Content Cart
Доступ к диалоговому окну Content Cart осуществляется из панели Explorer. При просмотре исходного сервера, из которого вы хотите получить данные, щелкните ПКМ по ревизии объекта, который вы хотите получить, и выберите команду Add to Content Cart из контекстного меню. Вы можете добавить одну или множество ревизий объектов или даже папку объектов. При первоначальном доступе в корзину будут загружены ревизии объектов, которые были выбраны на исходном сервере в момент открытия диалогового окна:
- Отдельная определенная ревизия объекта.
- Множество определенных ревизий одного объекта.
- Самые новые ревизии множества объектов.
- Самые новые ревизии всех объектов в выбранной папке (и ее нисходящей структуре). Это позволяет загрузить в корзину всю папку, с сохранением ее структуры. Чтобы получить папку (и ее нисходящую структуру), выделите ее в области Server Folders исходного сервера (в панели Explorer), затем щелкните ПКМ и выберите команду Add to Content Cart из контекстного меню.
Выберите запись верхнего уровня объекта, чтобы загрузить в корзину самую новую ревизию этого объекта.
Вы можете открыть Content Cart из различных аспектных видов панели Explorer, в том числе аспектных видов Where-used и Children. Его также можно открыть из окна Search Results.
Пример доступа к Content Cart.
Объекты, которые могут быть получены
Замечания
Что следует иметь в виду при получении данных:
- Могут быть получены только объекты данных в выпущенном состоянии на исходном сервере.
- Осуществляется получение только выбранной ревизии исходного объекта, а не всех ревизий, которые могут быть в этом объекте.
- При получении ревизии исходного объекта компонента или объекта управляемого листа схемы будут также получены все связанные дочерние объекты:
- Для объектов компонентов – применимые ревизии следующих связанных дочерних объектов: объект символа, объект(ы) посадочного места, объект(ы) 3D-модели, объект имитационной модели, объект шаблона компонентов, объект(ы) даташита.
- Для объектов управляемых схем – применимые ревизии следующих связанных дочерних объектов: объект(ы) компонента, объект(ы) символа, объект(ы) посадочного места, объект(ы) 3D-модели, объект(ы) имитационной модели, объект(ы) шаблона компонентов, объект(ы) даташита, объект шаблона схемы.
- Жизненный цикл полученной ревизии исходного объекта примет начальное состояние "после выпуска", в соответствии с назначенным определением жизненного цикла целевого объекта. История жизненных циклов ревизии исходного объекта будет проигнорирована.
- Если дочерний объект выбранного исходного объекта компонента или управляемого листа схемы не может быть получен по какой-либо причине, то получение этого выбранного объекта компонента или управляемого листа схемы не будет произведено.
Ревизия дочернего объекта, который используется множеством родительских объектов (например, общий объект символа или объект посадочного места), будет получен только один раз, а не множество раз для каждой ревизии родительского объекта.
Указание исходного и целевого серверов
Два сервера, участвующие в процессе получения, указываются в верхней области диалогового окна Content Cart. Исходный сервер определяется автоматически, на основе местонахождения ревизий объектов, которые вы выбрали для получения. Целевым сервером будет один из тех, в который вы вошли в данный момент. При подключении ко множеству серверов щелкните мышью по названию целевого сервера или по элементу управления 
справа, чтобы открыть выпадающий список подключенных в данный момент серверов. Переключите серверы, если необходимо.
Вы можете быть подключенным более чем к одному серверу управляемых данных, но в отдельный момент времени вы можете войти только в один сервер – это будет активный сервер (Active Server).
Выпадающее меню, связанное с целевым сервером, также предлагает быстрый доступ к странице
Data Management - Servers диалогового окна
Preferences, через пункт
Server Administration. Она может быть полезной, если вы еще не подключены/не вошли на целевой сервер.
Определение исходного и целевого серверов, участвующих в получении данных.
Именование корзины
Полученные с исходного сервера данные будут скопированы в новые ревизии объектов на целевом сервере. По умолчанию эти объекты будут расположены в определенной новой структуре папок на целевом сервере. Папка верхнего уровня полученных данных будет названа в соответствии с названием самой корзины. По умолчанию название будет задано в формате Content Cart - <Текущая дата> - <Текущее время>. Название определяется в момент открытия корзины. Его можно изменить на более осмысленное название, если это необходимо, щелкнув мышью по элементу управления Change справа от названия корзины.
Используете открывшееся диалоговое окно Content Cart Name Selection, чтобы ввести нужное название корзины. Либо вы можете выбрать папку на целевом сервере, в которую будет добавлена корзина. Это может быть существующая папка либо совершенно новая, созданная на лету. Найдите и выберите существующую папку для корзины с помощью диалогового окна Choose Folder – чтобы открыть его, нажмите 
, в правой части поля Content Cart Name. Либо создайте новую папку в структуре с помощью команд из контекстного меню.
Корзина Content Cart может быть названа необходимым образом. Либо измените название корзины (она будет перенесена в папку верхнего уровня с этим названием), либо выберите добавление содержимого корзины в определенную папку.
При получении данных целевым сервером может быть создано любое количество "папок" корзины данных, что предоставляет максимальную гибкость при определении того, где будет сохранено полученное содержимое. Имейте в виду, что не имеет значение, где в структуре папок целевого сервера изначально хранятся получаемые данные – вы можете беспрепятственно перемещать объекты и папки необходимым образом.
Определение объектов на получение
В главной области диалогового окна Content Cart представлена "таблица получения" со списком всех ревизий объектов, которые вы выбрали на получение с исходного сервера. В Content Cart может быть "загружено" любое количество ревизий объектов данных для их получения с исходного сервера. При первоначальном открытии, корзина будет загружена ревизиями объектов, которые были выбраны на исходном сервере на момент открытия, но может быть загружено любое количество дополнительных объектов. Для этого щелкните мышью по элементу управления Add More Items в правой верхней части диалогового окна и выберите запись Select, чтобы открыть диалоговое окно Choose Item. Здесь вы можете найти больше объектов на исходном сервере. Имейте в виду, что вы можете выбрать на добавление следующее:
- Отдельная определенная ревизия объекта.
- Множество определенных ревизий одного объекта.
- Самые новые ревизии множества объектов.
- Самые новые ревизии всех объектов в выбранной папке (и ее нисходящей структуре).
Либо выберите запись Add manually, чтобы открыть диалоговое окно Add new items. В этом диалоговом окне вы можете вставить внешний список нужных объектов (по одному на строку), по которому будет осуществлен поиск на исходном сервере с помощью выбранного критерия поиска (GUID, Item ID, Name или MPN).
Любую ревизию объекта можно удалить из списка, выбрав ее и нажав кнопку
.
Главная таблица получения, со списком всех выбранных на получение из исходного сервера ревизий объектов.
Подготовка корзины
Когда исходные ревизии объектов выбраны, необходимо подготовить Content Cart к переносу на целевой сервер. Для этого нажмите кнопку 
. Это подготовит целевой сервер к получению – будет проверен статус выбранных ревизий объектов (в случае, если они были получены ранее) и ссылок между родительскими и дочерними объектами и будет предложено действие. Результат этой подготовки будет представлен в главной таблице получения.
Пример Content Cart, подготовленной к переносу на целевой сервер.
Для каждой ревизии объекта, включенной в получение, в области Source таблицы будут представлены все применимые дочерние ревизии объектов и, опционально, папка, в которой они находятся на исходном сервере. Для каждой ревизии объекта (родительского и дочернего), в области Target таблицы будет представлена следующая информация:
- Revision ID – полный идентификатор ревизии объекта на целевом сервера на основе заданной для объектов этого типа схемы именования объектов и ревизий.
- Folder – папка на целевом сервере, в которой будет создана/перенесена получаемая ревизия объекта.
- Life Cycle – определение жизненного цикла, заданное для родительского объекта.
- Naming Scheme – схема именования ревизий, заданная для идентификации ревизий родительского объекта.
- Note – опциональная запись, которую можно использовать для предоставления другим участникам полезной информации о получении при просмотре ими полученных данных на сервере.
- Status – текущее состояние ревизии объекта на целевом сервере. Возможные состояния:
Not found (Не найдена) – ревизия объекта не была получена ранее.Already Exists (Уже существует) – ревизия объекта была получена ранее.
- Action – действие, которое следует предпринять для синхронизации исходного и целевого сервера. Доступные состояния:
Transfer new revision and item (Перенос новой ревизии и объекта) – для совершенно новых получений, когда объект не был получен ранее. Иными словами, создание нового объекта этого типа и новой запланированной ревизии, в которой будут храниться исходные данные.Transfer new revision (Перенос новой ревизии) – при получении другой ревизии объекта, когда ревизия этого объекта была получена ранее.Nothing to do (Ничего не делать) – выбранная ревизия объекта уже была получена ранее.
Щелкните мышью по заголовку столбца для сортировки данных в этом столбце в возрастающем порядке, щелкните мышью еще раз для сортировки в убывающем порядке. Перетащите с зажатой ЛКМ заголовок столбца, чтобы изменить порядок самих столбцов – корректные положение подсвечивается вертикальными позиционными стрелками. Щелкните ПКМ, чтобы получить доступ к элементам управления для отображения и скрытия столбцов данных в областях Source и Target.
Структура корзины
В рамках процесса подготовки, корзина использует настройки по умолчанию для каждого типа объектов, которые могут быть получены. Эти настройки определяются в диалоговом окне Content Cart Structure, которое открывается щелчком мышью по элементу управления Change Settings в нижней правой части диалогового окна Content Cart.
Настройки получения по умолчанию определяются в диалоговом окне Content Cart Structure.
Эти настройки используются для определения свойств новых ревизий объектов на целевом сервере, в запланированном состоянии, готовых в получению данных из изначальных ревизий объектов на целевом сервере. Они включают в себя папку по умолчанию на целевом сервере, а также определение жизненного цикла по умолчанию, схемы именования объектов и ревизий и начальный индекс. Также определено примечание по умолчанию, в формате Acquired from <ИмяИсходногоСервера>.
Касательно папок назначения на целевом сервере, объект каждого типа будет получен в отдельную папку в:
- Родительской папке верхнего уровня, названной в соответствии с Content Cart.
- Существующей папке, определенной в диалоговом окне Content Cart Name selection.
Измените эти настройки получения по умолчанию в соответствии с предпочтительными схемами для этих типов объектов на целевом сервере. Щелкните мышью по ячейке, чтобы получить доступ к элементам управления для редактирования.
Чтобы восстановить настройки структуры до настроек по умолчанию, нажмите кнопку
.
Настройки получения в диалоговом окне Content Cart Structure являются настройками по умолчанию "крупного уровня". Для объектов, которые не были получены ранее и для которых, соответственно, будут созданы новый родительский объект и начальная ревизия (Action = Transfer new revision and item), можно при необходимости задать свойства на уровне отдельных объектов, что предоставляет более детальный контроль. Для этого выберите ревизию объекта в главной таблице получения и нажмите кнопку 
. Будет открыто диалоговое окно Edit Item, где вы можете изменить свойства объекта необходимым образом, переопределив настройки по умолчанию.
Для лучшего контроля, вы можете определить свойства на уровне отдельных объектов.
При любых изменениях названия корзины, ее настройках структуры по умолчанию или самих отдельных объектов необходимо снова выполнить подготовку, чтобы обновить таблицу получения в соответствии с этими изменениями.
Получение корзины
После того, как подготовка завершена, нажмите кнопку 
, чтобы начать процесс получения. Будет открыто диалоговое окно подтверждения, уведомляющее о том, что Content Cart будет перенесена с исходного на целевой сервер – нажмите Yes, чтобы начать. Второе диалоговое окно подтвердит результат получения, и полученные объекты станут доступны для просмотра на целевом сервере с помощью панели Explorer. Если перед закрытием диалогового окна Content Cart вы снова запустите подготовку (нажатием ), поля Status и Action будут обновлены в соответствии с результатом, и в них будет отображено Already Exists и Nothing to do соответственно.
Просмотр результатов успешного получения.
Полученные данные ссылаются на свой изначальный источник. Информацию об этой ссылке можно увидеть, переключившись на вкладку аспектного вида
Origin целевой ревизии объекта. Чтобы быстро перейти к исходной ревизии объекта, нажмите кнопку
.
Получение данных в формате IntLib
У вас также есть возможность получить компоненты с сервера управляемых данных в интегрированную библиотеку (*.IntLib). При размещении компонентов из этой интегрированной библиотеки, ссылки будут указывать на объекты компонентов на сервере. Это предоставляет вам возможность использовать управляемые компоненты компании без подключения к серверу, при этом сохранив связь проекта с компонентами на исходном сервере управляемых данных.
Возможность получить управляемое содержимое в формат IntLib поддерживается только для сервера управляемых данных компании. Вы не можете получить содержимое из Altium Content Vault таким образом.
Чтобы использовать эту функциональную возможность в Altium NEXUS, вам необходимо включить использование неуправляемых компонентов. Использование неуправляемого содержимого по умолчанию отключено в Altium NEXUS, поскольку это не рекомендуется. Вы можете восстановить эту функциональность, включив параметр в диалоговом окне
Advanced Settings, которое открывается нажатием кнопки
на странице
System - General диалогового окна
Preferences:
Legacy.UnManagedLibraries
Вам понадобится перезапустить Altium NEXUS, чтобы изменение этой настройки вступило в силу.
Получение в IntLib
Из диалогового окна Content Cart, процесс получения в IntLib осуществляется следующим образом:
- Нажмите ссылку Select target server и выберите IntLib file из меню.
Определение файла IntLib в качестве цели Content Cart.
- Укажите имя и расположение сформированного файла IntLib. По умолчанию файлу будет задано имя в формате
Integrated_Library - <Дата> - <Время>.IntLib, и он будет сформирован в папке \Users\Public\Documents\Altium\AD<Версия>\Library\ExportCmpLib. Измените эти параметры необходимым образом с помощью диалогового окна Save As – чтобы открыть его, нажмите Change.
Примените имя файла и целевую папку по умолчанию либо измените их необходимым образом.
- Если необходимо получить дополнительные компоненты в ту же библиотеку IntLib, нажмите по ссылке Add More Items и выберите запись Select, чтобы открыть диалоговое окно Choose Item. Здесь вы можете выбрать больше объектов из целевого сервера. Либо выберите запись Add manually, чтобы открыть диалоговое окно Add new items. В этом диалоговом окне вы можете вставить внешний список нужных объектов (по одному на строку), по которому будет осуществлен поиск на исходном сервере с помощью выбранного критерия поиска (GUID, Item ID, Name или MPN).
- Нажмите кнопку , чтобы начать формирование IntLib. Будет создан временный пакет интегрированной библиотеки, в который будут добавлены сформированные исходные файлы SchLib (с символами, параметрами и ссылками на модели) и PcbLib. Затем этот пакет компилируется для создания файла IntLib, который будет сформирован в определенной папке. Информационное диалоговое окно подтвердит успешное создание файла.
Получение корзины в целевую папку, которая будет содержать в себе файл интегрированной библиотеки.
- Нажмите ссылку Select target server и выберите IntLib file из меню.
Определение файла IntLib в качестве цели Content Cart.
- Укажите имя и расположение сформированного файла IntLib. По умолчанию файлу будет задано имя в формате
Integrated_Library - <Дата> - <Время>.IntLib, и он будет сформирован в папке \Users\Public\Documents\Altium\NEXUS<Версия>\Library\ExportCmpLib. Измените эти параметры необходимым образом с помощью диалогового окна Save As – чтобы открыть его, нажмите Change.
Примените имя файла и целевую папку по умолчанию либо измените их необходимым образом.
- Если необходимо получить дополнительные компоненты в ту же библиотеку IntLib, нажмите по ссылке Add More Items и выберите запись Select, чтобы открыть диалоговое окно Choose Item. Здесь вы можете выбрать больше объектов из целевого сервера. Либо выберите запись Add manually, чтобы открыть диалоговое окно Add new items. В этом диалоговом окне вы можете вставить внешний список нужных объектов (по одному на строку), по которому будет осуществлен поиск на исходном сервере с помощью выбранного критерия поиска (GUID, Item ID, Name или MPN).
- Нажмите кнопку , чтобы начать формирование IntLib. Будет создан временный пакет интегрированной библиотеки, в который будут добавлены сформированные исходные файлы SchLib (с символами, параметрами и ссылками на модели) и PcbLib. Затем этот пакет компилируется для создания файла IntLib, который будет сформирован в определенной папке. Информационное диалоговое окно подтвердит успешное создание файла.
Deliver the cart to the target folder, which will contain the required Integrated Library file.
Использование IntLib
После того, как файл библиотеки IntLib сформирован, его можно добавить в список доступных файловых библиотек (через вкладку Installed диалогового окна Available File-based Libraries). Библиотека станет доступна для использования из панели Components. Разместите компоненты из IntLib в проекте. Хотя вы работаете с этими компонентами в режиме "офлайн", их связь с изначальным сервером обеспечит преемственность, когда вы вернетесь к работе "онлайн" непосредственно с сервером управляемых данных.
