Screen Set Manager: SmartLinks

This page is accessed via Configuration and Administration > User Configuration > Screen Set Manager. This is on the SmartLinks tab.

Use this page to configure the SmartLinks that are available for a business object. Oracle Transportation Management is pre-configured to display all available SmartLinks for business objects. However, you may want to prevent a user from viewing a specific SmartLink. You can also move SmartLinks to new positions in the hierarchy.

If you are editing or making a copy of an existing screen set, the SmartLinks that have been defined for that screen set appear. However, if you are creating a new screen set, no SmartLinks appear. Click Top. Then click the New icon to begin adding SmartLinks. You can also edit existing SmartLinks by clicking the Edit icon after selecting an action or group.

Note: The Edit, Export, and View SmartLinks are global and cannot be moved or deleted from the SmartLink menu for any business object.

The Display Alphabetically check box displays the SmartLinks alphabetically. If the check box is not selected, the SmartLinks will display in the order they appear on this page.

Adding SmartLinks by ID

You can add a SmartLink to a group and then reorder the group.

1. You can add an action to a group and then reorder the group.
   1. Highlight the Top object name or the name of a group by clicking it. Icons appear.
   2. Click the New icon.
   3. Select the Action by ID option button. Once you make this choice and save the record, you cannot use edit to choose a different form of action definition.
   4. Enter a Label ID.

Actions

1. Choose a SmartLink from the list.

Note: The list does not distinguish Actions from SmartLinks so you could add SmartLinks to the Actions list and vice-versa.

Adding SmartLinks by URL

Use this option to create a URL that the SmartLink will run instead of using a predefined SmartLink record.

1. Highlight the Top object name or the name of a group by clicking it. Icons appear.
2. Click the New icon.
3. Select the Action by URL option button. Once you make this choice and save the record, you cannot use edit to choose a different form of action definition.
4. Enter a Label ID.

URL

1. Enter a URL. This is the URL to which the action will redirect. The URL can be either relative or absolute. Relative URLs access local locations. This can be used to redirect to a file or servlet within the OTM server configuration. Absolute URLs point to an exact location and are used to redirect to an external URL. The macros available as query parameters when creating a menu link/queries are useable here.
2. The Format check box is only used by relative URLs. When selected, the relative URL will be passed through the standard OTM URL formatter. This adds on the breadcrumb key, the cross-site scripting key, URL prefix, and URL context. When selected, the Use New Client Session check box appears.
3. The Use Current Client Session appears only when the Format check box is selected. If you select this check box, the URL will use a new client session. Otherwise, it will run in the same client session as the screen that executed the action. It is recommended that you do not select this check box.
4. Enter a Primary Key Parameter Name. The primary key of the record(s) executing the action will always be passed as a query parameter in the URL. This value determines the name of the parameter. If left blank, the name will be pk. For multi-part primary keys the UI-display version of the value will be passed, i.e., the parts will be separated by the "x" deliminator. E.g., A shipment stop has a shipment GID of GUEST.ABC and a stop number of 1, the value passed will be GUEST.ABCx1.
5. Click Save.

Showing/Hiding SmartLinks

1. To hide a SmartLink, right-click on it and select Hide.
2. To show a hidden SmartLink, shown in light gray italics, right-click on it and select Show.

Moving SmartLinks

1. Highlight the SmartLink that you want to move by clicking on it.
2. Click Move Up or Move Down icons depending on the direction that you want to move it. If you get to the beginning or end of the list and click these icons, the SmartLinks wraps around to the beginning or end depending on its position.

Deleting SmartLinks

1. Highlight the Smartlink that you want to delete by clicking on it.
2. Click the Delete icon.