AX7 / D365: No symbols have been loaded for this document

From time to time I run into the issue that, while debugging D365 for Finance and Operations, my breakpoints will not be hit. In Visual Studio it isn’t marked as a solid red dot, instead it is just a red circle, telling me that no symbols have been loaded.

If you hover over it, Visual Studio will show the following message:

The breakpoint will not currently be hit. No symbols have been loaded for this document.

If you actually debug the code, with your breakpoint in the above state, I will simply never been hit.

How to load the symbols for your documents

In Visual Studio navigate to the menu bar on top and select “Dynamics 365”, from there open “Options…”.

In the options window select the “Debugging” node and make sure the “Load symbols only for items in the solution” is unchecked.

With the box checked, as shown above, only symbols for documents in your solution will be loaded.