假定您定期查询为每一位团队成员分配的工作。您可以为每一位团队成员创建查询,但是这会导致彼此之间略有差异的多个查询。 更好的选择是使用提示查询对此差异进行参数化,比如说,“系统 ABC 缺陷分配给 user。” 启动查询时,您会看到团队成员的列表。
占位符用于定义提示查询。占位符关键字是每次运行查询时由用户完成的查询中的位置。例如,假定您是团队负责人,团队中有 Tom、Jane 或 Joe。您原先运行单独的查询以了解有关工作负载的信息 - 您针对分配给每个团队成员的 CR 单独运行查询。 现在,您可以创建一个查询,提示您输入解决者的名称,然后针对该团队成员显示分配的 CR。
要构造此查询,请使用占位符关键字来代替具体名称。占位符关键字使用 %integer 形式,例如:%1、%2 和 %3 等。占位符关键字值必须始终由您在运行查询的过程中提供。占位符关键字不同于标准关键字,后者由系统自动提供。
占位符关键字和标准关键字(例如,%username)可以在同一个查询字符串中混用。占位符通过其独特的模式来识别,占位符始终为一个整数。例如,如果您要在查询中包含一个百分比,那么 %% 解释为字面上的百分比符号。输入 keyword='%%1' 会搜索带有关键字 %1 的 CR。单个 % (%1) 表示一个占位符,用户必须在此提供值之后才能运行查询。
用作为占位符的整数的编号用于确定请求您提供占位符值的顺序。在查询中使用整数的顺序与此无关。在此示例中,查询 release='%2' and owner='%1' 会提示您先输入所有者值,然后再输入发行版值。
在同一个查询中,占位符是可复用的。针对每个唯一的占位符,仅提示您一次。系统会将相同占位符的每一次出现均替换为相同的值。
指定占位符的最常用方式是从提示查询的现有值中进行选择。选择对应于您要在查询中所使用信息的属性名称。例如,从已分配 CR 的团队成员中进行选择。您可以选择解决者作为要在查询中使用的属性。系统会提示您数据库中的用户名。然后,您可以选择要查询的团队成员,并运行查询。无需重新定义查询,您就可选择另一个要查询的团队成员。
在数据库中进行更改时,会使这些属性保持最新状态。例如,如果在生命周期编辑器中修改了属性类型,那么使用该属性的占位符会自动更新以反映更改。
您可以在定义占位符时选择类型(相对于选择属性),创建定制占位符。选择类型时,会定义占位符输入是采用字符串、日期还是列表框的形式。收集信息后,该设置可确定占位符值。
例如,您可以创建定制列表框。选择列表框作为类型,然后输入一组要在提示中显示为列表框选项的值。 接着,为占位符值设置可管理的选项集,而不是每次运行提示查询时都输入自由格式字符串。占位符列表框不会共享,因为它们仅用于特定提示查询(为其创建了这些占位符列表框)的特定占位符。