访问和设置步骤输入、输出或检查点属性的值

相关项: API 测试

访问步骤属性

  1. 从“工具箱”窗格中，将要访问属性的活动拖到现有活动中，或将自定义代码活动或事件处理程序添加到现有活动中。确保自定义代码活动在要定义属性的活动之后。

  2. 在画布中选择步骤。

  3. 在“属性”窗格中，打开事件选项卡 。

  4. 在“事件”选项卡中，创建事件处理程序。“文档”窗格中将打开 TestUserCode.cs 文件。

  5. 在 TestUserCode.cs 文件的 TODO 部分，要使用 this 对象访问要设置属性的活动的属性，可使用以下语法:

    this.<活动名称>.Input.<属性名称>

    备注: 有关 this 对象的详细信息，请参阅 https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/this。

  6. 输入要设置属性的步骤名称，后跟 . 字符。

  7. 输入要设置属性的活动的属性名称，后跟 . 字符。

    在此示例中，为 ConcatenateStringsActivity 步骤设置 Prefix 和 Suffix 属性。

返回页首

访问步骤的父级活动

步骤的父级属性引用包含测试步骤的循环、条件或父级活动。

  1. 要访问活动的父级，请使用如以上访问步骤属性步骤所述的 this 对象。

  2. 不是输入步骤的属性，而是输入步骤的 Parent 属性。

  3. 如果要获取活动的父级循环，请使用以下语法输入 GetParentLoop 方法:

    this.<活动名称>.GetParentLoop();

以下代码将检索父级活动并将父级活动转换为字符串:

string ParentName = this.ConcatenateStringsActivity5.Parent.Name

返回页首

设置步骤的属性值

  1. 在画布中，选择要设置属性值的步骤。

  2. 在“属性”窗格中，打开事件选项卡 。

  3. 在“事件”选项卡中，创建事件处理程序。将打开 TestUserCode.cs 文件。

  4. 在 TestUserCode.cs 文件的 TODO 部分，使用以下语法输入参数/属性的参数值:

    this.<活动名称>.Input.<参数名称> = <参数值>;

    或

    this.<活动名称>.Output.<参数名称> = <参数值>;

    无法使用 this.<活动名称> 对象设置检查点值。必须改为使用 args.Checkpoint 对象。

    重要事项: 确保值类型与创建参数时输入的类型相同，即字符串参数必须具有字符串值。

测试运行时，UFT One 将在自定义代码步骤中指定的值传递到另一个活动中。

以下代码会为 ConcatenateStrings 活动设置 Prefix 和 Suffix 值:

CodeActivity6.Input.a = "Hello"; 
CodeActivity6.Input.b = "World"; 
this.ConcatenateStringsActivity4.Prefix = CodeActivity6.Input.a; 
this.ConcatenateStringsActivity4.Suffix = CodeActivity6.Input.b;

返回页首

运行时访问步骤的属性值

在测试运行期间，还可以在“输出”窗格中报告测试步骤的属性或参数的运行时值。这在测试运行期间监视特定操作或对象的值时很有用，无需停止或调试测试。

要执行此操作，请使用 UserLogger 对象:

  1. 将 OnAfterExecuteStep 事件的事件处理程序添加到要监视属性/参数值的步骤。

  2. 要在“输出”窗格使用 UserLogger 对象将值报告到编译日志中，可使用以下语法:

    Context.UserLogger.Info(<活动名称>.<属性名称>);

    备注: 使用事件处理程序或自定义代码中的 Context 对象可获取属性/参数的上下文值（即运行时值），而不是输入的值（例如，在“属性”窗格中输入的内容）。

编译日志显示在“输出”窗格中时，将看到作为编译日志一部分显示的属性/参数值行。注意，“输出”窗格不会列出带有值的属性/参数名称，因此，必须在查找该值的代码所在的步骤内部搜索。

例如:

以下代码将检索 ConcatenateStrings 活动的 Prefix 属性的值:

Context.UserLogger.Info(ConcatenateStringsActivity4.Prefix);

返回页首

启用或忽略选定的检查点 —— 可选

可以指示 UFT One 忽略任何测试步骤的检查点。如果需要在启用和忽略不同测试运行检查点之间切换，此选项将很有用。

使用 Checkpoint 对象访问检查点的属性:

  1. 在画布中，选择要启用或忽略检查点的步骤。

  2. 在“属性”窗格中，选择事件选项卡 。

  3. 在“事件”选项卡中，创建 OnCodeCheckpointEvent 事件的事件处理程序。将打开 TestUserCode.cs 文件。

  4. 在 TestUserCode.cs 文件的 TODO 部分中，使用以下语法启用或忽略事件的检查点:

    args.Checkpoint.RunUICheckpoints = true (用于启用检查点)

    或

    args.Checkpoint.RunUICheckpoints = false (用于禁用检查点)

返回页首

设置检查点的值

除了启用或忽略检查点之外，还可以设置检查点的值（预期或非预期）。此操作对于验证应用程序是否按预期工作和不允许发生意外行为都很有用。

  1. 启用步骤的检查点，如以上启用或忽略选定的检查点 —— 可选所述。

  2. 在包含启用检查点的代码的行 (args.Checkpoint.RunUICheckpoints = true) 之后，使用以下语法输入检查点值:

    args.Checkpoint.Assert.Equals("<实际值>", "<预期值>");

    有关 UFT One 中 args 对象支持的方法的详细信息，请参见Assert 对象。

  • 以下代码将为 ConcatenateStrings 步骤设置检查点的值:

    
args.Checkpoint.Assert.Equals(this.ConcatenateStringsActivity4.Prefix+this.ConcatenateStringsActivity4.Suffix, this.ConcatenateStringsActivity4.Result);

  • 此代码将检查前缀的文本值 (字符串的字母顺序) 是否少于后缀。要确保检查点成功，请输入一个大于后缀的前缀值，例如前缀为 aa，后缀为 bb。

    
args.Checkpoint.Assert.Less("Concatenate test", this.ConcatenateStringsActivity4.Prefix, this.ConcatenateStringsActivity4.Suffix,
           "The prefix is less than the suffix");

返回页首

另请参见: