Skip to main content
All CollectionsSelf-rosteringFor roster administrators
Reviewing and finalising preference-based rosters
Reviewing and finalising preference-based rosters
Charles Lynam avatar
Written by Charles Lynam
Updated over 2 months ago

Preference-based rosters normally require a roster administrator to finalise the roster for publishing. This article shows how to review users' preferences, develop a draft roster automatically, edit any selections, and finalise the roster for publishing.

To access the preference roster after the window has closed, go to the 'Closed' tab on the self-roster pages (A) and select Manage selections (B) from the Actions menu.

There are 4 main tabs (C):

Selections: see who has expressed what preferences for what shifts, and how many people have expressed a preference for each shift. If blockouts have been enabled for the self-roster, this tab will appear as Selections/Blockouts, and you can see details on users' blockouts for each shift.

Drafts: build and edit the proposed roster

Stats: review each user against their quota, the number of shifts they selected and the number of shifts they have been assigned.

Finalise: finalise the roster as a draft or publish to the main roster page

The Selections tab

Any shift that has at least one preference will be shown in green and any shift that has no selections against it will be shown in pink. The number of selections is listed at the bottom of each shift. In the example in the screenshot above (E), there are four people who have expressed a preference (in green) and one person who has expressed a blockout (in navy) for Monday August 4.

To see the selections of an individual, select their name from the 'Show data for' dropdown (D). The status of the selections is shown by the colour (see example in F), and may change colour as you build your rosters:

Yellow (e.g. August 6): Preferences picked by this user, but the person has not been assigned to that shift

Green (e.g. August 4): Preferences picked by this user, and the person has been assigned to that shift.

Navy (e.g. August 7): a blockout shift chosen by this user, which only applies if you allowed blockouts on this roster.

Grey (e.g. August 8): a shift that has been assigned to a person which was not on their preferences. If you staff someone on a shift that they have blocked out you will see a warning icon (e.g. August 13).

The Drafts tab

The simplest way to start building a roster is to click the 'Create drafts' button. This will run HosPortal's automated roster-building algorithm and create a draft roster. If a draft already exists, this will appear as a 'Refresh drafts' button (G), which will override the current draft with a new one.

The status of shifts is shown by colour (H):

Pink (e.g. August 13): a shift that has not been drafted yet.

White (e.g. August 5): a shift that matches a user's preferences

Yellow (e.g. August 12): a shift assigned to someone that does not match their preferences. If you assign someone to a shift that they have blocked out (something HosPortal's algorithm will never do, but you can do manually) you will see a blockout icon (e.g. August 8).

If a shift is left vacant, this will be labelled in red text (e.g. August 12).

How HosPortal's algorithm works

HosPortal's roster-filling algorithm uses a semi-random process to fill a roster. The rules it uses are that a user will never be staffed on a shift:

  • that they have blocked out

  • when they are on leave

  • if adding that shift would cause them to exceed their assigned roster quota

  • in a way that breaks one of the shift conflict rules or shift work rules. For instance if your rule prohibit someone working 2 shifts in a row, or prohibit someone working a shift on this roster the day before they have an activity on another roster that is already published.

Roster administrators can override any of these rules by editing a shift manually.

If there is a large aggregate of excess quota allocated to users the the random nature of the algorithm will generally tend to allocate shifts fairly across all users, rather than leave some users un-staffed. But you can check this at any time on the Stats tab (C) and - if desired - run the algorithm any number of times by pressing the 'Refresh drafts' button (G).

To edit a shift

Click on the pencil icon of any shift to edit it. The selection menu (I) includes options to:

  • 'Change user', to change the user assigned to a shift. The dialog (J) will display the users who selected the shift as a preference, and also provide options to filter the participants on your roster to see only those who have not met their quota, or users who conflict with the current shift as defined by any conflict rule.

  • 'Pin' a user to a shift to make sure that HosPortal's algorithm does not move them when you select 'Refresh drafts'. This can be helpful to manually fill difficult shifts first before filling the rest of the roster with HosPortal's algorithm. Pinned users are shown with a pin icon, for instance Dr Kildare on August 5 (H).

  • 'Vacate' the shift by removing the user that is currently assigned to that shift.

Finalising the roster

You can leave the roster in working state and come back to it at any time.

To finalise the roster and transfer it to the main roster page, go to the Finalise tab. This will lock down the selections as they exist on the Drafts tab and transfer them to the main roster. Before finalising, you can see an overview of the selections in the Drafts tab (K), as well as choose to transfer them in Published state, which makes them visible to users immediately, or in Draft state, for a roster administrator to publish later (L). There is also an option to place any vacant shifts on the market.

To complete the transfer, type 'confirm' and click the 'Finalise' button (M).

Once a roster is finalised you can no longer edit it on this Drafts tab. You can however always come back to this tab in the future to see the status of the roster at the moment you finalised it. You can also review the Selections tab at any time in the future, too.

The Stats tab

The Stats tab allows you to review each user against their quota, the number of shifts they selected and the number of shifts they have been assigned. If you have used blockouts it also reports the number of blockouts users have selected.

The data reported against each person (N) are:

Quota name: if there are multiple quotas, e.g. for weekdays and weekends, then data on each quota is reported separately.

Quota: the quota assigned to each person. This could be reported in points if shifts are worth different amounts. Anyone where the draft shifts is less than the quota assignment is flagged with a yellow alert icon.

Prefs: the number of preferences expressed by each person. A count of 0 means that person did not pick any preferences at all.

Drafts: the number of shifts assigned to each person.

Match: the number of shifts assigned to each person that matches their preferences.

Match percent: the ratio of Match divided by Drafts. If someone did not express any preferences then this percentage is not able to be calculated.

Other options for presenting the data are at the top of the table (O):

  • Download to export statistics data to Excel

  • Only show people who have expressed a preference for at least 1 shift.

  • Only show people who have not yet met their quota

  • Filter statistics by roster, if more than one roster is involved in this self-roster process.

  • View blockouts: present data on the number of blockouts people have selected, and the maximum number of blockouts they were allowed to select.

Did this answer your question?