In early October a new method was added to the Xrm.Navigation client api documentation, navigateTo.
For example, you can open the default view for contacts using the code below:
Or open a specific view by including the viewId
While it is currently not mentioned in the documentation, it is also possible to open dashboards which also do not have another method of navigating to them. For dashboards the pageType needs to be set to ‘dashboard’, and you can include the dashboardId property to open a specific dashboard, otherwise it will open the default dashboard.
It is also possible to open web resources using this method using ‘webresource’ as the pageType and adding webresourceName.
While you could just use the openWebResource method, navigateTo will open the webresource without opening a new window similar to if web resources are used in the site map, while openInNewWindow currently does nothing in the openWebResource method and will always open a new window.