Copyright © Cloud Software Group, Inc. All Rights Reserved

The Work Queue List

The work queue list shows all of the work queues to which the logged-in user has access.

Display the work queue list by clicking on the Work Queues button (or icon) in the lower left portion of the iProcess Workspace (Browser) screen:

Note that the work queue names correspond to user names and group names. Each time a user or group is added to the TIBCO system, a work queue is created for that user or group; all work items addressed to that user or group are sent to their work queue.

A time delay may be experienced when displaying a work queue list if either the “Redirected” or “Redirected Image” column has been added to the list, and the user has access to a large number of work queues.

Information about each work queue is provided in the columns of the list. In the example shown above, the number of urgent work items and the number of new (unopened) work items in the work queue is shown. The specific information that is displayed on your system will depend on how your system was set up — see .

For information about selecting items from lists, see Selecting Items in a List.

Work Queue Access

Access to work queues is summarized below:

•	User Access - All work items that are sent to you appear in your personal work queue. Note, however, depending on how the system has been configured by the system administrator, you may or may not have access to your personal work queue.

If you do have access to your personal work queue, a queue with your user name will appear in the work queue list.

For more information, see Hidden Personal Work Queues.

•	Group Access - Every user who is a member of a group has access to the work items in that group’s work queue. All work items that are sent to a group are accessible by all members of the group.

User and group work queues are denoted by the icon in the Type column on the work queue list (these icons may not be displayed if the columns on your system have been changed from the default — see ). See the example below.

If the user or group work queue icon is shown in a gray color, it means it is a “test” work queue. For information, see Released vs. Test Work Queues.

You can list the user and/or group work queues to which you have access by making selections from the View menu on the Work Queues window:

Additional work queue access is available in the following ways:

•

Participation Access - You may be given temporary “participation access” to another user or group work queue. A work queue supervisor must set up a “participation schedule” that specifies the duration of the participation access. During that period, the work queue to which you have been given participation access will appear in the work queue list, and you will have access to the work items in that work queue. For more information about participation, see Participation Access to a Work Queue.

•

Redirection Access - Although this does not give you direct access to another work queue, it causes work items that were originally destined to another work queue to be redirected to your work queue instead. A work queue supervisor must set up a “redirection schedule” that specifies the duration of the redirection. For more information about redirection, see Redirecting Work Items to Another Work Queue.

Hidden Personal Work Queues

When the system is configured, it can be specified that your personal work queue either be shown or hidden by default. If it is shown by default, when you first log in, a work queue with your user name appears in the work queue list; if it is hidden by default, a work queue with your user name does not appear.

Also, depending on how the system is configured, you may or may not have the authority to change the default setting, that is, if the queue is shown by default, you can hide it; if the queue is hidden by default, you can display it.

If you have the authority to change the default, the work queue list View menu will contain either the Hide Personal Work Queue or Show Personal Work Queue selection (depending on its current state):

Use this menu selection to either hide or show your personal work queue.

Released vs. Test Work Queues

Whenever a user or group is created in TIBCO, both a “released” and “test” work queue is created for that user or group:

•	Work items that result from cases of procedures with a status of Released are sent to the released work queue for the user/group.

•	Work items that result from cases of procedures with a status of Unreleased (a new procedure being tested for release) or Model (a procedure that has been imported) are sent to the test work queue for the user/group.

Typically, you will be working with released work queues — the norm in a production environment.

You may occasionally be asked to use test work queues — this is done in a testing or training environment.

To display released and/or test work queues, make the appropriate selection from the View menu on the work queue list:

Viewing Work Items in a Work Queue

To view the list of work items in a work queue, single-click the desired work queue in the work queue list:

Once a work queue is selected, you can also move the highlight bar with the keyboard arrow keys to select other work queues.

Either the list of work items in the selected work queue is displayed, or the work items list filter dialog is displayed because the number of work items in the list exceeds the specified threshold. For more information, see Work Item Lists.

Work Queue List Columns

By default, certain columns are displayed in a work queue list. You can easily customize the columns that are displayed by either using the Column Selector, or by changing them manually. For information, see Customizing Columns in a List.

The following table describes the columns of information that can be displayed on the work queue list:

 

Column Name	Description
Deadline Items	The number of work items in the work queue that have a deadline.
Description	A description of the work queue — typically, the name of the user or group.
First Deadline Date/Time	The date and time of the deadline that will be the first to expire in the work queue.
Group Queue / Group Queue Image	True - The work queue is a “group” work queue. False - The work queue is an individual “user” work queue.
Host Name	The name of the TIBCO iProcess Engine to which the iProcess Workspace (Browser) is connected.
Name	The user / group name for the work queue.
Redirected / Redirected Image1	True - The work queue is currently being redirected to another work queue. False - The work queue is not being redirected.
Released / Released Image	True - The work queue is “released” (contains work items from “released” procedures). False - The work queue is a “test” work queue (contains work items from “unreleased” or “model” procedures).
Total Items	The total number of work items in the work queue.
Type	The icon in this column indicates whether it is a user or group work queue, as well as whether it is a released or test work queue. For information, see Work Queue Access and Released vs. Test Work Queues, respectively.
Unopened Items	The number of work items in the work queue that have not been opened yet.
Urgent Items	The number of work items in the work queue that have been flagged as urgent. Whether or not a work item is urgent depends on a priority value given to the step when the procedure was created, as well as a configuration value specified in the server. That is, if the priority exceeds (is smaller than — with 1 being the highest priority) the configuration value, the work item is flagged as urgent.

---

1

If the “Redirected” or “Redirected Image” column is added to the work queue list, a time delay may be experienced when the work queue list is displayed or refreshed if the user has access to a large number of work queues.

Number of Work Queues in a Work Queue List

There is an indicator in the header bar of the work queue list to tell you how many work queues are in the list. This number is displayed to the right of the Find button. In this example, there are 9 work queues.

Note that if this number is displayed in the format “##/##” it means the list is being filtered in some way and only some of the work queues are listed. In the example below, 5 of the 9 possible work queues are listed.

The work queue list can be filtered in one of the following ways:

•	The Find button has been used to filter the list. (For information about using the find function, see Finding Items in a List.)

•	Only “Released Work Queues” or “Test Work Queues” has been selected from the View menu. (For information about displaying released and/or test work queues, see Released vs. Test Work Queues.)

•	Only “User Work Queues” or “Group Work Queues” has been selected from the View menu. (For information about displaying user and/or group work queues, see Work Queue Access.)

If one or a combination of these methods have been used to filter the work queue list, the number is shown in the ##/## format.

Displaying Work Queue Loading

The work queue loading feature allows you to display a graphical summary that shows you how many work items are currently in one or more of the work queues to which you have access. The chart displayed by this feature provides a visual view of the amount of load the work queues are experiencing.

You can access work queue loading in one of two ways:

•	Select Work Queue Loading Chart from the Tools menu, or click the icon, on the work queue list toolbar.

This displays a work queue loading chart that shows you all of the work queues to which you have access. Note that the very first time you display the work queue loading chart in this way, it lists all work queues to which you have access. If you pare down the list using the Select Work Queues function (see Displaying a Subset of Work Queues in the Work Queue Loading Chart), from then on the list only contains the subset you have chosen.

•	Right-click on one of the work queues in the work queue list, then select Work Queue Loading Chart from the context menu.

This displays a work queue loading chart that shows you only the work queue on which you right-clicked.

The following is an example work queue loading chart that shows multiple work queues:

If your personal work queue is hidden by default on the work queue list and you do not have the authority to change the default via the Show / Hide Personal Work Queue selection on the work queue list View menu, your personal work queue is also hidden on the Work Queue Loading Chart. For more information about hidden work queues, see Hidden Personal Work Queues.

The red, green, and yellow-colored bars indicate the number of urgent, unopened, and with-deadline work items in each work queue. The blue bar shows the total number of work items in each work queue. Placing the cursor on the bars of the chart causes the exact counts for that work queue to be displayed.

Selections are available on the View menu that allow you to display only the released work queues, only the test work queues, or both the released and test work queues. You can also use selections on the View menu to display only user work queues, only group work queues, or both user and group work queues.

The work queue loading chart can be refreshed at any time by either selecting Refresh Work Queues on the View menu, or by clicking on the icon on the toolbar.

You can close the work queue loading chart by clicking on the X in the upper-right corner.

Displaying a Subset of Work Queues in the Work Queue Loading Chart

The first time you display the work queue loading chart, it will list all work queues to which you have access. You can, however, choose to display only a subset of the available work queues by selecting Select Work Queues from the View menu, or by clicking the icon on the Work Queue Loading Chart dialog. The following dialog is displayed:

This dialog contains a check box for each work queue to which you have access. You can select or deselect all of the boxes in the list using the first check box on the dialog; you can then check/uncheck individual boxes in the list, as desired. When the desired work queues are selected, click OK.

The work queue loading chart will list only the work queues that you’ve selected on the Work Queue Selection dialog. This selection will persist until you change it again.

Finding Work Queues in the Work Queue List

The work queue list contains a Find function that can be used to quickly find the work queue you are looking for.

To invoke the Find function, either select Find from the View menu or click on the icon on the work queue list toolbar.

The number to the right of the icon tells you how many work queues are in the list.

As the Find function works the same on all lists, it is described in the Introduction chapter — see Finding Items in a List.

Sorting a Work Queue List

You can sort the work queue list on any one of the columns in the list. To sort on a column, click on the column header. If the column contains text, it is sorted in alphabetical order; if it is numeric, it is sorted in numerical order.

Once you click on a column header, a small arrow head appears in the column header, which indicates the order of the sort — if the arrow head is pointing up, the sort is in ascending order; if it’s pointing down, the sort is in descending order:

Each successive click on the column header, toggles between ascending and descending order.

Refreshing a Work Queue List

When the work queue list is initially displayed, it is a snap shot of the work queues at that point in time. You can refresh the list to get the most recent list of work queues from the iProcess Engine by selecting Refresh Work Queues from the View menu, or by clicking on the icon on the work queue list toolbar

Do not overuse this feature — refresh the list only when you need an updated list. Each time you refresh the list, the iProcess Engine must send a new list to your system, which can impact performance, depending on the number of items in the list, the speed of your system, etc.

A time delay may be experienced when refreshing a work queue list if either the “Redirected” or “Redirected Image” column has been added to the list, and the user has access to a large number of work queues.

 

Copyright © Cloud Software Group, Inc. All Rights Reserved