-
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
Open
dessyordanova
wants to merge
12
commits into
master
Choose a base branch
from
dess-wrd-templates
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+227
−1
Open
Dess wrd templates #1870
Changes from all commits
Commits
Show all changes
12 commits
Select commit
Hold shift + click to select a range
c5c5d53
Initial draft
dessyordanova abedb51
Managing permission and How to edit a template
dessyordanova 7f4cbc0
polished
dessyordanova a70c6b1
Refactor the main article splitting in to one for end users and one f…
dessyordanova 140064c
Update configuring-report-templates.md
dessyordanova 1ea1410
Update report-templates.md
dessyordanova 4f4b539
Update report-templates.md
dessyordanova 3bc3e02
Update report-templates.md
dessyordanova e20af4e
Update configuring-report-templates.md
dessyordanova 678acbc
Update how-to-edit-a-report-template.md
dessyordanova 78fc401
Update report-templates.md
dessyordanova 6067ed1
polishing after sync with Dancho
dessyordanova File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
88 changes: 88 additions & 0 deletions
88
...ports/report-designer-tools/web-report-designer/configuring-report-templates.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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: | ||
|
|
||
| ````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. | ||
|
|
||
| >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. | ||
|
|
||
| ### Restricting the Templates Folder | ||
|
|
||
| ````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: | ||
|
|
||
| * 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: | ||
|
|
||
| * 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: | ||
|
|
||
| |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. | ||
|
|
||
| |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%}) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file added
BIN
+22.2 KB
...ner/images/web-report-designer-report-templates-allowed-user-assets-manager.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+10.6 KB
...t-designer/images/web-report-designer-report-templates-allowed-user-save-as.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+97.3 KB
...eb-report-designer/images/web-report-designer-report-templates-allowed-user.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+13.8 KB
.../images/web-report-designer-report-templates-restricted-user-assets-manager.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+11.1 KB
...esigner/images/web-report-designer-report-templates-restricted-user-save-as.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+98.5 KB
...report-designer/images/web-report-designer-report-templates-restricted-user.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| --- | ||
| title: How to Edit a Report Template | ||
| 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 | ||
| --- | ||
|
|
||
| |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%}) | ||
Binary file added
BIN
+2.05 MB
knowledge-base/images/web-report-designer-edit-report-templates-load-template.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+16.7 KB
...ledge-base/images/web-report-designer-report-templates-create-from-template.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+87.4 KB
knowledge-base/images/web-report-designer-report-templates-load-template.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+11.1 KB
user-guide/images/web-report-designer-report-templates-create-blank.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+16.7 KB
user-guide/images/web-report-designer-report-templates-create-from-template.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+87.4 KB
user-guide/images/web-report-designer-report-templates-load-template.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+51.3 KB
user-guide/images/web-report-designer-report-templates-report-from-template.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+14.5 KB
user-guide/images/web-report-designer-report-templates-save-as-report.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+11 KB
user-guide/images/web-report-designer-report-templates-save-as-template.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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. | ||
|
|
||
| * **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: | ||
|
|
||
| * Beginning from scratch with a **Blank Report**—Gives you an empty report. | ||
| * Starting **From Template** (.trtx file)—Gives you a ready-made layout and structure to build on, making the report creation faster and more consistent. | ||
|
|
||
| |Create a Blank Report|Create From a Template| | ||
| |----|----| | ||
| | || | ||
|
|
||
| ### Creating Report Templates | ||
|
|
||
| 1. Create a blank report by selecting the **Blank Report** option. | ||
|
|
||
| 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: | ||
|
|
||
|  | ||
|
|
||
| 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). | ||
|
|
||
| Select the **Template** option: | ||
|
|
||
| |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. | ||
|
|
||
| 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 `File Name` and `Format`—After selecting a template, give your new report a meaningful name and choose the desired output format.: | ||
|
|
||
|  | ||
|
|
||
| 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%}) |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.