FIELD（定义）元素引用

项目
06/09/2015

使用 FIELD（定义）元素，可以定义工作项字段和指定应用于它的规则和条件。分配给字段的特性确定其数据类型以及其是否可用于包含在报表中。

备注

有关您用于在状态更改或工作流转换期间指定字段规则和条件的 FIELD（工作流）元素的信息，请参见 FIELD（工作流）元素。

架构层次结构

WITD

WORKITEMTYPE

FIELDS

FIELD

<FIELD name="fieldDisplayName" 
refname="fieldReferenceName" 
type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" 
syncnamechanges ="true | false" 
reportable="Dimension | Detail | Measure"
formula="sum"
reportingname="ReportingDisplayName" 
reportingrefname="ReportingReferenceName" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

特性和元素

下列各节描述了特性、子元素和父元素。

特性

name

必需。工作项查询的下拉菜单中显示的字段的友好名称。友好名称在团队项目中定义的所有字段中必须是唯一的。此外，友好名称可能与工作项窗体上字段旁显示的标签不同。有关详细信息，请参阅Control XML 元素引用。

特性类型为 typelib:FieldName。最小长度：1；最大长度：128。

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

模式值示例：Assigned To

refname

必需。唯一标签，用于将字段与在团队项目集合中定义的所有其他字段区分开来。

有关友好名称和引用名称的其他要求和限制，请参见工作项跟踪对象的命名约定。

特性类型为 typelib:ReferenceFieldName。最小长度：1；最大长度：70。

模式值：^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

模式值示例：Company.IssueType

type

必需。指定字段接受的数据类型。

备注

必须为具有相同 reportingrefname 的不同项目集合中的字段分配相同的 type 值。如果这些值不同，则在处理数据仓库时可能发生数据冲突。有关详细信息，请参阅解决数据仓库中发生的架构冲突。

下表列出了此特性的有效值：

值	用法
DateTime	根据协调世界时 (UTC) 时刻指定日期。
Double	指定浮点值。
GUID	指定将包含一个唯一标识符的字段。
History	支持讨论线索和跟踪其他历史记录信息。备注 System.History 字段是使用此数据类型的唯一字段。不能使用此数据类型定义自定义字段。
HTML	支持格式文本数据的捕获并用于更长的文本描述（如工作项描述）。
Integer	指定 32 位有符号整数值。
PlainText	支持输入可包含超过 255 个 Unicode 字符的文本字符串。
String	支持输入最多可包含 255 个 Unicode 字符的文本字符串。 String 字段用于标签或者其他最长为一行的短文本字符串。
TreePath	指定在分层结构或树结构中显示条目的字段，例如显示产品的区域和迭代路径所需的字段。若要定义子节点，请参见添加和修改区域和迭代路径。备注只有 System.AreaPath 和 System.IterationPath 字段使用此数据类型。不能使用此数据类型定义自定义字段。

syncnamechanges

可选。指定是否将工作项字段用于存储在 Active Directory 或一个工作组中做出更改后要进行更新的名称。此选项仅当 type="String" 时有效。特性类型为 xs:boolean。

指定 true 可启用数据字段同步，指定 false 可禁用数据字段同步。

reportable

可选。指定字段中的数据是否可用于包含在报表中。具有默认值 None 的字段既不导出到关系型数据仓库中，也不针对 SQL Server Analysis Services 多维数据集进行处理。有关可报告字段的详细信息，请参见添加或修改工作项字段以支持报告。

备注

必须为具有相同 reportingrefname 值的不同项目集合中的字段分配相同的 reportable 值。如果这些值不同，则在处理数据仓库时可能发生数据冲突。有关详细信息，请参阅解决数据仓库中发生的架构冲突。

下表列出了此特性的有效值：

Value	用法
Detail	可以为类型为 DateTime、Double、Integer 或 String 的字段指定。该字段中的数据将移至关系仓库数据库的“工作项”和“当前工作项”表中，但不会移至 Analysis Services 多维数据集中。此类型非常适合无限制的文本字段，因为您可在报表中使用这些字段，而不会使多维数据集明显变大。
Dimension	可为类型为 DateTime、Integer、String 或 TreePath 的字段指定。此字段中的数据将作为工作项维度的特性进入到关系仓库数据库和 Analysis Services 多维数据集，以便可以使用这些数据来筛选报告。将此类型用于包含有效值列表的字段。 dimension 类型的一个典型示例是“工作项类型”。
Measure	仅将 measure 类型用于 Integer 和 Double 字段。 Measure 是报告中的数值型的值。处理 Analysis Services 多维数据集时，将预先计算 reportable 特性设置为 measure 的字段上的数据。例如，“工作项”和“当前工作项”度量值组包含以下字段的累计数据：初始估计、剩余小时数和已完成小时数。指定 measure 时，必须指定 formula 特性。
None	如果您不希望将字段用于包含在报表中，请指定 None。这是默认分配。

formula

可选。 measure 可报告类型的聚合类型。唯一有效的值为 sum，其将基于设置返回所有值的和。

reportingname

可选。指定在报表中显示的名称。如果您未指定值，则将使用分配给 name 特性的值。

备注

必须为具有相同 reportingrefname 的不同项目集合中的字段分配相同的 reportingname 值。如果这些值不同，则在处理数据仓库时可能发生数据冲突。有关详细信息，请参阅解决数据仓库中发生的架构冲突。

特性类型为 typelib:FieldName。最小长度：1；最大长度：128。

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

模式值示例：Assigned To

reportingrefname

可选。指定处理可报告字段时使用的引用名称。如果您未指定值，则将使用分配给 refname 特性的值。

您可使用此特性来合并或分离将处理到数据仓库中的字段。若要合并两个具有不同引用名称且在不同项目集合中定义的字段，请为这两个字段分配相同的 reportingrefname。若要分离两个具有相同的引用名称但在不同的项目集合中定义的字段，请为每个字段分配一个不同的 reportingrefname。

您应尽可能合并字段以最大程度地减少仓库中的字段数，并遵循 1024 个可报告字段的最大限制。您可以生成带合并字段的跨组报表。