How many 10 minute units would be scheduled for an appointment expected to last 1 hour?

Why doesn’t Resource Scheduling Optimization on Org B work anymore after I copied Dynamics 365 Org A to Org B (with Resource Scheduling Optimization deployed)?

Resource scheduling optimization Endpoint, which is used for connecting Dynamics 365 org and Resource Scheduling Optimization Azure resources on Org B, will be broken after copying an org or rest org. We recommend deleting the current Resource Scheduling Optimization deployment, which won't delete anything else in the Dynamics 365 org. Then, copy and reset the org and then redeploy Resource Scheduling Optimization to target the Dynamics 365 org as needed.

My Resource Scheduling Optimization deployment takes a long time and won’t finish. What should I do?

If your Resource Scheduling Optimization deployment won’t complete, you'll need to contact the Microsoft Support team.

My Resource Scheduling Optimization deployment or upgrade failed. What should I do?

If you see the Delete Current Deployment option through the Resource Scheduling Optimization deployment app, you can delete the existing deployment, and then redeploy the latest version. If it fails again, check the admin settings. If the settings are correct but it still fails, contact the Microsoft Support team.

• Make sure your Dynamics 365 org is NOT in administration mode.

• Check to see that the Resource Scheduling Optimization add-on user has the Resource Scheduling Optimization security role.

Installing the Resource Scheduling Optimization solution failed through the Dynamics 365 admin center solution management page. What are my options?

Don’t install the Resource Scheduling Optimization solution from the solution management page. Use the Resource Scheduling Optimization deployment app to deploy Resource Scheduling Optimization. The deployment includes the Dynamics 365 solution and Azure resources.

Can I modify the out-of-box Resource Scheduling Optimization security role?

We don’t recommend changing the out-of-box security role directly. A modified out-of-box security role can cause issues like upgrade failures, jobs not pulling requirements/bookings as expected, and more. Instead, copy it as a new role and customize as needed.

How do I cancel a long-running schedule or blocked schedule?

If your schedule has been running for a long time and seems stuck, select Reset Resource Scheduling Optimization. This option clears the blocked job and resets the schedules into a good state.

I’m seeing the message “SAS Key hasn't been configured” when I publish a schedule. Is this ok?

The message means the Resource Scheduling Optimization Azure resources aren't set up correctly. We recommend going to the Resource Scheduling Optimization deployment app to check the Resource Scheduling Optimization deployment status. Redeploy as needed to fix the issue.

An optimization request failed and gave the message “Object reference not set to an instance of an object.” What does that mean?

Typically, a custom plug-in ran into an unhandled null value. It can occur because of a custom plug-in that is triggered synchronously on the creation of a booking, the update of a work order, or other booking-related record, or one of the other records that could be impacted when the results are returned by an optimization run. System customizers can use the plug-in trace log capability to identify which plug-in is failing. Warning: don’t forget to disable plug-in trace logging as soon as debugging is over to avoid overloading the organization’s database.

Why has an optimization request failed with the message “System failed to modify some bookings.”?

Sometimes you see this message for the following scenarios:

• If you manually update the same bookings in the middle of a Resource Scheduling Optimization run, Resource Scheduling Optimization won't overwrite the changes, and will fail the request.
• If you have a workflow/plug-in updating the same bookings during a Resource Scheduling Optimization run, Resource Scheduling Optimization won't overwrite the changes your other system logic did, and will fail the request.
• If you have multiple Resource Scheduling Optimization schedules that share the same resources and run at the same time, Resource Scheduling Optimization might show this message. To better understand the situation and further troubleshoot, check the following options:
  • Scroll through the optimization request booking grid and inspect the operation details column for each individual requirement and booking.
  • Do you have multiple schedules that share the same resources, requirements, and bookings running at the same time?
  • If you have only one schedule, is there any other user or workflow trying to update a booking during the run?

An optimization request failed with the message “The start time of a time window must be less than or equal to the end time.” What should I do?

The message indicates some invalid booking data got included in the optimization scope. For example: The user can query a booking entity to see if any booking record has an invalid estimated travel duration. You can specify the following expressions for the view:

• Estimated travel duration > Booking.EndTime - Booking.StartTime
• Estimated travel duration > Booking.Duration

Why aren’t my resources getting any bookings assigned?

There are various possible reasons. First, review the optimization results from the schedule board and corresponding optimization request > resource view to look for reasons why bookings aren't being scheduled. Here are more details to analyze:

• Territories:
  • Do your resources have related resource territories that match requirement territories?
• Resource attributes:
  • Is the Optimize Schedule field set to Yes?
  • Do your resources have a start and end location set?
  • Do their locations have geocodes?
    • Organizational Unit Address’ geocode is held in the related Organizational Unit.
    • Resource Address’ geocode is held on the related resource’s user/contact/etc.
• Characteristics:
  • Do your resources have any of the required characteristics and required skill levels?
• Work hours:
  • Are work hours configured and available during the optimization range?
    • If they're unconfigured, they could still be scheduled.
    • They might be set to not work on the days being optimized per the Resource Scheduling Optimization run scope.
  • Do they have any time off requests created or approved for the period of time that is being optimized?
• Resource preferences:
  • While unlikely, would resource preferences exclude them from consideration from all of their possible work orders and resource requirements?
• Status:
  • Is the resource’s status Active?

Why aren’t my work orders/requirements being scheduled?

There are various reasons why requirements might not get booked. First, review the optimization results from the schedule board and corresponding optimization request > Booking view to look for reasons why they’re not being scheduled. Here are more details to analyze:

• As a quick validation, select one of the resource requirements that won’t schedule and use the Schedule Assistant to see if it finds results.

  • While the schedule assistant and the Resource Scheduling Optimization aren't exactly the same, they evaluate based on similar criteria and if the Schedule Assistant finds results, Resource Scheduling Optimization generally will, too.

    Note

    There are some scenarios where the Schedule Assistant may find results and the Resource Scheduling Optimization won’t.

    • If your resources found as potential matches don't have Optimize Schedule set to Yes (meaning Resource Scheduling Optimization wouldn't consider them).
    • If your date windows on the requirement are outside of the scope of your Resource Scheduling Optimization run.
    • If your territory for the requirement doesn’t match the resources’ territory.

• Scheduling method:

  • Is the requirement’s Scheduling Method set to Optimize?

    Note

    This field is set to Don't Optimize by default. You either need to set it manually or configure Optimize on work order metadata setup.

• Territories:

  • The Resource Scheduling Optimization scope doesn’t necessarily depend on territory, but the Resource Scheduling Optimization run still does a territory match between requirement and resource:
    • If a requirement is assigned to a territory, then the resource must also be assigned to that territory for the requirement to be scheduled.
    • If a requirement isn't assigned to a territory, then only resources that don’t belong to any territory are eligible for that requirement.

• Characteristics:

  • Does your requirement require a characteristic that any of your resources have?
    • Do those resources have available working hours that are part of the scope of the run?
    • Based on those resources, are there other jobs that were/should be scheduled first based on the goals of your run?

• Restricted resources:

  • Is the requirement excluded from being assigned to a resource because that resource is marked as restricted? This behavior only applies if the Restricted Resources constraint is enabled.

• Date/time parameters:

  • Does your requirement have a From Date and To Date window that falls inside the scope of the optimization run’s scope?
  • Does your requirement have a Time From Promise and Time to Promised window that falls inside of the scope?
  • Do any of your date fields create an impossible scenario? For example:
    • Your From Date is after your Time to Promised.
    • Your To Date is before your Time From Promised.

• Capacity:

  • Is there sufficient capacity to pick up all of the work in your scope?
    • If not, is there a valid reason that this requirement might not have been selected based on your goals over other possible requirements?
  • Is there sufficient capacity based on the required characteristics and resource preferences within the scope of the run (with all other contributing factors)?

• Geolocation:

  • If the Work Location for the requirement is set to Onsite, the resource requirement needs to have a valid latitude and longitude. Also, does the resource have time to get to and from the job?

• Duration:

  • Does the resource requirement have a duration greater than 0? Does fulfilled duration = 0?
  • Does the requirement have a duration that would fit within a resource’s shift? Resource scheduling optimization doesn't currently support splitting a requirement into multiple bookings.

• Status:

  • Is the Status of the resource requirement set to Active?

• Related bookings:

  • Does this requirement already have a related booking record? If so, does the related booking record have a related booking status with a Scheduling Method field with a value other than Ignore?

• A schedule that might cause the requirement to impact/lower the score of optimization objectives.

• Optimization engine effort level: Larger optimization requests might require more time to optimize. Consider increasing the engine’s effort level to give it more time to find a suitable assignment.

Why are my completed, canceled, or other bookings being optimized when they shouldn’t be moved?

Booking Status has a Scheduling Method field that dictates how Resource Scheduling Optimization should consider booking records of that status:

• If Booking Status is set to Optimize, Resource Scheduling Optimization will move those bookings around.

• If Booking Status is set to Don't Move, Resource Scheduling Optimization won't move or optimize those bookings.

• If Booking Status is set to Ignore, Resource Scheduling Optimization won't consider that booking record; it will be as if the booking record doesn’t exist.

  Note

  Typical setup would dictate:

  • Booking statuses indicating the visit is complete or in some stage of progress should be set to Don't Move.
  • Booking statuses indicating the visit is canceled should be set to Ignore.
  • Booking statuses indicating the visit is scheduled or any other status where you want Resource Scheduling Optimization to consider moving the work around should be set to Optimize.

Why are some of my past bookings being removed?

A booking from the past might be moved if its booking status indicated that it should be optimized and if this booking is included in the optimization scope’s booking view. Thus, it might appear (especially in a test scenario) that all of the bookings from the past are being rescheduled if the booking wasn't set to a booking status that keeps the record from being moved. Here are a few ways you can block Resource Scheduling Optimization from moving past bookings:

• Pick a booking status of Don't Move.
• Remove the booking from the booking view.
• Lock the booking to a time or time range in the past.
• Set a promised date from/to or date from/to while enabling the time window constraint.

Can I have my resources start and end their day at different locations?

Yes, you can, as long as neither locations are location agnostic. For more information on the configuration, see start/end location section of this article. Additionally, if the resource is required to start/end from a location that is not resource address or organizational unit address, there is a workaround that can be used:

1. Extend the resource work hours by 10 minutes at the start and end of the shift. For example, if the resource's shift is from 9AM to 5PM, change it to 8:50 AM to 5:10 PM.
2. Create bookings that are locked to resource and time for these two 10-minute time slots. Work with dummy requirements located at the place the resource is expected to start/end. Using this temporary work-around, your resources can start and end at locations other than just their resource address or organizational unit address.

What happens if I remove the "Schedule within Working Hours" constraint?

When you remove this constraint, Resource Scheduling Optimization will still respect working hours and create bookings within the resource's working hours but can schedule travel outside of working hours. It might not leave time at the end of the day to travel to the resource's end location. All bookings will end within a resource's working hours.

Why are some of my past or future bookings that are outside of the optimization start and end range being removed?

With extensible scope, optimization range settings (Range Reference, Range Offset, Range Duration (days)) are the time range where bookings can be created, updated, or deleted. It has nothing to do with the scope of bookings. Here are some scenarios:

• Optimization Booking View and Optimization Range Settings configured as in the following screenshot. There are five bookings (A, B, C, D, E) included in the Scheduling Summary – Scheduled by RSO-WA booking view when they're being scheduled, with this configuration:

  • All five bookings will possibly be moved into the optimization range start/end area if there's enough capacity.

  • If a booking locked to Time Range overlaps with the optimization range, the booking will be moved. If the locked time range is outside of the optimization range, the booking will be ignored.

• If you add Now or After = 1 hour and other settings remain the same, there are still five bookings (A, B, C, D, E) included in the Scheduling Summary – Scheduled by RSO-WA booking view when they're being scheduled, with this configuration:

  • Only three bookings (C, D, E) will be possibly moved into the optimization range start/end area if there's enough capacity.

  • Booking A is in the past before Now or After will be excluded from the scope.

  • Booking B is overlapping with the Now or After line and will be considered as locked.

  • For a booking locked to Time Range, if a locked time range overlaps with the optimization range, the booking will be moved. If the locked time range is outside of the optimization range, the booking will be ignored.

• If you add Now or After = 4 hours and the other settings remain the same, there are still five bookings (A, B, C, D, E) included in the Scheduling Summary – Scheduled by RSO-WA booking view when they're being scheduled, with this configuration:

  • Only two bookings (D, E) will possibly be moved into the optimization range start/end area if there's enough capacity.

  • Bookings A and B are in the past before Now or After will be excluded from the scope.

  • Booking C is overlapping with the Now or After line and will be considered as locked.

  • For a booking locked to Time Range, if a locked time range overlaps with the optimization range, the booking will be moved. If the locked time range is outside of the optimization range, the booking will be ignored.

• If you add Now or After = 27 hours and the other settings remain the same, there are still five bookings (A, B, C, D, E) included in the Scheduling Summary – Scheduled by RSO-WA booking view when they're being scheduled, with this configuration:

  • Only one booking (E) will possibly be moved into the optimization range start/end area if there's enough capacity.

  • Bookings A, B, C, and D are in the past before Now or After will be excluded from the scope.

  • For a booking locked to Time Range, if the locked time range overlaps with the optimization range, the booking will be moved. If the locked time range is outside of the optimization range, the booking will be ignored.

Why are so many bookings in simulation status?

If any exception or error happens when an optimization schedule is still running, you might see some overlap on the schedule board. Some bookings are created or updated from the latest run while other bookings from the previous run failed to be deleted due to an exception. To avoid this issue, the optimization process becomes transactional in the Simulation status. During the optimization process, the create, update, and deleted operations are now visible. All new, updated, and to-be-deleted bookings are in a Simulation staging area. If the whole optimization request is completed and correct, these simulation bookings will be flipped into real bookings. Before the optimization request completes, you can see some simulation status (transparent) bookings move around the schedule board until the run is complete. Then all simulation bookings will be flipped into real bookings (solid blue). If an exception occurs and the optimization request fails, these simulation bookings will remain in simulation status for troubleshooting purposes unless you manually delete them. Otherwise, a system job will delete them automatically every two weeks.

Note

You can hide simulation bookings by changing the schedule board settings. Select the gear icon on the top right and select the Hide Canceled option.

Why is Resource Scheduling Optimization scheduling bookings that overlap with resource break times?

Right now, Resource Scheduling Optimization can’t split travel time from the booking from a visual perspective. It looks like Resource Scheduling Optimization is scheduling bookings that overlap break time, but actually they aren't because Resource Scheduling Optimization can’t split travel time from its working duration tile from the schedule board visualized view perspective. What you see on the schedule board may look like this:

Ideally, it should look like this:

Why am I seeing the error message "User lacks privileges"?

If you experience an optimization job failure with the error message "Related failed to update bookings," go to the bookings tab and search for failed bookings. There's a more detailed error message: "User lacks privileges."

To fix this issue, make your Resource Scheduling Optimization user has the correct security roles and field security profiles:

Security roles:

• Resource Scheduling Optimization

Field security:

• Resource Scheduling Optimization - Administrator
• Resource Scheduling Optimization - Dispatcher

How to copy security user roles

Sign into the environment as administrator.

Go to Settings > Security > Users > Application Users view.

Find the user named "Resource Scheduling Optimization." This user is created when Resource Scheduling Optimization is deployed.

You can also use advanced find to create a query to find users that have first name containing "Resource Scheduling."

Edit columns to include created date to easily decipher when the Resource Scheduling Optimization user was created.

Go to the newly created user view and make sure both Resource Scheduling Optimization users have the same roles including "Resource Scheduling Optimization".

How to copy field security profiles

Sign into the environment as an administrator.

Go to Settings > Security > Field Security Profiles view.

Find the user named "Resource Scheduling Optimization." This user is created when Resource Scheduling Optimization is deployed. Use advanced find field security profiles that have users with the first name containing "Resource Scheduling."

Add Resource Scheduling Optimization users to the "Resource Scheduling Optimization - Administrator" and "Resource Scheduling Optimization-Dispatcher" field security profiles.

Ensure field security profiles have consistent permissions when comparing the old and new app users.

Why am I seeing the error message that a user doesn't have read permissions when running Resource Scheduling Optimization?

If you run Resource Scheduling Optimization and get an error like the one below, add the system administrator security role to the user running Resource Scheduling Optimization.

[External Exception [Microsoft.Dynamics.FieldService: Microsoft.Dynamics.FieldService.FieldServicePlugin]]Principal user (Id=c4c45efe-866d-eb11-a812-000d3a8eefe9, type=8, roleCount=1, privilegeCount=110, accessMode=4), is missing prvReadmsdyn_workorder privilege (Id=912a06d3-4545-4bea-bbd1-18661ff70424) on OTC=10425 for entity 'msdyn_workorder'. context.Caller=c4c45efe-866d-eb11-a812-000d3a8eefe9. Or identityUser.SystemUserId=dd1c82e4-ddf4-45fd-a1bf-4efd51274d04, identityUser.Privileges.Count=5978, identityUser.Roles.Count=0 is missing prvReadmsdyn_workorder privilege (Id=912a06d3-4545-4bea-bbd1-18661ff70424) on OTC=10425 for entity 'msdyn_workorder'.

Can I use Resource Scheduling Optimization in more than one Dynamics 365 organization?

You can deploy multiple instances for Resource Scheduling Optimization in the same Microsoft 365 tenant. A Resource Scheduling Optimization instance can connect to one Dynamics 365 organization only. For more information, see Deployment information for Resource Scheduling Optimization.