Customize the Help experience

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Microsoft Dynamics 365 has a knowledge base application built in for online help. This help is hosted on the Dynamics 365 Help & Training site, a central location where users can find articles, videos, eBooks, best practices, and tips regarding topical issues.

In addition to the built-in help, Microsoft Dynamics 365 offers customizable help and tooltips to provide contextual information to users filling in forms. You can replace default Help with the custom Help of your choice, at the global (organization) level or entity level. Custom Help makes the content exposed through the Help links more relevant to the user’s day-to-day activities. With a single, global URL you can override the out-of-the-box Help links for all customizable entities. Per entity URLs override the out-of-the-box Help links on grids and forms for a specific customizable entity. You can include additional parameters in the URL, such as language code and entity name. These parameters allow a developer to add functionality to redirect the user to a page that’s relevant to their language or the entity context within the application. The entity level custom Help settings are solution aware, therefore you can package them as a part of the solution and transport them between organizations or distribute them in solutions. Custom tooltips provide the ability to set the text that appears as a tooltip when the field is displayed in a form. Tooltips are also solution aware. For more information about tooltips, view: Video: Microsoft Dynamics CRM Customizable Tool Tips

Note

Customizable Help is not available in Microsoft Dynamics 365 for tablets.

Example of a custom URL at a global level

You have a dynamic Help server to serve the Help content for the custom entities. Your solution almost entirely consists of the custom entities. You can specify the . aspx page that points to the Help server and pass the parameters in the URL. You can program the Help server to display the correct Help page based on the parameters passed.

Example of a custom URL at an entity level

You have a static set of Help webpages for the custom entities and customized out-of-the box (OOB) system entities. For example, you have added only two or three custom entities and heavily customized the opportunity entity. The rest of the OOB system entities remained unchanged. In this case, you can override the Help content for the custom entities and the Opportunity entity and use the default Help for the rest of the entities in your system.

Where to find help when you design your custom Help

When you build your own custom Help, check out the Training & Adoption Kit for Microsoft Dynamics 365. It contains a lot of ready-made material that you can use straight from the kit, or customize it. The Training & Adoption Kit includes eBooks for end users and administrators, user guides and quick references. Video buttonWatch a short video on how to customize the training material in the training and adoption kit.

Set up customizable Help

As an administrator, you can use the settings to override default Help at the global level.

  • Go to Settings > Administration.

  • Click the System settings > General tab, as shown here.

Global custom Help in Dynamics CRM

To override the default Help for an entity, use the settings in Microsoft Dynamics 365.

  • Go to Settings > Customizations.

  • Click the Customize the system > Components > Entity > General tab. You must first enable custom Help at the global level.

Entity level custom Help in Dynamics CRM

To append the parameters to a URL, set Append Parameters to URL in the System settings > General tab to Yes. Specify the parameters that will be attached to the URL:

  • User Language Code: userlcid

  • Entity Name: entity

  • Entry Point: hierarchy chart or form

  • Form Id: formid

See Also

Customize your Dynamics 365 system
Administering Dynamics 365
Community blog: CRM 2015 – Custom Help Content
MSDN: Custom help options
MSDN: Use web resources to provide help content

© 2016 Microsoft. All rights reserved. Copyright