COPY Element (Work Item Type Definition Schema)

Specifies a value to be copied into the current field.

<xs:element name="COPY" type="CopyRule"/>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
for	Optional PlainRule attribute. The name of a user or group to whom this rule applies.
not	Optional PlainRule attribute. The name of a user or group to whom this rule does not apply.
from	Required CopyRule attribute. The source of the value. Specifies whether to copy the default value from the value attribute, the field attribute, the system clock, or the current user. If you specify "value" or "field," you must also include the value or field attribute, respectively.
value	Optional CopyRule attribute. You must define this attribute if the from attribute has "value" as its value. The value to copy. Can be empty.
field	Optional CopyRule attribute. You must define this attribute if the from attribute has "field" as its value. The reference name of the field to copy. The reference name must match the reference name defined in the field definition's FIELD element. For more information, see FIELD Element (WORKITEMTYPE Element). Note If the work item is in the process of being changed, this element rule may select either the current or previous value from the source field.

Child Elements

None

Parent Elements

Element	Description
FIELD Element (WORKFLOW)	Required element. References a work item field definition and the rules and conditions that apply to the field. The reference is based on the STATE, TRANSITION, DEFAULTREASON, or REASON element that its parent FIELDS element is a child of.
FIELD Element (WORKITEMTYPE Element)	Required element. Defines a work item field and specifies the rules and conditions that apply to it.

Remarks

COPY is an optional child element of FIELD (Work Item Type Definition Schema) and FIELD (WORKITEMTYPE element).

Example

<COPY for="user name" not="user name" from="value | field | clock | currentuser" value="value" field="field reference name" />

Element Information

Namespace	https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef
Schema Name	Work Item Type Definition
Validation File	WorkItemTypeDefinition.xsd
Element Type	CopyRule Complex Type (Work Item Type Definition Schema)
Can Be Empty	Not applicable

See Also

Concepts

Field Rules, Defaults, Qualifiers, Lists, Actions, and Matching Patterns

Specifying Field Defaults

Other Resources

Setting Conditions on a Work Item Field