[D365] The menu item with name could not be opened

[D365] The menu item with name could not be opened

A very strange behavior came up often the last time when deploying our customizations to a fresh installed D365 box with PU11 and PU12:
The menu item with name sysloadstartpage could not be opened.

The following message stated:
The menu item with name defaultdashboard could not be opened.

And we even saw the message with a menuitem name from our customizations.

The message comes up as soon as the workspace is loaded:
Error menu item could not be loaded

We found the following ways to resolve this:

Message with standard menu item

Try the following steps and stop as soon as it works (try after each step):

  • Do a full database synchronization (most of the time this was enough)
  • Build model ApplicationSuite with database synchronize option
  • Full build of all models with database synchronize option
  • Restart IIS (cmd > iisreset)
Message with custom menu item

Also try the following steps and stop as soon as it works (try after each step):

  • Navigate to the menu containing the menu item in AOT > right click > Refresh:
  • Navigate to the menu item in AOT > right click > Refresh:
    AOT refresh menu item
  • Navigate to the related object in AOT > right click > Refresh
  • Restart IIS (cmd > iisreset)

Last resort: try steps from above section with synchronization

Still not working?

If all of those steps didn't work out, try to uninstall your customizations, build the system and try again.
If the error is gone, it may indicate you have broken customizations in your code.