Work Item Tasks

This section covers the Build Extensions Ant tasks that extend the EWM Ant toolkit by offering the build the ability to create work items, update work items, copy work item attribute data from one work item to another, fetch work item attribute data into Ant build properties, and search for work items returning the results of the search as a list work item IDs in a build property.

• createWorkItem
  The createWorkItem task creates an EWM work item. Store elements designate which attributes to set and the initial attribute value. The createWorkItem task creates the specified work item, sets the work item attributes with the specified value, saves the work item, and returns the work item ID in the specified property. All required values for the work item must be specified.
• updateWorkItem
  The updateWorkItem task updates the attributes of an EWM work item. Store elements designate which attributes to update and the new values for those attributes. The updateWorkItem task retrieves the specified work item, updates the work item attributes with the specified values, saves the work item, and returns the work item ID in the specified property.
• copyWorkItem
  The copyWorkItem retrieves attribute values from one EWM work item and copies them into another EWM work item. Value elements designate which work item attributes to retrieve and copy. The copyWorkItem task fetches both work items using the values specified for the fromWorkItemId and toWorkItemId attributes and sets the specified attributes in the toWorkItem with the values from the fromWorkItem. Store elements can be included when invoking copyWorkItem. Store elements are used to designate attributes to update in the toWorkItem thus combining the copy and updates processes into a single task.
• getWorkItem
  The getWorkItem task retrieves EWM work item attribute values. Fetch elements designate which work item attributes to retrieve and the name of the Ant property in which to return the attribute values. The getWorkItem task fetches the specified work item by workItemId and sets the specified Ant properties with the values of the work item attribute.
• queryWorkItem
  The queryWorkItem task finds and returns EWM work item IDs. The process to find the work items uses the standard query interface. The configuration of the query is handled by Operator Elements and Query Elements. Operator elements control the logic of the query; grouping query elements to be AND’ed or OR’ed. Query elements control work item filtering. The IDs of the work items found by the query are returned in a comma separated list in the specified Ant property.