Skip to content

Commit 449cf28

Browse files
committed
addressed feedback from Milen
1 parent 427732d commit 449cf28

File tree

8 files changed

+23
-11
lines changed

8 files changed

+23
-11
lines changed

user-guide/app-tour.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,9 @@ As illustrated by the video above, the main elements of the Web Report Designer'
2222
* A **Components tray** which contains all of the items that you can add to the report.
2323
* An **Explorer** providing a tree-based structure of everything that is already in the report, including the data structure.
2424
* A **Properties area** which shows the properties and values for the currently selected component.
25-
* A **Main menu** which lets you open, save, and interact with reports on a global level along with the **Asset Manager** which is where you store all of your.
25+
* A **Main menu** which lets you open, save, and interact with reports on a global level along with the **Asset Manager** which is where you store all of your assets.
2626
* A **Preview** button which shows an exact representation of the designed report.
27-
* A **Search box** which allows you to search the report instance for any property value, component data source, and so on.
27+
* A **Search box** which allows you to search the report instance for any properties (i.e., their names), component data source, and so on. The Search box also allows locating tools, like the components that can be added on top of searching in the report instance.
2828

2929
To view the app tour again, type `Start onboarding` in the search box.
3030

user-guide/components/components.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,8 @@ You can add components to your report in two ways:
3232
* Drag and drop—Click the report's design surface and drag a component from the Components tab onto the report.
3333
* Click to add—Click the desired location in your report, then click the component in the Components tab.
3434

35+
The **Search box** allows you to locate components quickly by typing.
36+
3537
You can edit already added components by clicking the respective report item on the design surface of the report. To edit multiple items simultaneously, select them by holding the `Ctrl` or `Cmd` key. Once the item is selected, you can edit its properties in the pane on the right.
3638

3739
![Components tray in List Mode ><](images/wrd-components-tray-design-mode.png)

user-guide/components/data-sources.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ table th:nth-of-type(2) {
2828

2929
# Data Sources
3030

31-
The Data Source components allow users to connect to and retrieve data from various storage and database systems. Data Sources serve as the foundation for all report components, providing the data that powers your tables, charts, maps, and other report elements.
31+
The Data Source components allow users to connect to and retrieve data from various storage and database systems. Data Sources serve as the foundation for all report components, providing the data that powers your tables, charts, maps, and other report elements.
3232

3333
Data Sources are essential for:
3434

@@ -51,6 +51,8 @@ The Web Report Designer provides the following data source types:
5151
* [JSON Data Source]({%slug web-report-designer-user-guide-components-data-sources%}#json-data-source)—Processes JSON data from local files or embedded content within reports.
5252
* [Object Data Source]({%slug web-report-designer-user-guide-components-data-sources%}#object-data-source)—Binds report items to .NET business objects and custom data providers.
5353

54+
>note Web Report Designer offers a **SharedDataSource** component which enables report designers to easily create and reuse a data source component across multiple reports. Existing data source components can be configured into SharedDataSource components via the **Explorer tab** in the Web Report Designer. Left-clicking the data source component will open the context menu from which the option *Save As Shared Data Source* can be chosen.
55+
5456
## SQL Data Source
5557

5658
To add a new SQL Data Source:

user-guide/components/report-items.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ To learn more about working with the TextBox item, see the [TextBox article in t
6666

6767
## HtmlTextBox
6868

69-
The HtmlTextBox allows you to insert and display HTML-formatted text within a report. The HtmlTextBox item is ideal for scenarios where you need rich text formatting, dynamic content, or templated text in your reports. You can set its content at design time using a WYSIWYG editor, an ezxpression editor, or dynamically from a data source.
69+
The HtmlTextBox allows you to insert and display HTML-formatted text within a report. The HtmlTextBox item is ideal for scenarios where you need rich text formatting, dynamic content, or templated text in your reports. You can set its content at design time using a WYSIWYG editor, an expression editor, or dynamically from a data source.
7070

7171
<iframe width="560" height="315" src="https://www.youtube.com/embed/7O-zB9QjkyU?si=HoHpwrcJ6ZDMwCxx" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
7272

user-guide/components/tables.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,8 @@ The **Components** tab offers a **Tables** section that allows users to visualiz
3131
* [Table Wizard]({%slug web-report-designer-user-guide-components-tables%}#using-the-table-wizard)&mdash;Guides you through creating a Table with an easy step-by-step wizard.
3232
* [Crosstab Wizard]({%slug web-report-designer-user-guide-components-tables%}#using-the-crosstab-wizard)&mdash;Guides you through creating a Crosstab with an easy step-by-step wizard.
3333

34+
Using the wizards and following manual tuning as needed is the recommended approach to configure tables and crosstabs. It also offers a smoother user experience.
35+
3436
## Prerequisites
3537

3638
Before adding any table component, ensure you have:
@@ -59,7 +61,7 @@ Tables organize data in a traditional row-and-column format that you can use for
5961
1. Drag the **Table** item from the **Components** tab and drop it onto the **Detail** section of the report.
6062
1. Bind the Table to your [data source]({%slug web-report-designer-user-guide-components-data-sources%}).
6163
1. Configure the table structure by adding or removing columns and rows as needed.
62-
1. Add TextBox report items to cells and bind their value to the relevant fields in your [data source]({%slug web-report-designer-user-guide-components-data-sources%}).
64+
1. Add TextBox report items to cells and bind their value to the relevant fields in your [data source]({%slug web-report-designer-user-guide-components-data-sources%}). Note that the empty-appearing table already consists of text boxes according to the applied data source and the available fields (just their value is empty). You can add new items if you want to have other item types instead, e.g., HtmlTextBox, Barcode, etc.
6365

6466
When you add a new Table, it starts with three columns, a header row, and a data row:
6567

user-guide/getting-started.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,13 @@ Make sure you have access to:
4242

4343
![Create Web Service Data Source ><](images/wrd-create-web-service-data-source.png)
4444

45-
1. On the **Configure Data Retrieval** screen, enter the URL of the web service providing the data for your report: `https://demos.telerik.com/reporting/api/reports/formats`, and then click **Finish**.
45+
Alternatively, you can type "Web Service Data Source" in the **Search box** to let the designer locate the tool for you.
46+
47+
1. On the **Configure Data Retrieval** screen, enter the URL of the web service providing the data for your report and then click **Finish**.
48+
49+
````
50+
https://demos.telerik.com/reporting/api/data/productsales
51+
````
4652
4753
![Web Service Data Source Wizard Step 1 ><](images/wrd-create-web-service-data-source-wizard-step1.png)
4854
@@ -52,7 +58,7 @@ Now you have a blank report that is connected to data.
5258
5359
Next, design the report by adding a Table report item to display your data.
5460
55-
1. Click the report's **Detail Section** to enable adding report items.
61+
1. Click the report's **Detail Section** to select it as a container which allows adding report items. The default selection is the report itself, which cannot parent tables directly.
5662
5763
1. Select the **Components** tab, and then click the [**Table Wizard**]({%slug web-report-designer-user-guide-components-tables%}#using-the-table-wizard) button:
5864
@@ -85,7 +91,7 @@ Now that you've created your first report, you can:
8591
8692
For a visual walkthrough, watch this video tutorial that demonstrates creating a report with a chart. The video covers the Visual Studio setup initially, but the Web Report Designer portion starts at the 3:08 mark:
8793
88-
<iframe width="560" height="315" src="https://www.youtube.com/embed/L-utkcB8-5c?si=bmJU9ggpSOykHdLK&amp;start=188" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
94+
<iframe width="560" height="315" src="https://www.youtube.com/embed/L-utkcB8-5c?si=bmJU9ggpSOykHdLK&amp;start=286" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
8995
9096
## See Also
9197

user-guide/report-structure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The Page Footer section appears at the end of every page. Use the Page Footer to
4848

4949
## Detail Section
5050

51-
The Detail section displays the detailed information and is printed once for every row in the data source. This is where you place the report items that constitute the main body of the report.
51+
The Detail section displays the detailed information and is printed once for every row in the data source if the report itself is bound to a data source. If not (e.g., data is bound to a table item or a chart item instead), the detail section is static and it is rendered once. This is where you place the report items that constitute the main body of the report.
5252

5353
## Report Items
5454

user-guide/user-guide-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,6 @@ This user guide contains articles that describe common scenarios related to desi
4949
* [Create a Simple Report]({%slug web-report-designer-user-guide-getting-started%})
5050
* [Explore the Structure of a Report]({%slug user-guide/report-structure%})
5151

52-
{% if site.has_cta_panels == true %}
53-
{% include cta-panel-overview.html %}
52+
{% if false == true %}
53+
{% include cta-panel-small.html %}
5454
{% endif %}

0 commit comments

Comments
 (0)