Content

Introduction

Work Assignment Page

Overview

Testing Lab Selector

Work SDI List

Resource Bar

Resource Selectors

Resource Icons

View Selector

Date Navigation Bar

Operations

Display Options and Legend

Recent Activities

Page Controls

Assign Work

Show Plan

 

Percentage Workload Calculation

 

Introduction

Top../images/arwup.gif (846 bytes)

As demonstrated in Introduction to Work Assignment and Planning, the Work Assignment page is where you assign work to Resources. This page can be opened from these areas:

Lab Admin → Planning → Plan Work.
Lab Admin → Planning → Testing Labs → "Plan Work" button.
LIMS → Tests → Manage Data Sets → "Plan Work " button.

This opens the page for the selected Data Sets.

LIMS → Tests → Manage Tests → "Plan Work " button.

This opens the page for the selected Tests.

LIMS → Samples → Manage → "Plan Work " button.

This opens the page for the selected Samples.

 

Work Assignment Page

Top../images/arwup.gif (846 bytes)

Overview

 

As demonstrated in Introduction to Work Assignment and Planning, the left frame lists the Work SDIs that require planning and (subsequently) can be put into a Plan. The right frame contains Resources in the Testing Lab, since the Work Assignment page allows planning for a single specific Testing Lab. Work SDIs selected in the left frame can be assigned to Resource in the right frame. Note that a Resource can be an Analyst (or Work Area of Analysts) or Instrument (or Work Area of Instruments).

Item Link to Description   Item Link to Description
1 Testing Lab Selector   8 Date Navigation Bar
2 Plannable Work Selector   9 Display Options and Key
3 Work SDI List   10 Recent Activities
4 Resource Bar   11 Page Controls
5 Resource Selectors   12 Assign Work
6 Resource Icons   13 Show Plan
7 View Selector      

Testing Lab Selector

 

The Testing Lab selector is a dropdown that specifies the single Testing Lab for which work will be planned. The dropdown content depends on your point of entry:

If the page is accessed from Lab Admin → Planning → Plan Work, the dropdown shows all Testing Labs to which the planner belongs. Choosing one shows all Work SDIs and Resources in that Testing Lab. This is a good choice if you plan for multiple Testing Labs.
If the page is accessed from the Testing Lab List, this defaults to the selected Testing Lab and does not let you choose any other.
NOTE:   You must be logged in as a member of a Testing Lab in order to see it in the dropdown. If the dropdown is empty, you are not logged in as a member of any Testing Labs.

Plannable Work Selector

 

The "Plannable Work" selector is a dropdown that contains logical groups of pending work. Each group is defined by an "Activity Class". The primary functions of Activity Classes are to:

Break down all plannable work into manageable groups. Work SDIs can appear in "Plannable Work" only if their WAPStatus is "Pending" and they are in the selected Testing Lab. The WAP policy provides additional filtering by defining query from and query where clauses to retrieve a subset of plannable work. This prevents laboratories that plan thousands of tests several months in advance from seeing thousands of Work SDIs in a single list.
Determine how the work is presented by defining columns, grouping, and sorting of the WorkSDI list. Query Categories are also provided to limit additional Queries that are available. Labels can also be defined to help identify each Activity. This is useful if you are creating work for specific SDCs such as Batches or Tests, where it is helpful to have the BatchId or WorkItemId in the Label.
Define business rules that govern Activity behavior (such as automatically completing the Activity when the work is done in the LIMS).

The ActivityAssignment Page Type (on which the WAP Assignment page is based) also contains a "Hide Activity Classes With Zero" property that hides an Activity Class with a zero quantity (such as Request Samples (0)), thus allowing you to see only Activity Classes that define work in need of planning.

Activity Classes are defined in the WAP Policy. Many predefined Activity Classes are provided, but you can define new ones for work such as "High Priority Samples".

Work SDI List

 

As demonstrated in Introduction to Work Assignment and Planning, the Work SDI List shows work that can be assigned. It is defined in the WAP Policy using properties similar to SDI List pages throughout the system.

As you select Work SDIs, the system checks to make certain each is compatible and can be put into the same Activity (as decribed in Introduction to WAP → Master Data → Planning Levels and WAP Resources), and shows the maximum duration for Resources in the bottom left of the screen.

A preview at the bottom left of the screen shows a work duration estimate, which indicates the time required to perform the work. As shown in WAP Resources, each Resource has a "Duration Rule" (such as "1 hour for 5 Tests"). As you select Work SDIs, that rule is executed to provide the preview.

Resource Bar

 

The Resource Bar is shown whenever Work SDIs are selected. This indicates the Resources required to perform the work (taken from the Master Data Resource requirements), Resources (if any) selected for each requirement, and the date (or date range) on which the work will be assigned. Note that the date/range reflects the date selected in the page body, so changing the date/range in the page body changes the date/range in the Resource Bar.

Resource Selectors

 

The "Focus" dropdown lists Resource Types defined in the Master Data. Selecting a Resource Type from here shows the available Resources. The Resource Icon for the selected Resource is highlighted in blue and displayed in the Resource Bar. Note that clicking a Resource in the Resource Bar shows only that Resource.

Multiple Resources can be selected using Ctrl-click and Shift-click operations. "Select All" selects all Resources. It is not possible to select multiple Work Areas. Multiple Resource selection is discussed further in Assign Work.

Resource Icons

 

Each Resource icon shows the Resource's "Percentage Workload" (sometimes displayed as "Percent Load"). This is the percentage of the Resource's time that has been consumed for the selected date range. This is further discussed in Percentage Workload Calculation. The color of the icon reflects the percentage workload on the Resource for the time frame you are currently viewing. The Color and Icon Legend shows colors for specific ranges.

1. The gold star in the left corner of a Resource icon indicates that this is a "Suggested Resource". Note that the Resources presented depend on the Work SDIs currently selected (as defined by the Master Data).

In order for a User to be a Suggested Resource, all of the following must be true:

The User must be a member of the Testing Lab.
If the Work SDIs have a common Work Area, the User must be a member of at least one of the Work Areas.
If the Work SDIs are Data Sets and the Parameter List requires Certification, the User must be trained on ALL Parameter Lists in the selection.

In order for an Instrument to be a Suggested Resource, all of the following must be true:

The Instrument must be a member of the Testing Lab.
The Instrument must be of the desired Instrument Type.
If a specific Instrument Model is required, the Instrument must be the correct Model.
If the Work SDIs have a common Work Area AND the Work Area contains Instruments of this Instrument Type, those become the "Suggested Instruments".

If there is reason to choose a Resource other than the Suggested Resource, the "Show All" link lets you do this by showing all Users, Instruments, and Work Areas in the Testing Lab. In the case of Instruments, Instruments of the correct Type and Model are also shown.

2. Clicking the Calendar icon loads the Resource's Calendar to view Appointments and Activities. This is the same effect as using the Calendar View Selector.
3. Hovering over the percentage number shows an Info icon. Clicking the info icon opens a dialog that shows how the Percentage Workload was calculated. This is discussed in Percentage Workload Calculation. This feature works anywhere in WAP where you see a percentage number for a Resource.

The examples below show how various Resources are rendered.

View Selector

 

The View Selector icons in the upper right corner let you toggle between Calendar View and Resource View.

Icon Description
Calendar View

Shows the Calendar of the selected Resource.

Resource View

Shows the Resource icons.

Also note that the Percentage Workload displayed for the Resource is calculated over the selected time range (discussed in Percentage Workload Calculation).

Date Navigation Bar

 

The Date Navigation Bar lets you choose the time frame over which work will be assigned. Use "Focus" (1) to select the Resource Type. Use the Resource dropdown (2) to select the Resource. Use the arrows (3) to step through available Resources.

Available display modes are described below.

Day

Day mode can show:

1. Appointments and Activities for the entire day.
2. Partial-day Appointments and Activities scheduled to the hour or minute.
3. Workload for the selected Resource on the currently selected day (discussed in Percentage Workload Calculation)

Use the < > arrows to step through days.

The Resource bar shows selected day, which is the day work will be assigned.

You can drag-select a time period, which is reflected in the Resource Bar.

Week

Week mode can show:

1. Appointments and Activities for entire days or multiple days.
2. Partial-day Appointments and Activities scheduled to the hour or minute.
3. Workload for the selected Resource on each day (discussed in Percentage Workload Calculation).

Use the < > arrows to step through weeks.

If you want to assign work across a range of days (such as sometime on Tuesday, Wednesday, or Thursday), Ctrl-click or Shift-click the columns (1), or drag across those days.

Month

The Percentage Workload is shown for each day. The Toolbar shows Percentage Workload for the entire month. Shift-click allows multi-day assignment (sometime within that range ), or you can drag a bar across to select multiple days (shown in the second image below).

You can also select across months. For example, you can click September 9th, go to October, then Shift-click Oct 9th.

7 Day and 14 Day

These are useful when you do not need to view Appointments and Activities down to the hour. Viewing multiple Resources can result in a busy screen. It is therefore best to view them in the 5 Day or 14 Day View.

These views let you drag Activities vertically to reassign or horizontally to reschedule. For example, you can move an entire bar up or down, or drag from the right to shorten a bar or drag left and right to do the work earlier or later. You can also drag a bar across to select a date range for the work (outlined in red below).

The Resource Selectors allow viewing Calendars of multiple Resources in the same view.

The "Select" checkbox (1) is shown for the Users and the Work Area. When you check this, then click "Assign Work", the work is assigned to the selected Resource for the selected time frame.

Percentage Workload is shown for each Resource on each day and is recalculated as you change Activities (discussed in Percentage Workload Calculation). In the example below, (2) shows increased load on the first week, while (3) shows decreased load on the second week.

Operations

 

"Operations" let you jump from an Activity to one or more SDI List pages. This is configurable using the "Operations" collection in the WAP Policy.

Display Options and Legend

 
  Display Options can be chosen by clicking the gear icon. These let you control how information is presented, particularly when in Calendar View.
Option Description
Color By This lets you adjust the color of an Activity based on different criteria. Changing this update the Color Key with your changes.
Show Appointments This lets you hide Appointments to view a cleaner screen.
Workload In Calendar View, this lets you show Percentage Workload for a Resource, the Resource's Available Time, or neither of these.
Activity Label This determines what is rendered in the Activity (as in the examples below).
A Legend showing colors and icons can be seen by clicking the balloon icon. The Legend shows what the colors and icons mean, particularly in the Calendar View.

Activities are color coded by SDC. For example, green indicates the Activity contains Tests.

 

Recent Activities

 

While you remain on the Assignment page, the system will remember a list of the recent Activities you created. If draft Activities exist, these buttons are provided:

Icon Description
View Recent Activities

Lets you view the list of recent Activities. There is an option to view or delete any of them. When deleting, remember that this is just a draft Activity, so after deleting the work you assigned, it will reappear on the left again and you can start over.

Delete Activity

Deletes the most recently created Activity (the last one you created). You can keep clicking undo and undo each change, but only for the duration of the session. Once you leave the page, the undo stack is cleared.

View Recent Activites in Plan

Lets you view the list of recent Activities on a Manage Work page. This lets you see all recent Activities on one big page.

Edit Selected Activity

Lets you edit the selected Activity. An example use would be manually changing the start time for fixed Activities.

Page Controls

 

The following page controls are available.

Icon Description
Refresh

Refreshes the Work SDI List.

Return

Returns to the previous page.

Assign Work

 

As demonstrated in Introduction to Work Assignment and Planning, the Assign dialog is shown after you click "Assign Work" and before the Activity is created. This dialog shows a summary of what is about to happen:

Item Description
SDI Assignment If the number of selected Work SDIs exceeds the Max Activity Size, the system generates multiple Activities as necessary (see Max Activity Size).

If multiple Resources are selected, the system divides the Work SDIs evenly among the Resources, then adjusts the Max Activity Size if required. Note that you can choose multiple Resources for only one Resource Type.

In the example shown above, 4 Activities will be created:

Activity 1: VC-382 Size=10

Activity 2: VC-382 Size=5

Activity 3: VC-381 Size=10

Activity 4: VC-381 Size=5

Note that there is a difference between assigning work to 2 Resources (381 and 382) and assigning work to a Work Area of Resources. When assigning to two Resources, half the work goes to one, half to the other. When assigning to Work Area, all the work goes into one Activity. It is not divided, and we do not worry about assigning someone to do it, as someone else will decide that later.

Max Activity Size  Master Data defines the "Max Activity Size". This limits the number of Work SDIs that can be placed into an Activity.

There is a global maximum of 1000 Work SDIs per Activity.

When creating an Activity, if the number of Work SDIs exceeds the Max Activity Size, you have the option of generating multiple Activities to accommodate the volume of work.

A typical use for Max Activity Size would be to match the size of an Activity to the size of a typical QC Batch.

If Master Data is a Test Method, you can specify a Max Activity Size for each Parameter List. To do this, "Is Work Plannable" must be set to "By DataSet".

If you add Work SDIs with different Max Activity Sizes, the lowest number is used. For example, If a pH Test has a Max Activity Size of 50 and a Metals Test has a Max Activity size of 100, the Activity will have a maximum size of 50.

 

Time Assignment Lets you specify if the Activity will be "Floating" or "Fixed":
"Assigning to . . ." indicates a Floating Activity. This work can be done at any time during the selected time range.
"Fix start time . . ." indicates a Fixed Activity. This uses the selected date as the start date. The end date is calculated based on the duration, which may change as you add/remove work to/from the Activity).
Resource Allocation Rules Shows the chosen Resources. Red indicates a missing Resource.
Activity Details This is a default label that was created based on the rule, but you can change it here.
Auto Activate Checking the "Auto Activate" checkbox automatically Activates the Activity and synchronizes it to the LIMS immediately after assigning the work (clicking the "Assign" button as shown in Assign Work and Create Activities).

Clicking "Assign" generates a single Activity with the following caveats:

When assigning a Fixed Start Date, the End Date is calculated as an offset from the Start Date, using the longest duration for the Activity Resources. For example, assume an Activity has two Resource requirements: A User who is required for 2 hours and and Instrument that is required for 6 hours. The End Date will be offset 6 hours from the Start Date.
The work hours for the Resource with the longest time duration are honored when calculating the End Date. This includes skipping over non-working days.

If no specific Resource has been assigned to the Activity, the work hours of the Testing Lab are used.

Appointments or other Activities assigned to the Resource are ignored in the End Date calculation.

For example, suppose a User works 9:00 a.m. to 5:00 p.m. Monday through Friday. In this case:

4 hours of work starting 10:00 a.m. Monday will finish 2:00 p.m. Monday.
4 hours of work starting 3:00 p.m. Monday will finish 11:00 a.m. Tuesday.
4 hours of work starting 3:00 p.m. Friday will finish 11:00 a.m. the following Monday.

Here is another example:

1.   There is a fixed Activity that is planned from 11 a.m. Wednesday to 1 p.m. Friday. The duration is 18 hours (6 hours on Wednesday + 8 hours on Thursday + 4 hours on Friday). The User works from 9 a.m. to 5 p.m.
2.   If work is started a day later, it will end at 1 p.m. on Monday. It will not end on Saturday because the User does not work on Saturday.
3.   The effect is shown as you move into the next week.

Show Plan

 

Opens the Manage Work page. This lets you work with the Plan. 

 

Percentage Workload Calculation

Top../images/arwup.gif (846 bytes)

Calculation of a Resource's Percentage Workload takes into account several factors.

At a high level, the formula for a Resource's availability on a given day is:

[Core Hours] - [time for Calendar Appointments] - [time assigned to Activites]

In reality, the formula is more complex, as it must to take into account:

Days when the User is not working.
Appointments that require a partial day, entire day, or multiple days.
Floating Activities, in which case work is not scheduled for a specific day. For example: The duration may be 5 hours, but work may be scheduled to occur any time Monday through Friday (assuming 1 hour per day).
Calculations for Work Areas (such as groups of Users). Consider that work can be assigned to a User in a Work Area or to the Work Area itself. Also, Users can rotate through Work Areas, so capacity for work fluctuates over time.
What are the "Core Hours" for an Instrument? For example, if an Instrument is used for a full working day (9 a.m. to 5 p.m.), does that indicate 100% utilization or only 33%?
Percentage Workload may be displayed for single days or date ranges.

The following examples demonstrate several load calculation scenarios. These are shown in the Workload Information dialog that opens when you click the Info icon.

1. On Monday, Bob works a total of 480 minutes, 180 of which reflect two Appointments. He also has a 180-minute Activity on that day. Bob is therefore 75% busy on Monday.
2. We now expand the Activity range to occur over 3 days instead of one. Bob still works 480 minutes and has 180 minutes of Appointments. However, because the Activity can occur at any time over a 3 day period, only 1/3 the total activity time is allocated to Monday.

Note that this is the same set of conditions as the previous example, but it is spread over 3 days. Moday is therefore only 1/3 of the total Activity time.

3. Bob then takes Tuesday as a vacation day. Even though the Activity range is 3 days, a full-day Appointment is treated as a non-working day. Therefore, the Activity must be completed over 2 days. The result is that 1/2 the total Activity time is allocated to Monday.
4. The Workload Information dialog can also be used to see how multi-day loads are calculated. This example shows a 5-day timeline. Bob is 43% loaded over the course of the week. Note that Tuesday is 100% because Bob is on vacation. The lost time is spread over Monday and Wednesday.
5. The Workload Information dialog can also show how Work Area loads are calculated. In this example, the "Viscometry" Work Area has two members (Alice and Bob). In addition to Bob and Alice having been assigned Activities, the Work Area itself also has two Activities assigned to it. This shows there is likely a problem in Viscometry on Monday, as it is 116% loaded. The calculation shows how the percentage load for the Work Area is calculated based on the percentage load of the members of the Work Area.

The planner can use this to correct the situation by doing things such as assign the work to a different day, click "Manage Users" and rotate Charlie through the Viscometry Work Area on Monday, and so on. To determine how the 116% was calculated, you can click the "116%" link.