チュートリアル：イベント・ハンドラ・コードによるテスト・ステップのチェックポイントのプロパティの設定

このチュートリアルでは、API テストのプロパティ値グリッドではなく、イベント・ハンドラ・コードを使用して、チェックポイントのプロパティを設定します。これは、入力プロパティの値がテストの実行中に動的に生成される場合に役立ちます（テスト実行の前に存在していないプロパティは、［プロパティ］表示枠の［入力プロパティ/チェックポイントのプロパティ］タブでは設定できません）。

このチュートリアルでは、文字列の連結ステップのチェックポイントのプロパティを設定します。

注意: このチュートリアルをサンプル API テストで実行する前に、このトピックを印刷するか、ブラウザ・ウィンドウを別の画面に移しておくことをお勧めします。

文字列の連結の作成

必要であれば、［ツールボックス］表示枠の［文字列操作］セクションから、文字列の連結ステップをキャンバスにドラッグします。

先頭に戻る

入力プロパティの入力

［プロパティ］表示枠で、［入力/チェックポイント］タブを開きます。

［入力/チェックポイント］タブで、次の入力プロパティを入力します。

プレフィックス	Hello （Hello の後にスペースあり）
サフィックス	World.

先頭に戻る

チェックポイントのイベント・ハンドラを作成します。

チェックポイントの実行を支援するため、UFT One には、ステップの後に実行してステップ結果を検査する特別なチェックポイント・ハンドラが設定されています。

［プロパティ］表示枠で、［イベント］タブをクリックします。
［イベント］タブの［CodeCheckPointEvent］行で、下矢印をクリックし、［標準設定のハンドラの作成］を選択します。

ドキュメント表示枠に［TestUserCode.cs］という別のタブが開き、OnCodeCheckPointEvent セクション用に、コードのセクションがこのファイルに追加されます。

先頭に戻る

チェックポイントの有効化

［TestUserCode.cs］タブで、コードの ConcatenateStringsActivity4_OnCodeCheckPointEvent 部分の下にある TODO:ここにコードを追加してください... セクションを探します。
//TODO:ここにコードを追加してください... 文字列を削除します。

注意: TODO 行の上下の行の括弧は削除しないようにしてください。この括弧は、コード構文を正しく保つために必要です。
同じ行に「args.」とピリオドを含めて入力します（入力するときにはオートコンプリート・リストが表示され、argsは、このリストから探すことができます）。

args. オブジェクトを入力したら、別のオートコンプリート・リストが表示されます。
オートコンプリート・リストからCheckpointオブジェクトを選択します。
Checkpoint オブジェクトの後に、ピリオド（.）文字を入力します。別のオートコンプリート・リストが表示されます。
オートコンプリート・リストから RunUICheckpoints オブジェクトを選択し、ENTER キーを押します。
RunUICheckpoints オブジェクトの後に、「=true」と入力します。
true 文字列の後に、セミコロン（;）文字を入力します。

これで、イベント・ハンドラ・コードは次のようになります。
```
args.Checkpoint.RunUICheckpoints=true;
```
［保存］をクリックします。

先頭に戻る

チェックポイントのプロパティ値に対するイベント・ハンドラ・コードの追加

チェックポイントを有効にしたら、どの値を期待値として使用するかを UFT One に指示できます。

RunUICheckpoints オブジェクトが含まれる行の下に、args. オブジェクト（ピリオドあり）をもう一度します。

args. オブジェクトを入力したら、オートコンプリート・リストが表示されます。
オートコンプリート・リストから Checkpoint オブジェクトを選択し、ENTER キーを押します。
Checkpoint オブジェクトの後に、ピリオド（.）文字を入力します。別のオートコンプリート・リストが表示されます。
オートコンプリート・リストから Assert を選択し、ENTER キーを押します。
Assert オブジェクトの後に、ピリオド（.）文字をもう一度入力します。別のオートコンプリート・リストが表示されます。
オートコンプリート・リストから Equals 関数を選択し、ENTER キーを押します。
Equals 関数の後に、開き括弧 ( 文字を追加します。Equals 関数のテキストの色が変化します。
括弧の内側に、次の文字列を入力します。
```
this.ConcatenateStringsActivity4.Prefix+this.ConcatenateStringsActivity4.Suffix),
```
注意: 正しい関数構文になるように、この文字列の後には必ずカンマを追加してください。

この文字列は、値を Prefix + Suffix プロパティに設定することで、チェックポイントのテスト・ステップの実際の結果を提示します。
前の文字列の後に、期待する文字列 "Hello World." を入力します。
Hello world 文字列の後に、閉じ括弧 ) 文字とセミコロン（;）文字を入力します。

これで、イベント・ハンドラ・コードは次のようになります。
```
args.Checkpoint.RunUICheckpoints=true; 
args.Checkpoint.Assert.Equals(this.ConcatenateStringsActivity4.Prefix+this.ContatenateStringsActivity4.Suffix,"Hello World.");
```
［保存］をクリックします。