カスタマイズポイント
拡張可能なクラス
このドキュメントの配布ターゲットのセクションで説明している拡張可能な Windchill ESI クラスを拡張した場合、Windchill ESI プロパティで定義する必要があります。以下のクラスはカスタムの拡張が許可されています。
◦ ESITarget
プリファレンス名: 配布ターゲットクラス
デフォルト値: com.ptc.windchill.esi.tgt.ESITarget
◦ ESITargetAssignmentLink
プリファレンス名: 配布ターゲット割当クラス
デフォルト値: com.ptc.windchill.esi.tgt.ESITargetAssignmentLink
◦ ESITargetFinder
プリファレンス名: 配布ターゲットファインダー
デフォルト値: com.ptc.windchill.esi.tgt.class.ESISimplePartTargetFinder
コンフィギュレーション可能なオプション
Windchill ESI プリファレンスは、配布ターゲットに関連するいくつかのコンフィギュレーション可能なオプションを制御します。以下のオプションがあります。
◦ ESITarget オブジェクトを表示するときに使用するマップファイルの名前を定義します。
プリファレンス名: ターゲットマップファイル
デフォルト値: $CODEBASE$/tgt/ESITarget.map
◦ 連結された UFID 文字列内の単一の UFID を見つけるときに使用する区切り記号を定義します。このプリファレンスは Windchill ESI サービスによって内部で使用され、ほかの Windchill コンポーネントの動作には影響しません。
プリファレンス名: 一意なフェデレーション ID セパレータ
デフォルト値: |
◦ BOM を識別するリリースアクティビティオブジェクトのリリースクラス属性値を定義します。1 つの Windchill 部品を同じ配布ターゲットに 2 回パブリッシングできるので (1 回目のパブリッシングで部品を定義し、2 回目のパブリッシングで BOM を定義)、この値が必要です。一部の Windchill ESI API では、この 2 つのタイプのパブリッシングアクティビティを区別する必要があります。このプリファレンスは、これらの API に検索対象を指示します。
プリファレンス名: BOM クラス
デフォルト値: com.ptc.windchill.esi.BOMHeader
◦ 配布ターゲット情報の検索に使用するクラスの名前を定義します。このプリファレンスは、Windchill ESI サービスによって、カスタム配布ターゲットの宛先 ID とプラント名を特定するために使用されます。このプリファレンスの既成の値は、getDestinationId(ESITarget) メソッドと getPlantName(ESITarget)) メソッドを持つ Java インタフェースの名前です。このプリファレンスがカスタムターゲット (ESIFileTarget のソフト拡張など) に対して機能するためには、そのメソッドを定義するインタフェースの具象実装の名前に適宜設定する必要があります。これらの各メソッドは、渡されたターゲットのタイプに基づいた出力を返すように設計できます。
プリファレンス名: 配布ターゲット情報ファインダー
デフォルト値: com.ptc.windchill.esi.tgt.ESITargetInfoFinder
 |
ERP コネクタは、ESITargetInfoFinder クラスをカスタマイズして adjustTarget をオーバーライドする代わりに、コンフィギュレーション可能な機能を提供するようになりました。既存のカスタマイズコードは引き続き機能しますが、新しいコンフィギュレーション方法を使用することをお勧めします。詳細については、「ESI 応答で宛先 ID とターゲット ID を設定するための ESI の設定」を参照してください。
|
◦ 配布ターゲット割当の検証に使用するクラスの名前を定義します。このプリファレンスは、Windchill ESI サービスによって、配布ターゲット割当 (自動割当と明示的割当の両方) を検証するために使用されます。検証をカスタマイズするには、メソッド isTargetValidForAutoAssignment(Persistable, ESITarget) および isTargetValid(Persistable, ESITarget) を定義するカスタムクラスの名前にこのプリファレンスを設定します。
プリファレンス名: 配布ターゲット割当バリデータ
デフォルト値: com.ptc.windchill.esi.tgt.ESITargetAssignmentValidator
|
|
部品の既成の検証は、Windchill ESI プリファレンス「ビューと配布ターゲットのマッピング」に設定されている値によって異なります。
|
◦ 「配布ターゲットに送信」 UI に「ユーザー入力」ステップを表示するかどうかを指定します。「はい」に設定した場合、「配布ターゲットに送信」 UI に「ユーザー入力」ステップが表示されます。「いいえ」に設定した場合、「ユーザー入力」ステップは UI に表示されません。
プリファレンス名: 「配布ターゲットに送信」UI の「ユーザー入力」ステップを表示
デフォルト値: No
|
|
このプリファレンスは分散プロセス配布ターゲットにのみ関連します。
|
◦ 「配布ターゲットに送信」 UI の「情報」ステップでユーザーが配布ターゲットを選択できるかどうかを指定します。「はい」に設定した場合、データの送信先となる配布ターゲットをユーザーが選択できます。「いいえ」に設定した場合、配布ターゲットは選択できず、関連付けられているすべての配布ターゲットにデータが送信されます。
プリファレンス名: 「配布ターゲットに送信」 UI でターゲットの選択を許可
デフォルト値: Yes
配布ターゲットには設定可能ないくつかの属性もあります。属性は以下のとおりです。
◦ 指定された宛先に日付エフェクティビティ情報を送信する際のエフェクティビティの開始日と終了日に使用するフォーマットを定義します。
属性名: EffectivityFormat
デフォルト値: yyyy/MM/dd HH:mm:ss
|
|
この属性が使用されるようにするには、「エフェクティビティのフォーマット」という名前のプリファレンスを設定しないでください。
|
◦ 指定された宛先のマッピング情報を提供する ESI 応答メタ情報ファイルへのパス。
属性名: responseMetaInfoPath
デフォルト値: $CODEBASE$/com/ptc/windchill/esi/ESIResponseMetaInfo.xml
この値を変更して、応答メタ情報ファイルの適切に修正されたバージョンに設定できます。カスタマイズされたバージョンの応答メッセージを取得するためにこのファイルを修正する方法については、「ESI 応答メタ情報ファイルの修正」を参照してください。
◦ ESI 応答メッセージを必要な宛先に送信する Info*Engine タスクへのパス。
属性名: taskURI
デフォルト値: com/ptc/windchill/esi/export/ExportTo<XXX>.xml。ここで、プレースホルダー <XXX> は、宛先のターゲットタイプがファイル、FTP、電子メールのいずれであるかに応じて、それぞれ File、FTP、または SMTP になります。
この値を変更して、ユーザーが ESI 応答メッセージの送信に使用するその他の Info*Engine タスクに設定できます。このようなカスタムバージョンのタスクを作成する際には、次のパラメータをタスクで使用できることを覚えておくと便利です。
|
パラメータ名
|
値
|
||
|---|---|---|---|
|
transaction
|
基になる ESI トランザクションを表す ESITransaction オブジェクト。
|
||
|
target
|
ESI 応答メッセージの送信先を表す ESITarget オブジェクト。
|
||
|
objectId
|
リリースされたプライマリビジネスオブジェクトの UFID。
|
||
|
type
|
プライマリビジネスオブジェクトのタイプを表す文字列 (例: com.ptc.windchill.esi.Part)。
|
||
|
username
|
そのオブジェクトをリリースした Windchill ユーザーの名前。
|
||
|
locale
|
そのリリースに関連するロケールインスタンス。
|
また、応答メッセージを表す IeCollection インスタンスをタスクでその VDB を介して使用でき、getVDB() 呼び出しを介してフェッチできます。
|
|
デフォルトの Info*Engine タスク (ExportTo<XXX>.xml 内) は、ESI 応答を必要な宛先に送信する Webject を呼び出した後、PostResult RPC を呼び出します。これは次の場合に行われます。
1. ESI 応答を正常に送信でき、ERP コネクタのプリファレンス「ポスト結果を有効化」の値が Yes に設定されている。または、
2. 何らかの理由で ESI 応答の送信に失敗した。
|
◦ ESI 応答メッセージを生成するフォーマット。
属性名: ESIResponseOutputFormat
デフォルト値: ESI XML
デフォルト値を使用した場合、ESIResponse.xsd 内のスキーマに準拠する XML フォーマットで ESI 応答が生成されます (このファイルの詳細については、Windchill Enterprise Systems Integration Open Application Programming Interface Guide を参照)。ESI 応答を PLM Services フォーマットで生成する場合、この値を「PLM」に変更できます。
|
|
この属性を設定した後で編集することはできません。
|
上記のモデル化属性のほかに、配布ターゲットのいくつかのソフト属性も設定できます。これらの属性の値によって、応答メッセージを構成する具体的なデータが決まります。そのような属性とその説明のリストについては、変更通知のパブリッシング、BOM のパブリッシング、部品のパブリッシング、プロセス計画のパブリッシング、リソースのパブリッシングの各セクションを参照してください。
最後に、ESITargetのセクションで説明しているように、ERP コネクタによって既成で提供されている ESITarget の各種ソフトタイプ拡張に加え、カスタマイズされたソフトタイプ拡張を作成して ESI で使用できます。「タイプおよび属性の管理」 UI を使用して特定のオブジェクトのソフトタイプ拡張を作成する方法については、Windchill Customization Guide を参照してください。
|
|
• 前述のように、カスタム配布ターゲットを使用する場合、Windchill ESI プリファレンス「配布ターゲット情報ファインダー」を、API getDestinationId() および getPlantName() の定義を必要に応じて提供するインタフェース com.ptc.windchill.esi.tgt.ESITargetInfoFinder の具象実装の名前に設定する必要があります。
• ERP コネクタは、ESITargetInfoFinder クラスをカスタマイズして adjustTarget をオーバーライドする代わりに、コンフィギュレーション可能な機能を提供するようになりました。既存のカスタマイズコードは引き続き機能しますが、新しいコンフィギュレーション方法を使用することをお勧めします。詳細については、「ESI 応答で宛先 ID とターゲット ID を設定するための ESI の設定」を参照してください。
|