-
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
base: master
Are you sure you want to change the base?
Dess wrd templates #1870
Changes from all commits
c5c5d53
abedb51
7f4cbc0
a70c6b1
140064c
1ea1410
4f4b539
3bc3e02
e20af4e
678acbc
78fc401
6067ed1
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,88 @@ | ||||||||||||||||||||||
| --- | ||||||||||||||||||||||
| 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| | ||||||||||||||||||||||
| |----|----| | ||||||||||||||||||||||
|
|
||||||||||||||||||||||
| Web Report Designer offers functionality for working with report templates. A **report template** is a reusable design that defines the layout, styling, and data structure of a report. It allows the developers to configure a specific folder for storing the report templates and to manage the access to this specific folder for certain users. | ||||||||||||||||||||||
|
|
||||||||||||||||||||||
| ## 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: | ||||||||||||||||||||||
|
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
|
||||||||||||||||||||||
|
|
||||||||||||||||||||||
| ````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 restrict `Report Templates`, the [DeniedPermissions]({%slug telerikreporting/report-designer-tools/web-report-designer/web-report-designer-customization%}) setting of the `ReportDesignerServiceConfiguration` can be used. It allows developers to customize the designer experience by disabling certain tools, components, or capabilities based on application logic or user roles. | ||||||||||||||||||||||
|
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. Move the code snippet here as it is closely related to the
Suggested change
|
||||||||||||||||||||||
|
|
||||||||||||||||||||||
| >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 to apply different restrictions based on the logged-in user or other conditions. | ||||||||||||||||||||||
|
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
|
||||||||||||||||||||||
|
|
||||||||||||||||||||||
| ### Restricting the Templates Folder | ||||||||||||||||||||||
|
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
|
||||||||||||||||||||||
|
|
||||||||||||||||||||||
| ````CSharp | ||||||||||||||||||||||
|
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. Move this code snippet to the section above. See the comment above. |
||||||||||||||||||||||
| 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 | ||||||||||
|
|
||||||||||
| If you want to start from a predefined report template with a ready-to-use design, the report template option is the right choice. | ||||||||||
|
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. Select the `New Report` 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
|
||||||||||
|
|
||||||||||
|  | ||||||||||
|
|
||||||||||
| 1. Create a report from an existing template by selecting the `From 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
|
||||||||||
|
|
||||||||||
| 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. | ||||||||||
|
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. Enter `File Name` and `Format`—After selecting a template, give your new report a meaningful name and choose the desired output 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
|
||||||||||
|
|
||||||||||
|  | ||||||||||
|
|
||||||||||
| 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.