スニペットをデバッグする

Snippet エディターウィンドウからスニペットをデバッグできます。 デバッガを使用して、スニペットコード内の変数を確認できます。 これはコードの問題を解決するのに役立ちます。 スニペットのデバッグには5つのオプションがあります。

• スニペット内の構文をチェックする。 スニペットをコーディングしている間、いつでも行うことができます。 デバッガツールは使用しません。
• スニペット全体をデバッグして、スニペット全体が実行された後に変数とその値を確認する。
• ブレークポイントを設定し、コード内の特定の行でデバッグを停止する。
• スニペットコードの各行をステップスルーして、変数とその値がどのように変化するかを1行ずつ確認する。
• TRACEステートメントを使用して、Snippet エディターウィンドウのTrace ペインにデータを出力する。

また、コードに動的オブジェクトや配列が含まれている場合は、それらの内容を表示してその変化を確認できます。

スニペットの構文をチェックする

Studioでスニペット内の構文をチェックできます。

1. Studioで、Snippetアクションを含むスクリプトを開きます。
2. Snippetアクションをダブルクリックします。
3. Text View タブにコードがない場合、Snippetコードを追加します。

4. Snippet エディターウィンドウの下部にあるCheck Syntaxアイコンをクリックします。

   構文エラーがない場合、構文チェックアイコンの横にあるステータスフィールドにOkayというメッセージが表示されます。

   構文エラーが見つかった場合は、エラーを説明するメッセージがポップアップ表示されます。 この説明には、エラーのある行番号が含まれています。 さらに、構文チェックアイコンの隣のステータスフィールドに、Error at line [#]というメッセージが表示されます。

5. 見つかった構文の問題をすべて修正します。
6. スニペットコード内の行を1つ以上選択し、Comment out selected linesアイコンをクリックできます。 これは、エラーをスキップして残りのエラーをチェックする場合に便利です。
7. スニペットコード内のコメントアウトされた行を1つ以上選択し、Uncomment the selected linesアイコンをクリックすることができます。

デバッガツールを使用する

1. Studioで、Snippetアクションを含むスクリプトを開きます。
2. Snippetアクションをダブルクリックします。
3. Text View タブにコードがない場合、Snippetコードを追加します。
4. Snippet editorウィンドウの右側で、Debuggerタブをクリックします。
5. Debugアイコンの右側にある下矢印ボタンをクリックし、Startを選択します。

6. コードに構文エラーがある場合は、Snippet editorウィンドウが展開されます。 コード内のすべてのエラーがウィンドウ下部のペインに表示されます。 エラーがない場合は、次のステップに進んでください。

   画像を表示

   
   1. エラーを修正します。
   2. エラーを修正したら、CloseまたはClear Trace Outputアイコンをクリックしてエラーペインを閉じます。
   3. デバッガーをもう一度起動します。
7. Variables as Text タブの内容を表示します。 このタブには、ブレークポイントを設定しなかった場合、すべてのコードが実行されたときの変数とその値が表示されます。
8. スニペットコード内の行を1つ以上選択し、Comment out selected linesアイコンをクリックできます。 これは、コードの一部を削除して、デバッグの結果がどのように変わるかを確認したい場合に便利です。
9. コメントアウトされたコードを1行以上選択し、Uncomment the selected linesアイコンをクリックすると、それらの行をスニペットに戻すことができます。

ブレークポイントを使ってデバッグする

スニペットコードの特定の行でデバッグを停止したい場合は、ブレークポイントを設定できます。 これにより、スニペットを1行ずつステップスルーすることなく、スニペットの途中で変数や値を確認できます。

1. Studioで、Snippetアクションを含むスクリプトを開きます。
2. Snippetアクションをダブルクリックします。
3. Text View タブにコードがない場合、Snippetコードを追加します。

4. Snippet editorウィンドウの行番号の左側の列をクリックします。 行番号に赤い丸が表示されます。

   画像を表示

   
5. Snippet editorウィンドウの右側で、Debuggerタブをクリックします。
6. Debugアイコンの右側にある下矢印ボタンをクリックし、Startを選択します。

7. コードに構文エラーがある場合は、Snippet editorウィンドウが展開されます。 コード内のすべてのエラーがウィンドウ下部のペインに表示されます。 エラーがない場合は、次のステップに進んでください。

   画像を表示

   
   1. エラーを修正します。
   2. エラーを修正したら、CloseまたはClear Trace Outputアイコンをクリックしてエラーペインを閉じます。
   3. デバッガーをもう一度起動します。
8. Variables as Text タブの内容を表示します。 ブレークポイントを設定した場合、このタブには変数とその値が表示されます。 ブレークポイントでデバッグが一時停止した行は、Snippet Editorウィンドウで強調表示されます。
9. ブレークポイントの確認が終わったら、赤い丸をもう一度クリックしてクリアします。
10. 必要であれば、別のブレークポイントを設定してください。
11. ブレークポイントからデバッグを続行するには、Resumeアイコンをクリックします。
12. デバッグを停止するには、Stop Debuggingアイコンをクリックします。

スニペットコードをステップスルーする

デバッガツールを使用して、スニペットコードを1行ずつステップスルーすることができます。 これにより、各行が実行されるたびに変数とその値がどのように変化するかを確認できます。

1. Studioで、Snippetアクションを含むスクリプトを開きます。
2. Snippetアクションをダブルクリックします。
3. Text View タブにコードがない場合、Snippetコードを追加します。
4. Snippet editorウィンドウの右側で、Debuggerタブをクリックします。
5. Debugアイコンの右側にある下矢印ボタンをクリックし、Startを選択します。

6. コードに構文エラーがある場合は、Snippet editorウィンドウが展開されます。 コード内のすべてのエラーがウィンドウ下部のペインに表示されます。 エラーがない場合は、次のステップに進んでください。

   画像を表示

   
   1. エラーを修正します。
   2. エラーを修正したら、CloseまたはClear Trace Outputアイコンをクリックしてエラーペインを閉じます。
   3. デバッガーをもう一度起動します。
7. Variables as Text タブの内容を表示します。 スニペットコードの起動時に、コード内の変数とその値が表示されます。
8. Stepアイコンをクリックして、スニペットの次の行に移動します。
9. スニペット内の各行について、前の2つのステップを繰り返します。
10. 残りの行をスキップするには、Resumeアイコンをクリックします。 Variables as Text タブには、スニペットコードがすべて実行された時点での変数とその値が表示されます。
11. デバッグを中止してやり直す場合は、Stop Debuggingアイコンをクリックし、ステップ3からこのプロセスを繰り返します。

動的オブジェクトと配列の内容を表示する

デバッガーを実行する際、Snippet エディターウィンドウでダイナミックオブジェクトの内容を確認できます。 これにより、コードの各ステップでオブジェクトが正しいデータを保持していることを確認できます。

1. Studioで、Snippetアクションをダブルクリックします。
2. 必要であればスニペットコードを追加します。
3. Debugger タブで、変数ツリータブをクリックします。
4. Debugger タブで、デバッグ開始アイコンの隣にある下矢印をクリックし、ステップインを選択します。 コードを1行ずつ確認したくない場合は、デバッグ開始アイコンをクリックします。
5. ステップ アイコンをクリックしてVariables as Treeタブの内容を確認します。 ステップをクリックするたびに、このフィールドは、前のコード行以降のスクリプトの変数とオブジェクトで更新されます。 デバッグ開始をクリックした場合はこのステップをスキップしてください。
6. すべてのコード行のステップスルーが終了した場合、またはデバッグ開始をクリックした場合、Variables as Treeタブにはスニペットの終了時のすべての変数、オブジェクト、およびその内容が表示されます。

7. コード内の任意の文字列配列または動的オブジェクトの隣にある+アイコンをクリックして、それらを展開することができます。 コンテンツが別の配列またはオブジェクトの場合は、ツリーの展開を続けて、各エンティティに含まれる内容を確認できます。

   画像を表示

   

TRACEを使ってデバッグする

TRACE キーワードを使用すると、ロギングを使用してデバッグできます。 このキーワードは、Snippet エディターウィンドウでデバッガツールを使用する場合にのみ機能します。 このキーワードをスニペットコードに含めてデバッガーを実行すると、Snippet エディターウィンドウの下部に表示されるTrace ペインにテキストが出力されます。

TRACE キーワードは、Snippet エディターウィンドウの外では無視されます。 これはデバッガツールでのみ機能します。

構文は次のとおりです：TRACE "<text>"

二重引用符内のテキストはSnippet エディターウィンドウに出力されます。 これはウィンドウ下部のTrace ペインに表示されます。

変数の値を出力するには、二重引用符内で変数代入を使用します。 例：

FOR i=1 TO 5
{
   TRACE "I = {i}"
}

この例の出力は次のようになります。

I = 1

I = 2

I = 3

I = 4

I = 5