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

Parent page: PLM 統合

Siemens Teamcenter® PLM 統合には追加のセットアップが必要で、Enterprise Server インスタンスのインストーラーでは自動的に管理されません。基本的に、必要な統合機能に応じて 2 段階のセットアップが必要です。第 1 段階では部品同期（Parts Synchronization）を有効化し、これは第 2 段階（プロジェクトの公開／初期化の PLM プロセスを有効化）を行うための前提条件でもあります。ただし、両方のセットアップ段階を実施することを推奨します。

Teamcenter との部品同期

ライブラリ部品の同期を有効にするには、Enterprise Server をホストしているマシンに Siemens Teamcenter^® EDA（Electronic Design Automation）Gateway ソフトウェアをインストールする必要があります。本ドキュメントでは、Enterprise Server と Teamcenter サーバーがすでに別々のマシンにインストールされている前提で説明します。2 つのインストールを分離できるため、この方法を推奨します（同一マシンにインストールすることも可能です）。

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

EDA Gateway のインストールおよび設定手順全体は、Siemens Support Center で入手できるバージョン別の EDA Integrationドキュメント に詳細に記載されています。必ずそのドキュメントに従ってください。ここでの手順は、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 のトピックに従ってセットアップを進めてください。

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

さらに、Design Publishing をサポートするために Install and set up Common Integration Services を実行してください。

次に、手順に従って Enterprise Server マシンに 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 が提供するものを使用してください。Enterprise Server Workspace のブラウザーインターフェースから設定ファイル一式としてダウンロードできます。Admin » PLM Integration を開き、Add Configuration ボタンで Add New Instance ビューを開き、Driver ドロップダウンメニューから Teamcenter EDA を選択し、URL フィールドに関連付けられた Download Teamcenter EDA client definition files リンクを選択します（例を参照）。

ダウンロードした 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 に記載された手順を示しています。本ケースでは、EDALIB_External_Applications プリファレンスに altiumLibrary,15 を追加します。

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

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

• Create.

章: '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'（任意）

分類マッピング（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 は、Teamcenter の Classification Admin ツールで確認できます。

Enterprise Server における分類マッピング

分類情報は、PLM（typically dm-config.xml など）の XML 設定ファイルに含める特別な Classification 属性で送信できます。例:

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

この属性の値は、分類ツリー内のパスをカンマ区切りで指定したものにします。例: “Components,SMT,Capacitor”。

同様に、分類属性は Teamcenter サーバー側の attribute mapping で設定した名前で参照できます。例:

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

Enterprise Server 上でライブラリを定義する

Enterprise Server で同期を行う前に、eda_cli.bat コマンド（Enterprise Server マシン上の %TCEDAECAD_ROOT% のディレクトリにあります）でライブラリを作成し、作成されたファイルに 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 – デフォルトでは、release_status_list.name = ‘TCM Released’ とマークされたコンポーネントのみが Teamcenter から Altium に同期されます。これは Teamcenter Query Builder で、Teamcenter がコンポーネントを選択するために使用するクエリを変更することで変更できます（例を参照）。

クエリ名は EDALIB_Sync_FindNewParts プリファレンスに保存されています。デフォルトのクエリは __EDALIB_find_newparts で、以下に示します。

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

►詳細は関連する Siemens Teamcenter ドキュメント を参照してください。

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

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

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

EDA Gateway のインストールおよび設定手順は、EDA IntegrationSiemens 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 により設定できます。

BOM ライン属性のマッピング

BOM ラインの Reference Designator および Quantity 属性は自動的に処理されますが、PLM connector XML Configuration file の <BOM> セクションに含める必要があります。

<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 ライン属性を使用するには、altiumPcb_edadef.xml ファイルの BOM ライン属性マッピングセクションにそれらを含める必要があります。たとえば、以下のエントリは Altium 属性 part_source を Teamcenter の BOM ライン属性 bl_part_source にマッピングします。

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

このようなマッピングを追加すると、PLM connector XML Configuration file の <BOMAttributes> セクションでその値を定義できます。

<!-- 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 代替部品のパブリッシュ設定

Altium Designer の ActiveBOM は、BOM アイテムに代替部品を追加することをサポートしています（learn more）。デザインを Teamcenter PLM にパブリッシュする際にこれらの代替部品をサポートするには、以下に示すとおり Teamcenter EDA の追加設定が必要です（Teamcenter の用語では、特定 BOM の範囲におけるこれらの代替コンポーネントは substitute components と呼ばれます）。これにより、substitute 転送ロジックを備えた Altium コールバックが有効になります。

1. 現在使用している Teamcenter サーバーバージョンのインストールファイル内で soa_client.zip ファイルを見つけてください。

2. この zip ファイル内で次のファイルを見つけてください。

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. これら 2 つのファイルを、Teamcenter EDA Gateway と Altium Designer をホストしている PC の %TCEDAECAD_ROOT% ディレクトリにコピーします。

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 が新しいライブラリを読み込むように、PC を再起動してください。

Notes:

• Teamcenter EDA は Java 11 で実行するように設定する必要があります。
• Teamcenter 13 を使用している場合は、Teamcenter 13 のインストールに含まれる追加ライブラリのバージョンを使用してください。
• %TCEDAECAD_ROOT% ディレクトリ内の CustomEDACallbacks.jar および altiumPcb_edadef.xml ファイルを更新することを忘れないでください。
• Altium Designer では、すべての design variants が同一の substitute セットを共有します。つまり、同一 BOM アイテムに対してバリアントごとに異なる substitute を定義することはできません。
• Teamcenter における substitute コンポーネントのリストは、コンポーネントリビジョンのリストです。substitute コンポーネントのエントリは BOM ラインを作成せず、BOM ラインプロパティを割り当てることもできません。Altium Designer では substitute に対して異なる値の BOM 列を持つことが可能ですが、Teamcenter の BOM ラインプロパティへ転送されるのはベースコンポーネントのプロパティのみです。
• BOM に substitute を含むプロジェクトを Teamcenter にパブリッシュした後、プロジェクト BOM から substitute を削除して再度パブリッシュすると、Teamcenter 側の BOM からもその substitute が削除されます。
• BOM に substitute を含むプロジェクトを Teamcenter にパブリッシュした後、Teamcenter 側で BOM を手動変更した場合、次回このプロジェクトをパブリッシュすると Teamcenter 側の BOM は上書きされます。つまり、手動で行った変更は失われます。

• ActiveBOM で substitute として使用するコンポーネントは、Teamcenter に同期されている必要があります。この条件は preSave callback によりチェックされます。Teamcenter に同期されていないコンポーネントがある場合、エラーメッセージが表示されて処理は中断され、Teamcenter 側には変更が行われません。

派生データセットのための Business Modeler IDE（BMIDE）設定

派生データ設定を作成した後（altiumPcb_edadef.xml ファイル内の参照を参照）、EDA_DerivedDataConfigDefault preference で設定名を指定できます。

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 を選択し、Options ダイアログボックス下部のSearchリンクをクリックして EDA_DerivedDataConfigDefault 設定を見つけ、その値を新しい構成に変更します。

設計パブリッシングに関する追加情報

Current Project Publishing Limitations:

• 特定のコンポーネント改訂版（「Precise BOM」）の参照は、Siemens EDA Gatewayではサポートされていません。
• ECOは現在サポートされていません。