Teamcenter EDA Gateway の追加インストールおよびセットアップ

Created: 5月 18, 2022 | Updated: 12月 11, 2025 | Applies to version: 5.0

This document is no longer available beyond version 5.0. Information can now be found here: Additional Installation and Setup for Teamcenter EDA Gateway for version 8.0

This documentation page references NEXUS Server (part of the deployed NEXUS solution), 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.

Parent page: Altium NEXUS Server との PLM 連携

Siemens Teamcenter® PLM 連携には、NEXUS Workspace インスタンスのインストーラーでは自動的に管理されない追加セットアップが必要です。基本的に、必要とする連携機能に応じて 2 段階のセットアップが必要になります。第 1 段階では部品同期を有効にし、第 2 段階（プロジェクトの公開/初期化 PLM プロセスを有効にする）に進むための前提条件にもなります。いずれにしても、両方のセットアップを実施することを推奨します。

Siemens Teamcenter PLM を Teamcenter EDA (Electronic Design Automation) Gateway インターフェース経由でサポートする機能は、現在 Closed Beta 段階であることに注意してください。Teamcenter インターフェースの旧バージョン（SOAP ベース API を使用）は、ベータテストが完了するまで引き続き動作します。
Teamcenter 接続連携には Altium NEXUS の Teamcenter PLM Addon license が必要です。

Teamcenter との同期の詳細については、Teamcenter PLM Addon サーバーライセンスが追加されたときに利用可能になる関連設定および公開のサンプルファイルを参照してください。

Teamcenter との部品同期

ライブラリ部品の同期を有効にするには、Altium NEXUS Server をホストしているマシンに Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway ソフトウェアをインストールする必要があります。本書では、NEXUS Server と Teamcenter サーバーが別々のマシンにすでにインストールされていることを前提としています。2 つのインストールを分離するため、この構成を推奨しますが、同一マシンにインストールすることも可能です。

Teamcenter EDA のインストールと設定

EDA Gateway のインストールおよび設定手順全体は、バージョン固有の EDA Integration ドキュメントに詳細に記載されており、Siemens Support Center から入手できます。そのドキュメントに忠実に従ってください。ここでの説明は、Siemens のドキュメントからの逸脱点、または Siemens のドキュメント内で要件として参照されている Altium 側の詳細のみを扱います。

使用している Teamcenter サーバーバージョンをサポートする EDA Gateway のバージョンを選択してください。互換性情報は、ダウンロードセンターで入手できる Gateway 対応の 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 のトピックに従ってセットアップを進めてください。

ライブラリ管理と設計管理の両方で Altium NEXUS/Teamcenter インターフェースを有効にするには、Team Environment Manager（TEM 設定マネージャー）を使用して、必要な 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 を実行してください。

次に、手順に従って NEXUS サーバーマシンに EDA Gateway CLIENT をインストールします。手順を簡略化するため、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 が提供するものを使用してください。Nexus Server の Web UI からサンプル設定ファイルのパッケージとともにダウンロードできます。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 を EDALIB_External_Applications プレファレンスに追加します。

コマンドをクリックして新しい値を追加し、続いて Save を行い、その後プレファレンスを閉じます。ログアウトしてから、再度 Teamcenter Rich client にログインします。

Organization アプリケーションを開きます。
External Applications セクションに移動し、以下のように altiumLibrary アプリケーションを追加します。

を選択します。アプリケーション名にはアンダースコア文字 (_) が含まれていてはなりません。
NOTE:Allow deletion of replicated master objects to this site オプションは必ずチェックされている必要があります。

章: 'Mapping ECAD part attributes to Teamcenter attributes'

Teamcenter のコマンドプロンプトから export_attr_mappings ユーティリティを実行し、マッピングをファイルに出力します。例:

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

属性マッピングの問題をトラブルシュートするには、C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties ファイルに rootLogger.level= DEBUG の行を追加して詳細ログを有効にします。

Teamcenter EDA 実行のログは C:\Windows\TEMP\eis_eda_log.log に出力されます。

章: 'Creating classification mapping for ECAD parts with Teamcenter classes'（オプション）

分類マッピングはオプションのセットアップ要件であり、使用しない、または 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 は、Teamcenter の Classification Admin ツールで確認できます。

NEXUS における分類マッピング

分類情報は、PLM の XML 設定ファイル（typically dm-config.xml など）に含める特別な Classification 属性として送信できます。例:
```
<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>
```
追加情報については、提供されている PLM 設定ファイルのサンプル（dm-TeamcenterEda-config-basic.xml）を参照してください。

NEXUS Server 上でのライブラリ定義

NEXUS と同期を行う前に、NEXUS Server マシン上の %TCEDAECAD_ROOT% のディレクトリにある eda_cli.bat コマンドを使用してライブラリを作成し、作成されたファイルが NEXUS Server からアクセス可能であることを確認する必要があります。

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

この段階で、NEXUS の Component Sync および NEXUS の Part Request with PLM Part Create プロセスを実行できるようになっているはずです。

ライブラリ部品同期に関する追加情報:
- Synchronization of Released/Unreleased Teamcenter parts – 既定では、Teamcenter から Altium へ同期されるのは release_status_list.name = ‘TCM Released’ が付けられたコンポーネントのみです。これは、Teamcenter Query Builder で、コンポーネントを選択するために Teamcenter が使用するクエリを変更することで変更できます（例を参照）。
クエリ名は EDALIB_Sync_FindNewParts プレファレンスに保存されます。既定のクエリは __EDALIB_find_newparts で、以下のようになります。

最後の条件を削除すると、まだ「TCM Released」されていないコンポーネントも同期対象にできます。

► 詳細については、関連する Siemens Teamcenter ドキュメントを参照してください。
- Multisite synchronization – Teamcenter を、複数サイト（その 1 つが Nexus Server）向けのコンポーネント情報ソースとして使用することも可能です。これには、ドキュメントで説明されている特別なセットアップが必要である点に注意してください。
- Destination folder for parts – Altium から Teamcenter に同期される部品のターゲットフォルダーは、 EDALIB_SaveAsFolderDefault Teamcenter プレファレンスによってサイト/ユーザーごとに設定できます。
- Current Part Synchronization limitations:
  - PLM 部品番号は Nexus 側でのみ生成されます。
  - コンフィギュレーションファイル内でコンポーネントごとに宛先フォルダーを指定することはできません。Teamcenter 側にグローバル設定があります。PLM XML 設定ファイル（dm-config.xml）内の宛先フォルダー設定は、警告なしに無視されます。ターゲットフォルダーは、Teamcenter ユーザーレベル、またはサイトレベルのオプション EDALIB_SaveAsFolderDefault から、すべてのコンポーネントタイプに対して取得されます。
  - ネイティブな部品選択（承認メーカー/ベンダーリスト、AML/AVL）はサポートされていません。従来どおり、コンポーネントパラメータに基づく部品選択のみがサポートされます。
► コンポーネント同期の構成および方法の詳細については、メインの PLM Integration ドキュメントを参照してください。

Teamcenter EDA を使用したデザインパブリッシング

Altium から Teamcenter へのデザインパブリッシングは、Altium NEXUS design client を介してのみ可能です。デザインパブリッシングを有効にするには、Nexus クライアントがインストールされているマシンに Teamcenter EDA (Electronic Design Automation) Gateway をインストールする必要があります。また、Altium Server と Teamcenter サーバーの両方へアクセスできる必要があります。

EDA Gateway のインストールおよび構成手順は、バージョン固有の EDA Integration ドキュメントに詳細に記載されており、これは Siemens Support Center で入手できます。必ずそのドキュメントに従ってください。ここでの説明は、Siemens のドキュメントからの逸脱点、または Siemens のドキュメント内で要件として参照されている Altium 側の詳細のみを扱います。

使用している Teamcenter サーバーバージョンをサポートする EDA Gateway のバージョンを選択してください。互換性情報は、ダウンロードセンターで入手できる Gateway 対応の 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 design management のトピックに従ってください。

プロジェクトのパブリッシュ時にコンポーネントの作成をサポートする場合、ライブラリ構成の一部をサーバー側で実行する必要があります。これは、パブリッシュテンプレートのデフォルトセクション戦略 <pt: BomStrategy> CreateNewAndLink </ pt: BomStrategy> に適用されます。

デザインの保存先フォルダーは、サイト/ユーザーオプション EDA_SaveAsFolderDefault によって設定できます。
altiumPCB_edadef.xml ファイルは、次の 2 台のマシンの %TCEDAECAD_ROOT% ディレクトリに追加する必要があることに注意してください。
- NEXUS Server マシン – Web UI から開始されるプロジェクト作成/パブリッシュを実行できるようにするため。
- NEXUS Client マシン – NEXUS Client から開始されるプロジェクト作成/パブリッシュを実行できるようにするため。
BOM ライン属性のマッピング

BOM ラインの Reference Designator および Quantity 属性は自動的に処理されますが、PLM コネクタの XML 構成ファイルの <BOM> セクションに含める必要があります。
```
<BOM>
    <BOMAttributes>
        
        <common:BOMAttribute>
        <common:Key>Reference Designator</common:Key>
        <common:Value>${parameter.LogicalDesignator}</common:Value>
        </common:BOMAttribute>
        
        <common:BOMAttribute>
        <common:Key>Quantity</common:Key>
        <common:Value>${parameter.Quantity}</common:Value>
        </common:BOMAttribute>
    </BOMAttributes>
</BOM>
```
追加情報については、提供されているサンプル PLM 構成ファイル (dm-TeamcenterEda-config-basic.xml) を参照してください。

他の BOM ライン属性を使用するには、それらを altiumPcb_edadef.xml ファイルの BOM ライン属性マッピングセクションに含める必要があります。たとえば、以下のエントリは、Altium 属性 part_source を Teamcenter の BOM ライン属性 bl_part_source にマッピングとして追加するものです。
```
<RdnAttrMapDefs>
    <RdnAttrDesign cadAttrName="part_source" tcAttrName="bl_part_source"/>
</RdnAttrMapDefs>
```
このようなマッピングを追加すると、PLM コネクタの XML 構成ファイルの <BOMAttributes> セクションで、その値を定義できるようになります。
```

<common:BOMAttribute>
    <common:Key>part_source</common:Key>
    <common:Value>${parameter.MakeOrBuy}</common:Value>
</common:BOMAttribute>
```
派生データセット用 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\*.*
1. 派生回路図データセット用に ‘Configure datasets' の下に新しいエントリを追加します。
パス名: $TEMP\Altium\TcEda\Project\schematic\*.*
1. バリアントデータセット用の別の派生データセット:
パス名: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*
1. データモデルへの変更を保存するには、File » Save Data Model を選択するか、メインツールバーの Save Data Model ボタンをクリックします。
2. 変更をテストサーバーにデプロイします。メニューバーで Deploy Template を選択するか、プロジェクトを選択してメインツールバーの Deploy Template ボタンをクリックします。
3. Rich Client で、EDA_DerivedDataConfigDefault 設定を、今作成した EDA 派生データ構成を指すように設定します。
4. Edit » Options を選択し、Options ダイアログボックス下部の Search リンクをクリックして、EDA_DerivedDataConfigDefault 設定を探し、その値を新しい構成に変更します。
追加のデザインパブリッシング情報

Current Project Publishing Limitations:
- 特定のコンポーネントリビジョン（「Precise BOM」）の参照は、Siemens EDA Gateway ではサポートされていません。
- ECO は現在サポートされていません。