通过

管理创建或修改工作项的权限

  • 项目

可以通过将 VALIDUSER 元素应用于人名字段来控制谁可以创建或修改工作项。 如果指定此元素时，指明用户的哪个用户或用户组中指定作为值为字段。 可以将此元素设置为支持可选的 group 特性，此特性要求分配给该字段的人必须是所指定组的直接成员或间接成员。 默认情况下，可以在该字段中指定**“Team Foundation Valid Users”**组的所有成员。

VALIDUSER 元素仅对 String 字段类型有效。 可以将此规则指定为 FIELD（定义）或 FIELD（工作流）元素的子元素。

主题内容

  • 人名字段

  • VALIDUSER 语法结构

  • VALIDUSER 特性

  • 通过允许为字段保持现有值来避免验证错误

备注

规则应用于 FIELD 定义，使用 witadmin 命令行工具导入和导出工作项类型的定义。请参见 自定义和管理工作项类型 [witadmin]。

人名字段

仅当引用人名字段时才可使用 VALIDUSER 规则。 下面的系统字段是人名字段的示例：

  • 激活者 (System.ActivatedBy)

  • 指派给 (System.AssignedTo)

  • 授权为 (System.AuthorizedAs)

  • 更改者 (System.ChangedBy)

  • 关闭者 (System.ClosedBy)

  • 创建者 (System.CreatedBy)

除了系统字段，还可以创建自定义字符串字段，以及将其用作人名字段。 同时，还可以同步自定义人名字段与 Active Directory。 有关更多信息，请参见管理工作项字段 [witadmin]。

VALIDUSER 语法结构

使用 VALIDUSER 元素时，可以指定人名字段必须包含**“Team Foundation Valid Users”**组或所指定其他组的成员的名称。

通过分别为 for 或 not 特性指定用户或组，可以允许或限制将规则应用于修改工作项的用户。

<VALIDUSER group="groupName" for="userName" not="userName" />

所有特性都是可选的。 所有特性都必须是包含 1 至 255 个字符的文本字符串。 可以使用标记指定组。 有关更多信息，请参见用标记引用用户和组。

备注

工作项字段不区分不同域中的用户标识。因此，在使用 VALIDUSER 规则的字段中输入的“Example1\jaepak”和“Example2\jaepak”将被视为同一个用户。但是，Visual Studio Team Foundation Server 中其他位置会区分不同域的用户标识。

返回页首

VALIDUSER 特性

可以指定是否限制 VALIDUSER 规则的应用对象。 如果不定义可选特性之一，则 Team Foundation Server 中的全部有效用户和组均可修改该字段。

特性

描述

for

可选。 指定 Team Foundation 中应用规则的用户或组的名称。 有效名称是包含 1 至 255 个字符的文本字符串。

模式值：^[^\\]+\\[^\\]+$

模式值示例：域\用户 ID

not

可选。 指定 Team Foundation 中不应用规则的用户或组的名称。 有效名称是包含 1 至 255 个字符的文本字符串。

模式值：^[^\\]+\\[^\\]+$

模式值示例：域\用户 ID

group

可选。 组的名称。 用户可以指定此组的成员，则人名字段的值。 有效名称是包含 1 至 255 个字符的文本字符串。

模式值：^[^\\]+\\[^\\]+$

模式值示例：域\组 ID

返回页首

通过允许为字段保持现有值来避免验证错误

下面的示例演示如何确保仅将有效用户分配给工作项，如何将**“指派给”**字段的默认值设置为创建该工作项的用户，以及如何提供包括团队项目的“Contributors (参与者)”组成员的名称的选取列表。 通过指定 ALLOWEXISTINGVALUE 元素，可以避免在成员离开团队以及不再注册为项目参与者时本会出现的验证错误。

<FIELD name="Assigned To" refname="System.AssignedTo" type="String" syncnamechanges="true" reportable="dimension">
   <HELPTEXT>The user who is working on this work item</HELPTEXT>
   <ALLOWEXISTINGVALUE />
   <VALIDUSER />
   <ALLOWEDVALUES expanditems="true" filteritems="excludegroups">
      <LISTITEM value="Active" />
      <LISTITEM value="[project]\Contributors" />
   </ALLOWEDVALUES>
   <DEFAULT from="field" field="System.CreatedBy" />
</FIELD>

请参见

参考

管理工作项字段 [witadmin]

概念

用标记引用用户和组

其他资源

使用字段规则