26 BPMプロジェクトのデバッグ

この章では、Oracle JDeveloperデバッガを使用して、BPMプロジェクトに含まれているBPMNプロセスをデバッグする方法について説明します。

この章の内容は次のとおりです。

26.1 BPMプロジェクトのデバッグの概要

Oracle JDeveloperデバッガを使用してBPMプロジェクトに含まれているBPMNプロセスをデバッグできます。BPMNプロセスをデバッグすると、プロセスの正常な実行を妨げるワークフローまたは論理的な問題を特定し、修正できます。

デバッグ処理には、SOAコンポジットまたはBPMNプロセスへのブレークポイントの追加が含まれ、それにより、デバッガがそれらのブレークポイントの1つに到達したときに実行を停止し、次のことを実行できるようになります。

SOAコンポジットまたはBPMNプロセス・ワークフローのトレース
プロセス・インスタンス属性の値のインスペクトまたはウォッチ
データ・オブジェクトの値のインスペクトまたはウォッチ
相関キーのインスペクトまたはウォッチ
会話のインスペクトまたはウォッチ
他のコンポーネントのコールのトレース実行およびBPMコンポーネントとの間で送受信される正規化されたメッセージ値の表示

プロセスの論理スレッドは、実行されるときに様々なフレームをアクティブ化します。これらのフレームは、プロセス・フローに応じてネストできます。各フレームは、特定の宣言レベルでのデータ・オブジェクトおよびプロセス・インスタンス属性の値を表すデータ値のセットで構成されています。フレームのネストは、スタック・フレームに準拠したものになります。

プロセスがデータ宣言コンテナに入ると、新しいフレームがアクティブ化されます。BPMNプロセスを実行するときに出現できる様々な宣言コンテナは次のとおりです。

BPMNプロセス自体
埋込みサブプロセス
コール可能プロセス
イベントのサブプロセス

これらのプロセス・コンテナそれぞれは、データ・オブジェクト、相関キーおよび会話の宣言をサポートします。これらのプロセス・コンテナがアクティブ化されると、デバッガによって新しいフレームが作成されます。

デバッガは、これらのプロセス・コンテナのネストのされかたに従ってスタック・フレームを構築します。スタック・フレームは、データ可視性を提供し、BPMNプロセス内のデータへのアクセスを可能にするモデルです。たとえば、再利用可能なBPMNプロセスのコール・アクティビティが含まれている埋込みサブプロセスが含まれているBPMNプロセスは、3つのレベルのネストを定義します。再利用可能なサブプロセス内で実行されるデバッガ・スレッドには、3つの要素を持つ1つのスタック・フレームが含まれています。最上位のフレームは再利用可能なプロセスに対応し、最後のスタック要素はBPMNプロセスに対応します。

Oracle JDeveloperデバッガの詳細は、Oracle JDeveloperユーザーズ・ガイドのJavaプログラムの実行とデバッグに関する項を参照してください。

26.2 BPMNフロー・オブジェクトへのブレークポイントの追加

BPMNフロー・オブジェクトにブレークポイントを追加して、プロセス・フローがそのBPMNフロー・オブジェクトに到達したときにデバッガを停止できます。

ブレークポイントは、BPMNプロセスの実行中にどこでデバッガが停止するのかを定義します。ブレークポイントは、複数のBPMNフロー・オブジェクトに追加できます。デバッガはこれらのブレークポイントに到達すると停止し、ユーザーはプロジェクト内の様々な変数の値を監視できます。これらの値は、BPMNプロセスのワークフローまたはロジックでの問題の解決に役立ちます。

26.2.1 BPMNフロー・オブジェクトへのブレークポイントの追加方法

BPMNフロー・オブジェクトにブレークポイントを追加する手順は次のとおりです。

ブレークポイントを追加するBPMNフロー・オブジェクトが含まれているBPMNプロセスを編集します。
ブレークポイントを追加するBPMNフロー・オブジェクトを右クリックします。
「ブレークポイントの切替え」を選択します。
BPMNフロー・オブジェクトの右上隅に赤い点が表示され、ブレークポイントがあることが示されます。

タイプBPMブレークポイントのブレークポイントが「ブレークポイント」ビューに表示されます。

26.3 BPMNコンポーネントへのブレークポイントの追加

BPMNコンポーネントにブレークポイントを追加して、SOAコンポジットの実行中にデバッガがそれに到達したときにデバッガを停止できます。

26.3.1 BPMNコンポーネントへのブレークポイントの追加方法

BPMNフロー・オブジェクトにブレークポイントを追加する手順は次のとおりです。

ブレークポイントを追加するBPMNコンポーネントが含まれているSOAコンポジットを編集します。
ブロークポイントを追加するBPMNコンポーネントを右クリックします。
次のいずれかを選択します。
- ブレークポイント・ペアの作成
  
  プロセスへの入出力メッセージを監視します。
- リクエスト・ブレークポイントの作成
  
  プロセスに入るメッセージを監視します。
- リプレイ・ブレークポイントの作成
  
  プロセスを終了するメッセージを監視します。
BPMNコンポーネントの右上隅に赤い点が1つまたは1組み表示され、ブレークポイントがあることが示されます。

タイプBPMブレークポイントのブレークポイントが「ブレークポイント」ビューに表示されます。

26.4 ブレークポイントの無効化

デバッグの特定の時点で、不要なブレークポイントを無効化できます。

デバッグ・セッションが進行するに従って、追加したブレークポイントのいくつかを削除し、他の場所にブレークポイントを追加する必要が生じる場合があります。

26.4.1 ブレークポイントの無効化方法

ブレークポイントを無効化する手順は次のとおりです。

無効化するブレークポイントが含まれているBPMNフロー・オブジェクトを右クリックします。
「ブレークポイントの無効化」を選択します。

26.5 BPMプロジェクトのデバッグ

BPMプロジェクトに含まれている任意のBPMNプロセスをデバッグできます。

Oracle JDeveloperデバッガを使用して、BPMプロジェクトに含まれているプロセスをトラブルシューティングします。

26.5.1 デバッガへのBPMプロジェクトのアタッチ方法

デバッガにBPMプロジェクトをアタッチする手順は次のとおりです。

「アプリケーション」ウィンドウで、デバッグするBPMプロジェクトを右クリックし、「デバッグ」アクションを選択します。
サーバー接続を構成します。
これは、個別に構成する必要がある固有のSOAデバッグ接続です。サーバー接続の構成方法の詳細は、Oracle JDeveloperによるアプリケーションの開発のリモート・デバッグ用に構成されたプロジェクトの使用方法に関する項を参照してください。

アプリケーションのデプロイ・ダイアログ・ボックスが表示されます。
「アプリケーション・サーバーにデプロイ」を選択します。
「次へ」をクリックします。
「構成のデプロイ」ページが表示されます。
必要に応じて、デプロイ構成を変更します。
「次へ」をクリックします。
「サーバーの選択」ダイアログ・ボックスが表示されます。
サーバーを選択するか、新しいサーバー接続を追加します。
「終了」をクリックします。
コンポジット・エディタおよび「デバッグ」ウィンドウが表示されます。
1ステップずつBPMNプロセスを実行します。
デバッガがBPMNプロセス内のブレークポイントに達したときは、そのブレークポイントがあるBPMNフロー・プロジェクトが強調表示されます。