Back Forward Item Node type
Completing the Node Details fields
 

About Navigation rules

  Show all 

XXXXXXXXXXX Need to further refine Show Harness as Build 301 doesn't show options XXXXXX

Use the Action tab of the Node Details window to specify the action to be performed when that node is selected at run-time in the user interface (for example, when a user clicks a menubar choice in a portal). The Action tab is available when types Item, Item List, and Selected Item are selected in the Type list.

Use the Advanced tab to specify additional details about the presentation of this node at run-time; for example, an icon to display on the node.

Action tab

The actions for the Separator type are described in Navigation form — Completing the Editor tab. For types Item and Item List, use the Action drop-down list to select one of the following options:

  • None
  • Open Landing Page
  • Open List
  • Create New Work
  • Open Rule
  • Open Rule By Name
  • Open Rule By Keys
  • Run Script
  • Open URL In Window
  • Open Wizard
  • Open Work By Handle
  • Open Work Item
  • Open Local Action
  • Open Assignment
  • Refresh Section Seen in 6.2 build 2011-Jan-26
  • Show Harness GRP-23547

  Open Landing Page

The Open Landing Page choice is only applicable in portals defined with the Developer role (for example the Developer or BusinessAnalyst portal rules). The Open Landing Page choice does not apply when the navigation rule is used in portals defined with the User role. See About Portal rules.

Field

Description

Action Choose Display to open a landing page for display, or CreateNewWork to create a new work object based on a landing page.
Name Enter a unique name for the landing page. Attempting to open a landing page while a landing page with the same Name value is open will result in the new landing page overriding the tab in which the already open landing page was displayed.
Class
  • For Action set to Display: Select the class on which the harness for the landing page is based.
  • For Action set to CreateNewWork: Select the class on which the flow run to create the work object is based.
Harness Name Applicable when Action is set to Display: Select the harness that the landing page is built on.
Model Applicable when Action is set to Display: Select the model used to generate the landing page.
Page Applicable when Action is set to Display: Specify an existing page.
Read Only Applicable when Action is set to Display: Select to display a read-only harness.
Flow Name Applicable when Action is set to CreateNewWork: Specify the name of the flow used to create new work.
Level A Enter a value to work with a when condition defined to open the selected item in a specified tab on the landing page.
Level B Enter a value to work with a when condition defined to open the selected item in a specified tab on the landing page.
Level C Enter a value to work with a when condition defined to open the selected item in a specified tab on the landing page.
Parameters
Name Specify additional parameters to pass to the harness or flow.
Value Specify additional parameter values to pass to the harness or flow.

  Open List

Field

Description

Action Open List
Class Select the class of a list view to be opened.
Purpose Required. Select the Purpose (second key-part) of the list view to be opened from the menu.
Action Choose Refresh, Redisplay, or Sort.
Header Select to display the list view header.
Parameters
Name Specify additional parameters to pass to the list view.
Value Specify additional parameter values to pass to the list view.

  Create New Work

Field

Description

Action Create New Work
Class Name Select the class that contains the flow you wish to start.
Flow Name Required. Select the flow to start when this node is selected.

  Open Rule

Field

Description

Action Open Rule
Handle Select the name or handle of the rule you wish to open.
Resolved By Select Name, Handle, or Handle By Condition to specify how the rule is located.
Handle Condition Applicable for Handle By Condition: Select a when condition to define when a rule should be resolved by handle.

  Open Rule By Name

Field

Description

Action Open Rule By Name
Class Select the class in which the rule is saved.
Instance Name Required. Select the name of the rule you wish to open.

  Open Rule By Keys

Field

Description

Action Open Rule By Keys
Class Required. Specify the class that has keys defined.
Key Read only, based on the keys defined on the class rule form for the class selected in the Class field.
Value Enter the key value that pertains to the rule you wish to open.

  Run Script

Field

Description

Action Run Script
Function Required. Enter the clipboard property or literal reference that contains the function you wish to run.
Parameters
Name Specify additional parameters to pass to the script function.
Value Specify additional parameter values to pass to the script function.

  Open URL in Window

Field

Description

Action Open URL In Window
Use Alternate Domain Select to specify an alternate domain for the URL to open. When selected, select a URL in the Alternate Domain URL field.

Use the Querystring section to specify the name and value of a query string for the alternate domain URL.

Use Primary Page Select to invoke an activity based on the contents of the primary page when this node is selected.
Activity Name Select an activity to return an HTML stream that will be shown in the opened window.
Window Properties
Window Name Specify a text string to define the name of the opened window.
Replace History Select to erase the history of the opened browser window.
Height Enter a numerical value to represent the height in pixels of the opened window
Width Enter a numerical value to represent the width in pixels of the opened window
Top Enter a numerical value to represent the offset in pixels from the top of the screen
Left Enter a numerical value to represent the offset in pixels from the left of the screen.
Resizable Select to enable the opened window to be resized.
Scrollbars Select to enable scrollbars in the opened window.
Location Bar Select to enable the location bar in the opened window.
Menu Bar Select to enable the browser's menu bar in the opened window.
Status Bar Select to enable the browser's status bar in the opened window.
Tool Bar Select to enable the browser's tool bar in the opened window.

  Open Wizard

Field

Description

Action Open Wizard
Class Required. Select the class of the wizard. This class name will begin with PegaAccel-.
Parameters
Name Specify additional parameters to pass to the wizard.
Value Specify additional parameter values to pass to the wizard.

  Open Work By Handle

Field

Description

Action Open Work By Handle
Handle Required. Select the handle of a work item, beginning with the class name.

  Open Work Item

Field

Description

Action Open Work Item
ID Required. Specify the full ID of a work item.

 Open Local Action

Field

Description

Action Open Local Action
Using Page Enter a page from the Pages & Classes tab to use when invoking the local action.
Class Name Specify the built-on class of the flow action.
Local Action Select the flow action to be triggered.

 Open Assignment

Field

Description

Action Open Assignment
Key Enter the key of the assignment you wish to open.

 Refresh Section

Field

Description

Action Refresh Section
Target Select the section to be refreshed as a result of clicking on the item. Select either This Section to refresh the current section or select Other Section to refresh a specified section.
Using Page Available when Other Section is selected for the Target field. Optional. Specify the page and class of the section to be refreshed.
Section Available when Other Section is selected for the Target field. SmartPromptSelect the section to be refreshed.
Pre-activity Optional. SmartPromptSelect an activity to run before refreshing the section. If the activity uses parameters, enter their values.

 Show Harness

Field

Description

Action Show Harness
Target Specify the target location where the specified harness displays as a result of clicking on the item. Select:
  • Pop-Up Window - Displays the harness in a new browser window
  • Replace Current - Replaces the current tab or work area contents with the new harness, with the option to save (submit) the current data before the new harness is displayed
  • New Document - Opens the harness with the option to display in a named tabXXXXXX Clarify with development. This was copied from Control form - Completing the Control tab because it should be the same options as pxButton
Tab Name Available for Replace Current and New Document targets. SmartPromptSpecify the tab to be replaced. If this value matches the name of an open tab, the new harness replaces the tab. Otherwise, the new harness appears in a new tab.
Class Available for a New Document target. SmartPromptSpecify the class of the harness.
Harness SmartPromptSelect the harness to display.
Read Only Select Yes if you want the harness contents to display in read-only mode. (For a Pop-Up Window target, if set to No you must enter a window name.)
Submit Current Available for a target of Replace Current. Select Yes to specify that the current contents is saved before the harness replaces it.
Window Name Available if Pop-Up Window is selected for the Target. Enter a name that the system uses to identify a browser window. If a window of that name is open, the new harness replaces the contents of that window. Otherwise, the system opens a new browser window and displays the harness in that window.
Window Width Available if Pop-Up Window is selected for the Target. Enter a positive integer to set the window width in pixels. If you leave this and the Window Height field blank, the system replicates the dimensions of the current window.
Window Height Available if Pop-Up Window is selected for the Target. Enter a positive integer to set the window height in pixels. If you leave this and the Window Width field blank, the system replicates the dimensions of the current window.
Key Optional. Available for a New Document target. SmartPromptSpecify the key value (pxInsName) of a data instance you want automatically opened as the new primary page when the harness is displayed. The system uses this value and the Class value to identify the data record. This action executes before a pre-activity (if one is defined).
Pre-activity Optional. SmartPromptSpecify an activity to run before displaying the harness. If the activity uses parameters, enter their values.

Advanced tab

Use the Advanced tab to specify additional details about the presentation of this node at run-time; for example, an icon to display on the node.

Field

Description

Icon Class Enter the CSS class that contains the icon to be used for this node in a menu.
Refresh on Update Select this check box to have the navigation refresh automatically when the user selects this node.
Selection Select Checkmark to enable a single selection, or Group to enable multiple items to be selected.
  • Optional: For Checkmark or Group, in the Selected When field, specify a when condition to define when the check mark is shown for this node.
  • Optional: For Group, in the Group ID field, enter an identifier for the selected group.
Show-When Select a when to define when the node is shown.
Show-Privilege Select a privilege rule to define to which operators the node is shown.
Enable-When Select a when to define when the node is enabled.
Enable-Privilege Select a privilege rule to define to which operators the node is enabled.
Identification-Name Identifier for this node. (Not applicable for the Item List node type.)
Additional Parameters Add parameters to be used as metadata in a custom user interface element.

Up About Navigation rules