Back Forward Developer portal basics — Setting preferences

 zzz Show all 

PreferencesSelect Edit > Preferences and complete this panel to review or modify personal settings that affect the operation of the developer portal and Explorers.

  1. Choose a preference group from the control at the left.
  2. Review or change preferences in that group.
  3. Click  Save   to apply your changes. Changes are effective immediately. Preferences are retained and apply the next time you log into this system.

 zzz General preferences

Complete the following preferences to control the behavior of the Developer portal window.

Label

Description

Login  
Full screen?

Select to cause the portal to open at full screen size the next time you log in.

NoteClearing this check box when in full screen mode has no immediate effect. To reduce the portal window for the current session, use Windows operations.

Run Process

The In field affects the portal behavior when you enter a new work object from the Developer portal through the Run > Process menu selection.

In

Select to control where work object forms appear:

  • View — Presents the work object entry form, assignments, and other user interactions in the Developer portal workspace.
  • Pop-Up — Presents the work object entry form, assignments, and other user interactions in a pop-up window, closed after each submission.
  • New Portal — Presents the work object entry form, assignments, and other user interactions in a separate window and separate Thread.
()

SmartPromptIf you chose New Portal for the In field, select a portal rule to be used.

Skin

SmartPromptOptional. Select a skin rule to use in the Run Process In portal. If not blank, this skin rule overrides the skin rule identified in the portal rule, when you open, edit or preview a harness, section, or flow action rule, or execute a flow using Run > Process > zzzzzz.

Exit  
Warn always?

Select to require a confirmation each time you click the Log off link.

Warn when data has changed?

Select to require a confirmation when you use the Close button (Close) for a rule or data form that contains modified but unsaved data.

JavaScript  
Disable compacting

Select to disable default processing that strips out white space and comments from JavaScript files before they are sent to a browser. When enabled, this feature improves performance by reducing the size of JS files, reducing traffic and the browser memory required to hold the script. As a security measure, this feature also scrambles (obfuscates) variable names.

Leave disabled unless you are debugging JavaScript files and you need to read the JavaScript code (in the HTML source code of the browser window)

 zzz General preferences — Keyboard

To view or change keyboard preferences, click the plus sign in the left panel to expand the General group, and then click the Keyboard link.

Set the preferences in this group to control use of keyboard shortcuts when using the Developer portal. See Navigating with keyboard shortcuts.

Label

Description

Enable

Select to allow use of keyboard shortcuts in the Developer portal, such as CTRL + 0 to log off. Clear to disable these shortcuts.

Restore Defaults

Click to reset all keyboard shortcuts to the default values.

Show Current

Click to display all of your current keyboard settings.

 

To view or change a single keyboard shortcut, select a Category from the list in the left panel and then select a Command from the list in the right panel.

Category Select the category that includes the command you want to view or change.
Command Select a command in the category.
ShortCut Key

Define a shortcut for the selected command, by selecting or clearing check boxes for the CTRL key, the ALT key, and a letter, digit or function key. Select at least one of the CTRL or ALT check boxes.

NoteChose shortcut assignments carefully. This facility allows you to override (reassign) keyboard shortcut values that are defined by Microsoft Internet Explorer, such as CTRL+ C for Windows clipboard copy or CTRL + V for Windows clipboard paste, while using the Developer portal. Consult Microsoft Help for a complete list of built-in shortcuts.

Click Save to record your changes.

 zzz General preferences — Log off

To view or change log off preferences, click the plus sign in the left panel to expand the General group, and then click the Log off link.

Set these preferences to determine the details to save when you log out. These choices affect the initial appearance and state of the Developer portal when you next log in.

Label

Description

Full State of Desktop Select to save all three states described in the following check boxes.
Open List Select to save the Currently Open list in the Views (Views) pane when you log out. The system reopens the objects on this list when you next log in.
Open Rules Select to cause rules and data instances that are open when you log out to be reopened when you next log in.
Explorer Tab Select to save the Application Explorer state (and the state of other visible explorers) when you log out. The system restores these tools when you next log in.

 zzz Edit preferences

Set the Edit preferences to affect the presentation of rule forms and data forms in the workspace.

Depending on the portal you are using, these preferences may be locked and not changeable. This condition is controlled by the Operator cannot override check box on the Options tab of the Portal form.

Label

Description

Rule Actions

Set these preferences to affect the appearance of open forms in the Developer portal.

Open  
Expand header

Select to present a newly opened rule or data form with the header visible (Header open) rather than collapsed (Header closed). See Identifying parts of rule and data forms.

Show tabs

Select to cause the Developer portal to show a tab for each open rule form or data form. Click a tab to bring the rule to the front.

Tabs
The tab label generally identifies the final key part or part (corresponding to the pyRuleName or pxInsName property). For rules or data instances that have a multipart key, the earlier key parts — for example, the Applies To key part of a property rule — does not appear.

Changes to this check box take effect the next time you log in.

Maximum

Select to control how many rules (or data instances) can be open at once and shown in the Currently Open Views list (Views). The default is 20, the maximum allowed. When you reach this maximum, you can't open an additional form until you close another. See Developer portal — Working with the Views display.

Changes to this value take effect the next time you log in.

Delete

Set two preferences to affect the operation of the portal after you click the Delete toolbar button (Delete).

Warn

Select to ask for confirmation for each requested Delete (Delete) operation.

Remove

Select to close a rule form or data form immediately when a Delete operation is successful.

Save As

Set the Auto Check-out preference to control check-out.

Auto Check-out

Select to automatically check out a new rule you create with the Save As (Save As..) toolbar operation. (Checkout occurs only when both the RuleSet containing the new rule and your own Operator ID are enabled for checkout.)

Flow Edit

Set these preferences to affect the operation of the Flow form.

Collapse Nav Pane

Select to automatically hide the navigation panel when editing a flow in Visio. This allows more of the form to be visible at once.

Stencil

Select one of three Visio templates to use when creating new flow rules:

  • Standard — Icons and shapes implemented in Version 5.3, such as Decision for an assignment task. These shapes are functionally equivalent to Classic shapes.
  • BPMN — Shapes used in Business Process Modeling Notation, such as Notify for an assignment task.
  • Classic — Shapes used in Version 4, 5.1, and 5.2, such Decisionas for a Decision task.

Existing flow rules are not affected by this preference, even when you later update them.

You can override this preference when you create a single flow rule by completing the Use Template field on the New form. See Flow rules — Completing the New Form.

When editing a flow rule in Visio, you can change the current stencil using the Flow Properties panel. See Flow rules — Editing in Visio — Flow properties.

Orientation

Select Portrait or Landscape to control the default presentation of flows in Visio. You can override this setting for a flow rule in the Flow Properties panel. See Flow rules — Editing in Visio — Completing the Flow Properties panel.

Stencil

Select the stencil that is the default for new flow rules you create. You can select another stencil when completing the New form for flows, or change the stencil in the Flow Properties panel. See Flow rules — Editing in Visio — Completing the Flow Properties panel.

Property Panel These preferences control operation of property panels on Harness, Section, and Flow Action forms.
Auto-Apply

Select to apply changes you make to a Cell Property panel, Layout panel, or other similar panels automatically as soon as you tab from a field.

When this option is selected, the panel is pinned.

Modified

Select:

  • Warn Always — A warning of potential loss of your inputs occurs if you click OK without previously clicking Apply (or Cancel). You can cancel the close.
  • Warn when not pinned — A warning occurs if the Cell Properties panel is not pinned to a fixed location and you click OK without previously clicking Apply (or Cancel).
  • Never warn — No warnings occur. Changes you made (if any) since last clicking Apply are lost.

(If selected, a warning dialog appears if you close a panel without clicking Apply or Cancel.)

You can't change this setting when Auto-Apply is selected.

 zzz View preferences

Set View preferences to control which Explorer tools appear in the navigation panel.

Label

Description

Explorer Tabs  
Show All

Select to cause the Developer portal to display all four Explorers. Clear to select Explorers individually. Excluding Explorer tools you never use can improve the performance of the Developer portal.

App Explorer

Select to display the Application Explorer in the navigation panel. See About the Application Explorer.

Used by Application

Select to display the Used by App Explorer in the navigation panel.

Class Explorer

Select to display the Class Explorer in the navigation panel. See About the Class Explorer.

Rules by Type

Select to cause the navigation panel to include the Rules by Type Explorer. See About the Rules by Type Explorer.

Customize  
App Explorer

Click to review or modify Application Explorer preferences. See Setting Application Explorer preferences.

Class Explorer

Click to select which base classes and other top-level classes appear in the Class Explorer selection box. See Setting Class Explorer preferences.

My Alerts Popup  
System Alerts notifier

Check to cause a small alert window to appear when your requestor session produces an alert. (The window does not interfere with processing or typing and disappears quickly; no click is required to dismiss it.) See Working with the My Alerts tool.

Display

These controls affect the order and labeling of nodes in the Class Explorer and Application Explorer trees. These settings do not affect which rules and classes appear.

Hierarchy

Select:

  • Parent — Presents subclasses to the right of the class identified in the Parent (directed inheritance) field on the Basic tab
  • Pattern — Presents subclasses to the right of the class based on pattern inheritance.

For example:

  • Under Parent inheritance, the class PegaSample-SimpleTask (a work type) appears as a subclass of Work-Object-. Under Pattern inheritance, the PegaSample-SimpleTask class appears as a subclass of PegaSample.
  • Under Parent inheritance, the Rule-Obj-FlowAction class appears as a subclass of the Rule-HTML-Section class. Under Pattern inheritance, the Rule-Obj-FlowAction class appears as a subclass of the abstract Rule-Obj- class.
Display Type

Select how objects are identified in the Class Explorer and Application Explorer:

  • Name — Presents the name (or a segment of a class name)
  • Label  — Presents the Short Description text
Your application can contain multiple rules with identical Short Description text. For example, two distinct properties with the text "Credit Limit" as Short Description text can both appear as nodes on the tree.
Recently Opened List  
Maximum

Select a count (10, 20, 50, or 100) that determines how many rules or data instances appear on the Views list (Views) when you display Recently Opened rules. See Developer portal — Working with the Views display.

 zzz Tools preferences

Four preference check boxes affect the operation of specific tools.

Select a check box to cause the specified tool to open in a new window when you start the tool. Clear the check box to start the tool in a pane within the portal workspace.

Label

Description

Clipboard See About the Clipboard tool
Image catalog See About the Image Catalog tool
Performance See About the Performance tool
Style viewer See About the Style Viewer

 zzz Search preferences

Set Search preferences to control the Find facility at the upper right of the Developer portal. See Developer portal basics — Find facility.

Label

Description

Max Results

Select a value between 5 and 50 to limit how many initial search responses are initially displayed. A lower limit produces faster response.

Regardless of the limit you set, you can access a full set of search responses by clicking the More... link from the Find results pop-up.

Search Type

Select one of four Find searches as the default search type:

  • Most Recent — Displays Most Recent rules in the Find box and makes searching for recently updated rules the default search type.
  • My Most Recent — Displays My most recent rulesin the Find box and makes searching for rules updated by you become the default search type.
  • Rule Content — Displays Rule content in the Find box and makes searching for a word anywhere in a rule the default search type.
  • Work — Displays Work objects in the Find box and makes opening a work object based upon a work object  ID the default search type.

You can select another search type at any time by clicking the icon corresponding to your Search Type selection.

 zzz Notes

The system saves preferences as an instance of the Data-CESettings class.

Up Developer portal basics