-
Notifications
You must be signed in to change notification settings - Fork 29
Dess wrd templates #1870
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Dess wrd templates #1870
Changes from all commits
c5c5d53
abedb51
7f4cbc0
a70c6b1
140064c
1ea1410
4f4b539
3bc3e02
e20af4e
678acbc
78fc401
6067ed1
bc7706d
cadcbac
9db0767
198b83c
e3ed4b1
12059d3
7530fc7
d345ad3
c24bef8
c86f7ea
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,98 @@ | ||||||
| --- | ||||||
| title: Configuring Report Templates | ||||||
| page_title: Configuring Report Templates in Web Report Designer | ||||||
| description: Learn more about Report Templates in the Telerik Reporting Web Report Designer, how to create and reuse them. | ||||||
| slug: web-report-designer-report-templates | ||||||
| tags: web, report, designer, wrd, report, template, trtx | ||||||
| published: True | ||||||
| position: 9 | ||||||
| --- | ||||||
|
|
||||||
| <style> | ||||||
| img[alt$="><"] { | ||||||
| border: 1px solid lightgrey; | ||||||
| } | ||||||
| </style> | ||||||
|
|
||||||
| # Configuring Report Templates in Web Report Designer | ||||||
|
|
||||||
| |Minimum Version:|Q4 2025| | ||||||
| |----|----| | ||||||
|
|
||||||
| The Web Report Designer lets you create report templates that simplify and streamline the report creation process. A **report template** is a reusable design that defines the layout, styling, and data structure of a report. | ||||||
|
|
||||||
| To control how application users utilize templates, developers can configure specific folders for storing report templates and manage user access to these folders. | ||||||
|
|
||||||
| ## Configure Report Templates Folder | ||||||
|
|
||||||
| All report templates are stored in a specific **Report Templates** folder. A default folder will be created at root level of your project. You can also navigate to a specific custom folder that contains all the report templates you wish to use. | ||||||
|
|
||||||
| The [`ReportDesignerServiceConfiguration`]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/how-to-set-up-in-.net-5-and-.net-core-3.1-applications%}#add-configuration-settings-in-the-startupcs-file) class provides a configuration setting for specifying the `TemplateDefinitionStorage`. Thus, you can navigate to a specific folder that stores all report templates: | ||||||
|
|
||||||
| ````CSharp | ||||||
| services.TryAddSingleton<IReportDesignerServiceConfiguration>(sp => new ReportDesignerServiceConfiguration | ||||||
| { | ||||||
| TemplateDefinitionStorage = new FileTemplateDefinitionStorage("templates_folder_path", new[] { "sub_folder_to_exclude" }), | ||||||
| }); | ||||||
| ```` | ||||||
|
|
||||||
| >note Report templates (.trtx files) can be stored only in the configured `Report Templates` folder. Other file formats are not allowed in the folder. | ||||||
|
|
||||||
| ## Managing Permissions | ||||||
|
|
||||||
| To restrict specific actions or features for users on the client side, for example, to limit access to the `Report Templates` folder, use the [`DeniedPermissions`]({%slug telerikreporting/report-designer-tools/web-report-designer/web-report-designer-customization%}) setting of the `ReportDesignerServiceConfiguration`. This setting allows developers to customize the designer experience by disabling certain tools, components, or capabilities based on application logic or user roles. | ||||||
|
|
||||||
| ````CSharp | ||||||
| services.TryAddSingleton<IReportDesignerServiceConfiguration>(sp => new ReportDesignerServiceConfiguration | ||||||
| { | ||||||
| DeniedPermissions = ReportDesignerPermissionsBuilder.Build( | ||||||
| Permission.Commands_AssetsManager_ReportTemplates | ||||||
| ) | ||||||
| })); | ||||||
|
|
||||||
| >note You can override the [`GetDeniedPermissions`]({%slug telerikreporting/report-designer-tools/web-report-designer/web-report-designer-customization%}) method in your custom implementation of the reporting service and apply different restrictions based on the currently logged-in user or other conditions. | ||||||
|
|
||||||
| ## Allowed Operations for Restricted Users | ||||||
|
|
||||||
| ````CSharp | ||||||
| services.TryAddSingleton<IReportDesignerServiceConfiguration>(sp => new ReportDesignerServiceConfiguration | ||||||
| { | ||||||
| DeniedPermissions = ReportDesignerPermissionsBuilder.Build( | ||||||
| Permission.Commands_AssetsManager_ReportTemplates | ||||||
| ) | ||||||
| })); | ||||||
| ```` | ||||||
|
|
||||||
| Once the end-user is **not** granted permissions for the Report Templates, the following actions are available: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| * Create a New Report from a Template - The **From Template** option remains visible even when the user lacks permissions to manage templates. In this restricted mode: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| * Users **cannot** create or upload new templates. | ||||||
| * Users **cannot** delete or edit existing templates. | ||||||
| * Users **can** still create new reports using the available templates. | ||||||
|
|
||||||
| >caption Restricted User | ||||||
|
|
||||||
|  | ||||||
|
|
||||||
| >caption Default User | ||||||
|
|
||||||
|  | ||||||
|
|
||||||
| * Opening the **Assets manager** - When a *restricted* user opens the Assets Manager, the `Report Templates` folder is invisible and inaccessible: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| |Restricted User|Default User| | ||||||
| |----|----| | ||||||
| ||| | ||||||
|
|
||||||
| * **Save Report As** - The *restricted* end-user can **only** save as a **Report**. The option for saving as a **Template** is hidden. | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| |Restricted User|Default User| | ||||||
| |----|----| | ||||||
| ||| | ||||||
|
|
||||||
| ## See Also | ||||||
|
|
||||||
| * [How to Edit a Report Template]({%slug web-report-designer-how-to-edit-a-report-template%}) | ||||||
| * [Working with Report Templates]({%slug web-report-designer-report-templates%}) | ||||||
| * [Report Templates in Standalone Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/report-templates%}) | ||||||
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,41 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| --- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| title: How to Edit a Report Template | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
dessyordanova marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| page_title: How to Edit a Report Template in Web Report Designer | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| description: Learn more about Report Templates in the Telerik Reporting Web Report Designer, how to create and reuse them. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type: how-to | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| slug: web-report-designer-how-to-edit-a-report-template | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tags: web, report, designer, wrd, report, template, trtx, edit | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| published: True | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| position: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tags: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| res_type: kb | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| --- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |Minimum Version:|Q4 2025| | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |----|----| | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| To edit an existing Report Template (.trtx file), follow the steps: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1. Select the `New Report` option from the Menu: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <img style="border: 1px solid gray;" src="images/wrd-create-menu-option.png" alt="Create a Report"/> | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1. Create a Report **From Template**: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <img style="border: 1px solid gray;" src="images/web-report-designer-report-templates-create-from-template.png" alt="Create From a Template"/> | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1. Select the Report Template (.trtx file) you want to edit: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <img style="border: 1px solid gray;" src="images/web-report-designer-report-templates-load-template.png" alt="Load a Template"/> | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1. Make the desired changes to the loaded predefined report | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1. Save as a **Template** overwriting the previously selected .trtx file: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <img style="border: 1px solid gray;" src="images/web-report-designer-edit-report-templates-load-template.gif" alt="Edit a Template"/> | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ## See Also | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| * [Setting up the Web Report Designer in .NET applications]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/how-to-set-up-in-.net-5-and-.net-core-3.1-applications%}) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| * [Web Report Designer Customization]({%slug telerikreporting/report-designer-tools/web-report-designer/web-report-designer-customization%}) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| * [Report Templates in Standalone Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/report-templates%}) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Original file line number | Diff line number | Diff line change | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,91 @@ | ||||||||||
| --- | ||||||||||
| title: Creating and Using Report Templates | ||||||||||
| page_title: Creating and Using Report Templates in Web Report Designer | ||||||||||
| description: Learn more about Report Templates in the Telerik Reporting Web Report Designer, how to create and reuse them. | ||||||||||
| slug: web-report-designer-report-templates | ||||||||||
| tags: web, report, designer, wrd, report, template, trtx | ||||||||||
| published: True | ||||||||||
| position: 9 | ||||||||||
| --- | ||||||||||
|
|
||||||||||
| <style> | ||||||||||
| img[alt$="><"] { | ||||||||||
| border: 1px solid lightgrey; | ||||||||||
| } | ||||||||||
| </style> | ||||||||||
|
|
||||||||||
| # Creating and Using Report Templates in Web Report Designer | ||||||||||
|
|
||||||||||
| |Minimum Version:|Q4 2025| | ||||||||||
| |----|----| | ||||||||||
|
|
||||||||||
| A **report template** is a reusable design that defines the layout, styling, and data structure of a report. It allows report designers to create consistent and professional-looking reports without starting from scratch each time. | ||||||||||
|
|
||||||||||
| ## Key Benefits | ||||||||||
|
|
||||||||||
| Whether you are building dashboards, invoices, or summaries, report templates help you start with a solid foundation—saving time and ensuring visual and structural consistency across your reporting projects. Using templates offers: | ||||||||||
|
|
||||||||||
| * **Increased Productivity**—Templates offer a ready-made layout and structure, so you can focus on your data instead of design. | ||||||||||
|
|
||||||||||
| * **Ensure Consistency**—Maintain a uniform look and feel across multiple reports - especially useful for teams or organizations. | ||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
|
|
||||||||||
| * **Simplify Design for Non-Designers**—Even if you're not familiar with styling or layout best practices, templates give you a polished starting point. | ||||||||||
|
|
||||||||||
| * **Customize and Reuse**—Easily adapt templates to fit different projects or departments, and reuse them to stay efficient. | ||||||||||
|
|
||||||||||
| * **Support Branding**—Include your company’s logo, colors, and fonts to ensure every report aligns with your brand identity. | ||||||||||
|
|
||||||||||
| ## Working with Report Templates | ||||||||||
|
|
||||||||||
| When creating a new report by clicking the `New Report` option in the main menu, you are presented two options: | ||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
|
|
||||||||||
| * Beginning from scratch with a **Blank Report**—Gives you an empty report. | ||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
| * Starting **From Template** (.trtx file)—Gives you a ready-made layout and structure to build on, making the report creation faster and more consistent. | ||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
|
|
||||||||||
| |Create a Blank Report|Create From a Template| | ||||||||||
| |----|----| | ||||||||||
| | || | ||||||||||
|
|
||||||||||
| ### Creating Report Templates | ||||||||||
|
|
||||||||||
| 1. Create a blank report by selecting the **Blank Report** option. | ||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
|
|
||||||||||
| 1. Design the report in the Web Report Designer according to your needs. | ||||||||||
|
|
||||||||||
| 1. Save the report as a template—This allows you or your team to reuse it for future reports. | ||||||||||
|
|
||||||||||
| When you wish to save the currently opened report, select the `Save As...` option from the Menu: | ||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
|
|
||||||||||
|  | ||||||||||
|
|
||||||||||
| The end-user is presented the option to save the report either as a `Report` (.trdp or .trdx file format), or as a `Template` (.trtx file format). | ||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
|
|
||||||||||
| Select the **Template** option: | ||||||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
|
|
||||||||||
| |Save As Report|Save As Template| | ||||||||||
| |----|----| | ||||||||||
| | || | ||||||||||
|
|
||||||||||
| ### Using Report Templates | ||||||||||
|
|
||||||||||
| To start creating your report by using a predefined report template with a ready-to-use design, use the report template option. | ||||||||||
|
|
||||||||||
| 1. Select the **New Report** option from the Menu: | ||||||||||
|
|
||||||||||
|  | ||||||||||
|
|
||||||||||
| 1. Create a report from an existing template by selecting the **From Template** option. | ||||||||||
|
|
||||||||||
| 1. Navigate to the existing template (`.trtx`) file—When creating a new report, you can choose a template from the available list. The designer loads the layout and styles, and you can then customize the content and data bindings. | ||||||||||
|
|
||||||||||
|  | ||||||||||
|
|
||||||||||
| 1. Enter a file name and select the format for your new report: | ||||||||||
|
|
||||||||||
|  | ||||||||||
|
|
||||||||||
| Now, you are ready to continue crafting your report loaded from a template. | ||||||||||
|
|
||||||||||
| ## See Also | ||||||||||
|
|
||||||||||
| * [How to Edit a Report Template]({%slug web-report-designer-how-to-edit-a-report-template%}) | ||||||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Move this code snippet to the section above. See the comment above.