Harness forms
How to support work object copying
|
|
C-2076 GROVS Follow these steps to allow users of your application to enter a new work object by copying information from an existing work object.
Through a model, you can control which properties in the existing work object are copied. (These instructions assume the harness rule is in the newer SmartFrames format.)
Add the Copy
icon to the harness
You can offer work object copying in your application through a labeled button at the bottom of the work object form or through an icon on the header. Development steps are similar.
1. Open the harness form to be altered, such as Perform, Review, or Confirm.
) in the Basic control group
(
) and select the Icon control
(
). Drag the icon
control to the top-right array of icons and drop it into
position.) in the Basic control group
() and select the Button control
(
). Drag the button control ) to the
bottom area of the wireframe harness or to a cell and drop it into
position. Complete the panel that appears.2. Select CUSTOM as the Type.
3. Select an icon or enter text for a button label. The recommended
icon is named iconCopy(
). BUG-4294 tooltip
4. Select CopyWork for the Do Action
field as the activity to execute when the icon or button is
clicked.
5. Complete parameters for this activity. Enter the Purpose key part of the harness rule that is to appear for the new work object, such as New or NewCovered.
6. Select In Current Window as the place where
activity results are desired. Do not select In Popup
Window. B-15592
7. Complete the ToolTip text and other fields in the panel as desired. See Icons — Placing an icon in a layout cell.
8. Save the Harness form.
9. Optionally, create a model rule named pyCopyDefault
in the work type of the objects to be copied. List all properties that
are to be copied from the current work object 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
object, such as the work object ID. MARTT 3/9/06
When users click the icon on a
work object form, the application presents a copy. The user can enter
data and submit the copy as another way to create a work object. The
form for the original work object is closed (and locks on it are
released; any unsubmitted changes are lost).
The new work object has the same work type as the original. Only one work object is covered. If the original work object is a cover, the new work object is also a cover, with no covered members.
The history of the new work object identifies the original work object, and the date and time of the copy.
If you don't create a model rule named pyCopyDefault, the standard model rule Work-.pyDefault is applied. This copies only pyLabel and pyDescription properties.
