Использование Content Cart

Главная страница: Работа с управляемыми компонентами

Функциональные возможности получения данных (Data Acquisition) сервера управляемых данных предоставляют удобный способ копирования данных между двумя серверами. Инструментом, с помощью которого это осуществляется, т.е. интерфейсом службы Data Acquisition Service, является Content Cart. Это центр управления для определения того, что необходимо получить с исходного сервера и передать на указанный целевой сервер – своего рода, надежный фургон для перевозки данных между серверами.

Лучше всего показать работу этой функциональной возможности на примере. Для демонстрации подробностей использования Content Cart и его использования для получения данных, в этой статье рассмотрено получение объектов компонентов (Component Item) между следующими серверами:

• Source Server (Исходный сервер) – сервер управляемых данных под названием Company Workspace.
• Target Server (Целевой сервер) – второй сервер управляемых данных под названием Secondary Company Workspace.

Доступ к Content Cart

Доступ к диалоговому окну Content Cart осуществляется из панели Explorer. При просмотре исходного сервера, из которого вы хотите получить данные, щелкните ПКМ по ревизии объекта, который вы хотите получить, и выберите команду Operations » Add to Content Cart из контекстного меню. Вы можете добавить одну или множество ревизий объектов или даже папку объектов. При первоначальном доступе в корзину будут загружены ревизии объектов, которые были выбраны на исходном сервере в момент открытия диалогового окна:

• Отдельная определенная ревизия объекта.
• Множество определенных ревизий одного объекта.
• Самые новые ревизии множества объектов.
• Самые новые ревизии всех объектов в выбранной папке (и ее нисходящей структуре). Это позволяет загрузить в корзину всю папку, с сохранением ее структуры. Чтобы получить папку (и ее нисходящую структуру), выделите ее в области Server Folders исходного сервера (в панели Explorer), затем щелкните ПКМ и выберите команду Operations » Add to Content Cart из контекстного меню.

Пример доступа к Content Cart.

Указание исходного и целевого серверов

Два сервера, участвующие в процессе получения, указываются в верхней области диалогового окна Content Cart. Исходный сервер определяется автоматически, на основе местонахождения ревизий объектов, которые вы выбрали для получения. Целевым сервером будет один из тех, в который вы вошли в данный момент. При подключении ко множеству серверов щелкните ЛКМ по названию целевого сервера или по элементу управления справа, чтобы открыть выпадающий список подключенных в данный момент серверов. Переключите серверы, если необходимо.

Определение исходного и целевого серверов, участвующих в получении данных.

Именование корзины

Полученные с исходного сервера данные будут скопированы в новые ревизии объектов на целевом сервере. По умолчанию эти объекты будут расположены в определенной новой структуре папок на целевом сервере. Папка верхнего уровня полученных данных будет названа в соответствии с названием самой корзины. По умолчанию название будет задано в формате 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 (Ничего не делать) – выбранная ревизия объекта уже была получена ранее.

Структура корзины

В рамках процесса подготовки, корзина использует настройки по умолчанию для каждого типа объектов, которые могут быть получены. Эти настройки определяются в диалоговом окне 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). При размещении компонентов из этой интегрированной библиотеки, ссылки будут указывать на объекты компонентов на сервере. Это предоставляет вам возможность использовать управляемые компоненты компании без подключения к серверу, при этом сохранив связь проекта с компонентами на исходном сервере управляемых данных.

Чтобы использовать эту функциональную возможность в Altium NEXUS, вам необходимо включить использование неуправляемых компонентов. Использование неуправляемого содержимого по умолчанию отключено в Altium NEXUS, поскольку это не рекомендуется. Вы можете восстановить эту функциональность, включив опцию Legacy.UnManagedLibraries в диалоговом окне Advanced Settings, которое открывается нажатием кнопки на странице System - General диалогового окна Preferences. Вам понадобится перезапустить Altium NEXUS, чтобы изменение этой настройки вступило в силу.

 

Получение в IntLib

Из диалогового окна Content Cart, процесс получения в IntLib осуществляется следующим образом:

1. Нажмите ссылку Select target server и выберите IntLib file из меню.

   Определение файла IntLib в качестве цели Content Cart.

2. Укажите имя и расположение сформированного файла IntLib. По умолчанию файлу будет задано имя в формате Integrated_Library - <Дата> - <Время>.IntLib, и он будет сформирован в папке \Users\Public\Documents\Altium\NEXUS<Версия>\Library\ExportCmpLib. Измените эти настройки необходимым образом с помощью диалогового окна Save As – чтобы открыть его, нажмите Change.

   Примените имя файла и целевую папку по умолчанию либо измените их необходимым образом.

3. Если необходимо получить дополнительные компоненты в ту же библиотеку IntLib, нажмите по ссылке Add More Items и выберите запись Select, чтобы открыть диалоговое окно Choose Item. Здесь вы можете выбрать больше объектов из целевого сервера. Либо выберите запись Add manually, чтобы открыть диалоговое окно Add new items. В этом диалоговом окне вы можете вставить внешний список нужных объектов (по одному на строку), по которому будет осуществлен поиск на исходном сервере с помощью выбранного критерия поиска (GUID, Item ID, Name или MPN).
4. Нажмите кнопку , чтобы начать формирование 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 в проекте. Хотя вы работаете с этими компонентами в режиме "офлайн", их связь с изначальным сервером обеспечит преемственность, когда вы вернетесь к работе "онлайн" непосредственно с сервером управляемых данных.