ログの処理、エラー処理、Windchill PDMLink への応答メッセージには同じ概念を使用しますが、異なる機能を実行し異なる方法で実装されます。以下のセクションでは、これらのプロセスについて説明し、それぞれの機能を要約します。

EAI コンポーネントのログ作成アーキテクチャは、システム管理者が EAI ソフトウェアコンポーネントプロセスを簡単に記録できるように設計されています。Windchill ESI ビジネスロジックは、すべてのトランザクションアクティビティのログをログファイルに作成し、特にルーチンおよび機能エラー処理を記述するメッセージを作成します。

Windchill ESI エラーおよびシステムログエントリは、ビジネスロジックが以下の処理のマイルストーンに達した直後に生成されます。

ログエントリは時間の経過に沿って記録されます。並列処理による混乱を避けるために、エントリのフィルタ処理または並べ替えはトランザクション番号に基づいて行う必要があります。ログ作成プロセスでは、入力として ESILog スキーマを使用します。ログスキーマの詳細については、XML スキーマを参照してください。

EAI ソフトウェアコンポーネントによって生成されたすべての Windchill ESI ログは、ほかの標準的な TIBCO 製品のメッセージと区別するために ESI の役割修飾子とともに TIBCO BusinessWorks プロセスエンジンログ内に保持されます。ログファイルのサイズを設定でき、Web ベースの TIBCO BusinessWorks Administrator でログを表示できます。ログの表示方法については、TIBCO Administrator User's Guide を参照してください。

ログファイルをテキストファイルにエクスポートし、テキストエディタで表示したり、Microsoft Excel などのスプレッドシートプログラムに CSV ファイルとしてエクスポートし、メッセージをフィルタまたは並べ替えたりすることができます。また、ログメッセージを有効または無効にすることも、さまざまなレベルの詳細度および重大度が表示されるように設定およびカスタマイズすることもできます。

以下の表では、ログエントリのコンポーネントについて順番に説明します。ログのフィールドはコンフィギュレーション可能な区切り記号で区切られています。デフォルトでは、区切り記号はコンマ (,) に設定されています。

以下のセクションでは、ログメッセージのさまざまなフィールドに関連付けられているコードまたは番号について詳しく説明します。

アプリケーションフィールドは、ログエントリの情報のソースであるアプリケーションを示します。ログエントリのアプリケーションフィールドとほかのフィールド間に体系的に設定された相関関係はありません。以下の表は、アプリケーションに関連付けられている番号を示しています。

メッセージを分類しやすいように、Windchill ESI により、Windchill ESI ビジネスロジックで各ログエントリが生成された時点でタイプが割り当てられます。以下の表は、メッセージタイプを示します。

重大度はシステムに対するメッセージの影響を示します。カスタマイズしたメッセージの重大度タイプとして、5 以上 (9 を除く) の重大度を使用できます。以下の表に、現在の重大度を示します。

以下の項目に関するメッセージコードの詳細について説明します。

各メッセージには 40003 など 5 桁のコードが関連付けられています。これによりロケールや配布ターゲットごとにメッセージログを設定できます。Windchill ESI では、いくつかのサポート言語にメッセージテキストがローカライズされます。グローバル変数 ESILog/Locale を使用して、展開されている BusinessWorks 処理エンジンごとに希望のログ言語を選択できます。デフォルトでは、メッセージは ESIMessageLookups.properties に保存されます。特定の配布ターゲットや追加のロケールに合わせて、このファイル内のデフォルト Windchill ESI メッセージテキストを設定できます。メッセージの照会キーにはワイルドカードを含めることができます。つまり、任意のロケールやシステムで動作するようにコードを設定できます。

ログメッセージは、ロケール、システム、ワイルドカードという優先順位に従って選択されます。

エントリのフォーマットは"コード.システム.ロケール=ローカライズ済みテキスト" です。

以下に例を示します。

41308.PT3.en_US=<SAP インスタンス PT3 の米国英語のテキスト>

41308.*.de_DE=<すべてのシステム用のドイツ語のテキスト>

41308.*.*=<すべてのシステムとロケール用のデフォルトのテキスト

メッセージコードは、以下の方法に従って番号が付けられます。

前述のとおり、サイトのニーズに応じて、ログに書き込むメッセージタイプおよび重大度を設定できます。これらのメッセージの設定は、グローバル変数を使用して行います。

以下の表は、グローバル変数として保存されているフラグを示しています。重大度 0 のメッセージ (致命的メッセージ) は必ず記録されます。このメッセージをオフにするためのフラグはありません。これらのフラグに設定可能な値は 0 (false) または 1 (true) です。

この表に示したフラグは、どのような場合にメッセージを記録するかを指定します。これとは別に、何を記録するかを指定するフラグがあります。これらのグローバル変数については、以下の表で詳しく説明します。

以下の図は、EAI ソフトウェアコンポーネントでログ作成プロセスがどのように起動するかを示しています。

以下の TIBCO BusinessWorks のサンプルスクリーンショットは、ハードコード化された情報と実行時プロセスデータを含む、ログに書き込まれたデータを表示するログ作成プロセスの呼び出しを示します。

Windchill ESI EAI ソフトウェアコンポーネントは、(部品、BOM、ドキュメント、変更通知、ドキュメントリンク、プロセス計画、リソースなどの) すべてのオブジェクト/操作/組織のサブトランザクション PostResult メッセージを送信します。ESIPostResult スキーマの Message フィールドは、オブジェクトのステータスに関する説明テキストが表示される文字列フィールドです (PostResult スキーマ構造の詳細については、Windchill ESI の実装を参照してください)。このフィールドには、いくつかの情報が自動的に入力されます。メッセージフィールドの構造については、以下の表で説明します。フィールドは、グローバル変数 ESIMessaging/Delimiter を使用して区切られています。デフォルトでは 2 本の縦線 (||) に設定されています。この区切り記号は、メッセージ文字列フィールド全体の前にも付加されます。この機能は、メッセージに指定された区切り記号を使用してソースアプリケーションでメッセージを動的に解析できるように用意されたものです。

ログ作成とは異なり、Windchill への応答メッセージにはどのような場合にメッセージを送信するかを指定するフラグはありません。メッセージはオブジェクト、操作、または組織ごとに必ず送信する必要があります。ただし、Windchill PDMLink にどのようなメッセージを返すかを指定するフラグはあります。これらのフラグについては、以下の表で説明します。

Windchill ESI システムのエラーは、クローズループ方式で処理されます。これは、エラーごとにある方法で記録され処理されることを意味します。Windchill PDMLink ユーザーには能動的に通知が行われるので、ユーザーはエラーを見て各エラーの原因を修正し、処理を進めるためにトランザクションを再サブミットできます。

Windchill ESI ビジネスロジックには、カスタムのエラー処理プロセスが含まれています。このプロセスは、TIBCO BusinessWorks アプリケーションでエラーが検出された後にインラインで呼び出されます。プロセスが開始されると、エラーのタイプが評価され、以下の操作の検討を含め、エラーの処理に必要な操作が決定されます。

ログ作成フラグでは、エラーをログに記録するかどうかを指定します。エラーの重大度は、エラー処理コードによって決まります。エラーコードが重大度 0 (致命的) の場合、すべての処理が停止されます。重大度 0 のエラーは必ず記録されます。エラーコードが重大度 1 (エラー) の場合、処理は続行されます。重大度 1 のエラーは、ログフラグが有効になっている場合に記録されます。

Windchill PDMLink ユーザーには積極的に通知が行われるので、ユーザーはエラーの原因を修正できます。ただし、このような通知を提供するためのデータが不十分な場合は、Windchill PDMLink と配布ターゲット間でデータが一致しない可能性が提示され、管理者への電子メールメッセージやポケットベルの呼び出しなど、より高いレベルでカスタマイズされた通知を送信できます。

エラーが処理されると、そのエラーのプロセススレッドは必然的に終了します。エラー処理プロセスでは、入力として ESIError スキーマを使用します。エラー処理サービスが呼び出された場合は、必要な情報を入力する必要があります。ESIError スキーマの詳細については、XML スキーマを参照してください。

Windchill ESI システムの EAI コンポーネントのエラーは、以下の 3 つのタイプに分類できます。

チェックポイントのガイドラインの詳細については、Windchill Enterprise Systems Integration Administration Guide - SAP を参照してください。

Windchill ESI ビジネスロジックでは、エラー処理プロセスを呼び出すたびに 5 桁のメッセージコードが使用されます。このコードを使用して、エラー処理プロセスの動作を決定する処理コードを調べます。エラー処理には複数の処理コードがあり、各コードには以下のオプションを含む操作の順列があります。

致命的なメッセージ (重大度 0) は必ず Windchill ESI ビジネスロジックのログに記録されます。エラーメッセージ (重大度 1) は、対応するログフラグが true に設定されている場合に記録されます。ログに記録するメッセージも、処理コードの決定に使用した 5 桁のコードを使用して決定します。

以下の表は、各コードのハイレベルの概要を示します。

以下の表は、各エラーコードに関する追加情報を示します。

ログ作成およびエラー処理プロセスの機能と相違点について、以下に要約します。