Синхронизация компонентов с корпоративными системами

Вы просматриваете версию 1.0. Для самой новой информации, перейдите на страницу Синхронизация компонентов с корпоративными системами для версии 5.0

This documentation page references Altium Concord Pro, which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

Главная страница: Altium Concord Pro

Altium Concord Pro обеспечивает одно- и двунаправленную синхронизацию данных о компонентах (в том числе вариантов выбора компонентов) с корпоративными системами. Файл конфигурации позволяет указать направление синхронизации и, следовательно, указать, какая система владеет какими параметрами. Синхронизация данных о компонентах между Concord Pro и целевой корпоративной системой использует встроенный процесс синхронизации, который может быть запущен вручную или настроен как периодически повторяемое событие.

Altium Concord Pro не предлагает полную интеграцию с PLM – этот уровень интеграции доступен только в Altium NEXUS.

Установка Altium Concord Pro включает в себя средство импорта базы данных компонентов CSV, который можно использовать для переноса данных компонентов в Concord Pro из файла, экспортированного из другой системы (PLM, ERP или какой-либо другой). Кроме того, для следующих корпоративных систем предлагается прямая поддержка:

  • PTC Windchill® PLM (11.0 M030)
  • Arena® PLM
  • Oracle® Agile™ PLM

Конфигурация интерфейса осуществляется через веб-интерфейс Concord Pro, где настройка соединения и отображение параметров заданы в XML-файле конфигурации (загруженном на сервер).

Когда процесс синхронизации добавляет данные компонента в целевую систему, сформированный номер объекта передается обратно в Concord Pro в виде параметра PlmPartNumber. Он выступает в роли ключевого параметра при синхронизации данных между Concord Pro и корпоративной системой. Кроме того, конфигурация может быть задана таким образом, чтобы параметры/атрибуты объекта на стороне корпоративной системы обновляли свойства на сервере Concord Pro (доступна настройка по отдельным полям), без необходимости выпускать новые ревизии этого объекта компонента (Component Item).

Средство загрузки CSV

Установка Altium Concord Pro включает в себя средство импорта базы данных компонентов в формате CSV, которое можно использовать для переноса данных компонентов в Concord Pro из файла, экспортированного из корпоративной системы. Это средство, реализованное в виде настраиваемого командного файла (*.bat), импортирует данные о компонентах из целевого файла электронной таблицы (*.csv) на сервер, как задано существующими шаблонами сервера или специальным файлом конфигурации.

Это консольное средство можно найти в папке \Program Files (x86)\Altium\Altium Concord Pro\Tools\CSVImport установки Concord Pro. См. csv-import.bat для получения информации о синтаксисе, используемом этим средством, или просто запустите командный файл без атрибутов для получения более подробной информации.

Примечания:

  • Средство и его папка среды выполнения Java (JRE8) могут быть скопированы в любое расположение и запущены из него, в том числе из другой машины в локальной сети, на которой не установлен Concord Pro.
  • Может понадобится запустить средство от имени администратора, в зависимости от того, где оно расположено.
  • Синтаксис средства чувствительно к регистру, как и ссылки в шаблонах сервера и во всех используемых файлах конфигурации.

Формат исходного файла:

Для средства импорта данных CSV необходимо, чтобы исходный файл CSV использовал символьную кодировку кодировку UTF-8. Если файл использует другой формат кодировки, такой как ANSI или UTF-8-BOM, средство импорта не будет корректно интерпретировать расширенные символы (например µ), либо оно не примет исходный файл *.csv.

При создании простого файла CSV для тестов обратите внимание, что некоторые версии Блокнота Windows не осуществляют сохранение в совместимый формат UTF-8. Если вы сомневаетесь, можно использовать другой текстовый редактор, например Notepad++, для создания и сохранения файлов, кодированных в UTF-8, а также для проверки формата кодировки файлов *.csv, экспортированных из корпоративной системы.

Автоматический режим

При использовании средства без файла конфигурации (параметр –c), оно попытается сопоставить имя целевого файла CSV (например, Resistor.csv) с шаблоном компонентов на сервере, который поддерживает этот тип компонентов (Resistor). Найденный шаблон определит ревизию, жизненный цикл и папку по умолчанию (целевую папку на сервере) для импортированных данных. Обратите внимание, что минимальным требованием к данным в исходном файле CSV является наличие столбца параметров PART_NUMBER и соответствующих значений.

Средство импорта csv предоставляет общую информацию о прогрессе в окне консоли, и оно также может формировать лог-файл, в соответствии с указанным синтаксисом команды (-l). Если в файле CSV присутствуют параметры производителя компонента (по умолчанию MFR_PART_NUMBER и MFR_NAME), на сервере будут созданы соответствующие записи вариантов выбора компонентов.

Опциональный лог-файл предоставляет подробности об успешном процессе импорта. Если процесс завершается неудачей, лог-файл не будет создан.

Настраиваемый режим

Расширенный режим средства использует файл конфигурации XML для указания сопоставления параметров в файле и на сервере для процесса импорта. В примере, показанном ниже, это может быть отображение исходного параметра Value в параметр Resistance на сервере и параметра Format в параметр Package.

Для получения базового файла конфигурации, который может быть изменен под собственные требования, запустите средство с параметром формирования файла конфигурации (-g). Будет создан указанный файл XML с парами ключа параметра и значения, извлеченными из исходного файла CSV, и настройкой ревизии, жизненного цикла и целевой папки из соответствующего шаблона. Например:
csv-import.bat -s http://HPZ600:9780 -u admin -p admin -g MyConfig.xml -i C:\Users\Public\Documents\CSV_Files\Resistor.csv

Измените значения атрибутов в разделе ToAltium файла конфигурации MyConfig.xml (для Resistor) для сопоставления необходимым образом.

Для проведения необходимого сопоставления файл конфигурации затем используется со средством импорта CSV Uploader (параметр –c):
csv-import.bat -s http://HPZ600:9780 -u admin -p admin -c MyConfig.xml -i C:\Users\Public\Documents\CSV_Files\Resistor.csv

Если на сервере уже существуют записи компонентов (импортированные в примере процесса автомаитческого режима), будут созданы новые ревизии и в существующие данные будут добавлены заново сопоставленные параметры – существующие параметры не удаляются.

Дополнительные возможности:

  • Примененный файл конфигурации определяет все настройки процесса импорта, в том числе сопоставление параметров, независимо от соответствующих шаблонов сервера.
  • Все параметры могут быть сопоставлены с учетом параметров входного файла CSV, включая то, какое имя используется в файле для номера PLM и данных производителя компонента.
  • В файл конфигурации может быть включено множество определений сущностей, в том числе входящие в них атрибуты. Скопируйте существующую запись группы сущностей, например Resistor, затем вставьте/измените ее для создания другой записи для Capacitor.
  • Если целевой путь указан без файла CSV, средство будет искать в исходной папке имена файлов CSV, которые соответствуют определениям сущностей в файле конфигурации. Если для Capacitor и Resistor существуют сущности настроек и найдены соответствующие файлы CSV, на сервер будут импортированы данные для этих компонентов. По сути, это пакетный режим работы средства.
  • Если исходный файл CSV использует определенную структуру имен файлов, которая не соответствует стандартным типам компонентов на сервере (Resistor, Capacitor и т.д.), это можно разрешить путем сопоставления класса PLM в файле конфигурации. Например, если исходным файлом является PLM-Export_Resistors.csv, запись класса PLM plmType=”Resistor” может быть изменена на plmType=”PLM-Export_Resistors”.

Прямая поддержка систем

Для следующих корпоративных систем Altium Concord Pro предлагает прямую поддержку:

  • PTC Windchill® PLM (11.0 M030)
  • Arena® PLM
  • Oracle® Agile™ PLM
Вследствие ограничений API, синхронизация библиотек с компонентами производителей/вариантами выбора компонентов в данный момент не поддерживается при работе с интегрированной инстанцией Windchill.

Подключение к корпоративной системе

Подключение к корпоративной системе осуществляется на странице Admin - PLM Integration веб-интерфейса Concord Pro. Подключение включает в себя загрузку необходимого файла конфигурации XML и включение/настройку синхронизации компонентов из корпоративной системы с компонентами на сервере Concord Pro.

Для создания новой инстанции интерфейса нажмите кнопку  . Может быть создано любое необходимое количество инстанций для взаимодействия установки Altium Concord Pro со множеством инстанций различных корпоративных систем. Например, компоненты могут находиться в одной инстанции, либо различные подразделения могут использовать различные инстанции (одной или разных корпоративных систем). У каждой инстанции должно быть уникальное имя и файл конфигурации.

В установку включены примеры файлов конфигурации – нажмите по разделу ниже, чтобы получить более подробную информацию:

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

При запуске проверки подключения, сервер анализирует текущие настройки для совместимости с данными Concord Pro и целевой корпоративной системой. Будут произведен поиск проблем конфигурации, такие как ошибки пути, определения несоответствующих типов компонентов, некорректные настройки жизненного цикла или ревизии, и отчет по этим проблемам будет приведен в диалоговом окне Configuration Validation Report.

Добавьте и настройте интерфейс с корпоративной системой, затем найдите и исправьте ошибки в загруженном файле конфигурации.Добавьте и настройте интерфейс с корпоративной системой, затем найдите и исправьте ошибки в загруженном файле конфигурации.

Хотя вам, скорее всего, понадобится настроить подключение только к одной инстанции корпоративной системы, на сервер Concord Pro может быть добавлено любое количество инстанций.

Если файл конфигурации был изменен и затем загружен повторно в инстанцию корпоративной системы, используйте опцию  для обнаружения проблем, которые могли появиться.

Синхронизация компонентов

Синхронизация компонентов между Concord Pro и подключенной инстанцией корпоративной системы, или точнее, ее параметрическими данными, включает в себя следующее:

  1. Настройка синхронизации для каждого типа компонентов, что включает в себя:
    1. Определение направления синхронизации.
    2. Определение того, какие компоненты включены в синхронизацию и где необходимо создавать новые компоненты.
    3. Настройка отображения параметров.
  2. Выполнение синхронизации.

В файле конфигурации, используемом для подключенной инстанции корпоративной системы, обрабатывается первый объект. Сама синхронизация может быть выполнена по требованию со страницы PLM Integration веб-интерфейса Concord Pro, и/или она может быть запланирована, т.е. настроена автоматическая синхронизации с периодическими интервалами, определенными при конфигурации подключения к инстанции корпоративной системы.

Настройки синхронизации

В файле конфигурации вы определяете раздел отображения синхронизации для каждого определенного типа компонентов. Со стороны Concord Pro, это компонент типа altiumType (и это название, которое вы видите в диалоговом окне Component Type Altium Designer). Со стороны корпоративной системы, создается компонент типа plmType. Это обозначается в виде сущности (Entity) в файле, примером которой для конденсаторов может быть:

<Entity altiumType="Capacitor" plmType="Capacitor">
.

.
</Entity>

Значение plmType может быть разным, в зависимости от конкретной используемой корпоративной системы.

Внутри тэгов Entity, для управления и настройки синхронизации с сервера Concord Pro в инстанцию корпоративной системы используются два раздела, которые позволяют выполнить одно- или двунаправленную синхронизацию. Для получения более подробной информации используйте разделы ниже, а также комментарии в примерах файлов конфигурации. В конечном счете, содержимое файла конфигурации будет зависеть от ваших определенных требований.

Проведение синхронизации компонентов

Сама синхронизация осуществляется со страницы PLM Integration веб-интерфейса Concord Pro. Щелкните мышью по элементу управления , соответствующему инстанции корпоративной системы, с которой вы хотите осуществить синхронизацию. Процесс синхронизации будет осуществлен в соответствии с настройками, заданными в файле конфигурации.

Синхронизация затронет только те компоненты, которые были изменены с момента последнего запуска синхронизации (т.е. компоненты, отметка времени которых является более поздней по отношению к дате последней синхронизации) и которые соответствуют критериям синхронизации в файле конфигурации. Это называется инкрементальной синхронизацией.

Выполняемая синхронизация компонентов между Concord Pro и указанной инстанцией корпоративной системы.Выполняемая синхронизация компонентов между Concord Pro и указанной инстанцией корпоративной системы.

Элемент управления изменится на . Если вы хотите остановить процесс синхронизации, щелкните мышью по этому элементу управления. Будет открыто диалоговое окно подтверждения – нажмите  , чтобы остановить синхронизацию. Все уже синхронизированные компоненты останутся, но дальнейшей синхронизации осуществляться не будет.

Обновите браузер (F5), чтобы проверить, когда процесс синхронизации будет завершен. Чтобы увидеть подробную информацию о завершенном процессе или убедиться в его успешности, выберите вкладку Synchronisation status и опцию списка Closed – если процесс все еще запущен, он будет отображен в списке Active. Подробная информация о выбранном событии синхронизации показана в нижней области, которая также включает в себя ссылку на системный лог-файл (PLM [дата-номер].log) для этого события.

Запланированная синхронизация компонентов

У вас также есть возможность запланировать автоматизированную синхронизацию. Для этого измените инстанцию корпоративной системы (на главной странице PLM Integration нажмите по имени инстанции или по соответствующему элементу управления ), выберите вкладку Component Synchronisation и включите параметр Synchronize PLM Components with server on schedule. Используйте элементы управления Synchronize every для настройки графика автоматизированной синхронизации. Система является очень гибкой, и она позволяет:

  • Настроить запланированную синхронизацию каждые 15/30/45/60/75/90 минут.
  • Настроить запланированную синхронизацию каждые x часов.
  • Настроить ежедневную запланированную синхронизацию, осуществляемую в указанное время.

Заданный вами график будет отражен на главной странице PLM Integration, в столбце Sync scheduled.

Настройка графика синхронизации.Настройка графика синхронизации.

Для настройки запланированной синхронизации необходимо предоставить корректные учетные данные (для корпоративной системы). Нажмите кнопку  и введите имя пользователя (User name) и пароль (Password) в открывшемся окне PLM Credentials. Без корректных учетных данных запланированная синхронизация останется в отключенном состоянии. Синхронизация по запросу также будет невозможна.

Вы также можете запустить процесс синхронизации по запросу на странице Edit instance. Нажмите кнопку  и выберите необходимый режим синхронизации:

  • Incremental (Инкрементальный) – в этом режиме, синхронизация затронет только те компоненты, которые были изменены с момента последнего запуска синхронизации (т.е. компоненты, отметка времени которых является более поздней по отношению к дате последней синхронизации) и которые соответствуют критериям синхронизации в файле конфигурации. Это режим по умолчанию, и это тот же самый режим, который запускается щелчком мыши по элементу управления  для инстанции корпоративной системы на главной странице PLM Integration.
  • Full (Полный) – этот режим принудительно осуществляет полную синхронизацию. Все компоненты, которые соответствуют критериям синхронизации в файле конфигурации, будут включены в процесс синхронизации, с применением соответствующих изменений.
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Content