在TestStand报告中添加步骤注释



主要软件:
主要软件版本: N/A
主要软件修正版本: N/A
次要软件: N/A

问题: 我想在我的报告中添加我的步骤注释,如何可以实现?

解答: 一般而言,步骤的注释只会出现在TestStand为序列文件(Tools » Sequence File Documentation)生成的文档中,而不会包括进生成的报告中。这使因为每一个步骤的注释都不是显示在树型视图上的属性(右键该步骤,再选择打开树型视图)。因此可以按照下面的步骤来将步骤注释包括在一个报告中。
  1. 覆盖SequenceFilePostResultListEntry的引擎回调函数

    通过选择Edit » Sequence File Callbacks并在该回调函数上双击来覆盖SequenceFilePostResultListEntry引擎回调函数。这样会将回调函数添加在序列文件中。当引擎添加序列文件中的某步骤的结果时,TestStand引擎就会调用整个回调函数。

    在你的客户端序列文件的View选项打开这个回调,并且选择 Parameters页。其中在下一个步骤中会用到的两个重要参数就是Step和Result containers. Step container代表当前步骤的属性,Result container则代表该步骤的结果列表。

  2. 在Result container中创建和插入一个新的"comment"属性

    在Main步骤组中的这个回调函数中,插入一个ActiveX动作步骤,参数设置如下:
    • Object Reference: Parameters.Result
    • Automation Server: NI TestStand API 3.5 (Ver 1.0)
    • Object Class: PropertyObject
    • Action: Call Method
    • Method: SetValString
    • Parameters (lookupString): "Comment"
    • Parameters (options): 1
    • Parameters (newValue): CommentOf(Parameters.Step)

    上述的ActiveX动作步骤引用了该步骤的结果列表,并且在结果列表中插入一个叫 "Comment"的属性. Parameters.Step中的Comment返回该特定属性对象的注释,并且被当作"Comment"属性的值来使用。

  3. 将新的属性添加入报告中 

    "Comment"属性现在已经包括进结果列表中,但是并没有自动地添加到报告中。因此我们还需要下面一个ActiveX的动作步骤,参数设置入下:
    • Object Reference: Parameters.Result
    • Automation Server: NI TestStand API 3.5 (Ver 1.0)
    • Object Class: PropertyObject
    • Action: Call Method
    • Method: SetFlags
    • Parameters (lookupString): "Comment"
    • Parameters (options): 0
    • Parameters (flags): 0x2000

    上述的 ActiveX动作步骤引用了该步骤的结果列表以及"Comment"属性. 标签参数设置为0x2000 来表示IncludeInReport标签。
当完成了上述步骤之后,步骤注释现在已经包括在报告中了,具体可参考附件的序列文件。

相关链接: KnowledgeBase 3SBHTOBJ: Adding Step Descriptions to TestStand Reports
Developer Zone Tutorial: Understanding and Modifying Result Collection
KnowledgeBase 3JT9NORY: What is a Callback in TestStand?

附件:


CommentInReport.seq - CommentInReport.seqATTIUNGZ - ATTIUNGZ



报告日期: 11/14/2005
最近更新: 11/14/2007
文档编号: 3RDFJH9F