reporting-docs/localize-report-serverside-based-on-parameter.md в 7fe5410e8187ea13cbe97b18555c96ea2c1e4e7d

5.2 KiB

Исходник Ответственный История

title	description	type	page_title	slug	position	tags	ticketid	res_type
How to Localize Report Server-Side Based on Report Parameter Value	I would like the users of my Html5 Report Viewer to select the Report culture as a value of a Report Parameter. How can I apply the selected culture in Report rendering?	how-to	Localizing Report from the ReportsController	localize-report-serverside-based-on-parameter			1592067	kb

Environment

Product

Progress® Telerik® Reporting

Description

In my scenario, the users would select the Report culture as a value of a Report Parameter in the Html5 Report Viewer. How can I apply the selected culture server-side for the Report rendering?

Solution

The CreateInstance and CreateDocument virtual methods are called always when you need to render the report in a viewer that utilizes the [Telerik Reporting REST Service]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/overview%}) for generating reports. In the former you have the [client reportSource]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-report-viewer/api-reference/reportviewer/methods/reportsource(rs)%}), hence you may take the selected culture from the corresponding parameter. In the latter, you may provide the culture to the Reporting engine through the DeviceInfo dictionary in the CreateDocumentArgs args argument.

Here is sample code, which assumes that the Report has a parameter called lang that holds the selected culture name:

[Route("api/reports")]
public class ReportsController : ReportsControllerBase
{
	public static string Lang { get; set; }

	public ReportsController(IReportServiceConfiguration reportServiceConfiguration)
		: base(reportServiceConfiguration)
	{
	}

	//...

	public override IActionResult CreateInstance(string clientID, [FromBody] ClientReportSource reportSource)
	{
		Lang = reportSource.ParameterValues["lang"].ToString();

		return base.CreateInstance(clientID, reportSource);
	}

	public override IActionResult CreateDocument(string clientID, string instanceID, [FromBody] CreateDocumentArgs args)
	{
		args.DeviceInfo["CurrentCulture"] = Lang;
		args.DeviceInfo["CurrentUICulture"] = Lang;

		return base.CreateDocument(clientID, instanceID, args);
	}
}

The idea is to introduce a static string property, set its value in the CreateInstance method and use this value in the CreateDocument method.

note The ReportsController gets instantiated on each request. Therefore, if the variable holding the culture name is not static, the value will be lost between the requests.

If you need to localize also the Text specifying the names of the Report Parameter editors in the Html5 Viewers, you need to use the [renderingEnd]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-report-viewer/api-reference/reportviewer/events/renderingend(e,-args)%}) event to select the parameter editor's element and change its text based on the selected culture. Here is a sample jQuery code for the event handler:

renderingEnd: function (e, args) {
	var langValue = e.data.sender.reportSource().parameters["lang"];

	var langParam = $(`.trv-parameter-header div[title='Language']`);
	if (langValue == "bg-BG") {
		langParam.text("Език");
	} else {
		langParam.text("Language");
	}
}

The reason for this is that the Parameters area of the viewer gets rendered with viewer loading, after calling the [Get Report Parameters]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/rest-api-reference/report-parameters-api/get-report-parameters%}) request that returns the visible Report Parameters with their default values. When the user selects new parameter values in the viewer, the Get Report Parameters request is not performed and the names of the editors are not updated.

5.2 KiB Исходник Ответственный История

Environment

Description

Solution

See Also

5.2 KiB

Исходник Ответственный История