Microsoft Dynamics NAV 2009 SP1 includes the client extensibility application programming interface (API) for creating RoleTailored client control add-ins. The client extensibility API is provided in the Microsoft.Dynamics.Framework.UI.Extensibility.dll assembly, which is installed with the RoleTailored client. You develop control add-ins using Microsoft Visual Studio and distribute them as Microsoft .NET Framework–based assemblies for deployment to computers running the RoleTailored client.

Design Considerations When Developing Control Add-ins

This section includes things to consider when developing control add-ins.

Using a Control Add-in on Pages

  • You apply control add-ins on field controls of RoleTailored client pages.

  • You can apply control add-ins on more than one field control on a page.

  • You can use control add-ins on all page types except a RoleCenter page type.


    To include a control add-in on a Role Center, you apply the control add-in on a page that is assigned to a part of the Role Center.

  • You can use control add-ins on pages that are included in parts and FactBoxes of other pages.

  • You can design the user interface of the control add-in to fill the page part area entirely or partially.

  • You cannot use control add-ins on the following areas:

    • On a field under a repeater control, which is used display data in a list, such as in a list place

    • Action Pane

    • Command bar

    • Filter pane

Binding a Control Add-in to the Database

A control add-in can bind with data in the Microsoft Dynamics NAV database, which allows you to create control add-ins that can display and update data in the database. For more information, see Binding a RoleTailored Client Control Add-in to the Database.

Calling C/AL Triggers on a Page

By implementing events, a control add-in can call the OnControlAddin trigger of page field that is applied with the control add-in. For more information, see Calling C/AL Triggers from a RoleTailored Client Control Add-in.

See Also