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

Created: 6月 06, 2024 | Updated: 7月 21, 2024 | Applies to version: 7.0

親ページ： PLM統合

Siemens Teamcenter® PLM統合には、Enterprise Serverインスタンスのインストーラーでは自動的に管理されない追加の設定が必要です。基本的に、必要な統合機能に応じて、2つのレベルの設定が必要です。第1レベルはパーツ同期を有効にし、第2レベルの前提条件でもあります。第2レベルは、プロジェクトの公開/初期化PLMプロセスを有効にします。それにもかかわらず、両方の設定レベルを実行することが推奨されます。

Siemens Teamcenter PLMのサポートは、Teamcenter EDA (Electronic Design Automation) Gatewayインターフェースを通じて現在クローズドベータであることに注意してください。以前のバージョンのTeamcenterインターフェース（SOAPベースのAPIを使用）は、ベータテストが完了するまで機能し続けます。
Teamcenter接続統合にはTeamcenter PLM Addonライセンスが必要です。

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

Teamcenterとの部品同期

ライブラリ部品の同期を有効にするには、エンタープライズサーバーをホストするマシンにSiemens Teamcenter^® EDA (Electronic Design Automation) ゲートウェイソフトウェアをインストールする必要があります。このドキュメントでは、エンタープライズサーバーとTeamcenterサーバーが既に別々のマシンにインストールされていることを前提としています - これら二つのインストールを分離することをお勧めしますが、同じマシンにインストールすることも可能です。

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

EDA Gatewayのインストールおよび設定手順全体は、Siemens Support Centerで入手できるバージョン固有のEDAインテグレーションドキュメントに詳細に記載されています。そのドキュメントに従ってください。ここでの指示は、Siemensのドキュメントからの逸脱、またはSiemensのドキュメントで要件として参照されているAltium側の詳細を指定する場合にのみカバーされます。

Teamcenterサーバーのバージョンに対応するEDA Gatewayのバージョンを選択してください。対応情報は、ダウンロードセンターで利用可能なTcEDA<version>_README.pdfファイルに記載されています。その後、EDA Gatewayのインストールと設定（非MentorのECADアプリケーション用）のドキュメント（例としてEDAバージョン5.1のリンク）を参照し、部品ライブラリ管理に関するトピックでセットアップを進めるガイドを参照してください：

Enterprise Server/Teamcenter インターフェースのインストールと設定の一環として、以下の Teamcenter 機能もインストール（および必要に応じてライセンス認証等）する必要があります。詳細はEDA Gateway を使用した ECAD アプリケーションの設定を参照してください。

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

さらに、共通統合サービスのインストールと設定を実行して、デザインパブリッシングをサポートします。

次に、手順に従って、エンタープライズサーバーマシンにEDA Gateway CLIENTをインストールしてください。プロセスを簡素化するために、C:\Siemens\TeamcenterEDA2フォルダの使用をお勧めします。

EDA Gatewayをパーツライブラリ管理用に設定する

上記の通り、このセクションでは、EDAゲートウェイのインストールと設定（ノンメンターECADアプリケーション用）のドキュメント（例としてEDAバージョン5.1のリンク）を参照してください。特に部品ライブラリ管理用のEDAゲートウェイのインストールと設定についてのトピックです。

Teamcenterのドキュメント内の特定の章に到達した際には、この一連の指示に戻って参照してください。以下のセクションでは、それらの章に名前で言及しています。

Chapter: 'EDAクライアントの部品ライブラリ管理の設定'

そのステップでは、ライブラリゲートウェイ設定ファイルの準備を求められますが、代わりにAltiumが提供するものを使用してください。エンタープライズサーバーワークスペースのブラウザインターフェースから設定ファイルのパッケージをダウンロードできます：Admin » PLM Integrationを開き、Add Configurationボタンを使用して新規インスタンス追加ビューを開き、DriverのドロップダウンメニューからTeamcenter EDAを選択し、次にURLフィールドに関連付けられたDownload Teamcenter EDA client definition filesリンクを選択します - 例を見る。

ダウンロードしたPLMClientConfigurationFiles.zipファイルの中には、altiumLibrary_edadef.xmlファイルが含まれています。このファイルをシステム環境変数%TCEDAECAD_ROOT%で指定されたディレクトリに入れてください。また、提供されたaltiumPcb_edadef.xmlファイルもそのディレクトリに追加してください。

ZIPアーカイブにはCustomEDACallbacks.jarファイルも含まれていることに注意してください。これを同じディレクトリに追加することで、Teamcenterが作成したID参照をAltium側に伝播させることができます。► 詳細情報。
以前の（GUI非対応の）PLMインテグレーションインターフェースを使用している場合、これらのファイルはサンプル設定ファイルのダウンロードで利用可能です。エンタープライズサーバーのバージョン5.5のドキュメントで、手動のXML中心のインターフェースに関する情報を確認してください。

Chapter: 'Teamcenterサーバーを部品ライブラリ管理用に設定する'

Teamcenter Rich Clientをinfodbaユーザー、または他の管理権限を持つユーザーとして開きます。
► Teamcenter Rich Clientに関する情報を参照してください。

以下のスクリーンショットは、TeamcenterでECADツール用の外部アプリケーションを作成するに記載されている手順を示しています。この場合、altiumLibrary,15をEDALIB_External_Applications設定に追加します：

コマンドをクリックして新しい値を追加し、保存をクリックしてから、設定を閉じます。Teamcenter Rich clientからログアウトしてから再度ログインしてください。

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

Createを選択します。

注意：アプリケーション名にアンダースコア (_) を含めてはいけません

注意：Allow deletion of replicated master objects to this siteオプションは、チェックされている必要があります。

Chapter: 'ECAD部品属性をTeamcenter属性にマッピングする'

Teamcenterコマンドプロンプトを通じて、export_attr_mappingsユーティリティを実行し、例えば以下のようにマッピングをファイルに出力します。

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

コンポーネント上の実際のTeamcenter属性にマップするために、要件に応じてmappings.txtファイルを修正します。エクスポートされた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で見つけることができます。

Chapter: 'Teamcenterクラスを用いたECAD部品の分類マッピングの作成'（オプション）

分類マッピングはオプションの設定要件であり、あなたのTeamcenter PLMインストールに使用または必要とされないかもしれません。分類属性を使用するには、それらが前述の'ECAD部品属性をTeamcenter属性にマッピングする'セクションを完了する際に、属性マッピング設定/ファイルに含まれている必要があります。

この設定ステージを始める前に、分類機能が有効になっていることを確認してください。その後、分類マッピングの設定に従って指示を行ってください。

_eda2tc.csvはcategory,classIdの順に列が並んでいること、そして_tc2eda.csvはclassId,categoryの順に列が並んでいることを確認してください。必要であれば、ファイル名を入れ替えてください。

分類属性を使用するには、それらを属性マッピングに含める必要があります。分類属性マッピングの例は以下の通りです：

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

ここで、番号-60262はTeamcenterの分類管理ツールで見つけることができます。

エンタープライズサーバーでの分類マッピング

分類情報は、PLMのXML設定ファイル（通常は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`）を参照して、追加情報を確認してください。

エンタープライズサーバー上でのライブラリの定義

エンタープライズサーバーとの同期を可能にする前に、eda_cli.batコマンド（エンタープライズサーバーマシンの%TCEDAECAD_ROOT%ディレクトリに位置）を使用してライブラリを作成し、作成されたファイルがエンタープライズサーバーからアクセス可能であることを確認する必要があります：

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

この段階で、エンタープライズサーバーコンポーネント同期とエンタープライズサーバーパーツリクエストとPLMパーツ作成プロセスを実行できるはずです。

追加のライブラリパーツ同期情報：

リリース済み/未リリースのTeamcenterパーツの同期 - デフォルトでは、release_status_list.name = ‘TCM Released’ とマークされたコンポーネントのみがTeamcenterからAltiumに同期されます。これは、Teamcenter Query Builderで使用されるクエリを変更することで変更できます（例を参照）。

クエリの名前はEDALIB_Sync_FindNewPartsの設定に保存されています。デフォルトのクエリは__EDALIB_find_newpartsで、以下に示されています。

最後の条件を削除することで、「TCM Release」されていないコンポーネントも同期できるようになります。

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

マルチサイト同期 - Teamcenterを複数のサイト（Enterprise Serverを含む）のコンポーネント情報のソースとして使用することも可能です。これには特別な設定が必要で、その設定方法はドキュメントに記載されています。
単位の同期 - Workspace Teamcenter統合は、ユーザーインターフェースのコンポーネントパラメータマッピングテーブルに追加されたデータタイプおよびSiPrefixデータ列を通じて、単位を認識したパラメータマッピングをサポートしています。エントリーのドロップダウンメニューオプションを使用して、適切なデータタイプ（オプションを見る）と単位接頭辞（オプションを見る）を選択してください。

部品用の宛先フォルダ – AltiumからTeamcenterに同期された部品のターゲットフォルダは、EDALIB_SaveAsFolderDefault Teamcenterの設定によりサイト/ユーザーごとに設定できます。
現在の部品同期の制限事項:
- PLM部品番号はエンタープライズサーバー側でのみ生成されます。
- 設定ファイル内のコンポーネントに対して宛先フォルダを指定することはできません - Teamcenter側にはグローバル設定があります。PLM XML設定ファイル(dm-config.xml)内の宛先フォルダ設定は、警告なしに無視されます。ターゲットフォルダは、Teamcenterユーザーレベル、またはサイトレベルオプションのEDALIB_SaveAsFolderDefaultから取得されます。
- ネイティブ部品選択（承認された製造業者/ベンダーリスト、またはAML/AVL）はサポートされていません。以前と同様、コンポーネントパラメータに基づく部品選択のみがサポートされます。

► コンポーネント同期の設定と方法についての詳細は、PLM統合ドキュメントをご覧ください。

Teamcenter EDAでの設計公開

AltiumからTeamcenterへの設計公開は、Altium Designerを通じてのみ可能です。設計公開を有効にするには、Altium DesignerがインストールされているマシンにTeamcenter EDA（電子設計自動化）ゲートウェイをインストールする必要があります。また、エンタープライズサーバーとTeamcenterサーバーの両方へのアクセスが必要です。

EDA Gateway のインストールおよび設定手順は、Siemens Support Centerで入手できるバージョン固有のEDAインテグレーションドキュメントに詳しく記載されています。そのドキュメントに従ってください。ここでの指示は、Siemensのドキュメントからの逸脱、またはSiemensのドキュメントで要件として参照されているAltium側の詳細を指定する場合にのみカバーします。

Teamcenterサーバーのバージョンに対応するEDA Gatewayのバージョンを選択してください。対応情報はダウンロードセンターで利用可能なTcEDA<version>_README.pdfファイルに記載されています。その後、EDA Gatewayのインストールと設定（非MentorのECADアプリケーション用）のドキュメント（例としてEDAバージョン5.1のリンク）を参照し、設計管理のためのEDA Gatewayのインストールと設定（非MentorのECADアプリケーション用）についてのセットアップガイドを確認してください。

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

デザインの保存先フォルダは、サイト/ユーザーオプションのEDA_SaveAsFolderDefaultによって設定できます。

上記のライブラリ管理の設定章で述べたように、altiumPCB_edadef.xmlファイル（ダウンロードした設定ファイルから取得）をAltium Designerがインストールされているマシンの%TCEDAECAD_ROOT%ディレクトリに追加する必要があります。これにより、Altium Designerを通じてプロジェクトの作成/公開を行うことができます。

また、CustomEDACallbacks.jar Javaソースファイル（設定ファイルのZIPダウンロードで利用可能）を追加することで、Teamcenterは製造される基板（PCB/PWB）部品に対して作成したID参照をAltium側のプロジェクトパラメータエントリに伝播させるように設定できます。このJavaファイルを%TCEDAECAD_ROOT%ディレクトリに追加し、Altium DesignerをホストするPCを再起動してください。

実際には、Altium DesignerのPCBプロジェクトがTeamcenter PLMで作成/更新された場合、その関連部品IDがプロジェクトに関連付けられたAltium PLMパラメータとして自動的に利用可能になります。

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

BOMラインのリファレンス指定子と数量属性は自動的に処理されますが、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>セクションでその値を定義することができます：

<!-- 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項目に代替部品を追加する機能をサポートしています（詳細を学ぶ）。Teamcenter PLMにデザインを公開する際に、これらの代替部品をサポートするためには、以下に説明するようにTeamcenter EDAの追加設定が必要です（Teamcenterの用語では、特定のBOMの範囲内のこれらの代替コンポーネントは代替コンポーネントと呼ばれます）。これにより、Altiumのコールバックが代替転送ロジックで有効になります。

現在使用しているTeamcenterサーバーのインストールファイルでsoa_client.zipファイルを探します。
このzipファイル内で以下のファイルを探します：

soa_client\java\libs\TcSoaStructureManagementStrong*.jar

soa_client\java\libs\TcSoaBomStrong*.jar
これら2つのファイルをTeamcenter EDA GatewayとAltium DesignerがインストールされているPCの%TCEDAECAD_ROOT%ディレクトリにコピーします。

%TCEDAECAD_ROOT%\setup_eda.batファイルを開き、以下の行を探します：

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

以下の行を下に追加します：
```
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）に注意してください。前の手順でコピーしたファイル名に含まれているバージョン番号と一致させる必要があります。

%TCEDAECAD_ROOT%\altiumPcb_edadef.xmlファイルを開き、<CallbackDefs>セクション（ファイルに既に存在します）内に以下の<callback …/>エントリを追加します：

<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>セクション内の複数行コメントに既に存在します。これらのエントリをコメントから移動させることができます（例えば、このセクションの-->部分の直下に移動します）。

新しいライブラリがTeamcenter EDAに読み込まれるように、PCを再起動します。

注意：

Teamcenter EDAはJava 11で動作するように設定する必要があります。
Teamcenter 13を使用する場合は、Teamcenter 13インストールからの追加ライブラリのバージョンを使用してください。
%TCEDAECAD_ROOT%ディレクトリ内のCustomEDACallbacks.jarとaltiumPcb_edadef.xmlファイルを更新してください。
Altium Designerでは、すべての設計バリアントが同じ代替品セットを共有しています。つまり、同じBOMアイテムに対して異なる代替品を定義することはできません。
Teamcenter内の代替コンポーネントのリストは、コンポーネントのリビジョンのリストです。代替コンポーネントのエントリーはBOM行を作成せず、BOM行のプロパティを割り当てることはできません。Altium Designerでは、代替品に異なる値を持つBOM列を持つことができますが、基本コンポーネントからのプロパティのみがTeamcenterのBOM行プロパティに転送されます。
BOMに代替品があるプロジェクトがTeamcenterに公開され、その後プロジェクトBOMから代替品が削除され、再度プロジェクトが公開された場合、代替品もTeamcenterのBOMから削除されます。
BOMに代替品があるプロジェクトがTeamcenterに公開され、その後TeamcenterでBOMが手動で変更された場合、このプロジェクトの次回の公開時にTeamcenterのBOMは上書きされ、手動で行われた変更は失われます。
ActiveBOMで代替品として使用されるコンポーネントはTeamcenterに同期されている必要があります。この条件はpreSaveコールバックによってチェックされます。Teamcenterに同期されていないコンポーネントがある場合、エラーメッセージが表示され、操作は中断されるため、Teamcenterに変更は加えられません。

派生データセット用のビジネスモデラーIDE（BMIDE）設定

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

BMIDEで、Extensionフォルダを開きます。
拡張機能フォルダ内で、EDA Derived Dataを右クリックし、New EDA Derived Dataを選択します。新規EDA Derived Dataウィザードが表示されます。
EDA Derived Dataダイアログボックスで、情報を入力し、次へをクリックします。
派生PCBデータセットに新しいエントリを「データセットの設定」の下に追加します。

パス名: $TEMP\Altium\TcEda\Project\pcb\*.*

派生した回路図データセットに新しいエントリを「データセットの設定」の下に追加します。

パス名: $TEMP\Altium\TcEda\Project\schematic\*.*

バリアントデータセットのための別の派生データセット:

パス名: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

データモデルへの変更を保存するには、File » Save Data Modelを選択するか、メインツールバーのSave Data Modelボタンをクリックします。
変更をテストサーバーにデプロイします。Deploy Templateをメニューバーで選択するか、プロジェクトを選択してからメインツールバーのDeploy Templateボタンをクリックします。
Rich Clientで、EDA_DerivedDataConfigDefaultの設定を、作成したばかりのEDA派生データ設定を指すように設定します。
Edit » Optionsを選択し、オプションダイアログボックスの下部にある検索リンクをクリックし、EDA_DerivedDataConfigDefaultの設定を見つけて、その値を新しい設定に変更します。

追加の設計公開情報

現在のプロジェクト公開の制限事項:

特定のコンポーネントのリビジョンの参照（「正確なBOM」）は、Siemens EDA Gatewayではサポートされていません。
ECOは現在サポートされていません。

印刷用ページ

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.