Use form and field events
Applies To: Microsoft Dynamics CRM 2013, Microsoft Dynamics CRM Online
You can add scripts for the OnLoad and OnSave events for the form and OnChange events for each field. Tabs have a TabStateChange event and IFRAMES have an OnReadyStateComplete event. The PreSearch event is new with Microsoft Dynamics CRM 2013 and Microsoft Dynamics CRM Online. Handlers for this event can only be applied using code for lookup field controls.
|Events in the form are disabled for the bulk edit form. The bulk edit form is displayed when multiple records in a list are edited.|
The OnLoad event occurs after the form has loaded. It cannot prevent the window from loading. Use the OnLoad event to prepare the data in the form for use. Some actions that can be performed by using the OnLoad event include the following:
Perform calculations based on changing values.
Alert a user to a situation.
Disable fields that should not be updated.
For more information, see OnLoad Event.
The OnSave event does not correspond to the standard HTML OnSubmit event. The OnSave event occurs when :
The user clicks the button in the lower right corner of the form, even when there is no changed data to be saved.
Code executes the Xrm.Page.data.entity.save method, even when there is no changed data to be saved.
The user navigates away from the form and there is unsaved data in the form.
With auto-save is enabled, 30 seconds after data has changed and there is unsaved data in the form.
Code executes the Xrm.Page.data.save method and there is unsaved data in the form.
Code executes the Xrm.Page.data.refresh method passing a true value as the first parameter and there is unsaved data in the form.
You can detect which action was performed to save the form by using the getSaveMode method in the save event arguments retrieved from the getEventArgs method execution context. Navigating away from a form when it contains unsaved data corresponds to the ‘Save and Close’ behavior found in forms for entities that have not been updated.
The OnSave event can be canceled to prevent the data from being saved. Because of this it, is very common to use the OnSave event to validate data.
For more information, see OnSave Event
The OnChange event is available on every field. Generally, the OnChange event requires two conditions to be true:
The data in the field must change.
The field must lose focus.
There is an exception to this behavior that that applies to Two-Option (Boolean) fields that are formatted to use radio buttons or check boxes.
The OnChange event does not occur if the field is changed programmatically using the setValue method. If you want event handlers for the OnChange event to run after you set the value, you must use the fireOnChange method in your code.
After the event, the data in the field will be revalidated. This means that you cannot use the event to enter invalid data.
Some actions that can be performed by using the OnChange event include the following:
Perform calculations to change other fields based on changing values.
Change the formatting of fields, such as telephone numbers.
Implement dependent optionsets See Sample: Create dependent OptionSets (picklists) for an example.
For more information, see Field OnChange Event.
This event occurs when a tab is expanded or collapsed. You may want to defer execution of code until a tab is expanded.
|This event never occurs in Microsoft Dynamics CRM for tablets because tabs in that client do not collapse.|
This event is important if you are using script to modify the src property of an IFRAME control. An IFRAME will be refreshed when the tab is expanded. Any changes to the src property will be removed. If you interact with the src property of an IFRAME, you should always include this code in the TabStateChange event instead of the Onload event.
For more information, see Tab TabStateChange Event.
Any script that interacts with the contents of an IFRAME will fail unless the contents of the IFRAME has completed loading. This event provides a location to include script that will execute as soon as the contents of the IFRAME have completed loading.
|This event never occurs in Microsoft Dynamics CRM for tablets because IFRAMEs are not displayed.|
For more information, see IFRAME OnReadyStateComplete Event.
Use the addPreSearch method to add an event handler to control for a lookup attribute. There is no user interface to add an event handler manually. Use this event with the addCustomFilter, addCustomView and setDefaultView to control the views opened when people search for a record to set as the value of a lookup field.
For more information, see Lookup Control PreSearch Event.
Microsoft Dynamics CRM 2013 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.