Поддержка сбора данных с Altium On-Prem Enterprise Server

Altium предоставляет организации возможность копировать нужный контент из исходного Workspace и передавать его во второй, целевой Workspace — процесс, который называют просто Workspace Data Acquisition.

При получении (acquisition) проектного контента право владения полностью переходит к команде целевого Workspace: она может вносить изменения и поддерживать контент — в своём Workspace — так, как сочтёт нужным в дальнейшем. А благодаря сохранению связи между полученными данными и их исходным источником становится возможной интеллектуальная обработка данных, включая уведомления, когда источник любого скопированного контента обновляется. Так, например, если позже в исходном Workspace будет изменена ревизия элемента проекта, целевой Workspace сможет обновиться до этой ревизии, повторно синхронизировавшись, так сказать, с «материнским кораблём». И независимо от того, были ли в целевом Workspace выполнены дополнительные релизы этого элемента, всегда остаётся возможность вернуться к предыдущей ревизии из исходного Workspace — всё это за счёт сохранения ссылки на исходный источник элемента, или Origin.

Получение данных — концептуальный обзор

Следующее изображение даёт более высокоуровневую графическую иллюстрацию концепции получения данных. Показанные принципы получения данных одинаковы независимо от типа получаемых данных.

Концепция получения данных Workspace.

Обратите внимание: Workspace, который будет получать контент (целевой Workspace), должен иметь возможность подключаться к исходному Workspace. Это означает, что Enterprise Server не может выступать источником контента для Altium 365 Workspace, поскольку последний не может подключиться к первому — тот находится внутри локальной LAN/WAN и не опубликован в интернете.

На практике это означает, что данные Content Cart можно передавать между Altium 365 Workspaces, между Enterprise Server Workspaces, а также из Altium 365 Workspace в Enterprise Server Workspace. В этих случаях принимающий/целевой Workspace может «видеть» и подключаться к исходному Workspace, тогда как целевой Altium 365 Workspace не может видеть и подключаться к Workspace, находящемуся в закрытой локальной сети.

Сводка по получению данных между Workspaces:

ИСТОЧНИК		ЦЕЛЬ	ПОДДЕРЖИВАЕТСЯ
Altium 365 Workspace	→	Altium Enterprise Server Workspace
Altium Enterprise Server Workspace	→	Altium Enterprise Server Workspace
Altium Enterprise Server Workspace	→	Altium 365 Workspace
Altium 365 Workspace	→	Altium 365 Workspace

Элементы, которые можно получить

Следующие типы Items можно получить из исходного Workspace в целевой Workspace с помощью функции Data Acquisition:

• 3D Model
• Altium Designer Preferences
• Component (включая связанные Part Choices)
• Component Template
• Datasheet
• Footprint
• Managed Schematic Sheet
• Output Job
• Schematic Template
• Script
• Simulation Model
• Symbol

Что следует учитывать при получении данных:

• Получается только выбранная ревизия исходного Item, а не все ревизии, которые могут существовать для этого Item. В представлении по умолчанию панели Explorer это будет последняя (текущая) ревизия Item, если только явно не выбрана более низкая (старая) ревизия — снимите выбор с опции Show only latest в меню , чтобы отобразить все доступные ревизии Item.
• При получении ревизии исходного Component или Managed Schematic Sheet Item также будут получены все связанные дочерние Items:
  • 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 целевого Workspace как в панели Components panel в Altium Designer, так и на странице Components page Workspace. Вы можете назначить нужный Component Type для одной или нескольких записей компонентов с помощью операции Change Component Type operation в панели Explorer в Altium Designer.

• Managed 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.

• Жизненный цикл полученной ревизии исходного Item будет установлен в начальное состояние (например, Draft), определяемое назначенным определением жизненного цикла (lifecycle definition) для целевого Item. Любая история жизненного цикла для ревизии исходного Item будет проигнорирована.
• Если дочерний Item выбранного исходного Component/Managed Schematic Sheet Item по какой-либо причине не может быть получен, то получение выбранного Component/Managed Schematic Sheet Item выполнено не будет.

Пользовательский интерфейс получения

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

Получение выполняется с помощью диалога Content Cart, доступ к которому осуществляется из панели Explorer panel. Просматривая исходный Workspace, из которого вы хотите получить данные, щёлкните правой кнопкой мыши по ревизии Item, которую нужно получить, и выберите команду Operations » Add to Content Cart в контекстном меню. Можно добавить одну или несколько выбранных ревизий Item, или даже папку Items (что загрузит в корзину последнюю ревизию всех Items в этой папке).

Диалог Content Cart — центральный пункт управления получением данных из исходного Workspace.

Используйте Content Cart, чтобы получить весь необходимый контент данных. Процесс получения Items данных из исходного Workspace можно свести к следующим шагам:

1. Текущий активный Workspace автоматически определяется как исходный Workspace.
   1. Вы можете изменить активный Workspace, отображаемый в представлении панели Explorer, — а значит и текущий источник данных — через меню выбора Workspace, доступное в левом верхнем углу панели.
   2. Доступные Workspaces — это те, к которым вы ранее подключались и/или которые в данный момент доступны (подключены), как показано в разделе Known Servers на странице Data Management – Servers page диалога Preferences.
   3. Обратите внимание: хотя Altium Content Vault также доступен как источник, его прямое использование для получения данных считается устаревшим (deprecated) в пользу панели Manufacturer Parts Search panel — куда вы будете перенаправлены, если Content Vault выбран в качестве источника. Панель Manufacturer Parts Search предоставляет расширенные возможности поиска реальных компонентов через сервис Altium Parts Provider Service и в фоновом режиме использует Altium Content Vault как источник данных моделей компонентов. Найденные компоненты, для которых доступны поддерживающие данные моделей, можно Acquired for use in your designs.
2. Используйте выпадающее меню имени целевого Workspace (подсвечено синим), чтобы выбрать альтернативный целевой Workspace из списка, который заполняется текущими подключёнными Workspaces — выберите опцию Server Administration, чтобы включать/отключать подключения к Workspace.

3. Исходная ревизия Item отображается в основной таблице. В корзину можно добавить любое количество дополнительных ревизий Item. Для этого нажмите элемент управления Add More Items в правом верхнем углу диалога и выберите пункт Select, чтобы открыть диалог Choose Item (вариант панели Explorer). Здесь можно просматривать исходный Workspace в поисках дополнительных Items, добавляя их по одному или пакетно, используя стандартные инструменты множественного выбора.

   Либо выберите пункт Add manually, чтобы открыть Add new items dialog. Этот диалог позволяет вставить внешний список требуемых items (по одному item в строке), после чего выполнить поиск по ним в исходном Workspace, используя выбранный критерий поиска (GUID, Item ID, Name или MPN). Выбирайте и удаляйте ревизии Item из списка (кнопкой ), если решите, что их всё-таки не нужно получать.

4. Нажмите элемент управления Change Settings в правом нижнем углу диалога Content Cart, чтобы открыть Content Cart Structure dialog. Здесь можно задать параметры по умолчанию для каждого типа Data Item, поддерживаемого функцией получения. Это включает указание папки по умолчанию в целевом Workspace, а также Lifecycle Definition по умолчанию, схемы именования Item и Revision и начальный индекс. Также можно добавить примечание, которое может быть полезно другим при просмотре полученного контента.
5. После выбора нужных исходных Items нажмите кнопку , которая подготавливает целевой Workspace к получению. При этом автоматически проверяется статус выбранных ревизий Item (на случай, если они уже получались ранее), связи родитель–дочерний элемент, а затем предлагается требуемое действие — для новых получений это будет Transfer new revision and item. Хотя параметры получения по умолчанию (см. пункт 3 выше) применяются на этапе подготовки, при необходимости можно изменить свойства отдельных целевых Items. Для этого выберите Item в списке и нажмите кнопку .
6. После завершения подготовки нажмите кнопку , чтобы запустить процесс получения данных. Появится начальное диалоговое окно подтверждения — нажмите Yes, чтобы продолжить перенос содержимого между исходным и целевым Workspace. Вторичное диалоговое окно подтверждения подтвердит результат получения данных.

Полученные данные содержат ссылку на свой исходный источник. Эту информацию о «родительской» связи можно увидеть, переключив представление аспектов для целевой ревизии Item на аспект Origin. Информация доступна только когда исходный (Origin) Workspace доступен и подключён — см. пункт 1 выше.

Механика получения данных

Для тех, кто хотел бы узнать о механизмах передачи данных, лежащих в основе процесса Data Acquisition, следующий раздел даёт больше понимания базового процедурного потока, используемого функцией, и типовых сценариев, встречающихся при управлении получением данных.

Базовый процедурный поток

Следующее изображение подробнее рассматривает механику получения данных из исходного Workspace. Оно иллюстрирует процедурный поток, который, по сути, копирует выбранную ревизию исходного элемента между назначенными исходным и целевым Workspace.

Механика получения данных из исходного Workspace и переноса их в целевой Workspace.

Как видно, процедура по сути сводится к трём отдельным этапам, обеспечивающим перенос данных между Workspace при сохранении их целостности:

1. Download – выбранная ревизия исходного элемента (в исходном Workspace) сначала загружается.
2. Modify & Retarget – данные автоматически модифицируются в соответствии с заданными локальными предпочтениями (локальными для целевого Workspace), при этом надёжно сохраняется полученное значение.
3. Release – данные выпускаются (released) в целевой Workspace (в данном случае — в новую ревизию существующего целевого Item). Целевая ревизия сохраняет связь со своим происхождением — указатель на «предка», то есть на ревизию исходного Item.

Управление полученными данными

В предыдущем разделе был показан базовый поток получения данных. Чтобы эффективно управлять получением данных, отслеживается относительная история как исходных, так и полученных элементов, чтобы соответствующие действия по получению были доступны разработчику через интерфейс управления получением.

Следующие разделы рассматривают общие сценарии, встречающиеся при управлении получением данных. В каждом случае состояние полученных данных — с точки зрения целевого Item и любых ревизий — сравнивается с исходным Item и его ревизиями.

Полностью новое получение

В этом сценарии ни одна ревизия исходного Item ранее не получалась. Ревизия исходного Item должна быть получена в начальную ревизию нового целевого Item. Новый целевой Item и ревизия создаются в рамках настройки получения.

Сценарий 1 — получение данных в начальную ревизию нового целевого Item.

Получение более поздней ревизии

В этом сценарии ревизия исходного Item уже была получена ранее. Затем исходный Item был изменён, в результате чего стала доступна более поздняя ревизия. В этом случае будет создана новая ревизия существующего целевого Item, чтобы получить более позднюю ревизию исходного Item.

То есть на практике, даже если последняя ревизия была получена в другую папку Cart целевого Workspace, система импортирует новую ревизию в существующий Component Item. У этого компонента теперь доступна новая ревизия, которая будет автоматически обнаружена при открытии проекта, использующего компонент — это будет обозначено статусом Out of date в панели Properties panel, Item Manager или документе ActiveBOM document.

Сценарий 2 — получение более поздней ревизии ранее полученного исходного Item.

Уже существует

В этом сценарии последняя ревизия исходного Item уже получена — больше нечего получать.

Сценарий 3 — требуемая ревизия исходного Item уже получена, делать ничего не нужно.