The Resource Roster Console (RRC) is a console that enables schedulers to view all work for some or all resources for a payroll period.
The RRC is accessed by the Resource Roster Console tab in Salesforce.
By default, the current date will be the first day displayed. Resources are presented in alphabetical order. Use the pagination feature to toggle the resources you see.
Enter part of a resource name to quickly filter the resource list for matching names.
You can use the filters at the top of the console to filter resources using several parameters and actions.
-
Resource names—Enter the letters of the first or last name of a resource and select the matching record.
-
Tags—Enter the names of tags to filter resources that have matching tags.
-
Regions—Enter the names of regions to filter resources by their primary region.
Multiple records can be selected when filtering by Resource Name,Tags and/or Region.
-
The Apply button becomes active once valid parameters have been entered. Click the button to filter for matching resources.
-
The Clear button removes the filters and refreshes the list of resources.
-
The AND function searches for resources with all of the parameters entered.
-
The OR function searches for resources with any of the parameters entered.
Tip
When multiple records are selected within a parameter (e.g., multiple tags) these are always treated with the AND logic.
Group event jobs need to be managed from the group event page.
However, a new group event can be created using the Create Group Event button provided on the resource roster console.
All resource work, activities, and availabilities are laid out in a grid format with resources listed on the left column and dates listed in a row above the records.
Resource Work and Activities
Hovering over a work, activity, or availability record will display details about that item.
Availability Example
Unavailability Example
Activity Example
Single Client Job Example
Group Event Job Example
Shift Example
A resource’s scheduled hours and contracted hours can be viewed near their name on the Resource Roster Console.
Scheduled Hours v Contracted Hours Example
Values are shown as Scheduled Hours/Contracted Hours where:
-
Scheduled Hours equals the total work hours scheduled for the resource for the selected payroll period and includes:
-
Duration of all scheduled single booking work excluding any work with a tag included in the Salesforce custom setting Excluded_Scheduled_Hour_Tags.
-
Duration of all scheduled group event work excluding any work with a tag included in the Salesforce custom setting Excluded_Scheduled_Hour_Tags.
-
Duration of all scheduled shift work excluding any work with a tag included in the Salesforce custom setting Excluded_Scheduled_Hour_Tags.
-
Duration of all activities with the activity type listed in the Salesforce custom setting Payable_Activity_Types.
-
Duration of all availabilities/unavailabilities with the availability type listed in the Salesforce custom setting Payable_Activity_Types.
-
-
Contracted Hours equals the value set on the resource’s Salesforce record for Contracted Hours.
The View Period function for a resource opens a new screen that provides granular detail on the work, activities, and availability for an individual resource.
Work, activities, and availabilities can be added, edited, or deleted from this view the same as records on the main Resource Roster console view.
The individual resource view can be accessed from the resource’s name on the Resource Roster Console.
Select the ‘View All Resources’ link to return to the main view of the Resource Roster Console.
Work (i.e., single booking jobs, shifts, activities and availability/unavailability) can be added directly from the resource roster console.
When hovering over a date/resource combination on the console, select the + sign at the bottom left of the cell to display the options for adding a work, activity or availability item.
Selecting Cancel will hide the options and return to the console.
Existing work (i.e. Jobs, Shifts), Activities and Availabilities can be viewed or edited directly from the Resource Roster Console.
-
Hover over a work, activity or availability record to display a summary.
-
Right-click the work, activity or availability record to display further options.
The Add Availability option opens the Create Availability modal.
-
The Repeat function enables a recurring pattern of availability to be created on a weekly or fortnightly pattern. This pattern can be repeatable, and any global holidays can be skipped.
-
The All Day function makes the record a 24-hour availability for the date selected.
When the availability record is saved, there is a check to see if there is already an availability created for the proposed date/time.
-
If there is no clash, the new availability is saved.
-
If there is a clash, the Availability Conflicts modal is shown.
The options for managing all listed availability conflicts in one action are:
-
Reset—Clear any entries entered in the individual records.
-
Merge all—Merge the two records for each day into one record for the day using the earliest start time and latest end times.
-
Overwrite all—Replace all the existing records with the new records.
-
Cancel all—Do not create any of the new records and keep the existing records.
The merge, overwrite, and cancel functions can also be done on an individual level. In this scenario, an action must be selected for each conflict record before the record can be saved.a
-
The Repeat function enables a recurring pattern of availability to be created on a weekly or fortnightly pattern. This pattern can be repeatable, and any global holidays can be skipped.
-
The All Day function makes the record a 24-hour availability for the date selected.
When the availability record is saved, there is a check to see if there is already an availability created for the proposed date/time.
-
If there is no clash, the new availability is saved.
-
If there is a clash, the Availability Conflicts modal is shown.
The options for managing all listed availability conflicts in one action are:
-
Reset—Clear any entries entered in the individual records.
-
Merge all—Merge the two records for each day into one record for the day using the earliest start time and latest end times.
-
Overwrite all—Replace all the existing records with the new records.
-
Cancel all—Do not create any of the new records and keep the existing records.
The merge, overwrite, and cancel functions can also be done on an individual level. In this scenario, an action must be selected for each conflict record before the record can be saved.a
Hover over the availability record to display a summary of the availability.
Right-click an existing availability record to display availability record options.
-
Edit availability—Select to edit an availability record’s details.
-
Delete availability—Select to delete the availability record.
-
Cancel—Select to cancel the display of the options.
When deleting an activity, a Delete Availability? modal is displayed to confirm that the activity record is to be deleted.
Note
Once deleted, the availability record cannot be retrieved.
The Add Availability option opens the Create Activity modal.
The Repeat function enables a recurring pattern of availability to be created on a weekly or fortnightly pattern. This pattern can be repeatable, and any global holidays can be skipped.
The All Day function will make the record a 24-hour activity for the date selected.
The Repeat function enables a recurring pattern of availability to be created on a weekly or fortnightly pattern. This pattern can be repeatable, and any global holidays can be skipped.
The All Day function will make the record a 24-hour activity for the date selected.
Hover over the activity record to display a summary of the activity.
Right-click an existing activity record to display activity record options.
-
Edit activity—Select to edit an activity’s details.
-
Delete activity—Select to delete the activity.
-
Cancel—Select to cancel the display of the options.
When deleting an activity, a "Delete Activity?" modal is displayed to confirm that the activity record is to be deleted.
Note
Once deleted, the activity record cannot be retrieved.
The "Add Single Client Job" option opens the single booking "Schedule Job" modal, with the resource and the date already pre-populated.
Refer to Single Client Bookings (for job creation options).
Note
-
The Service Agreement Date field is an additional field that is displayed when adding a single booking job to a base roster.
-
The field is provided for flexibility when selecting the required client service line items.
-
The field defaults to the current system date.
Hover over the job record to display a summary of the job.
Right-click an existing Single Client job record to display the options for managing the job.
-
Edit job—Select to edit job details.
-
View in Skedulo—Select to view the job in the Skedulo web app.
-
Cancel—Select to cancel the display of the options.
The Add Group Event Job option opens a modal for the scheduler to select the Group Event for which the job will be added.
Select Group Event modal
When a Group Event has been selected then the Group Event Schedule Job modal is displayed with the resource and the date already pre-populated.
Group Event - Schedule Job modal
Note
-
The Service Agreement Date field is an additional field displayed when adding a group event job to a base roster.
-
The field enables flexibility when selecting the required client service line items.
-
The field defaults to the current system date.
Hover over the job record to display a summary of the group event job.
View Job Example
The Add Shift option will open the Create Shift modal.
The All Day function will make the record a 24-hour shift for the date selected.
Hover over the shift record to display a summary of the shift.
Right-click an existing shift record to display shift record options.
-
Edit Shift—Select to edit shift details.
-
Delete shift—Select to delete the shift.
-
Cancel—Select to cancel the display of the options.
When deleting a shift, a Delete Shift? modal is displayed to confirm that the shift record is to be deleted.
Note
Once deleted, the shift record cannot be retrieved.
The Base Roster feature on the Resource Roster Console enables a scheduler to configure regular lines of work for resources which can be repeatedly replicated to a future time period.
The following options are available for the Base Roster:
-
Manage Base Roster...
-
Configure one or more base rosters.
-
Access a base roster.
-
Add work and activities for resources.
-
-
Replicate Base Roster…
-
Validate the replication of a base roster to a future roster period.
-
Replicate a base roster to a future roster period.
-
-
Publish Roster...
-
Dispatch work to resources.
-
Sending a notification to resources of the published roster.
-
Configuration of Base Rosters includes…
-
Creating one or more Base Rosters for access from the Resource Roster Console.
-
Enabling the creation of jobs on the Base Roster.
-
Subscribing users to a public work group to receive email notifications of roster validation and/or replication.
-
Subscribing users to a public work group to receive email notifications of roster publication processing.
To enable access to base rosters, a system administrator is required to configure the base rosters using Salesforce custom settings.
The Salesforce custom setting Skedulo Shift Type Setting is used to enable the use of the base roster. Add a new Skedulo Shift Type Setting record and enter the following values. All other values can be left blank.
Base rosters are enabled by using a previous time period where there are no jobs, shifts, or activities.
|
Custom Setting Field |
Value |
Example |
|---|---|---|
|
Name |
A short, unique descriptive name for the roster |
“Base Roster 1” |
|
Category |
A category name for listing and managing base rosters within the custom setting |
"Base Rosters" |
|
Order |
The order in which the base rosters are to be listed on the console |
1 |
|
Start Date |
The start date of the base roster in format: “yyyy-mm-dd” |
2019-07-14 |
|
End Date |
The end date of the base roster in format: “yyyy-mm-dd” NoteThe End Date must be no less than seven (7) calendar days after the Start Date and no greater than twenty-eight (28) days after the Start Date. This restriction has been added to limit the data processing load on customer Salesforce orgs. |
2019-07-27 |
By default, jobs are not able to be created on dates prior to the current date.
Administrators are able to use a custom setting to allow the creation of jobs on dates prior to the current date:
-
Custom Setting: ‘Skedulo Config’ > ‘Allow_Past_Job_Creation_On_Booking’
-
Description: Set to true to allow job creation in the past for Single Client jobs and Group Event jobs.
-
Value: True or False.
-
Set to True to allow for the creation of jobs for dates on the Base Roster.
-
Following roster validation and/or replication processing, an email notification is distributed to all users added to a Salesforce public work group.
Add users who are to be notified to the ‘Roster_Replication_Notification’ public work group.
Once configured, the Base Rosters are accessed using the ‘Base Roster’ button on the Resource Roster Console.
Clicking the button will present a list of the base rosters which have been configured.
Selecting Base Roster
-
Select Base Roster - Select the required base roster from the drop-down list.
-
Close - Click to close the dialog and do not go to a base roster
-
Select - Click to go to the selected base roster
Once a Base Roster is displayed…
-
The ‘Base Roster Period’ value will display the dates to confirm which base roster was selected.
-
A ‘Back to Console’ button is provided to enable the user to return directly to the Resource Roster Console.
Base Roster Selected
When a Base Roster has been accessed, the schedule is able to add Single Booking jobs, Group Event jobs, Shifts and Activities for individual resources to the base roster.
Base Roster - Adding Work and Activities
The Base Roster has the ability to manage work and activities to be replicated with the base roster.
Refer to the relevant section for managing work or activity records:
Following the creation or updating of a Base Roster, the scheduled work and activities for all resources is then able to be validated and/or replicated from the Base Roster to a new Roster Period.
Replication is actioned by clicking the ‘Replicate Roster’ button on the console.
Replicate Roster Button
When clicked, the ‘Replicate Roster’ Modal is displayed.
Replicate Roster modal
The following options are available:
-
Base Roster Period
-
The ‘From Date’ and ‘To Date’ (inclusive) will be used as the source jobs to be replicated.
-
-
New Roster Period
-
The ‘From Date’ and ‘To Date’ (inclusive) will be used as the dates to which the Base Roster Period will be replicated.
-
-
Include Allocated Resources?
-
If selected, resources allocated to a job in the Base Roster Period will be allocated to the new replicated job in the New Roster Period (Default).
-
If not selected, no allocated resources will be allocated to new replicated jobs in the New Roster Period.
-
-
Skip Holidays?
-
If selected, no jobs will be replicated to dates that have been configured as Holidays in the Skedulo package.
-
If not selected, jobs will be replicated to dates configured as Holidays (Default).
-
-
Include Jobs?
-
If selected, all Base Roster jobs will be included in validation or replication (Default).
-
If not selected, no Base Roster jobs are included invalidation or replication.
-
-
Include Shifts?
-
If selected, all Base Roster shifts will be included in validation or replication (Default).
-
If not selected, no Base Roster shifts are included invalidation or replication.
-
-
Include Activities?
-
If selected, all Base Roster activities will be included in validation or replication (Default).
-
If not selected, no Base Roster activities are included invalidation or replication.
-
The actions available are...
-
Cancel
-
Select to cancel the replication.
-
-
Validate
-
Select to trigger a background process to identify any conflicts which new replicated jobs would have in the new Roster period.
-
A notification email of the validation results will be distributed when validation has finished processing.
-
-
Replicate
-
Select to trigger a background process to validate and replicate jobs in the Base Roster Period into the New Roster Period. A notification email of the replication results will be distributed when replication has finished processing.
-
Important
-
Selecting ‘Validate’ does not create jobs in the New Roster Period.
-
Selecting ‘Replicate’ will create jobs in the New Roster Period
Custom Settings
The following custom settings, configurable in Salesforce, allow additional fields to be included and certain fields to be excluded when replicating work.
|
Custom Setting |
Description |
|
Job_Replication_Extra_Fields |
Additional job fields to be included in the roster replication |
|
Job_Replication_Excluded_Fields |
Job fields to be excluded from the roster replication |
Note
Custom fields are not able to be included or excluded in roster replication.Replicate Roster Validations
The following possible outcomes may be listed in the email Notification depending on the outcome from the validation and/or replication processing.
Table 4.
|
Conflict Name |
Conflict Info |
|---|---|
|
New Job Conflicts with Existing Job |
The new scheduled job is conflicting with an existing job to which the resource has been allocated. <A list of existing work to which the resource is already allocated> |
|
New Job Conflicts with Existing Shift |
The new scheduled job is conflicting with an existing shift to which the resource has been allocated. <A list of existing work to which the resource is already allocated> |
|
New Job Conflicts with Existing Activity |
The new scheduled job is conflicting with an existing activity to which the resource has been allocated. <A list of existing work to which the resource is already allocated> |
|
New Shift Conflicts with Existing Job |
The new scheduled shift is conflicting with an existing job to which the resource has been allocated. <A list of existing work to which the resource is already allocated> |
|
New Shift Conflicts with Existing Shift |
The new scheduled shift is conflicting with an existing shift to which the resource has been allocated. <A list of existing work to which the resource is already allocated> |
|
New Shift Conflicts with Existing Activity |
The new scheduled shift is conflicting with an existing activity to which the resource has been allocated. <A list of existing work to which the resource is already allocated> |
|
New Activity Conflicts with Existing Job |
The new scheduled activity is conflicting with an existing job to which the resource has been allocated. <Existing job to which the resource is already allocated> |
|
New Activity Conflicts with Existing Shift |
The new scheduled activity is conflicting with an existing shift to which the resource has been allocated. <Existing shift to which the resource is already allocated> |
|
New Activity Conflicts with Existing Activity |
The new scheduled activity is conflicting with an existing activity to which the resource has been allocated. <Existing activity to which the resource is already allocated> |
|
SA Line Item Dates Exceeded |
New scheduled work date is not within the service line item date range. |
|
Exceeds Service Agreement Balance Remaining |
The total cost of newly replicated work plus any scheduled work not yet completed or cancelled does not exceed the balance remaining on the client’s service agreement linked to the work. |
|
Exceeds Service Line Item Balance Remaining |
The total cost of newly replicated work plus any scheduled work not yet completed or cancelled does not exceed the balance remaining on a client’s service line item linked to the work. |
|
Resource Unavailable |
The allocated resource is unavailable for the part or all of the new scheduled work. |
|
Resource Does Not Have Required Skills |
The allocated resource does not have all the required skills for the new scheduled work. Missing skills are: <List of missing job skills> |
|
Resource Scheduled Hours Less than Contracted Hours |
Resource’s scheduled hours for the period are less than resource’s contracted hours for the period: <Resource Name with link to resource record> |
|
Resource Scheduled Hours Exceeds 76 Hours |
Resource scheduled hours are greater than 76 hours: <Resource Name with link to resource record> |
|
Resource Unavailable for New Activity |
The allocated resource is unavailable for the part or all of the new activity. |
A New Roster Period can be published, when a Base Roster has been replicated to a future roster period and has been verified as ready for publication.
Note that following replication, it is still possible to add, view and update work and activities in the new roster period in preparation for publication by the scheduler.
Click the ‘Publish Roster’ button to publish a new roster period.
Publish Roster Button
Click the Publish Roster button to open the Publish Roster modal.
In the modal, select the Roster Period ‘From Date’ and ‘To Date’.
Publish Roster Modal
-
Cancel - Cancels the roster publication.
-
Publish - Publish the roster.
Publishing a roster results in three outcomes.
-
The work between and including the new roster period dates will be dispatched to the allocated resources.
-
A single notification will be sent to each resource with at least one allocated work item within and including the new roster period dates.
-
An email notification with details of the publication will be sent to Salesforce users registered with the nominated public work group.
Publishing a roster generates an email to schedulers who have subscribed to the roster Publication Work Group.
The roster publication email notification contains the outcomes of the poster publication with the following details…
-
Subject: “Published Roster - <From Date>; to <To Date>”
-
“The roster for <From Date> to <To Date> has been published.”
-
Date and time the publish roster was started.
-
Date and time the publish roster was finished.
-
Name of the person who triggered the publish roster function.
-
Total number of jobs published.
-
List of published jobs including a link to the job record.
-
Total number of shifts published.
-
List of published shifts including a link to the shift record.
-
Total number of resources notified.
-
List of resources notified including a link to the resource record.
Publishing a roster generates an SMS notification to resources which contains the outcomes of the poster publication.
The roster publication email notification is as follows…
“The roster for <From Date> to <To Date> has been published and your allocated work is available for viewing in the Skedulo mobile app”
You can print a weekly roster for a location from the Resource Roster Console.
Click the Print Roster button to print a weekly roster for a location.
Print Roster button
When the Print Roster button has been clicked then the ‘Print Roster’ modal is displayed.
When displayed select the Location and Start Date.
Print Roster modal
The options available are…
-
Include Jobs?
-
If selected, the week’s jobs for the Location will be included in the printed roster (Default).
-
If not selected, no jobs for the Location are included in the printed roster.
-
-
Include Shifts?
-
If selected, the week’s shifts for the Location will be included in the printed roster (Default).
-
If not selected, no shifts for the Location are included the printed roster.
-
-
Include Activities?
-
If selected, the week’s activities for the Location will be included in the printed roster (Default).
-
If not selected, no activities are included in the printed roster.
-
-
Ignore Work Status?
-
If selected, the work status is ignored and all work is added to the printed roster.
-
If not selected, only current work is added to the printed roster (Default).
-
The actions available are...
-
Cancel
-
Select to cancel the printing of the roster.
-
-
Print
-
Select to generate a PDF of the Location’s roster for the selected week.
-
Example Location Roster printout
Comments
0 comments
Article is closed for comments.