3 steps to control the Form Assistant Pane

Published: May 25, 2007

Completing a form can be complicated at times when you have to look up and select information. For example, you are filling in an account form, and you have to pick the parent account from a list. Or, you are filling in an order form, and you have to choose the correct price list. The Form Assistant Pane helps you to select the appropriate Microsoft Dynamics CRM 3.0 data by displaying lists of filtered records based on the data entered on the form. The pane can also provide tips for helping you look, and, in some areas of Microsoft CRM, other functionality is available, such as the ability to create a follow-up activity.

The Form Assistant Pane is opened by default in the Services area of Microsoft CRM, but closed by default in the other areas. Though this pane can be temporarily opened or closed each time you open a form, for example, an account, order, or invoice form, you may find it more convenient to change the default system-wide. You can do this in three basic steps: by exporting the form, using a text editor to customize the XML code in the form, and then importing and publishing the form in Microsoft CRM.

There are a few things to be aware of before you start.  You might overwrite other customizations.  Read the online Help topics Customizing Entities and Export or import customized entities, templates, or navigation to understand these risks.

Also, you can’t add the Form Assistant Pane to all forms. Some custom logic implemented in JScript for the lookup will not work properly in the Form Assistant Pane. For example, some lookups change the lookupclass attribute at runtime (usually to filter the results) depending on the value of other fields on the form. 

*
**
**
On This Page
1. Export the form for customization1. Export the form for customization
2. Customize the form2. Customize the form
3. Import and publish the customization3. Import and publish the customization

1. Export the form for customization

1.

In Microsoft CRM, on the Navigation Pane, click Settings, and then click Customization.

2.

In the Customization area, click Export Customizations.

3.

In the Export Customizations list, select the entity you want to customize.

4.

On the More Actions menu, select Export Selected Customizations, and then click OK.

5.

In the File Download dialog box, click Save, select a location for the customizations.xml file, and then click Save again.

Note

Save a backup of the file. If the customization causes problems with functionality, you can revert to the original file.

2. Customize the form

1.

Open the customizations.xml file in a text editor such as WordPad.

2.

In the customizations.xml file, change this parameter as follows:
relatedInformationCollapsed= “false”

A value of “false” opens the Form Assistant Pane by default, while “true” collapses the pane by default. Make sure to use the correct case, because this string is case-sensitive. Not all forms have this code and adding it could cause the form to behave unexpectedly.

3.

Save the customizations.xml file.

3. Import and publish the customization

1.

In Microsoft CRM, in the Navigation Pane, click Settings, and then click Customization.

2.

In the Customization area, click Import Customizations.

3.

In the Import Customizations area, browse to the updated customizations.xml file, and then click Upload.

4.

On the More Actions menu, select Import Selected Customizations, and then click OK.

5.

In Microsoft CRM, in the Navigation Pane, click Settings, and then click Customization.

6.

In the Customization area, click Customize Entities.

7.

Select the entity you customized.

8.

On the Actions toolbar, click Publish.

To test the customization, open the form for the entity you customized.



Was this information useful?