API ユーザ・コード・ファイルのデバッグ - 実習

関連：ユーザ・コード・ファイル

この実習では、API テストで提供されている UFT One のデバッグ機能を使って API ユーザ・コード・ファイルを作成およびデバッグします。

注意: この使用例に関連するタスクについては、「テスト、コンポーネント、関数ライブラリ、またはユーザ・コード・ファイルのデバッグ」を参照してください。

テスト・ステップを作成する

  1. API テストを作成します。

  2. ［ツールボックス］表示枠の［数学］セクションで、［加算］アクティビティ、［乗算］アクティビティ、［カスタム コード］アクティビティをキャンバスにドラッグします。

先頭に戻る

数値演算ステップのプロパティを設定する

  1. ［入力/チェックポイント］タブでの［入力］表示枠で、［加算］演算の値を入力します。

    • A の［値］カラムに 10 と入力します。

    • B の［値］カラムに 6 と入力します。

  2. ［入力/チェックポイント］タブに、［乗算］演算の値を入力します。

    • A の［値］カラムに 2 と入力します。

    • B の［値］カラムに 4 と入力します。

先頭に戻る

カスタム・コード・アクティビティのパラメータを作成する

  1. 「［入力/出力プロパティ/パラメータの編集］ダイアログ・ボックス（API テスト）」で、入力パラメータの詳細を入力します。

    • ［名前］フィールドに AddResult と入力します。

    • ［タイプ］フィールドのドロップダウン・リストから［String］を選択します（選択されていない場合）。

    ［入力/チェックポイント］タブの［入力］表示枠に、AddResult という名前の入力プロパティが表示されます。

  2. さらに、MulResult という名前で入力パラメータを作成します。

    • ［名前］フィールドに MulResult と入力します。

    • ［タイプ］フィールドのドロップダウン・リストから［String］を選択します（選択されていない場合）。

    ［入力/チェックポイント］タブの［入力］表示枠に、MulResult という名前の入力プロパティが表示されます。

  3. ［追加］ボタンをクリックし、［出力プロパティの追加］を選択します。

  4. 出力パラメータの詳細を入力します。

    • ［名前］フィールドに Result と入力します。

    • ［タイプ］フィールドのドロップダウン・リストから［Decimal］を選択します。

  5. ［チェックポイント］表示枠に 128 と入力します。

先頭に戻る

カスタム・コード・アクティビティを既存のステップにリンクする

  1. 「［リンク元の選択］ダイアログ・ボックス（API テスト）」で、［AddActivity］ステップを選択します。右表示枠で、［結果］を選択して［OK］をクリックします。

    リンク元である Step.OutputProperties.AddActivity<番号>.Result が［AddResult］行に表示されます。

  2. このダイアログで、［乗算］ステップを選択します。右表示枠で、［結果］を選択して［OK］をクリックします。

    リンク元である Step.OutputProperties.MultiplyActivity<番号>.Result が［MulResult］行に表示されます。

先頭に戻る

カスタム・コード・アクティビティのイベントを作成する

  1. ［プロパティ］表示枠で、ドロップダウン・リストから［カスタム コード］アクティビティを選択します。キャンバスで［カスタム コード］アクティビティをクリックしても選択できます。

  2. ［プロパティ］表示枠で、［イベント］タブをクリックします。

  3. 「［イベント］タブ（［プロパティ］表示枠 - API テスト）」で、ExecuteEvent と AfterExecuteStepEvent で使用する標準設定のハンドラを作成します。これにより、CodeActivity<番号>_OnExecuteEvent と CodeActivity<番号>_OnAfterExecuteEvent という 2 つのイベントが TestUserCode.cs ファイルに追加されます。

  4. TestUserCode.cs ファイル内の CodeActivity_OnExecuteEvent で、次のテキストを入力します。

    decimal AddResult = AddActivity.Result;
decimal MulResult = MultiplyActivity.Result;
CodeActivity<番号>.Output.Result = AddResult*MulResult;

  5. このメソッドの最後の行にブレークポイントを入力します。

  6. TestUserCode.cs ファイル内の CodeActivity<番号>_OnAfterExecuteStepEvent で、次のテキストを入力します。

    decimal result = CodeActivity<番号>.Output.Result;

  7. このメソッドの最後の行にブレークポイントを入力します。

  8. テストを保存します。

先頭に戻る

テストを実行する

［実行］＞［実行］を選択するか、F5 キーを押します。

先頭に戻る

最初のブレークポイントで変数の値を確認する

  1. テストが最初のブレークポイントで停止したら、［表示］＞［デバッグ］＞［ローカル変数］を選択して、「［ローカル変数］表示枠」を開きます。

  2. ［ローカル変数］表示枠には、［加算］と［乗算］アクティビティの現在値が表示されます。AddActivity の現在値は 16、MultiplyActivity の現在値は 8 です。

    行のノードを展開すると、テスト実行で使用されているさまざまな項目の値を参照できます。

先頭に戻る

［ウォッチ］表示枠に変数を追加する

  1. ［TestUsercode.cs］タブで、AddResult というテキストを強調表示します。

  2. ［表示］＞［デバッグ］＞［ウォッチ］を選択して［ウォッチ］表示枠を開きます。

  3. 「［ウォッチ］表示枠」で、［新しいウォッチ式の追加］ボタンをクリックして Add Result と入力します。

    AddResult の式の行には、値に 16、タイプに［10 進数］と表示されます。

  4. ［新しいウォッチ式の追加］ボタンをもう一度クリックし、MulResult 変数を［ウォッチ］表示枠に追加します。この表示枠には、MulResult という式が値 8、タイプ［10 進数］と表示されます。

先頭に戻る

次のブレークポイントで変数の値を確認する

  1. ［実行］＞［続行］を選択するか、F5 キーを押して実行セッションを続行します。

  2. 実行セッションが次のブレークポイントで停止したら、CodeActivity<番号>.Output.Result というテキストを強調表示して［ウォッチ］表示枠に追加します。

    表示枠の変数の値は、128 と表示されます。

    前の手順で［ウォッチ］表示枠に AddResult と MulResult を追加しましたが、未定義なので［不正な式］と表示されます。この値は存在し、現在のイベントに関連付けられています。

  3. ［ローカル変数］タブをクリックします。Result の行の値は 128 と表示されています。これは、前の手順で入力したカスタム・コードで、Result は CodeActivity6.Output.Result に等しく、これが AddResult*MulResult に等しいことを指定したためです。

    さらに、実行セッションが一時停止した状態でエディタ内の変数名にカーソルを置くと、ツールヒントが開き、変数とプロパティの現在値が表示されます。

  4. ［実行］＞［続行］を選択して実行セッションを最後まで実行し、実行結果を表示します。

先頭に戻る