Screen Set Manager: Actions

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

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

If you are editing or making a copy of an existing screen set, the actions that have been defined for that screen set appear. However, if you are creating a new screen set, no actions appear. Click Top to highlight it. Then click the New icon to begin adding groups and actions.

You can also edit existing actions by clicking the Edit icon after selecting an action or group.

The action hierarchy consists of groups and actions. A group is used to organize lower level objects such as other groups and/or actions. For example, the actions hierarchy for Order Release provides a group called "Events" with the actions "Add Order Release Event" and "View Order Release Events". The lowest level object in the hierarchy is an action.

The Display Alphabetically check box displays the groups and actions alphabetically. If the check box is not selected, the actions will display in the order they appear on this page. Groups and actions can be created and moved. See below.

The Display Expanded check box overrides the glog.ui.actions.initiallyExpanded.maxCount property. Regardless of how many actions are in the menu, the list of actions will always be expanded when the action menu is opened.

Adding Groups

You can add a group below the Top object or below another group but not after an action.

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 Group option button. Once you make this choice and save the record, you cannot use edit to choose a different option.
4. Enter a Label ID. If a translation exists for the label selected, it will be used, otherwise what is entered here is used.
5. Click Save.
6. To add a subgroup, highlight the group you added and repeat the process. A group hierarchy is limited to three levels. For example,

Group 1

Group 2

Group 3

Adding Actions by ID

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 an action 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 Actions by URL

Use this option to create a URL that the action will run instead of using a predefined Action 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 Actions

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

Moving Groups/Actions

You can move group/action objects to any position in the hierarchy. However, the following rules apply for any object with parent-child relationships. In general, once a parent-child relationship is established, child objects can only be moved with the parent object and not to other parent objects.

• If a group has subgroups or actions, you can move the parent group and all of its actions/child objects.
• If a group has only one subgroup or action, these actions cannot be moved.
• If a group has multiple actions, the actions can be moved with the group only.

1. To move an object within the action hierarchy, click the object to highlight it.
2. Click or 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 object wraps around to the beginning or end depending on its position.

Deleting Groups/Actions

You can delete a group and all of its child objects or delete the child objects within a group.

1. To delete an action, click the check box next to the action that you want to delete and click the Delete icon.
2. To delete a group and all of its child objects, click the check box next to the parent group and click the Delete icon.
3. To delete the child objects within a group, click the check box next to the child object and click the Delete icon.

   Note: If you remove all Groups and Actions from the list, the Actions drop-down list or button does not appear on the Results or Edit pages.