Using Push Buttons and Links

Select a type of push button or hyperlink. Options are:

• Push Button: Adds control in the shape of a button with borders that end users click.

• Hyperlink: Adds a control of underlined text with no border that users click.

• Action Widget: Adds a hyperlink that triggers JavaScript when clicked. When selected, the system defaults the Destination to PeopleCode Command and activates the Action Widget Settings group box.

  Important! The combination of record and field names associated with the action widget must be 28 characters or less.

Accesses a uniform resource locator (URL). You can select a value from the URL table or use the value of a record field to define the destination.

Selecting this option enables the External Link group box. You can choose to have the URL encoded or not by selecting the Encoded by Application check box.

Selecting this option applies an external link to your page in the form of a push button or link that accesses a new page, taking the user to the external web site that you designate. To return to the primary page, the user closes the new page. When setting the record and field name, consider these points:

• If you specify a dynamic external link, you must enter a record name and field name.

  The system uses the value of the record and field specified as the value of the link.

• Whether the external link is static or dynamic, you can use the specified record and field names to control the page field in PeopleCode when you want, for example, to hide the link dynamically with PeopleCode.

• The tool tip, or mouse over text, that appears with the link at runtime comes from the RFT long label assigned to the record field.

  However, the RFT long label appears only if it is different from the assigned display value of the link and it is not null. If the link appears as an image button, the tool tip is derived from the label text if it exists. Otherwise, the system uses the RFT long label.

Accesses a PeopleSoft page. Parameters include the menu path to the page and a check box to specify whether data from the current page should be used in the search dialog box.

Selecting this option enables the Internal Link group box.

Selecting this option adds an internal link in the form of a push button or link that you can use to access another component or page from within the system or another PeopleSoft database or node. You can even specify the type of action mode to open in for that page. To control the push button or link in PeopleCode, enter the record and names.

Like the external link, if you associate a record and field name with this link, the tool tip that appears at runtime draws from the RFT long label for the record field. However, the RFT long label only appears if it is different from the assigned display value of the link.

Select to add an instant messaging button to the page. Associate the button with a record field that contains entries in the form of <user>@network (such as John@Yahoo). For this purpose, we provide the MCFIMNETWORKS table. The MCFIMDOMAIN field is the source for the instant messaging network providers. This table contains only three network providers: AOL, Yahoo, and SameTime Connect. You should never enter additional networks not already in this table.

See MultiChannel Framework.

Enables the user to jump to the anchor tag that you designate for a page field on the General tab of the properties dialog box for that field.

Selecting this option enables the user to jump from one destination (the link that you assign as the page anchor) to another (the field that you enable as the page anchor) in your page. When you select this option, the page fields that you previously set as page anchors on the General tab of the properties dialog box appear in the Related Control drop-down list box in the Actions group box. You can place as many page anchor buttons or links on the page as necessary.

Associates a record field, so when the user clicks the push button or link, the system runs any FieldChange PeopleCode that is associated with that field. Enter the record and field names. The field must have PeopleCode in the FieldChange event.

Runs processes that you set up previously with PeopleSoft Process Scheduler. Associate process push buttons with a specific process definition; the process is run each time that a user clicks the button.

Selecting this value enables the Process group box, where you can specify the type and name of the process that you want to run.

See Submitting Process Requests.

Displays a prompt dialog box for a specific control field. Adds a custom prompt button or link next to a field on the page in place of the standard prompt that is associated with that field. For example, you might want the prompt to read Find an Airport Code.

Selecting this value enables the Actions group box. In the Related Control drop-down list box, select the field that you want to associate with the prompt. The systems sets the action type, Prompt, automatically. Set the text label properties for the link on the Label tab.

Represents certain actions that a user can perform on a grid, scroll area, and scroll bar, such as bottom, top, insert row, and so on.

Use to provide action buttons for the grid, scroll area, or scroll bar in areas outside of that control, such as at the bottom of the page or outside the borders of the control.

Selecting this value enables the Actions group box, where you can specify the action type and related control. The Action Type field enables you to select the action to be performed in the specific level. The level is specified in the Related Control field. Specify one of the following scroll actions: Bottom, Next, Previous, Row Delete, Row Insert, and Top.

For example, if you want a user to be able to move through a page at runtime, set the action type to Next or Previous and specify which scroll area you want those actions to control.

Access an existing secondary page. After you design a secondary page, you must associate it with a control on the primary page. The secondary page push button or link is the starting point for the user of that secondary page. Selecting this option enables the Secondary Page group box, where you can select the name of the secondary page that you want to associate with the push button or link.

Represents the various toolbar actions available to the user. A user can perform several actions on a page, such as save, display the next page in a group, correction mode, and so on. These normally reside on the toolbar at the bottom of each PeopleSoft Pure Internet Architecture page. Use this type of push button or link for placing save, next in list, or other toolbar functions on the page.

Selecting this value enables the Actions group box, where you can specify the action type: Add, Correction, Next in List, Next in Worklist, Next Page, Notify, Previous in List, Previous in Worklist, Previous Page, Refresh, Return to List, Save, Update/Display, Update/Display All, or View Worklist.

Select the portal to which you want the internal link to point. Use Current is the default. Valid values include all of the values in the PORTAL_NAME column of the PSPRDMDEFN table.

Select the PeopleSoft database to which you want the internal link to point. Local stands for the node that is marked as the default only. If the content reference you need is registered with a non-default local node, make sure you choose the exact same value from this drop-down list box.

Valid values include all of the values in the MSGNODENAME column of the PSMSGNODEDEFN table. If you select a node other than Local, the Use data from current page in search check box is deselected.

The node that you select should match the node for the destination component in the Registration Wizard or on the Content Ref Administration page. Select PeopleTools > Portal > Structure and Content. Click the Edit link to access the Content Ref Administration page.

Select the menu name in which the destination page is contained.

Select the component in which the destination page is contained. These values depend on the menu that you select.

Select the market of the destination component.

See Specifying Market-Specific Components.

Select the page that should be active. These values depend on the component that you select.

Select the action mode in which you want the page to begin.

Select if you want data from the current page to be used in the search dialog box. This option ensures that the new page inherits the proper keys from the context of the current page. The process is almost identical to the Transfer( ) PeopleCode function, and it performs a similar function.

If this check box is selected, the system discards the existing keylist; builds a new keylist from the current component buffer using the context of the field (when a choice exists between rows in a scroll area); and uses this keylist to start the new component.

If this option is deselected, the system uses the existing keylist in the normal manner.

Select to make the Custom JavaScript edit box read-only and populate the edit box with the with the default JavaScript, RelatedActionJS.

If you want to revert the field to the default, just select this check box and the system repopulates the field with the default value.

When enabled, enter the name of the custom JavaScript to execute.

Select to make the push button or link available to users who have display-only access to this page.

Display-only access is set in the permission list properties.

Select to open the target content page in a new browser window. This option is enabled when the destination type is either Internal Link or External Link. This option and Replace Current Window are mutually exclusive.

Select to replace the existing content in the target area. This option is enabled when the destination type is either Internal Link or External Link. This option and Open in New window are mutually exclusive.

Select to activate the push button or link when the user presses the Enter key. You can have more than one push button or link with this feature set per page, as long as only one of these fields is enabled at runtime. Otherwise, only one push button or link with this attribute enabled is allowed per page. This feature is available for all control types except external links.

When using Activate by Enter Key in a scroll area or grid with an occurs count greater than one, the Enter key triggers the first row only.

Note that on a secondary page with the standard OK and Cancel buttons enabled, the Enter key activates the OK button rather than a custom button or link.

Enables the system to issue a save warning for the field if the user changes the value and attempts to exit the page before saving. This setting reinforces current save warning behavior. This option is set by default for edit boxes, long edit boxes, radio buttons, check boxes, and drop-down list boxes. Deselecting this option overrides the save warning that normally appears to users. The user will not see a save warning after changing the value of the field and attempting to exit the page. An example of when this might be necessary is for a drop-down list box that includes links to another page. If the user selects a link from this field to transfer to another page but has not made any other changes to the page, then the system is not required to issue a save warning.

By deselecting the Set Component Changed flag, you ensure that no save warning message is issued for this field. This option works for fields associated with a derived work field or database record field.

For the push button/hyperlink control, the default setting is deselected instead of selected, unlike with other page controls.

Select to include the field as a list box item in the persistent search results grid. You must also select the Persist in Menu grid property for the grid that contains the field.

This property is disabled on check boxes and radio buttons.

You must enable recent search results caching at the system level in the web profile for this property to take effect.

Select to have no pop-up page. This value is the default.

Select to associate this control with a pop-up page that you select from the drop-down list box. Only pop-up pages appear in the Page Popup drop-down list box.

Select to associate this control with a system-defined message pop-up page that displays a message from the Message Catalog. You can design and implement Message Catalog pop-up pages to be context sensitive. When you select this option, the Message Set/Number fields are enabled.

See PeopleBooks and the Online PeopleSoft Library, Managing the PeopleSoft Online Library and PeopleBooks Integrating Context Sensitivity.

See Message Catalog.

Enter the message set and message number of the message. These fields are enabled when you select Message Catalog Popup.

Displays the message text of the message set/number that you select. This field is display-only.