[マーカー] パネル

ブレークポイント、条件付きブレークポイント、およびデバッグ中にワークフローの実行を制御および検査するために使用されるトレースポイントを管理するためのマーカー パネル。

ブレークポイント

[ブレークポイント] は、デバッグ プロセスを、実行上問題を生じる可能性があるアクティビティで意図的に一時停止する際に使用します。条件やヒット数を設定すると、単純なブレークポイントが条件付きブレークポイントに変わります。ログを追加すると、条件付きトレースポイントに条件付きブレークポイントが作成されます。ログ メッセージのみを追加すると、ブレークポイントが単純なトレースポイントに変換されます。

次のように、アクティビティにブレークポイントを配置および変更できます。

• コンテキスト メニューから、アクティビティを右クリックして [ブレークポイントを切り替え] を選択します。
• アクティビティを選択し、[デバッグ] タブの [ブレークポイント] ボタンをクリックする。
• 目的のアクティビティを選択したまま F9 キーを押します。

切り替えを行う 1 つのブレークポイントに対して、1 つのアクティビティを選択する必要があります。ただし、ブレークポイントの数に制限はなく、自由に切り替えることができます。ブレークポイントが設定された後、ワークフロー内のアクティビティの順序が変更されていないことを確認してください。

各ブレークポイントまたはトレースポイントは、そのステートに基づいて特定のアイコンを受け取ります。アイコンがアクティビティに設定され、[マーカー] パネルに表示されます。

ブレークポイントのアイコンと種類

入力	説明
ブレークポイント	ブレークポイントは、アクティビティが実行される前にデバッグ プロセスを一時停止します。ブレークポイントには次のステートがあります。 有効 - 無効 -
条件付きブレークポイント	条件付きブレークポイントは、設定された条件やヒット数に依存するブレークポイントです。条件付きブレークポイントには、次のステートがあります。 有効 - 無効 -
トレースポイント	トレースポイントは、ログ メッセージが設定されたブレークポイントです。デバッグ中にトレースポイントに到達すると、メッセージはトレースレベルで記録されます。トレースポイントには次のステートがあります。 有効 - 無効 -
条件付きトレースポイント	条件付きトレースポイントには、条件またはヒットカウントが設定され、ログ メッセージが記録されます。ヒット数フィールドに指定された回数だけ条件が満たされると、メッセージがログに記録されます。条件付きトレースポイントには、次のステートがあります。 有効 - 無効 -

ブレークポイントまたはトレースポイントのステートを変更するには、アクティビティを選択して F9 キーを押すか、[マーカー] パネルのアイコンをクリックするか、デザイナーまたは [マーカー] パネルのコンテキスト メニューを使用します。また、[デバッグ] タブの [ブレークポイント] ボタンをクリックし、ドロップダウン メニューを開き、[ブレークポイントを切り替え] をクリックすることができます。

注:

デザイン時に設定された [ブレークポイント] は、オートメーション プロジェクトを再度開いたときにもそのまま残ります。ブレークポイントはランタイム時には残らず、デバッグ時にのみ残ります。

パネルでブレークポイントを選択し、[削除] ボタンをクリックして削除します。[すべてのブレークポイントを削除] オプションを使用すると、現在のプロジェクト内のすべてのブレークポイントを削除できます。[すべてのブレークポイントを有効化] オプションは、現在開いているプロジェクト内のすべてのブレークポイントを有効化できます。また、[すべてのブレークポイントを無効化] オプションは、すべてのブレークポイントを無効化します。[マーカー] パネルでは複数選択が可能です。

ブレークポイントの設定

[マーカー] パネルには、オートメーション プロジェクトの切り替えられたブレークポイント部分ごとに個別に調整できる設定セットがあります。アイコンをクリックしてウィンドウを開きます。

注:

[条件] フィールドに追加される式は、いずれも検証されないことに配慮してください。

ブレークポイントの設定のフィールドの説明

[ブレークポイントの設定] ウィンドウには、次のオプションがあります。

オプション	説明
条件	ブレークポイントの条件。デバッグ中に条件が満たされると、実行が中断され、アクティビティが強調表示されます。
ヒット カウント	実行が中断されるまでに条件が満たされる必要がある回数を指定します。ヒット カウントが条件を満足する回数よりも大きい場合、ブレークポイントに到達しても実行は停止しません。ヒット カウントの最大値は 32,767 です。
メッセージをログ	条件が満たされたときにトレース レベルでログに記録するメッセージを指定します。メッセージは [出力] パネルに表示されます。条件が設定されていない場合でも、メッセージはログに記録されます。
ログ中に実行を続行します。	オンにすると、条件が満たされ指定されたメッセージがログに記録されたときに実行が一時停止されません。ログメッセージが以前に設定されている場合のみ使用できます。

プロジェクトのブレークポイントの設定は、デザイナー パネルでブレークポイントにカーソルを合わせると表示されます。

ブレークポイントのコンテキスト メニュー

[マーカー] パネルの項目を右クリックして、次の選択肢のあるコンテキスト メニューを開きます。

オプション	説明
削除する	選択したブレークポイントを削除します。
フォーカス	デザイナー パネルのブレークポイントにジャンプします。
有効化	選択したブレークポイントを有効化します。
無効化	選択したブレークポイントを無効化します。
設定	ブレークポイントに条件を追加するための [ブレークポイントの設定] ウィンドウを開きます。

注:

[ファイルを検証] または [プロジェクトを検証] を使用する場合、ブレークポイント条件は評価されません。

Windows - レガシ プロジェクトの既知の制限事項

ワークフローに以下が含まれる場合、ブレークポイントにヒットしても実行は一時停止しません。

• [ページの読み込みを待機] プロパティのオプションが選択されている UI Automation アクティビティ
• 同じ式を使用して呼び出される、異なる型の 2 つの変数

ブックマーク

ブックマークを使用すると、ワークフロー内の特定のアクティビティにマークを付けて、そこにすばやくジャンプできます。ブックマークの配置と変更には、任意のアクティビティを右クリックして [ブックマークを切り替え] を選択します。これにより、アクティビティにブックマーク [挿入アイコン] アイコンのラベルが付けられます。

フィルター ボタンを使用すると、パネル内のブレークポイントとブックマークをフィルター処理できます。ブレークポイントと同様に、パネルでブックマークを選択して [削除] ボタンをクリックすると、そのブックマークはプロジェクトから削除されます。[すべてのブックマークを削除] オプションを使用すると、現在のプロジェクト内のすべてのブックマークを削除できます。[すべてのブックマークを有効化] オプションを使用すると、現在開いているプロジェクト内のすべてのブックマークを有効化できます。[前のブックマーク] オプションと [次のブックマーク] オプションを使用すると、ブックマークしたアクティビティ間を移動できます。

[マーカー] パネルのブックマークを右クリックして、次の選択肢のあるコンテキスト メニューを開きます。

オプション	説明
削除する	選択したブックマークを削除します。
フォーカス	デザイナー パネルのブックマークにジャンプします。
有効化	選択したブックマークを有効化します。
無効化	選択したブックマークを無効化します。

ブックマークしたアクティビティを削除すると、対応するブックマークも削除されます。ブレークポイントと同様に、ブックマークもデバッグ中に追加できます。

[マーカー] パネル

[マーカー] パネルには、現在のプロジェクトのすべてのブレークポイントとブックマークが表示され、それらが含まれているファイルも表示されます。

要素	説明
場所	Shows the activity with the toggled breakpoint or bookmark, as well as conditions set to breakpoints.
ファイル パス	Displays the file and its location.
メッセージ	For breakpoints, shows messages to be logged if the condition is met. Hover over the breakpoint tag on an activity to view its condition and log message. For bookmarks, lets you type messages that appear when hovering over the bookmark tag on an activity.
フィルター	Hides or reveals the Breakpoints or Bookmarks sections in the panel.
Delete all, Enable all, Disable all	Perform actions on all breakpoints or bookmarks listed in the panel, regardless of whether they are selected.
Delete the selection	Deletes only selected elements. Deleting the Breakpoints or Bookmarks sections also deletes all breakpoints or bookmarks from the current file.

デザイナー パネルで強調表示されたアクティビティを表示するには、ブレークポイントまたはブックマークをダブルクリックします。リボンのコンテキスト メニュー オプションを使用して、ブレークポイントまたはブックマークを有効化または無効化します。

To delete multiple breakpoints or bookmarks, select them and select Delete in the context menu. This removes the breakpoints or bookmarks from the current file.