Show all
Used in composite portals, a section containing a Work Area control supports the runtime presentation of work object forms and worklists. Two formats are available:
- Single Document Interface (SDI) — The runtime contents of the cell are produced by a single harness rule.
- Multiple Document Interface (MDI) — The runtime contents of the cell are produced be one or more harness rules, each identified by a tab. One tab is frontmost.
For an example of the MDI Work Area, experiment with the User portal, a composite portal. This portal has a single space, defined by the harness rule Data-Portal.WorkUser. The section Data-Portal.UserCenterPanel defines the Work Area.
Follow these steps to include a Work Area control in a composite portal. This facility depends on rules of various types:
- The standard HTML property rule WorkArea.
- Optionally, a style sheet saved as a text file rule. (In most cases, make style changes using the Application Skin wizard rather than through a separate style sheet.)
- A section rule that contains the control
- A composite portal. (See How to create a composite portal.)
Step 1. Drag and drop the Work Area
control
Create a section rule to hold the Work Area control. For the Applies To class, select @baseclass, Data-Portal, or a Work- class.
A new section contains an initial layout, in Smart Layout format. From the Layout tab:
- Add a second layout, of type
Free Form with one row and one column, below the Smart Layout.
- Delete the original Smart Layout.
- Click the down-arrow (
) at the right end of the
Advanced control group (
) and select the
Work Area control (
).
- Drag the control. When
the pointer changes shape to indicate that you can drop the
layout, release the mouse button.
Step 2. Complete the Cell Properties panel
— Top fields
Parameters to the standard HTML property rule WorkArea control the display.
Field
|
Description
|
| Property
|
Retain the placeholder property pyTemplateDocumentView. (This property is not used.)
|
| Display As
|
Retain the default HTML property rule WorkArea. Click the magnifying glass icon ( ) to enter parameters for the control. Complete the following parameters:
Parameter
|
Description
|
ID
|
Not used. Leave blank.
|
Tabbed
|
 Select:
No to create a Single Document Interface control, allowing the user to open only a single work object form.Yes to create a Multiple Document Interface control, allowing the user to open multiple tabbed work objects.
|
Sizing
|
Select Stretch in most cases to cause the runtime presentation to expand to the entire height offered by the enclosing section.
Select Fixed to limit the runtime presentation to a fixed height in pixels; scroll bars appear at runtime as needed.
|
| Open by Default
|
 If the Tabbed parameter value is Yes, complete at least one row of the Open by Default array to label and identify the contents of each tab. Order is significant.
|
Label
|
Enter brief text to appear as the label of this tab.
|
Harness Class
|
Identify the Applies To key part of a harness rule.
|
Harness Name
|
Identify the Purpose key part of a harness rule.
|
Auto Refresh
|
Select to cause automatic refresh of the runtime harness display when the user clicks the tab to make it frontmost.
|
Thread
|
Optional. If the Tabbed parameter value is No, you can force execution to occur in a specific requestor Thread. Enter the Thread name.
Leave blank in most cases to use the default Thread, Standard.
|
Default Action
|
If the Tabbed parameter value is No, select to determine the automatic processing that is to occur when the section is initially presented:
None — No automatic processing; the form area is initially empty. Display — Present a work object form.Create New Work — Start a flow execution that creates a new work object.Get Next Work — Search for an appropriate assignment to present to this use next.
|
If you selected Display for the Document Action parameter, complete these additional parameters:
Parameter
|
Description
|
Class Name
|
Identify the Applies To key part of a harness rule.
|
Harness Name
|
Identify the Purpose key part of a harness rule.
|
Read Only
|
Select to present the runtime harness display in read-only mode, disallowing all input.
|
Page
|
Optional. Identify a clipboard page name to support the runtime harness display.
|
Model
|
Optional. Identify the second key part — Model Name — of a model rule to provide initial values on the clipboard page. To find this model at runtime, the system uses the Class Name value as the first key part.
|
Parameters
|
Optional. You can pass parameter values to sections within the harness using a special syntax:
paramname1=paramvalue1; paramname2=paramvalue2; ...
where paramname is the parameter name and paramvalue is a literal constant within double quote characters, or a property reference of the form pagename.propname. For example:
Length="20"; Width=pyWorkPage.Width;
|
If you selected Create New Work for the Document Action parameter, complete these additional parameters to identify the starter flow:
Parameter
|
Description
|
Class Name
|
Identify the Applies To key part of a flow rule that creates a new work object, as a literal value or a property reference.
|
Flow Name
|
Identify the Flow Type key part of a flow rule that creates a new work object, as a literal value or a property reference.
|
Parameters
|
Optional. You can pass parameter values to the flow rule using a special syntax:
paramname1 = paramvalue1; paramname2=paramvalue2; ...
where paramname is the parameter name and paramvalue is a literal constant within double quote characters, or a property reference of the form pagename.propname. For example:
Length="20"; Width=pyWorkPage.Width;
|
If you selected Get Next Work for the Document Action parameter, complete an additional parameters:
Parameter
|
Description
|
Parameters
|
Optional. You can pass parameter values to the Work-getNextWorkObject activity (or your activity built to perform such processing) using a special syntax:
paramname1=paramvalue1; paramname2=paramvalue2; ....
where paramname is the parameter name and paramvalue is a literal constant within single quote characters, or a property reference of the form pagename.propname. For example:
Length="20"; Width="200";
|
|
| Behavior
|
Leave blank. Not used.
|
3. Complete the Cell Properties panel
— General tab
4. Complete the Cell Properties panel
— Advanced tab
About Harness rules
About Section rules
Harness and Section forms