フォームのデバッグ
キャプチャ フォーム (スキャン新規ジョブ作成、スキャン、ドキュメント レビュー、検証、確認) などのフォームをデバッグすることができます。
デバッグ モードでのフォームの起動
デバッグ モードでフォームを起動すると、ランタイムの動作に従ってプライマリ フォームがロードされます。
-
に移動します。
フォームのリストが表示されます。
-
デバッグするフォームのコンテキスト メニューで、[デバッグ] をクリックします。
または、フォームの [アクション] バーで [デバッグ] をクリックします。
フォームは、新しいブラウザ ウィンドウにデバッグ モードで表示されます。[フォーム初期化] ポップアップが表示されます。フォームのリストと、フォームに初期値変数として設定されたグローバル変数が表示されます。ドロップダウンが利用可能な場合には、選択可能な値すべてが表示されるのではなく、選択された値のみが表示されます。
- ボタン クリック イベントを使用した .Net アクションなど、任意のアクションにブレークポイントを追加できます。フォームのロード時にブレークポイントを追加するには、[フォームのロード完了イベント アクションを実行する前に一時停止する] を選択します。
- 初期化データの値を更新します。
- [OK] をクリックします。
ブレークポイントの設定
ブレークポイントは、プログラムに含まれる意図的な停止または一時停止で、デバッグの目的で使用されます。また、一時停止
と呼ばれることもあります。たとえば、フォームのブレークポイントにイベントを設定できます。レンダリング前
およびレンダリング後
のフォーム イベントや、Begin 条件
、Else 条件
、End 条件
のアクションにはブレークポイントを設定できません。
-
[デバッグ] ウィンドウで、[ブレークポイント] の をクリックします。
[ブレークポイント] ダイアログ ボックスが表示されます。以下に示すように、対応するすべてのコントロール、イベント、およびアクションが関連付けられた、フォームのツリーが表示されます。
-
フォーム
-
イベント
-
設定されたアクション 1
-
設定されたアクション 2
-
-
-
コントロール 1
-
イベント
-
設定されたアクション 1
-
設定されたアクション 2
-
-
-
コントロール 2
-
イベント
注 「レンダリング前」イベントおよび「レンダリング後」イベントで構成したアクションをデバッグすることはできません。フォーム ロード イベントのアクションのみをデバッグできます。 -
-
-
ブレークポイントを追加します。
選択したブレークポイントが [選択された項目] リストに追加されます。
- [完了] をクリックします。
-
フォーム実行中にアクションをスキップするには、[スキップするアクション] の をクリックします。
[フォーム アクション] ダイアログ ボックスが表示されます。
-
アクションを追加します。
選択したアクションが、[選択された項目] リストに追加されます。
-
[完了] をクリックします。
アクションのステータスは、スタック トレースでスキップされるように更新されます。
注 フォームを初めてロードしてデバッグしたときに、フォームのロード完了イベント アクションを実行する前に一時停止する
をオンにした場合、最初のアクションはスキップされません。デバッグを再開してから、スキップするアクションを追加する必要があります。パネル 説明 1 フォーム
現在のフォームのコントロールがこのパネルに表示されます。
2 [変数値] パネル
フォーム変数、グローバル変数、およびフォーム コントロールを一覧表示します。
注 このパネルで変数とコントロールを表示および更新できます。非表示状態のコントロールを表示することもできます。3 [スタックトレース] パネル
アクションを実行順に一覧表示します。
4 [ブレークポイント] パネル
ブレークポイントを設定したイベントを一覧表示します。
-
ブレークポイントを設定すると、フォームのロード時にイベントを呼び出すことができます。
-
フォームの「ロード時」イベントで任意のブレークポイントを呼び出すには、メイン ページをリフレッシュします。
-
コントロールでイベントを呼び出すには、フォーム自体を使用します。たとえば、ボタンをクリックするか、テーブル内の行を選択します。
イベントが呼び出されると、[スタックトレース] パネルに次のアクションが表示されます。アクションのステータスは、最初のブレークポイントに到達するまで実行されると更新されます。実行を続行するか、アクションをステップ オーバーするかを選択できます。
1
[続行] 次の有効なブレークポイントまで実行を継続します。
2
[ステップ オーバー] 現在のアクションを実行し、次の順番のアクションで停止します。
3
[スキップ] デバッグ中に選択したアクションをスキップし、ステータスが [スキップ] に更新されます。以下の例を参照してください。
4
[クリア] [スタックトレース] パネルをクリアします。
5
[スタックトレース] 実行するアクションのリストです。
アクションのスキップ - 例
-
アクションにブレークポイントを設定します (SamePage1)。
-
[デバッグ] パネルで、[SamePage1] アクションが設定されているコントロール (button1) をクリックします。
[SamePage1] アクションのステータスは、ブレークポイントが設定されていることを示す [一時停止] に更新されます。
-
このアクションをスキップするには、[スタックトレース] パネルで [スキップ] をクリックします。
ステータスが [一時停止] から [スキップ] (アクションが実行されていないことを示します) に更新され、該当する場合は次のアクションで一時停止します。
デバッグ中の条件の使用
デバッグ モードで条件を使用した場合に経由したパスを判別できます。フォームに Begin 条件とElse 条件を設定した場合は、これらの条件がスタックトレースに表示されるため、ロジックが実行された箇所を特定できます。
注 Begin 条件内に Begin 条件を設定して、ロジックをネストできます。Begin 条件をクリックすると、true または false の結果を表示できます。たとえば、次のシナリオでは、BeginCondition1 の結果は false で、BeginCondition2 の結果は true です。
-
アクションの入力/出力の表示
ブレークポイントに到達したときに、.Net アクションなどのサーバー側のアクションを展開し、コントロール、フォーム変数、およびグローバル変数の値を表示および更新して、実行を継続できます。
テーブル コントロールを展開すると、すべての行と列を表示できます。
リダイレクト アクションは、リダイレクトはしませんが、実行するとリダイレクト先を示すメッセージが表示されます。
たとえば、フォーム変数の値を更新する場合などに値を更新するには、次の手順を実行します。
- [フォーム変数] タブをクリックします。
- 変数を選択して [編集] をクリックします。
-
必要に応じて値を変更して [OK] をクリックします。
注 同様の方法でグローバル変数とフォーム コントロールを更新できます。ただし、配列フォーム変数と高度なフォーム コントロールは更新できません。