Дополнительная установка и настройка для Teamcenter EDA Gateway

Parent page: Интеграция с PLM

Интеграция с Siemens Teamcenter® PLM требует дополнительной настройки, которая не выполняется автоматически установщиком экземпляра Enterprise Server. По сути, требуется два уровня настройки — в зависимости от того, какие функции интеграции нужны. Первый уровень включает синхронизацию компонентов (Parts Synchronization) и также является обязательным условием для второго уровня, который включает PLM-процессы публикации/инициализации проекта (Project Publish/Initialization). Тем не менее рекомендуется выполнить оба уровня настройки.

Синхронизация компонентов (Parts) с Teamcenter

Чтобы включить синхронизацию компонентов библиотек, необходимо установить ПО Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway на машине, на которой размещён Enterprise Server. В этом документе предполагается, что Enterprise Server и сервер Teamcenter уже установлены на разных машинах — мы рекомендуем именно такой подход, чтобы обеспечить разделение двух установок, хотя их можно установить и на одной машине.

Установка и настройка Teamcenter EDA

Полная процедура установки и настройки EDA Gateway подробно описана в документации для соответствующей версии EDA Integration, доступной в Siemens Support Center. Пожалуйста, строго следуйте этой документации. Инструкции ниже охватывают только отличия от документации Siemens либо уточняют детали со стороны Altium, которые в документации Siemens указаны как требования.

Выберите версию EDA Gateway, которая поддерживает версию вашего сервера Teamcenter — информацию о совместимости следует искать в соответствующих TcEDA<version>_README.pdfфайлах, доступных в центре загрузок. Затем обратитесь к документации Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (пример ссылки приведён для EDA версии 5.1) по теме Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management, чтобы она провела вас через настройку:

В рамках установки и настройки интерфейса Enterprise Server/Teamcenter необходимо также установить (и при необходимости лицензировать и т. п.) следующие функции Teamcenter — см. Setting up EDA Gateway for ECAD applications:

• Extensions » Mechatronics Process Management » EDA Server Support
• Extensions » Mechatronics Process Management » EMPS-Foundation
• Extensions » Mechatronics Process Management » ECAD Library Management
• Extensions » Mechatronics Process Management » EDA for Business Modeler IDE
• Extensions » Supplier Relationship Management » Vendor Management
• Base Install » Active Workspace » Server Extensions » EDA Server Support for Active Workspace
• Base Install » Active Workspace » Client » Electronic Design Automation for Active Workspace

Кроме того, выполните Install and set up Common Integration Services для поддержки публикации проектов (Design Publishing).

Далее выполните шаги и установите EDA Gateway CLIENT на машине Enterprise Server. Чтобы упростить процесс, рекомендуем использовать папку C:\Siemens\TeamcenterEDA2.

Настройка EDA Gateway для управления библиотекой компонентов

Как и выше, для этого раздела также следует обратиться к документации Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (пример ссылки приведён для EDA версии 5.1) по теме Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

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

Глава: 'Configure the EDA client for part library management'

На этом шаге вас попросят подготовить library gateway configuration file — вместо этого используйте файл, предоставленный Altium. Его можно скачать вместе с пакетом конфигурационных файлов из браузерного интерфейса Enterprise Server Workspace: откройте Admin » PLM Integration, нажмите кнопку Add Configuration, чтобы открыть представление Add New Instance, выберите Teamcenter EDA в выпадающем меню Driver, затем выберите ссылку Download Teamcenter EDA client definition files, связанную с полем URL — см. пример.

Внутри загруженного файла PLMClientConfigurationFiles.zip будет файл altiumLibrary_edadef.xml — поместите его в каталог, на который указывает системная переменная окружения: %TCEDAECAD_ROOT%. Также добавьте в этот каталог предоставленный файл altiumPcb_edadef.xml.

Глава: 'Setting up Teamcenter server for part library management'

Откройте Teamcenter Rich Client от имени пользователя infodba либо другого пользователя с правами администратора.
► См. информацию о Teamcenter Rich Client.

Скриншоты ниже иллюстрируют шаги, описанные в Create external applications for your ECAD tool in Teamcenter. В нашем случае мы добавим altiumLibrary,15 в настройку (preference) EDALIB_External_Applications:

Нажмите команду , чтобы добавить новое значение, затем Save, после чего закройте настройку. Выйдите из системы и затем снова войдите в Teamcenter Rich client.

• Откройте приложение Organization.
• Перейдите в раздел External Applications и добавьте приложение altiumLibrary, как показано ниже:

• Выберите Create.

Глава: 'Mapping ECAD part attributes to Teamcenter attributes'

Через командную строку Teamcenter запустите утилиту export_attr_mappings, чтобы вывести сопоставление (mapping) в файл, например:

export_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba

Измените файл mappings.txt в соответствии с вашими требованиями, чтобы сопоставить реальные атрибуты Teamcenter с компонентами. Пример рабочего сопоставления, добавленного в содержимое экспортированного mappings.txt:

{ Item type="EDAComPart"
    Cost : Item.GRM(IMAN_master_form).object_desc /description="Cost"
    Tolerance : ItemRevision.GRM(IMAN_master_form).object_desc /description="Tolerance"}

После завершения сопоставления импортируйте его обратно в Teamcenter:

import_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba

Для диагностики проблем сопоставления атрибутов можно включить подробные логи, добавив строку rootLogger.level= DEBUG в файл C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties.

Журналы выполнения Teamcenter EDA можно найти в C:\Windows\TEMP\eis_eda_log.log.

Глава: 'Creating classification mapping for ECAD parts with Teamcenter classes' (необязательно)

Сопоставление классификации (classification mapping) — необязательное требование настройки и может не использоваться или быть не нужно для вашей установки Teamcenter PLM. Обратите внимание: чтобы использовать атрибуты классификации, их нужно включить в конфигурацию/файл сопоставления атрибутов при выполнении предыдущего раздела 'Mapping ECAD part attributes to Teamcenter attributes' выше.

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

Убедитесь, что _eda2tc.csv имеет столбцы в порядке category,classId, а _tc2eda.csv имеет столбцы в порядке classId,category. При необходимости поменяйте имена файлов местами.

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

"SMT attribute" : ItemRevision.ICS(-60262) /description="SMT"

Где номер -60262 можно найти с помощью инструмента Classification Admin в Teamcenter.

Сопоставление классификации в Enterprise Server

Информация о классификации может передаваться с помощью специального атрибута Classification, включённого в ваш XML-файл конфигурации PLM (typically dm-config.xml или аналогичный). Например:

<common:Attribute>
    <common:Key>Classification</common:Key>
    <common:Value>${parameter.Classification}</common:Value>
</common:Attribute>

Значение этого атрибута должно быть путём в дереве классификации, разделённым запятыми, например: “Components,SMT,Capacitor”.

Аналогично, атрибуты классификации можно указывать по имени, которое было настроено в сопоставлении атрибутов на сервере Teamcenter, например:

<common:Attribute>
    <common:Key>SMT attribute</common:Key>
    <common:Value>smt attr value</common:Value>
</common:Attribute>

Определение библиотеки на Enterprise Server

Прежде чем станет возможна синхронизация с Enterprise Server, необходимо создать библиотеку командой eda_cli.bat (расположена в каталоге %TCEDAECAD_ROOT% на машине Enterprise Server), а также убедиться, что созданные файлы доступны для Enterprise Server:

edacli.bat -configureLibrary -application altiumLibrary -status %userprofile%\status.xml

На этом этапе должна быть возможна синхронизация компонентов Enterprise Server Component Sync и процесс запроса компонента Enterprise Server Part Request with PLM Part Create.

Дополнительная информация о синхронизации библиотечных компонентов:

• Synchronization of Released/Unreleased Teamcenter parts – По умолчанию из Teamcenter в Altium будут синхронизироваться только компоненты, помеченные release_status_list.name = ‘TCM Released’ . Это можно изменить в Teamcenter Query Builder, изменив запрос, который Teamcenter использует для выбора компонентов (см. пример).

Имя запроса хранится в настройке (preference) EDALIB_Sync_FindNewParts. Запрос по умолчанию — __EDALIB_find_newparts, он показан ниже.

Последнее условие можно удалить, чтобы синхронизировать компоненты, которые ещё не “TCM Released”.

► Дополнительные сведения см. в соответствующей документации Siemens Teamcenter.

• Multisite synchronization – Также возможно использовать Teamcenter как источник информации о компонентах для нескольких площадок (одна из них — Enterprise Server). Обратите внимание, что для этого требуется специальная настройка, описанная в документации.
• Unit-of-measure parameter synchronization– Интеграция Workspace с Teamcenter поддерживает сопоставление параметров с учетом единиц измерения через дополнительные столбцы данных Data Type и SiPrefix в таблице Component Parameter Mapping table пользовательского интерфейса. Используйте параметры выпадающего меню записи, чтобы выбрать подходящий тип данных (see options) и приставку единицы (see options).

• Destination folder for parts – Целевую папку для компонентов, синхронизируемых из Altium в Teamcenter, можно задавать для каждого сайта/пользователя с помощью настройки EDALIB_SaveAsFolderDefault Teamcenter preference.
• Current Part Synchronization limitations:
  • Номера деталей PLM генерируются только на стороне Enterprise Server.
  • Папку назначения нельзя указать для компонентов в файле конфигурации — на стороне Teamcenter есть глобальная настройка. Настройка папки назначения в файле PLM XML Configuration (dm-config.xml) будет проигнорирована без предупреждения. Целевая папка берется из уровня пользователя Teamcenter либо из опции уровня сайта EDALIB_SaveAsFolderDefault для всех типов компонентов.
  • Выбор нативных деталей (Approved Manufacturer/Vendor List, или AML/AVL) не поддерживается. Как и ранее, поддерживаются только варианты выбора деталей на основе параметров компонента.

Публикация проектов (Design Publishing) с Teamcenter EDA

Публикация проекта из Altium в Teamcenter возможна только через Altium Designer. Чтобы включить публикацию проекта, необходимо установить Teamcenter EDA (Electronic Design Automation) Gateway на компьютер, где установлен Altium Designer . Также потребуется доступ и к Enterprise Server, и к серверу Teamcenter.

Процедура установки и настройки EDA Gateway подробно описана в документации для конкретной версии EDA Integration, доступной в Siemens Support Center. Строго следуйте этой документации. Инструкции здесь охватывают только отличия от документации Siemens или уточняют детали на стороне Altium, которые в документации Siemens указаны как требования.

Выберите версию EDA Gateway, которая поддерживает версию вашего сервера Teamcenter — информацию о совместимости следует искать в соответствующих файлах TcEDA<version>_README.pdf Gateway, доступных в центре загрузок. Затем обратитесь к документации Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (пример ссылки приведен для EDA версии 5.1) по теме Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management, чтобы она провела вас через настройку:

Если требуется поддержка создания компонентов при публикации проекта, то часть конфигурации библиотек должна выполняться на сервере. Это относится к стратегии секций по умолчанию <pt:BomStrategy>CreateNewAndLink</pt:BomStrategy> в шаблоне публикации.

Целевую папку для проектов можно задавать параметрами уровня сайта/пользователя: EDA_SaveAsFolderDefault.

Сопоставление атрибутов строк BOM

Атрибуты строк BOM Reference Designator и Quantity обрабатываются автоматически, но их нужно включить в раздел <BOM> файла PLM connector XML Configuration:

<BOM>
    <BOMAttributes>
        <!-- "Reference Designator" attribute is mandatory for Teamcenter EDA connector -->
        <common:BOMAttribute>
        <common:Key>Reference Designator</common:Key>
        <common:Value>${parameter.LogicalDesignator}</common:Value>
        </common:BOMAttribute>
        <!-- "Quantity" attribute is mandatory for Teamcenter EDA connector -->
        <common:BOMAttribute>
        <common:Key>Quantity</common:Key>
        <common:Value>${parameter.Quantity}</common:Value>
        </common:BOMAttribute>
    </BOMAttributes>
</BOM>

Чтобы использовать другие атрибуты строк BOM, необходимо включить их в раздел сопоставления атрибутов строк BOM файла altiumPcb_edadef.xml. Например, запись ниже добавляет сопоставление атрибута Altium part_source с атрибутом строки BOM Teamcenter bl_part_source:

<RdnAttrMapDefs>
    <RdnAttrDesign cadAttrName="part_source" tcAttrName="bl_part_source"/>
</RdnAttrMapDefs>

После добавления такого сопоставления можно определить его значение в разделе <BOMAttributes> файла PLM connector XML Configuration:

<!-- You can add any other custom attributes, but these need to be mapped to Teamcenter attribute in altiumPcb_edadef.xml file -->
<common:BOMAttribute>
    <common:Key>part_source</common:Key>
    <common:Value>${parameter.MakeOrBuy}</common:Value>
</common:BOMAttribute>

Конфигурация публикации альтернативных компонентов BOM

ActiveBOM в Altium Designer поддерживает добавление альтернативных компонентов к позициям BOM (learn more). Чтобы поддержать такие альтернативные компоненты при публикации проекта в Teamcenter PLM, нужно выполнить дополнительную настройку Teamcenter EDA, как описано ниже (в терминологии Teamcenter эти альтернативные компоненты в рамках конкретного BOM называются substitute components). Это включит обратные вызовы Altium с логикой передачи substitute.

1. Найдите файл soa_client.zip в установочных файлах версии сервера Teamcenter, которую вы используете в данный момент.

2. Найдите следующие файлы внутри этого zip-файла:

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. Скопируйте эти два файла в каталог %TCEDAECAD_ROOT% на ПК, где установлены Teamcenter EDA Gateway и Altium Designer.

4. Откройте файл %TCEDAECAD_ROOT%\setup_eda.bat и найдите следующие строки:

   
   rem
   rem Add customer callbacks
   rem
   if exist CustomEDACallbacks.jar (
   	SET EDA_CP=%EDA_CP%;CustomEDACallbacks.jar
   )
   

5. Добавьте ниже следующие строки:

   
   rem Added for Altium support of BOM substitutes
   set EDA_CP=%EDA_CP%;TcSoaStructureManagementStrong_14000.3.0.jar
   set EDA_CP=%EDA_CP%;TcSoaBomStrong_14000.3.0.jar
   

   Обратите внимание на номер версии (т. е. 14000.3.0 в примере выше). Он должен совпадать с номером версии, включенным в имя файла, который был скопирован на предыдущем шаге.

6. Откройте файл %TCEDAECAD_ROOT%\altiumPcb_edadef.xml. Добавьте следующие записи <callback …/> внутри раздела <CallbackDefs> (он уже существует в файле):

   
   <callback type="java" operation="preSave" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:checkSubstitutes"/>
   <callback type="java" operation="preSaveAs" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:checkSubstitutes"/>
   <callback type="java" operation="postSave" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:updateSubstitutes"/>
   <callback type="java" operation="postSaveAs" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:updateSubstitutes"/>
   

   Указанные выше записи уже присутствуют в файле altiumPcb_edadef.xml — в многострочном комментарии внутри раздела <CallbackDefs>. Вы можете перенести эти записи из комментария (например, переместив их сразу под часть --> в этом разделе).
7. Перезагрузите ПК, чтобы Teamcenter EDA загрузил новые библиотеки.

Notes:

• Teamcenter EDA должен быть настроен на работу с Java 11.
• Если вы используете Teamcenter 13, убедитесь, что используете версии дополнительных библиотек из вашей установки Teamcenter 13.
• Убедитесь, что обновили файлы CustomEDACallbacks.jar и altiumPcb_edadef.xml в каталоге %TCEDAECAD_ROOT%.
• В Altium Designer все design variants используют один и тот же набор substitute, т. е. невозможно задать разные substitute для одной и той же позиции BOM в разных вариантах.
• Список substitute-компонентов в Teamcenter — это список ревизий компонентов. Записи substitute-компонентов не создают строки BOM и для них нельзя назначать свойства строк BOM. В Altium Designer можно иметь столбец BOM с другим значением для substitute, но в свойства строк BOM Teamcenter будут передаваться только свойства базового компонента.
• Если проект с substitute в BOM был опубликован в Teamcenter, а затем substitute из BOM проекта был удален и проект был опубликован снова, substitute также будет удален из BOM в Teamcenter.
• Если проект с substitute в BOM был опубликован в Teamcenter, а затем BOM был вручную изменен в Teamcenter, то при следующей публикации этого проекта BOM в Teamcenter будет перезаписан, т. е. изменения, внесенные вручную, будут потеряны.

• Компоненты, используемые в качестве заменителей в ActiveBOM, должны быть синхронизированы с Teamcenter. Это условие проверяется с помощью preSave callback. Если есть компоненты, которые не были синхронизированы с Teamcenter, будет показано сообщение об ошибке, и операция будет прервана, поэтому в Teamcenter не будет внесено никаких изменений.

Конфигурация Business Modeler IDE (BMIDE) для производных наборов данных

После создания конфигурации производных данных (см. ссылки в файле altiumPcb_edadef.xml), вы можете указать имя конфигурации в настройке EDA_DerivedDataConfigDefault.

1. В BMIDE откройте папку Extensions.
2. В папке Extensions щёлкните правой кнопкой мыши EDA Derived Data и выберите New EDA Derived Data. Откроется мастер New EDA Derived Data.
3. В диалоговом окне EDA Derived Data введите информацию и нажмите Next.
4. Для производного набора данных PCB добавьте новую запись в разделе «Configure datasets».

Путь: $TEMP\Altium\TcEda\Project\pcb\*.*

5. Для производного набора данных схемы добавьте новую запись в разделе «Configure datasets».

Путь: $TEMP\Altium\TcEda\Project\schematic\*.*

6. Ещё один производный набор данных для наборов данных Variants:

Путь: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

7. Чтобы сохранить изменения в модели данных, выберите File » Save Data Model или нажмите кнопку Save Data Model на главной панели инструментов.
8. Разверните изменения на тестовом сервере. Выберите Deploy Template в строке меню или выделите проект и затем нажмите кнопку Deploy Template на главной панели инструментов.
9. В Rich Client задайте настройку EDA_DerivedDataConfigDefault, чтобы она указывала на только что созданную конфигурацию производных данных EDA.
10. Выберите Edit » Options, нажмите ссылку Search в нижней части диалогового окна Options, найдите настройку EDA_DerivedDataConfigDefault и измените её значение на новую конфигурацию.

Дополнительная информация о публикации проекта

Current Project Publishing Limitations:

• Ссылка на конкретные ревизии компонентов («Precise BOM») не поддерживается Siemens EDA Gateway.
• ECO в настоящее время не поддерживается.