Настройка Teamcenter PLM

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

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

Синхронизация компонентов с 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 файлах 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, чтобы она помогла вам пройти настройку:

В рамках установки и настройки интерфейса 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 Instance, чтобы открыть окно Add new instance, выберите вкладку Configuration, затем Download sample configuration.

Внутри скачанного 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 Configuration файла 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 Configuration файла 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>

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

После создания конфигурации производных данных (см. ссылки в файле altiumPcb_edadef.xml) вы можете указать имя конфигурации в настройке (preference) 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».

Pathname: $TEMP\Altium\TcEda\Project\pcb\*.*

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

Pathname: $TEMP\Altium\TcEda\Project\schematic\*.*

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

Pathname: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

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

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

Current Project Publishing Limitations:

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