Skip Headers
Oracle® Communications Order and Service Management Task Web Client User's Guide
Release 7.2.2

E35416-01
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
PDF · Mobi · ePub

5 Customizing the Task Web Client

This document describes how to customize the Oracle Communications Order and Service Management (OSM) Task Web client.

See "Setting Query Preferences" to customize queries.

Customizing Your Display

Use the Preferences page to define the way information is displayed on your screen. You can find the Preferences page in the Worklist, Notifications, and Query pages.

Figure 5-1 shows the Worklist Preferences page.

Figure 5-1 Worklist Preferences Page

The figure shows a screenshot of the Worklist Preferences View.

Note:

See "Viewing Orders" for more information on creating and saving preferences.

Sorting Information

When OSM first displays the Worklist page, it sorts the orders by task state.

You can change the way in which these columns are sorted by specifying a primary and secondary sort criteria. You do this from the Worklist Preferences, Notifications Preferences, and Query Preferences pages.

To sort orders:

  1. From either the Worklist, Notifications, or Query page, open the Preferences page. (See Figure 5-1 for an illustration of the Preferences page from the worklist.)

  2. Select a primary sort order. From the 1st Sort Order menu, select a column name to be the primary sort order, then select Ascending or Descending.

  3. Select a secondary sort order. From the 2nd Sort Order menu, select a column name to be the secondary sort order, then select Ascending or Descending.

    Note:

    If you do not want to specify a secondary sort order, select None in the 2nd Sort Order menu, as described below.
  4. Click Update.

You can revert the sorted information to the default order by selecting Default from the Sort Order menu.

To temporarily sort on a column:

Click the link at the top of the column on which you want to sort.

You can sort on every column. When you click to sort the first time, the Worklist is sorted in ascending order of the values in that column. When you click on the same column link again, it is sorted in descending order.

Changing the Colors of States

You can change the background and text colors used to represent the different states of orders in the Worklist, Query, and Change Task/Status pages.

To change the color of the order state:

  1. Click Options.

  2. On the Options window, select a text and background color from the Text and Background menus for a particular order/task state.

  3. Repeat step 2 for each order state.

  4. Click Update.

Displaying, Hiding, and Reordering Columns

Using the Preferences option, you can select the columns you want to display in the Worklist, Query, and Notifications pages and the order in which you want them to appear. If you remove all columns from the Displayed Columns list, the default columns still appear in the Worklist.

To display, hide, or reorder columns:

  1. In the Worklist page, click Preferences.

  2. Do any of the following:

    • To display a column, in the Worklist Preferences page, select a column from the Available Columns list and click the right arrow button to move it into the Displayed Columns list.

    • To hide a column, select a column from the Displayed Columns list and click the left arrow button to move it into the Available Columns list.

    • To change the order of columns, select a column name from the Displayed Columns list and use the up and down arrow buttons to place it in the position.

  3. Click Save As to name the preference and save it to the database.

See "Setting Worklist Preferences" for more information on setting worklist preferences.

Setting Table Height

You can specify a fixed or variable table height, depending on the value of the is_tablelayout_height_fixed parameter in oms-config.xml. You can set the value of is_tablelayout_height_fixed to True or to False.

The default value of is_tablelayout_height_fixed is True, causing all tables to use the value of the height_of_tablelayout parameter, also found in oms-config.xml. The default setting of height_of_tablelayout is 400 pixels.

Using a fixed table height can create excessive white space in and between tables. Setting is_tablelayout_height_fixed to False causes table height to be solely determined by the number of rows in the table and can help eliminate white space.

To set the table height:

  1. Open OSM_Home/SDK/Customization/osm-ejb/security/META-INF/oms-config.xml, where OSM_Home is the directory in which OSM is installed.

    Note:

    You may need to unpack oms-config.xml to be able to edit it. For instructions on how to unpack oms-config.xml, see OSM System Administrator's Guide.
  2. Search for the following parameter:

    is_tablelayout_height_fixed
    
  3. Do one of the following:

    • To set the table height to fixed, set is_tablelayout_height_fixed to True.

      You may desire a fixed height different from the default. If so, change the fixed height of all tables.

      To change the fixed height of all tables:

      1. Search for the following parameter:

        height_of_tablelayout
        
      2. Set height_of_tablelayout to the desired numerical value.

        The default is 400 pixels.

    • To set the table height to variable, set is_tablelayout_height_fixed to False.

      Table height will now vary for each table, depending on the number of rows in the table.

  4. Save and close the file.

    Note:

    After saving and closing oms-config.xml, you may have to redeploy it. See OSM System Administrator's Guide to determine if you need to redeploy oms-config.xml and instructions for redeploying it.

Customizing the Worklist

When you log into the Task Web client for the first time, OSM displays orders in the Worklist based on your last saved preference or, if no preference exists, the system default.

You can customize the Worklist to display the information you want to see by defining and saving your own preferences.

Setting Worklist Preferences

The Worklist Preferences page lets you define, edit, save, and delete Worklist preferences. To access this page, click the Edit Preference link on the Worklist page.

The Worklist preferences page has the following areas:

About the Worklist Columns Area

Table 5-1 describes the Worklist Columns area.

Table 5-1 Worklist Columns Area

Column Description

Available Columns

This area shows the available query list columns. See Table 5-2 for more information about the columns in this list.

Displayed Columns

This area shows the displayed query list columns.

Sort Order

In this area, you can change the way in which columns are sorted by specifying a primary and secondary sort criteria. By default, the 1st Sort Order is set to Ascending and the 2nd Sort Order is set to Descending.


Table 5-2 describes the columns in the Available Columns list.

Table 5-2 Available Columns List

Column Description

Order ID

Unique system-generated order identifier.

Ref.#

Customer-supplied order identifier.

Namespace

Cartridge namespace of the order.

Version

Cartridge namespace version of the order.

Process

Description of the process definition associated with the order.

Type

Description of the order type associated with the order.

Source

Description of the order source associated with the order.

Task

Order task description.

State

State of the task.

User

Name of the user who has accepted or been assigned the task.

Process Status

Status of the process at the current processing point.

Priority

Priority of the order.

Order Creation Date

Date at which the order was created.

Started

Date at which the task was started.

Expected Order Completion Date

The date when the order is expected to be completed. This is calculated as follows:

  • If OSM receives the order after the expected start date, then the expected order completion date is the expected duration added to the order creation date.

  • If OSM receives the order before the expected start date, or if it has no expected start date because it is a process-based order, then expected order completion date is the expected duration added to the expected start date.

Expected Duration

The amount of time the order is expected to take to complete processing. The expected duration format is as follows:

P[<days>D][T[<hours>H][<minutes>M][<seconds>S]]

Expected Start Date

The date when the order is expected to start processing.

Requested Delivery Date

The date by which the customer requests the order to be delivered.

Expected Task Completion Date

Date at which the task is expected to complete.

Order State

Current life cycle state of the order.

Target Order State

Target life cycle state of the order.

Execution Mode

Execution mode of the task.

Expected Grace Period Completion

Date at which the grace period is expected to expire.


About the Worklist Filters Area

In the Worklist Filters area, you can control the number of orders that appear in the Worklist by filtering on one or more criteria. By default, all execution modes, order states, task states, and task descriptions are selected.

Figure 5-2 shows the Worklist Filters area.

Note:

When the worklist is filtered on the basis of “Namespace” only, orders of the current version are displayed.

Figure 5-2 Worklist Filters Area

The figure shows a screenshot of the Worklist Filters Area.

Table 5-3 describes the Worklist Filters area.

Table 5-3 Worklist Filters Area

Column Description

Execution Modes

The Execution Modes filter lets you display tasks based on one or more execution modes. The execution modes are: (All), Do (In Amending), Do, Redo, and Undo.

Order States

The Order States filter lets you display orders associated with one or more states. The order states are: (All), Aborted, Amending, Cancelled, Cancelling, Failed, In Progress, Not Started, Suspended, and Waiting for Revision.

Task States

The Task States filter lets you display tasks associated with one or more states. The task states are: (All), Accepted by current user, Assigned to current user, Others, Received, and Suspended.

Tasks

The Tasks filter lets you display one or more tasks based on the task description.


About the Order Details Area

The Order Details area has the Field list that you use to display orders associated with a specific column name and, in some cases, other specific conditions and values. For example, if you select Process Status from the Field list, you must select a status such as True, False, Next, Back, and so on, from the Condition Value list. By default, no fields are selected (Clear).

Table 5-4 describes the field filtering options available in the Order Details area.

Table 5-4 Order Details Area

Filtering Option Description

Field

The list that contains the default and user-defined columns.

Condition

The Condition option is only available for certain columns in the field list.

You have the option of searching for orders equal to a value or between two values:

  • If you select =, the Value field is enabled.

  • If you select between, both the Upper Value and Lower Value fields are enabled.

Lower Value

The lower value of the condition for the selected field.

Upper Value

The upper value of the condition for the selected field.


For text fields and Order ID and Reference # column headers, you can use wildcard symbols for the = condition field to represent any number of unknown characters. Use * to search for any character or group of characters, and ? to search for any single character.

When you filter on a phone field, you must use numeric characters only.

Note:

If you have a large number of tasks in your worklist, and if you want to show orders associated with most of the tasks, instead of making multiple clicks, select the first task displayed in the list, then scroll to the bottom, press and hold the Shift key, and then click the last task in the list. This highlights all of the tasks. Next, press and hold the Ctrl key, and then click the tasks you want to remove from the list. This deselects the unwanted tasks.

Defining Worklist Preferences

The first time you access the Worklist, you are presented with either your last saved preference (from a previous release), or the system default.

To define a worklist preference:

  1. Log in to the Task Web client and navigate to the Worklist page (it may appear automatically after login).

    If your last saved preference is available, it is displayed in the menu as MyWorklist; otherwise, the menu does not appear.

  2. On the Worklist page, click Edit Preference.

    The Worklist Preferences page is displayed. If you are working with MyWorklist, the settings for that preference are loaded. If no preference is available, the system default, named untitled is loaded.

  3. Modify your settings as desired and click Save As.

    A dialog box is displayed prompting for the preference name.

  4. In the text box, type a name (up to 50 characters) and click OK.

    The named preference is now the current Worklist Preference and is displayed in the menu as the selected item.

  5. Click Worklist to return to the Worklist page.

    If the newly created preference is your only preference, it is displayed as the selected item in the menu. In this case, click Refresh to apply it to the Worklist. If you have more than one preference saved, however, you may need to select the newly created preference from the list to apply it.

Selecting a Worklist Preference

You can select a Worklist preference from either the Worklist or the Worklist Preferences page.

  • Worklist: When you select a preference from the menu on the Worklist page, it is applied immediately to the Worklist.

  • Worklist Preferences: When you select a preference from the menu on the Worklist Preferences page, the settings for that preference are loaded. The preference that you select on this page is not automatically applied when you return to the Worklist.

    Note:

    The current worklist preference is the last preference you applied to the Worklist, which may or may not be the preference you are working with on the Worklist Preferences page. Remember to always select the preference you want to apply to the Worklist from the Worklist page.

Editing a Worklist Preference

You can edit a worklist preference by selecting it from the Worklist and clicking the Edit Preference link, or you can select and edit it directly from the Worklist Preferences page. Use the following procedure when selecting a preference from the Worklist.

To edit a worklist preference:

  1. On the Worklist page, select the preference from the menu and click Edit Preference.

    The Worklist Preferences page displays the settings for the selected preference.

  2. Change the settings as desired and then do one of the following:

    • Click Save to save your changes to an existing preference

    • Click Save As to save your changes to a new preference

  3. If you chose Save As, a dialog box is displayed prompting for the preference name. Type the preference name and click OK.

    The newly created or saved preference name is displayed as the selected item in the menu.

  4. Click Worklist to return to the Worklist page.

  5. If the preference you edited is already selected, click Refresh to apply your most recent changes; otherwise, select the preference you want to apply to the Worklist.

Deleting a Worklist Preference

You can delete worklist preferences that are redundant or have become obsolete.

To delete a worklist preference:

  1. On the Worklist Preferences page, select the preference from the menu and click Delete.

    A dialog box is displayed asking if you want to delete the current preference.

  2. Click OK.

    The preference name is removed from the list.

  3. Click Worklist to return to worklist.

    Note:

    If all named preferences are deleted, the system reverts to the default preference.

Creating a New (Untitled) Worklist Preference

When you click the New button on the Worklist Preferences page, the system creates a new untitled preference which contains the default settings. This provides an alternate way to create preferences, which are based on the default rather than on modifying existing preferences.

To create a new worklist preference:

  1. On the Worklist Preferences page, click New.

    The preference named untitled is displayed in the menu and the default preference settings are loaded.

  2. Modify any settings as desired and click Save As.

    A dialog box is displayed prompting for the preference name.

  3. In the text box, enter a name, up to 50 characters, and click OK.

    The named preference is displayed in the menu as the selected item.

  4. Click Worklist to return to the Worklist page.

  5. Select the newly created preference from the menu to apply it to the worklist.

Customizing User-Specific Settings

The Options page lets you customize the user-specific settings. You can configure settings such as your email address, time zone, appearance of the login screen, and the color of the order and task. See "Customizing the Task Web Client" for more information.

Figure 5-3 shows the Options page.

Figure 5-3 Options Page

The figure shows a screenshot of the Options page.

Table 5-5 describes the Options page.

Table 5-5 Options Page

Column Description

User Email Address

Set your email account to receive notifications.

Time Zone for Dates

Select your timezone.

Login Screen

Change the initial screen displayed by the OSM system when you log in.

Order/Task State Color

Change the text and text background colors to differentiate orders at different task states.