カスタマイズポイント
拡張可能なクラス
このドキュメントの「配布ターゲット」のセクションで説明している拡張可能な 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 を識別する ReleaseActivity オブジェクトの releaseClass 属性値を定義します。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 インタフェースの名前です。このプリファレンスがカスタムターゲット (ESISAPTarget のソフト拡張など) に対して機能するためには、そのメソッドを定義するインタフェースの具象実装の名前に適宜設定する必要があります。これらの各メソッドは、渡されたターゲットのタイプに基づいた出力を返すように設計できます。
プリファレンス名: 配布ターゲット情報ファインダー
デフォルト値: com.ptc.windchill.esi.tgt.ESITargetInfoFinder
配布ターゲット割当の検証に使用するクラスの名前を定義します。このプリファレンスは、Windchill ESI サービスによって、配布ターゲット割当 (自動割当と明示的割当の両方) を検証するために使用されます。検証をカスタマイズするには、メソッド isTargetValidForAutoAssignment(永続可能オブジェクト, ESITarget) および isTargetValid(永続可能オブジェクト, ESITarget) を定義するカスタムクラスの名前にこのプリファレンスを設定します。
プリファレンス名: 配布ターゲット割当バリデータ
デフォルト値: com.ptc.windchill.esi.tgt.ESITargetAssignmentValidator
 |
注記: 部品の既成の検証は、Windchill ESI プリファレンス「ビューと配布ターゲットのマッピング」に設定されている値によって異なります。
|
「配布ターゲットに送信」 UI に「ユーザー入力」ステップを表示するかどうかを指定します。「はい」に設定した場合、「配布ターゲットに送信」 UI に「ユーザー入力」ステップが表示されます。「いいえ」に設定した場合、「ユーザー入力」ステップは UI に表示されません。
プリファレンス名: 「配布ターゲットに送信」UI の「ユーザー入力」ステップを表示
デフォルト値: いいえ
|
|
このプリファレンスは配布ターゲット MES および Proficy にのみ関連します。
|
「配布ターゲットに送信」 UI の「情報」ステップでユーザーが配布ターゲットを選択できるかどうかを指定します。「はい」に設定した場合、データの送信先となる配布ターゲットをユーザーが選択できます。「いいえ」に設定した場合、配布ターゲットは選択できず、関連付けられているすべての配布ターゲットにデータが送信されます。
プリファレンス名: 「配布ターゲットに送信」 UI でターゲットの選択を許可
デフォルト値: はい
配布ターゲットには設定可能ないくつかの属性もあります。属性は以下のとおりです。
指定された宛先に日付エフェクティビティ情報を送信する際のエフェクティビティの開始日と終了日に使用するフォーマットを定義します。
属性名: 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/ExportToJMSQueue.xml
この値を変更して、ユーザーが ESI 応答メッセージの送信に使用するその他の Info*Engine タスクに設定できます。このようなカスタムバージョンのタスクを作成する際には、次のパラメータをタスクで使用できることを覚えておくと便利です。
|
パラメータ名
|
値
|
|---|---|
|
transaction
|
基になる ESI トランザクションを表す ESITransaction オブジェクト。
|
|
target
|
ESI 応答メッセージの送信先を表す ESITarget オブジェクト。
|
|
objectId
|
リリースされたプライマリビジネスオブジェクトの UFID。
|
|
type
|
プライマリビジネスオブジェクトのタイプを表す文字列 (例: com.ptc.windchill.esi.Part)。
|
|
username
|
そのオブジェクトをリリースした Windchill ユーザーの名前。
|
|
locale
|
そのリリースに関連するロケールインスタンス。これは、ESI 応答で送信される JMS メッセージプロパティ com_infoengine_locale を設定するために使用されます。
|
また、応答メッセージを表す IeCollection インスタンスをタスクでその VDB を介して使用でき、getVDB() 呼び出しを介してフェッチできます。
ESI 応答メッセージを生成するフォーマット。
属性名: ESIResponseOutputFormat
デフォルト値: ESI XML
デフォルト値を使用した場合、ESIResponse.xsd 内のスキーマに準拠する XML フォーマットで ESI 応答が生成されます (このファイルの詳細については、Windchill Enterprise Systems Integration Open Application Programming Interface Guide を参照)。ESI 応答を PLM Services フォーマットで生成する場合、この値を PLM に変更できます。この属性を設定した後で編集することはできません。
上記のモデル化属性のほかに、配布ターゲットのいくつかのソフト属性も設定できます。これらの属性の値によって、応答メッセージを構成する具体的なデータが決まります。そのような属性とその説明のリストについては、変更通知のパブリッシング、BOM のパブリッシング、部品のパブリッシング、プロセス計画のパブリッシング、リソースのパブリッシングの各セクションを参照してください。
最後に、配布ターゲットのクラスのセクションで説明しているように、Windchill ESI によって既成で提供されている ESITarget の各種ソフトタイプ拡張に加え、カスタマイズされたソフトタイプ拡張を作成して ESI で使用できます。「タイプおよび属性の管理」 UI を使用して特定のオブジェクトのソフトタイプ拡張を作成する方法については、Windchill Customization Guide を参照してください。
|
|
前述のように、カスタム配布ターゲットを使用する場合、Windchill ESI プリファレンス「配布ターゲット情報ファインダー」を、API getDestinationId() および getPlantName() の定義を必要に応じて提供するインタフェース com.ptc.windchill.esi.tgt.ESITargetInfoFinder の具象実装の名前に設定する必要があります。
|