クラス
ESIRelease
このクラスは主に履歴管理に使用されます。このクラスのインスタンスは、Windchill からビジネスオブジェクトがリリースされるたびに作成および永続化されることで、そのリリースを表します。ユーザーがリリースを管理することを考慮して、このクラスは wt.fc.Item を拡張します。さらに、インタフェース wt.inf.container.WTContained を実装して、組織コンテナに関連付けることができます。
ESIRelease オブジェクトは、リリースに属するすべてのトランザクションにリンクされます。ESIReleaseTransactionLink オブジェクトはこれらの関係を管理します。ESIRelease オブジェクトは、ESIReleaseObjectLink インスタンスを介してリリース済みオブジェクトにもリンクされます。
ビジネスオブジェクトを Windchill からリリースすると、ESI 応答ジェネレータは ESIRelease オブジェクトを作成し、そのステータスを "pending" に設定します。その他のリリースステータスの値には "succeeded" と "failed" があります。これらの値は標準 Windchill 列挙タイプを使用してローカライズされています。ReleaseStatusType クラスは ESIRelease ステータスの一連の有効な値を定義します。Windchill ESI リリース列挙タイプの定義については、「Windchill ESI トランザクションでの列挙タイプ」の図を参照してください。
ESIRelease オブジェクトには、パブリッシング対象のオブジェクトが属する組織内で一意の番号が付いています。組織のデータベースに存在する番号の中で最も大きい値を見つけて、その番号に 1 を足すことで、組織内で一意の番号が生成されます。番号の重複を回避するため、ESIRelease オブジェクトの作成はシリアル化されます。
このクラスはカスタマイズ担当者による拡張を許可しません。
ESIReleaseObjectLink
このクラスは wt.fc.ObjectToObjectLink の拡張であり、リリース可能なオブジェクト (WTPart、WTChangeOrder2、MPMProcessPlan など) を、そのリリースを表す ESIRelease オブジェクトにリンクします。このリンクは、オブジェクトナビゲーション (リリース可能な特定のオブジェクトの ESIRelease オブジェクトをフェッチする場合など) のみに使用され、したがって属性を持ちません。
ESIReleaseTransactionLink
このクラスは wt.fc.ObjectToObjectLink の拡張であり、前のセクションで説明したように、ESIRelease オブジェクトを、ESIRelease によって表されるリリースを構成する各 ESITransaction オブジェクトにリンクします。このリンクは、オブジェクトナビゲーション (リリースのトランザクションを照会する場合など) のみに使用され、したがって属性を持ちません。
ESIReleaseUtility
このクラスはパッケージ txn 内に存在し、ESIRelease オブジェクトに関連する各種タスク用のユーティリティメソッドを提供します。このクラスのパブリックメソッドは、このパッケージの一部のサービスへのアクセスを提供します。
このクラスで使用可能な属性とメソッドの詳細については、Windchill リリース関連の Java ドキュメンテーションを参照してください。
ESITransaction
ERP コネクタによるパブリッシングの試行によって 1 つ以上の Windchill ESI トランザクションが生成され、永続可能な ESITransaction オブジェクトによって各トランザクションが表されます。トランザクションの初期ステータスは pending です。その他のトランザクションステータスの値としては processing、succeeded、failed があります。これらの値は標準 Windchill 列挙タイプを使用してローカライズされています。ESITransactionStatusType クラスは ESITransaction ステータスの一連の有効な値を定義します。Windchill ESI トランザクション列挙タイプの定義については、「Windchill ESI トランザクションでの列挙タイプ」の図を参照してください。
トランザクションには、パブリッシング対象のオブジェクトが属する組織内で一意の番号と、ユーザーがそのトランザクションを削除するか (つまり、ユーザーインタフェースでそのトランザクションを完全に非表示にするか) どうかを示すフラグが付いています。組織のデータベースに存在する番号の中で最も大きい値を見つけて、その番号に 1 を足すことで、組織内で一意の番号が生成されます。番号の重複を回避するため、トランザクションの作成はシリアル化されます。
ESITransaction は public クラスです。このクラスは Windchill の標準アクセス制御機能を利用できるように wt.fc.Item を継承します。さらに、インタフェース wt.inf.container.WTContained を実装して、組織コンテナに関連付けることができます。カスタマイズ担当者はこのクラスを拡張できます。
ESITransactionObjectLink
ESITransaction オブジェクトを wt.fc.WTObject オブジェクトに関連付けることができます。この関係は永続的です。ESITransactionObjectLink オブジェクトはこの関係を管理します。
ESITransactionObjectLink は public クラスです。カスタマイズ担当者はこのクラスを拡張できます。
ESITransactionTargetLink
このクラスは wt.fc.ObjectToObjectLink の拡張であり、名前が示すように、ESITransaction オブジェクトを ESITarget オブジェクトにリンクします。ここで、ESITarget オブジェクトへのデータのパブリッシングが ESITransaction オブジェクトによって表されます。この場合も、このリンクは、オブジェクトナビゲーション (特定のトランザクションの配布ターゲットをフェッチする場合など) にのみ使用され、したがって属性を持ちません。
 | ビジネスオブジェクトを Windchill からリリースすると、そのリリースの各宛先にトランザクションが作成されます。このような各トランザクションは対応する宛先に属する各ターゲットにリンクされ、ESITransactionTargetLink オブジェクトがこの関係を管理します。 |
ReleaseActivity
各トランザクションには、上記の「トランザクションオブジェクトの継承」の図に示すように、永続可能なリリースアクティビティオブジェクトによって表されるリリースアクティビティが 0 個以上含まれています。
リリースアクティビティは、「トランザクションオブジェクトの継承」の図に示すように、Windchill ObjectToObjectLink のサブクラスです。
リリースアクティビティオブジェクトは、failed、succeeded、pending、warning、partially_succeeded のいずれかのステータスを持ちます。ステータスの値は列挙型クラス ReleaseStatusType によって定義されています。
リリースアクティビティオブジェクトには action 属性があります。値は列挙タイプクラス ReleaseActivityAction によって定義されます。上記の「Windchill ESI トランザクションでの列挙タイプ」の図を参照してください。
リリースアクティビティオブジェクトにはリリースアクティビティメッセージが 1 つ関連付けられている場合があります。上記のパブリッシング履歴の追跡の図を参照してください。
リリースアクティビティは、1 つのリリース可能なオブジェクト (wt.fc.Persistable のインスタンス) と 1 つの ESITarget オブジェクトに関連付けられます。リリースアクティビティオブジェクトには次の追加属性があります。
◦ creator - リリースアクティビティを作成したユーザー。多くの場合、この値は、リリースアクティビティを作成した関数に関連付けられたセッションプリンシパルです。この値が WTPrincipal でない可能性があるため、この属性は java.lang.String です。
◦ description - リリースアクティビティを作成した関数によって指定された便利なテキスト。
◦ releaseClass - すべての Windchill ESI RPC 応答で提供される Windchill ESI 論理名。
◦ deleted - ユーザーがそのエントリを削除するか (つまり、ユーザーインタフェースでそのエントリを完全に非表示にするか) どうかを示すフラグ。
◦ releaseStamp - リリースアクティビティを作成した関数によって指定されたタイムスタンプ。この値が指定されていない場合、releaseStamp はリリースアクティビティオブジェクトが作成された時刻に設定されます。トランザクションとその関連アクティビティを表示する場合、アクティビティは releaseStamp の昇順で並べ替えられます。
◦ releasedObjectState - リリース済みオブジェクトにリリースアクティビティが作成されたときの、リリース済みオブジェクトのライフサイクル状態。この属性は、そのオブジェクトがパブリッシング済みであるかどうかを判別するために使用されます。
ステータスが succeeded であるリリースアクティビティオブジェクトは、オブジェクトがパブリッシング済みであるかどうかを判別するために使用されます。その情報は、オブジェクトのリリース時に使用する適切な操作 (更新または作成) を決定するために必要なので、これらのオブジェクトをデータベースから削除することはできません。適切な SQL 権限を持つ管理者は、Windchill ESI トランザクションや失敗したパブリッシングアクティビティ (関連メッセージを含む) を削除できます。ERP コネクタにはこれを行うツールはありません。
| | オブジェクトのライフサイクル状態がリリース後に変更された場合、changed object として再パブリッシングの対象として有効と見なされます。そのオブジェクトの再パブリッシングの開始時にそのオブジェクトにはステータスが "succeeded" であるリリースアクティビティがすでに存在しますが、そのライフサイクル状態と作成済みのリリースアクティビティの releasedObjectState 属性の値は一致しないので、そのオブジェクトはパブリッシング済みとは見なされません。 |
| | Windchill ESI プリファレンス「作業版数をチェック」が「いいえ」に設定されている状態で、パブリッシング済みのオブジェクトに作業版数が適用されてリリースされた場合、そのライフサイクル状態がパブリッシング済みの作業版数のライフサイクル状態と異なる場合でも、新しい作業版数は変更なしオブジェクトとして処理されます。そのような場合、トランザクションが成功するためには、「変更の警告を強化」プリファレンスの値が「いいえ」に設定されている必要があります。連産品部品をパブリッシングする際には、前述のプリファレンスは無視されます。つまり、プリファレンスの値に関係なく、連産品部品の新しい作業版数は、変更されたオブジェクトとして必ず送信されます。 |
リリースアクティビティは public クラスです。カスタマイズ担当者はこのクラスを拡張できます。Javadoc が提供されています。
ReleaseActivityMessage
リリースアクティビティメッセージオブジェクトは、ERP コネクタユーザーに役立つ情報が含まれている永続可能オブジェクトです。各リリースアクティビティには、1 つのリリースアクティビティメッセージが関連付けられている場合があります。
リリースアクティビティメッセージは public クラスです。このクラスはカスタマイズ担当者による拡張の対象ではありません。
ESITransactionRelease
ESITransaction オブジェクトをリリースアクティビティオブジェクトに関連付けることができます。この関係は永続的です。ESITransactionRelease オブジェクトはこの関係を管理します。
ESITransactionRelease は public クラスです。カスタマイズ担当者はこのクラスを拡張できます。
ESIRelatedTransaction
ESIRelatedTransaction は、2 つの Windchill ESI トランザクション間のオブジェクト間リンクです。これは複数のパブリッシングリクエストを結合する必要が生じることを見込んで提供されています。このオブジェクトは ERP コネクタでモデル化されていますが、ESIRelatedTransaction オブジェクトを作成または管理するサービスはありません。
ESIRelatedTransaction は public クラスです。カスタマイズ担当者はこのクラスを拡張できます。
ESITransactionUtility
Windchill ESI トランザクションのパッケージは、クラス、ESITransaction、ReleaseActivity、および ESITransactionUtility を除き、自己完結型かつプライベートのパッケージです。
ESITransactionUtility はこのパッケージへのパブリックインタフェースです。このパッケージの各サービスは、ESITransactionUtility クラスのパブリックメソッドを介して呼び出す必要があります。このクラスのメソッドはスレッドセーフではありません。各スレッドは、トランザクションユーティリティの新しいインスタンスを作成します。
このクラスで使用可能な属性とメソッドの詳細については、Windchill リリース関連の Java ドキュメンテーションを参照してください。
ESITransactionManagementDelegate
これは com.ptc.windchill.esi.txn パッケージに存在するパブリックインタフェースです。これは一般的なサービスを提供し、ESI でのトランザクション管理をカスタマイズするため、カスタマイズ担当者による拡張の対象となります。
このクラスで使用可能な属性とメソッドの詳細については、Windchill リリース関連の Java ドキュメンテーションを参照してください。
ESITransactionManagementDelegateImpl
これは com.ptc.windchill.esi.txn パッケージに存在する ESITransactionManagementDelegate のデフォルトの実装です。これは一般的なサービスを提供し、ESI でのトランザクション管理をカスタマイズするため、カスタマイズ担当者による拡張の対象となります。
このクラスで使用可能な属性とメソッドの詳細については、Windchill リリース関連の Java ドキュメンテーションを参照してください。
トランザクション警告委任
委任メカニズムにより、Enterprise System Integration トランザクションの処理中に警告が生成された場合、必要に応じて通知の送信を許可/拒否します。既成では、以下に示す 2 つの委任が提供されています。これらはサービスプロパティ com.ptc.windchill.esi.delegate.TransactionWarningDelegate を使用して設定できます。
TransactionWarningEmailDelegate
この委任はデフォルトで設定されており、ESITransaction の作成者に電子メールで警告通知を送信します。サポートされている API とカスタマイズ可能な API の詳細については、このクラスの Java ドキュメンテーションを参照してください。
TransactionWarningNoOpDelegate
このクラスは、トランザクションのパブリッシング中に生成された警告の通知を無視することを目的とします。これはコンフィギュレーション可能な何もしない委任です。
TransactionWarningDelegateFactory
このクラスは、警告委任をインスタンス化するための共通ファクトリとして機能します。コンフィギュレーションに基づいて警告を送信するための委任を返します。この委任は、ESITarget のセットの destinationID に設定できます。DestinationID 情報の詳細については、配布ターゲットのセクションを参照してください。