Progress® Telerik® Reporting R3 2017

Localization

The article elaborates on how to localize the messages displayed by the HTML5 Report Viewer.

  1. To localize the report viewer messages, create a new JavaScript file using the following code snippet:

    JavaScript
    ; (function (trv, $) {
        "use strict";
    
        var sr = {
            controllerNotInitialized: 'Controller is not initialized.',
            noReportInstance: 'No report instance.',
            missingTemplate: 'ReportViewer template is missing. Please specify the templateUrl in the options.',
            noReport: 'No report.',
            noReportDocument: 'No report document.',
            invalidParameter: 'Please input a valid value.',
            invalidDateTimeValue: 'Please input a valid date.',
            parameterIsEmpty: 'Parameter value cannot be empty.',
            cannotValidateType: 'Cannot validate parameter of type {type}.',
            loadingFormats: 'Loading...',
            loadingReport: 'Loading report...',
            preparingDownload: 'Preparing document to download. Please wait...',
            preparingPrint: 'Preparing document to print. Please wait...',
            errorLoadingTemplates: 'Error loading the report viewer\'s templates.',
            loadingReportPagesInProgress: '{0} pages loaded so far ...',
            loadedReportPagesComplete: 'Done. Total {0} pages loaded.',
            noPageToDisplay: "No page to display.",
            errorDeletingReportInstance : 'Error deleting report instance: {0}', 
            errorRegisteringViewer : 'Error registering the viewer with the service.', 
            noServiceClient : 'No serviceClient has been specified for this controller.', 
            errorRegisteringClientInstance : 'Error registering client instance', 
            errorCreatingReportInstance : 'Error creating report instance (Report = {0})', 
            errorCreatingReportDocument : 'Error creating report document (Report = {0}; Format = {1})', 
            unableToGetReportParameters : "Unable to get report parameters", 
            errorObtainingAuthenticationToken: 'Error obtaining authentication token.',
            clientExpired: "Click 'Refresh' to restore client session.",
    
            //accessibility string resources
            ariaLabelPageNumberSelector: "Page number selector. Showing page {0} of {1}.",
            ariaLabelPageNumberEditor: "Page number editor.",        
            ariaLabelExpandable: "Expandable",
            ariaLabelParameter: "parameter",
            ariaLabelErrorMessage: "Error message",
            ariaLabelParameterInfo: "Contains {0} options.",
            ariaLabelMultiSelect: "Multiselect",
            ariaLabelMultiValue: "Multivalue",
            ariaLabelSingleValue: "Single value",
            ariaLabelParameterDateTime: "Datetime",
            ariaLabelParameterString: "String",
            ariaLabelParameterNumerical: "Numerical",
            ariaLabelParameterBoolean: "Boolean",
        };
    
        trv.sr = $.extend(trv.sr, sr);
    
    }(window.telerikReportViewer = window.telerikReportViewer || {}, jQuery));
  2. Specify the name of the file using the following convention:

    resources.[culture].js

    where [culture] is the name of the culture for the specified localization resource. For example, to provide a localization resource for the French Belgian culture, the corresponding resource file could be named as follows:

    resources.fr-BE.js

  3. Add the newly created JavaScript file to the <head> element of the page with the viewer:

    HTML
    <script src="resources.fr-BE.js"></script>
  4. Translate the texts for the specified culture

Tip Tip

To modify the HTML5 Viewer's HTML template that contains the toolbar, Preview, Parameters and DocumentMap areas, you will have to set the viewer's templateUrl. For more details, check Providing Templates.

See Also

Other Resources