Share via


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).

NoteNote
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