The task is used to update the attributes of an EWM® work item. Store elements designate which attributes to update and the new values for those attributes. The task retrieves the specified work item, updates the work item’s attributes with the specified values, saves the work item, and returns the work item ID in the property specified.

Attributes

The task supports Team Build Attributes, Build Extensions Debugging Attributes, Build Extensions General Attributes, as well as, its own task specific attributes. Click on a link for more information on the common attributes.

The following table describes the task specific attributes for the task:

Task Specific Attributes
Attribute Description Required
property Name of the Ant property in which to store the work item ID. No
workItemId The ID of the work item to update. Yes

Store Elements

Store elements are specified within the element. Store elements designate which work item attributes to set and the values for those attributes. All Store elements are optional. At least one Store element is required. A name and value is required for each Store element. The name attribute specifies the name of an EWM work item attribute. The value attribute specifies the value of the EWM work item attribute. Some EWM work item attributes have options which are described below.

The following table describes the work item attributes that can be specified via Store elements, their name attribute value, their requirements, and their options:

The following table describes the Required Store Element Attributes and their possible values:

The following table describes the Optional Store Element Attributes and their possible values:

Store Element Notes

Examples

Add approvals to the work item 

<target name="task" if="run.task">
  
  <xt:updateWorkItem
      RepositoryAddress="${repositoryAddress}"
      userId="${userId}"
      passwordFile="${passwordFile}"
      processAreaName="IMS_SB_IMS"
      workItemId="${workitem}"
    >
    <xt:store name="approval" value="Tech"  approvalType="REVIEW" approvalApprover="djreilly@us.ibm.com" approvalDueDate="2015-06-01"/>
    <xt:store name="approval" value="Tech"  approvalType="REVIEW" approvalApprover="mra@us.ibm.com"/>
    <xt:store name="approval" value="Tech"  approvalType="REVIEW" approvalApprover="tlk@us.ibm.com"/>
    <xt:store name="approval" value="Test"  approvalType="REVIEW" approvalApprover="djreilly@us.ibm.com" approvalDueDate="2015-06-01"/>
    <xt:store name="approval" value="Doc"   approvalType="REVIEW" approvalApprover="djreilly@us.ibm.com" approvalDueDate="2015-06-01"/>
    <xt:store name="approval" value="Japan" approvalType="REVIEW" approvalApprover="djreilly@us.ibm.com" approvalDueDate="2015-06-01"/>
    <xt:store name="approval" value="SSC"   approvalType="APPROVAL" approvalApprover="djreilly@us.ibm.com" approvalDueDate="2015-06-01"/>
  </xt:updateWorkItem>
  
</target>

Result:

Approvals tab