Настройка Teamcenter PLM

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). Обратите внимание, что для этого требуется специальная настройка, описанная в документации.
• Destination folder for parts– Целевую папку для компонентов, синхронизируемых из Altium в Teamcenter, можно задавать для каждого сайта/пользователя с помощью настройки Teamcenter EDALIB_SaveAsFolderDefault.
• 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> XML‑файла конфигурации PLM‑коннектора:

<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> XML‑файла конфигурации PLM‑коннектора:

<!-- 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). Это включит обратные вызовы (callbacks) Altium с логикой передачи замен.

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 используют один и тот же набор замен, т. е. невозможно задать разные замены для одной и той же позиции BOM в разных вариантах.
• Список substitute components в Teamcenter — это список ревизий компонентов. Записи substitute components не создают строки BOM и не могут иметь назначенные свойства строки BOM. В Altium Designer можно иметь столбец BOM с другим значением для замен, но в свойства строк BOM Teamcenter будут передаваться только свойства базового компонента.
• Если проект с заменами в BOM был опубликован в Teamcenter, затем замена из BOM проекта была удалена и проект опубликован снова, то замена также будет удалена из BOM в Teamcenter.
• Если проект с заменами в BOM был опубликован в Teamcenter, а затем BOM был вручную изменён в Teamcenter, то при следующей публикации этого проекта BOM в Teamcenter будет перезаписан, т. е. изменения, внесённые вручную, будут потеряны.

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

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

После создания конфигурации derived data (см. ссылки в файле 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 в настоящее время не поддерживается.