Skip to content

Commit 08aa9e7

Browse files
Update typereferences-element.md (#1767)
* Update typereferences-element.md * Update chart-(obsolete).md
1 parent d87c220 commit 08aa9e7

File tree

2 files changed

+10
-9
lines changed

2 files changed

+10
-9
lines changed

doc-output/configure-the-report-engine/typereferences-element.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: TypeReferences Element
3-
page_title: TypeReferences Element Configuration
4-
description: "Learn how to set up the TypeReferences Element, allowing you to use custom user functions in the report and create ObjectDataSource components."
2+
title: typeReferences Element
3+
page_title: typeReferences Element Configuration
4+
description: "Learn how to set up the typeReferences Element, allowing you to use custom user functions in the report and create ObjectDataSource components."
55
slug: telerikreporting/using-reports-in-applications/export-and-configure/configure-the-report-engine/typeReferences-element
66
tags: typeReferences, element, user, function, ObjectDataSource
77
published: True
@@ -21,7 +21,7 @@ table th:nth-of-type(2) {
2121

2222
>note This element was first introduced in the [2024 Q1 (18.0.24.305)](https://www.telerik.com/support/whats-new/reporting/release-history/progress-telerik-reporting-2024-q1-(18-0-24-305)) Reporting version.
2323
24-
Defines a collection of type references used by the Reporting Engine to resolve the custom types permitted to be used during the design and processing stages. The assemblies used by the types in TypeReferences section are loaded into application domain if the type is successfully resolved, so it's not necessary to declare the assembly also in the AssemblyReferences section.
24+
Defines a collection of type references used by the Reporting Engine to resolve the custom types permitted to be used during the design and processing stages. The assemblies used by the types in the typeReferences section are loaded into the application domain if the type is successfully resolved, so it's not necessary to declare the assembly also in the AssemblyReferences section.
2525

2626
XML-based configuration file:
2727

@@ -36,7 +36,7 @@ XML-based configuration file:
3636
JSON-based configuration file:
3737

3838
````JSON
39-
"TypeReferences": [
39+
"typeReferences": [
4040
],
4141
````
4242

@@ -46,11 +46,11 @@ The following sections describe attributes, child elements, and parent elements.
4646

4747
| | |
4848
| ------ | ------ |
49-
|Attributes|<ul><li>__typeName__ – mandatory string attribute. Specifies the full name of the type, i.e. namespace and class name.</li><li>__assemblyName__ – mandatory string attribute. Specifies the name of the assembly that contains the type.</li><li>__publicKeyToken__ – optional string attribute. Specifies the public key token of the assembly. Can be omitted or can have empty or null value.</li></ul>|
49+
|Attributes|<ul><li>__typeName__ – mandatory string attribute. Specifies the full name of the type, i.e., namespace and class name.</li><li>__assemblyName__ – mandatory string attribute. Specifies the name of the assembly that contains the type.</li><li>__publicKeyToken__ – optional string attribute. Specifies the public key token of the assembly. Can be omitted or can have an empty or null value.</li></ul>|
5050
|Child Elements|<ul><li>__add__ - Optional element. Adds a type reference to the collection.</li><li>__clear__ - Optional element. Removes all references to inherited type names, allowing only the references that are added by the current add element.</li><li>__remove__ - Optional element. Removes a reference to an inherited type name from the collection.</li></ul>|
5151
|Parent Elements|<ul><li>__configuration__ - Specifies the root element in every configuration file that is used by the common language runtime and the .NET Framework applications.</li><li>__Telerik.Reporting__ - Configures all settings that Telerik Reporting Engine uses.</li></ul>|
5252

53-
When providing the Public Key Token, the Reporting Engine will try to match it with the Public Key Token of the found DLL. It will not load an assembly with the same name and a different Public Key Token and will throw an exception instead. If the Public Key Token is omitted in the configuration, the Reporting Engine will load the first DLL, which name matches the provided Assembly Name. Potentially, this may allow bad agents to replace trusted assemblies with malicious ones and constitutes a security vulnerability. Since the Public Key Token provides an extra security layer to your application, we advise to always include it in the configuration file.
53+
When providing the Public Key Token, the Reporting Engine will try to match it with the Public Key Token of the found DLL. It will not load an assembly with the same name and a different Public Key Token and will throw an exception instead. If the Public Key Token is omitted in the configuration, the Reporting Engine will load the first DLL, whose name matches the provided Assembly Name. Potentially, this may allow bad agents to replace trusted assemblies with malicious ones and constitutes a security vulnerability. Since the Public Key Token provides an extra security layer to your application, we advise always including it in the configuration file.
5454

5555
## Example
5656

@@ -77,7 +77,7 @@ JSON-based configuration file:
7777

7878
````JSON
7979
"telerikReporting": {
80-
"TypeReferences": [
80+
"typeReferences": [
8181
{
8282
"typeName": "MyNamespace.MyClassName",
8383
"assemblyName": "MyAssemblyName",
@@ -87,7 +87,7 @@ JSON-based configuration file:
8787
}
8888
````
8989

90-
> When adding the `Telerik.Reporting` section manually, do not forget to register it in `configSections` element of the configuration file. Failing to do so will result in a [ConfigurationErrorsException](https://learn.microsoft.com/en-us/dotnet/api/system.configuration.configurationerrorsexception?view=dotnet-plat-ext-7.0) with the following text: *Configuration system failed to initialize*.
90+
> When adding the `Telerik.Reporting` section manually, do not forget to register it in the `configSections` element of the configuration file. Failing to do so will result in a [ConfigurationErrorsException](https://learn.microsoft.com/en-us/dotnet/api/system.configuration.configurationerrorsexception?view=dotnet-plat-ext-7.0) with the following text: *Configuration system failed to initialize*.
9191
9292
## See Also
9393

report-items/chart-(obsolete).md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ previous_url: /report-items-chart, /featuressplineareas
1414
>* The Chart report item is now superseded by the more advanced [Graph]({%slug telerikreporting/designing-reports/report-structure/graph/overview%}) report item. The Graph is most often used for building powerful OLAP and Pivot charts.
1515
>* The Chart report item is not supported in .NET Core projects and in projects deployed on Azure.
1616
>* The complete Chart report item documentation is available as a `CHM` file up to Telerik Reporting version 8.2.14.1204, and can be downloaded from [your Telerik account](https://www.telerik.com/account/downloads/product-download?product=REPORTING).
17+
>* If your reports utilize the Chart item, you need to add a [typeReference]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-report-engine/typeReferences-element%}) in your configuration to explicitly allow the element to be processed: `<add typeName="Telerik.Reporting.Processing.Chart" assemblyName="Telerik.Reporting" publicKeyToken="a9d7983dfcc261be" />`. This is required due to vulnerabilities in the item code.
1718
1819
The Chart report item is used to display a chart on a report. 
1920

0 commit comments

Comments
 (0)