formContext

FormContext is a client-side API object used in Microsoft Dynamics 365 Customer Engagement and the broader Power Platform for form scripting. It represents the specific form instance that is currently loaded, replacing the older Xrm.Page model in recent versions. FormContext provides access to the form’s data, UI, and runtime context, enabling developers to create dynamic, client-side behavior.

In practice, formContext is supplied to form event handlers through the executionContext parameter. You obtain the FormContext by calling executionContext.getFormContext() inside onLoad, onSave, or onChange functions. Once you have formContext, you can interact with the form and its fields in a structured way.

Core areas of the API include the data API and the UI API. The data API allows reading and writing field values, for example by using getAttribute to access a field and then getValue or setValue. The UI API provides access to controls on the form, enabling operations such as showing or hiding controls and enabling or disabling fields. formContext also offers access to the record identifier and other context information, and you can register additional event handlers through the form’s data and event sections.

FormContext is the recommended approach for client-side form scripting in modern Dynamics 365 applications. It is context-specific to the form instance and is not available for server-side code. For legacy code, Xrm.Page remains documented but is considered deprecated in favor of formContext.