Harness forms - How to support work item copying
Follow these steps to allow users of your application to enter a new work item by copying information from an existing work item. Through a data transform, you can control which properties in the existing work item are copied.
These instructions assume the harness is in the SmartFrames format.
You can offer work item copying in your application through a labeled button at the bottom of the user form or through an icon on the header. Development steps are similar.
Open the harness form to be altered, such as Perform, Review, or Confirm, and then perform one of the following actions:
- To add an icon, select the Image control from the Data display list, and then drag the image control onto the top-right array of icons and drop it into position.
- To add a button, select the Button control from the Action list, and then drag the button control onto the bottom area of the wireframe harness or to a cell and drop it into position. Complete the panel that appears.
CUSTOMas the Type.
Select an icon or enter text for a button label. The recommended icon is named
CopyWorkfor the Do Action field as the activity to execute when the icon or button is clicked.
Complete parameters for this activity. Enter the Purpose key part of the harness that is to appear for the new work item, such as New or NewCovered.
Select In Current Window as the place where activity results are desired. Do not select In Pop-up Window.
Complete the ToolTip text and other fields in the panel as desired.
Save the Harness form.
Create a data transform named
pyCopyDefaultin the work type of the objects to be copied, and then specify Set actions in the data transform for all properties that are to be copied from the current work item to the new object.
These may or may not correspond to fields that users can enter or overtype. Be careful not to copy values that are unique to a work item, such as the work item ID.
When users click the Copy icon on a user form, the application presents a copy. The user can enter data and submit the copy as another way to create a work item. The form for the original work item is closed (and locks on it are released; any unsubmitted changes are lost).
The new work item has the same work type as the original. Only one work item is covered. If the original work item is a cover, the new work item is also a cover, with no covered members.
The history of the new work item identifies the original work item, and the date and time of the copy.
If you don't create a data transform named pyCopyDefault, the standard data transform Work-.pyDefault is applied. This copies only pyLabel and pyDescription properties.
In advanced cases, if the data transform doesn't set a value for the pyFlowName property, the system starts the flow on the new work item recorded in the pyFlowName value of the original work item.
Your application can override the Work-.CopyWork activity to provide additional capabilities if needed by your application.