Installation

  • 3 minutes to read

DevExpress provides a solution for SharePoint (SharePoint 2013 and SharePoint 2016) that implements wrappers for ASPxGridView and ASPxHtmlEditor controls. Once it is installed in the SharePoint environment, it registers all required assembly files, and provides a SharePoint portal with a set of Web Parts and Site Features. See the following MSDN topic for more information on SharePoint solutions: Solutions Overview.

NOTE

DevExpress ASP.NET controls v13.1 to v16.2 only support SharePoint 2013.

We introduced support for SharePoint 2013 and SharePoint 2016 in v17.1.

This document describes how to install a DevExpress products on a SharePoint server or development machine containing a SharePoint product. You can install DevExpress Web Parts automatically or manually.

Automatic Installation

To install the DevExpress products for SharePoint automatically, use the DevExpress ASP.NET SharePoint Register tool that ships with the DevExpress ASP.NET installation.

NOTE

The ASP.NET SharePoint Register tool can only run on a machine with SharePoint installed.

To use this tool, copy the "SharePoint" folder (located in the <Installation Root Directory>\Tools\ path) from your computer to the machine where SharePoint is installed, and run the ASPxSharePointRegister.exe file from the copied folder.

SharePointSupport_ReadyToUseWebParts_Installation_StartMenu

In the invoked dialog, specify the SharePoint portal URL.

SharePointSupport_ReadyToUseWebParts_Installation_ASPxSharePointRegister

Click the Register button to install DevExpress Web Parts for SharePoint to the specified portal on this machine. The registration tool automatically identifies the SharePoint product version (e.g., SharePoint 2016), and installs the corresponding set of Site Features. The Unregister button removes previously registered assemblies. Note that you are required to reset the IIS server after the solution is installed and activated.

After installation, navigate to the Site Actions -> Site Settings -> Manage Site Features menu to enable DevExpress features and embed Web Parts as required.

SharePoint_EndUser_Installation_SiteFeaturesDX

Starting with SharePoint 2013, to replace the default HTML editor for list items with ASPxHtmlEditor in default forms, you need to change their render mode to Server Render, using the Server Render option in the web part toolpane (see the image below). This can be done in the browser UI, within the SharePoint Designer, or in code (server object model, CSOM, powershell, etc.). To edit a form using the browser UI, open the form, click Settings SharePointSupport_ReadyToUseWebParts_Installation_Settings and select the Edit page option from the dropdown menu. Choose Edit web part from the web part menu. In the web part options pane, choose Server Render (ServerRender) from the CSR Render Mode combo box in the Miscellaneous options group.

SharePointSupport_ReadyToUseWebParts_Installation_EditWebPart

Manual Installation

If Windows SharePoint Products and Technologies are hosted by a third-party company, and you do not have access to the system, contact your system administrator and provide the appropriate solution (.wsp) file. The following solution files are available.

  • DevExpressSharepoint2013.wsp

    Use this file where SharePoint 2013 is installed.

  • DevExpressSharepoint2016.wsp

    Use this file where SharePoint 2016 is installed.

Select the file based on the corresponding SharePoint version, which installs DevExpress SharePoint Solutions and registers the required DevExpress assemblies in the GAC.

See Also