SYSPRO Ribbon bar > Administration > Hyperlinks and Exceptions

Hyperlinks and Exceptions

You use this program to configure the behavior of list view-type windows in SYSPRO that are referred to as property controls.

Property controls can be viewed from within SYSPRO query programs and are designed to optimize the amount of information that can be displayed on the screen. They are also designed to be completely flexible and allow you, for example, to indicate which fields are visible and the sequence in which these fields must be displayed.

The program also enables you to associate SYSPRO and third-party application programs with any field displayed within the property control.

Toolbar and menu

Field Description
System-wide Enable this to apply the customized hyperlinks, exceptions and smart links to all operators in all companies.
By Role Enable this to apply smart links to a specific operator role. Exceptions and hyperlinks cannot be defined by role.
Role Indicate the operator role to which you want to apply the customized hyperlinks, exceptions and smart links

Customized Hyperlinks

Field Description
Caption to match Indicate the caption of the field displayed on the property control against which you want to associate a program. Your entry here is not case-sensitive, but it must match the caption of the property control.

You can establish this by right-clicking the field and selecting Customize Hyperlinks from the shortcut menu. The caption assigned to the field is displayed automatically.

Description for hyperlink Describes the hyperlink. This is used if you associate more than one program to a caption - in which case the description is displayed on the shortcut menu when you double-click the field.
Type of program to launch  
Run a SYSPRO program Opens a SYSPRO program from the hyperlink that is associated with the field.

Any program written to SYSPRO standards by third-party developers can also be opened, providing the program name does not exceed 6 characters.

Run an application from the workstation Opens an executable residing on the workstation from the hyperlink that is associated with the field.
Run a application from the server Opens an executable residing on the server from the hyperlink that is associated with the field.
Program to launch Indicate the program you want to launch from the hyperlink.

You can associate up to 10 programs against each field.

Browse-style program Indicates that the SYSPRO program is a browse-style program (i.e. programs typically associated with the setup programs used to define static data such as stock codes, customer, currencies etc).
Program parameters Enter parameter(s) you want to use when launching a SYSPRO program (e.g. if you want the hyperlink to launch the Inventory Query program for a specific stock code, then you can enter that stock code in this field).

For a customized hyperlink, you do have to define a program parameter such as '%key'. The current key value is automatically passed to the SYSPRO program. If you actually do the enter '%key' then this is assumed to be absolute value passed as the program parameter.

A program parameter can be used when you require a specific parameter (e.g. to run a specific Report Writer report, you can pass the report name as the program parameter).

%key The value of the current key field.
%oper The current operator code.
%coid The current company id.

Customized Exceptions

This pane highlights information of an exceptional nature whenever it is displayed on a custom forms property control.

Field Description
Caption to match Indicate the caption of the field displayed on the custom forms property control that you want to highlight.
[Note]

Because you can configure more than one exception for a given caption, the first match exception is applied.

Operand  
Contains The exception applies only if the custom form value contains the entry defined at the Comparison value field.
Equals The exception applies only if the custom form value is the same as the entry defined at the Comparison value field.
Greater than The exception applies only if the custom form value is greater than the entry defined at the Comparison value field.
Greater than or equal to The exception applies only if the custom form value is greater than or equal to the entry defined at the Comparison value field.
Less than The exception applies only if the custom form value is less than the entry defined at the Comparison value field.
Less than or equal to The exception applies only if the custom form value matches or is less than the entry defined at the Comparison value field.
Not equal to The exception applies only if the custom form value does not match the entry defined at the Comparison value field.
Starts with The exception applies only if the custom form value starts with the entry defined at the Comparison value field.
Comparison value The value that must be matched to the custom form field after applying the operand.
Match case The exception must apply only if the case of the comparison value matches the case of the custom form field.
Color to apply  
Select Color Select the color you want to assign to exception.
Sample Preview your selections as you make them.
Apply to  
Background Applies the selected color to the background.
Foreground Applies the selected color to the foreground text.
Tooltip for exception Indicates the text that must be displayed as the tool tip when the mouse pointer hovers over the custom form field.

Smart Links

This pane displays all standard Smart Links available in the system. By default, these are displayed for all operators.

Field Description
Caption Indicates the caption to which the Smart Link is attached.
Description Indicates where the caption is displayed.
In use Indicates whether the Smart Link is displayed against the caption in forms and list views.

Disable this check box to remove the Smart link from all forms and listviews. The Smart Link is removed for all operators across all companies when the System-wide option on the toolbar is enabled. Alternatively, the Smart Link is only removed for operators belonging to the Role indicated on the toolbar.

Changes to Smart Links are applied immediately the Save and Exit option is selected.

Notes and warnings

Prerequisites

  • You can only configure custom form exceptions if you defined a Custom program folder (System Setup).

Restrictions and limits

  • Hyperlinks and Smart links are applied to both forms and listviews. Exceptions are only applied to list views.

  • You cannot configure hyperlinks for group heading fields.

  • Date fields launch the Company Calendar program automatically, regardless of the program associated to these field.

  • Property controls support the facility for 'program exceptions'. These exceptions originate from business logic that dictates whether a given caption's value should be highlighted (e.g. in red).

    These exceptions take precedence over any user-defined exception rule.

Database considerations

  • Changes to hyperlinks, exceptions and smart links are saved in the CUSLNK.IMP, CUSEXC.IMP and CUSREM.IMP files in the CUSPROGS folder. If they are applied to a role, then these files are stored in the Role_xxx folder.