New to Telerik Reporting? Download free 30-day trial

Web Report Designer Customization

Starting with R3 2023, the Telerik Web Report Designer can be customized either for all users or for particular users based on certain criteria.

Customization Options

Customization options the developer may pass to the client of the Web Report Designer in the latest Telerik Reporting version 18.1.24.514:

  • DeniedPermissions: a list of permissions that will be denied to the user client-side

There are two approaches for providing the customization options to the ReportDesigner.

Customizing Web Report Designer for All Users

The customization options like denied permissions may be configured for all users of the Web Report Designer through the corresponding property in the ReportDesignerServiceConfiguration. For the permissions, this is the property DeniedPermissions:

services.TryAddSingleton((Func<IServiceProvider, IReportDesignerServiceConfiguration>)(sp => new ReportDesignerServiceConfiguration
{
    //...
    DeniedPermissions = ReportDesignerPermissionsBuilder.Build(
        Permission.Create_Components_ReportItems_PictureBox,
        Permission.Create_Components_ReportItems_HTMLTextBox
        )
}));

The above code will deny the Web Report Designer client to add PictureBox and HTMLTextBox items. The user will still be able to edit existing ones.

Fine Tune the Customization in the Web Report Designer

The Web Designer may customized per user or based on other conditions by overriding the Reporting REST Service virtual methods exposed for the corresponding property.

For example, by overriding the virtual method GetDeniedPermissions you may create logic that returns different permissions per user.

Example:

A sample implementation of the GetDeniedPermissions. The returned permissions are the ones that will be denied to the user(s):

public override IActionResult GetDeniedPermissions()
{
    return this.Json(ReportDesignerPermissionsBuilder.Build(
        Permission.Create_Components_ReportItems_PictureBox,
        Permission.Create_Components_ReportItems_HTMLTextBox,
        Permission.Commands_Document_NewCombined,
        Permission.Commands_DataSources_SharedDataSource_Delete,
        Permission.Commands_DataSources_SharedDataSource_Edit,
        Permission.Commands_AssetsManager
        )
    );
}

The code above denies the users (all in this case) to add PictureBox and HTMLTextBox items. It also hides the menu command for creating ReportBook Document > NewCombined, forbids the user to delete and edit an existing SharedDataSource, and hides the AssetsManager.

In this article