Note
If you're looking for help with errors, unexpected behavior, crashes, and bugs, create a Dynamics 365 support ticket.
Why did I receive an email or Message Center notification about a Field Service update?
Roughly once a month, Field Service pushes a standard update to customers on Field Service version 8.8.6 and higher. A message is sent each month prior to this update highlighting that an update is planned. For more information on this update, see our documentation on the different kinds of Field Service updates and when Field Service updates are planned.
The other type of update messages that some may have received highlights that one or more of your environments are on a version of Field Service lower than 8.8.6. This message advises that you need to upgrade your environment as soon as possible or Microsoft will conduct the update for you. Be sure to take action as soon as possible.
As this message states, we strongly recommend that customers conduct this update on their own, as soon as possible. Updating yourself means that you can take appropriate testing measures and change management steps. The only validation that we are able to conduct will confirm that the upgrade will succeed based on the environment configuration at the time of our test. Our validation will not validate other potential functional disruptions following an unmanaged update.
To get all of our customers to the latest version of Field Service, Microsoft will be conducting these updates between now and December. These Microsoft-applied updates will happen in a phased manner; when your environments are selected to receive this update, you'll receive a message highlighting a specific date that your environment will be updated, with additional language highlighting some additional details about the process.
Why is Field Service missing from the sitemap navigation?
As of Field Service v8.x, you can find Field Service among the other Dynamics 365 apps by selecting Dynamics 365 in the top left and selecting Field Service.

The navigation is different from previous versions (7.x and 6.x), where Field Service was found in the menu as seen in the following screenshot.

Can I customize out-of-the-box web resources, option sets, security roles, or workflows?
No. Customizing, taking dependencies, or custom invocation of these components is not supported and could result in unintended system behaviors. Organizations that customize these components may not immediately cause the environment to break; but eventually, as Microsoft releases changes to the customized components, the changes will not be applied to the top layer of that component. The specific customized layer will override all future changes, which will eventually cause the instances that have customized these components to experience unpredictable errors and behavior.
Why are there work orders with duplicate work order numbers?
This issue occurs when generating a large number of work orders in parallel. As of Field Service version 8.6.0.274+, you can prevent this from occuring if you opt in to the Auto Numbering function in Field Service Settings.
Why can't cascade crew changes be disabled for a booking scheduled to a crew or group
This issue happens when a booking is assigned from a resource (not crew or group) to a crew or group and the value of msdyn_CascadeCrewChanges in the booking is set to false. To overcome this issue, open the booking and set the value of msdyn_CascadeCrewChanges to Yes. Then, reperform the booking assignment to a crew, which will fix the error the user sees when assigning the booking to a crew.
Can I modify, edit, or delete Field Service date fields or statuses?
No. Modifying, editing, or deleting date fields and statuses can affect business logic and may disrupt solution upgrades. Examples of work order date fields include date window start, date window end, time from promised, and time to promised. Examples of status fields include work order system status and agreement system status.
Why do I get the error message "This form can only be used on service-maintenance based records. Record is read only"?

Field Service makes the out-of-the-box Field Service opportunity, lead, quote, and invoice forms read-only once Field Service detects the record is not a service-maintenance based record. Field Service forms or the forms copied from Field Service forms do not support opportunity, lead, quote, and invoice records other than Field Service opportunity, lead, quote, and invoice. If you want to use an opportunity form for non-Field Service-related opportunities, use the out-of-the-box opportunity (Opportunity: Opportunity) form shipped by Dynamics 365 Sales or copy this form for further customization. The same is true for lead, quote, and invoice.
In addition, some organizations may see this error after upgrading from versions of Field Service earlier than version 8. In this scenario, the issue is usually with copied forms on these entities; customers might have to update the event handlers to call either the x.Library.load for Field Service forms or x.Library.loadStandardForm handlers for these entities’ standard, out-of-the-box forms.
Why do I get an AttributeMap error when upgrading and how do I fix it?
You may have encountered one of these two errors during upgrade:
- "An AttributeMap, with ID: GUID, between attribute customerid and msdyn_serviceaccount of entity incident and msdyn_workorder, has an unmanaged base instance and therefore cannot be updated by a managed solution."
- "An AttributeMap, with ID: GUID, between attribute customerid and msdyn_billingaccount of entity incident and msdyn_workorder, has an unmanaged base instance and therefore cannot be updated by a managed solution."
You can resolve this issue by following the steps outlined below. The attribute maps will be automatically recreated by upgrading to a newer version. Review these two attribute maps and delete them in your environment.
Error with customerid and msdyn_serviceaccount
- Go to Settings > Customization > Customize the System.
- Go to Entities > Work Orders > N:1 Relationships.
- Double-click on the row called msdyn_account_msdyn_workorder_ServiceAccount.
- Select Mappings.
- Select the Service Account mapping and delete it.
- Run upgrade again.

Error with customerid and msdyn_billingaccount
- Go to Settings > Customization > Customize the System.
- Go to Entities > Work Orders > N:1 Relationships.
- Double-click on the row called msdyn_account_msdyn_workorder_BillingAccount.
- Select Mappings.
- Select the Billing Account mapping and delete it.
- Run upgrade again.

What is the msdyn_postponegenerationuntil field that is found on many Field Service entities?
The msdyn_postponegenerationuntil field is intended for internal use only as it is used for workflow record generation design. Manipulating values in this field or taking dependencies on it is not supported and can lead to unexpected system behavior.
This field is found in the following entities:
- Agreement Booking Setup (msdyn_agreementbookingsetup)
- Agreement Booking Date (msdyn_agreementbookingdate)
- Agreement Invoice Setup (msdyn_agreementinvoicesetup)
- Agreement Invoice Date (msdyn_agreementinvoicedate)
- Order Invoicing Setup (msdyn_orderinvoicingsetup)
- Order Invoicing Setup Date (msdyn_orderinvoicingsetupdate)
- Order Invoicing Date (msdyn_orderinvoicingdate)
- Incident Types Setup (msdyn_incidenttypessetup)
- Quote Booking Setup (msdyn_quotebookingsetup)
What about product bundles? I'd like to use them in Field Service scenarios.
Unfortunately, at this time, using product bundles within Field Service is not supported.
Can I create a booking with a duration of 30 seconds?
No, the minimum duration for a booking is one minute.
Why can't I delete a record because of an association?
This issue occurs when there are related records with a restrict-delete association that blocks record deletion.
To fix this issue, identify the relevant entities with such relationships, and then delete the records of those entities related to the record you are now trying to delete.
- Go to Settings > Customizations.
- Select Customize the system.
- Locate the entity with records you want to delete (for example, Accounts).
- Go to 1: N Relationships for the entity.

- Find any relationships where the Type of Behavior is Referential, Restrict Delete.
- Take note of the related entity for each of those relationships; these are the type of records that may be restricting your ability to delete the record.
Where are the **Date Windows Start** and **Date Window End** fields?
As of the 2021 Wave 2 October update, the Date Window Start and Date Window End fields have been removed to simplify the experience. Use the Time From Promised and Time To Promised fields to manage time expectations for when service should be performed. To revert this change, see the Pre/Post Booking Flexibility Date Field Population setting in the Agreements section of Field Service settings.