@progress/telerik-jquery-report-viewer 23.24.806 → 24.24.1112

package/dist/js/telerikReportViewer.js

@@ -1,5 +1,5 @@
 /*
-* TelerikReporting v18.2.24.806 (https://www.telerik.com/products/reporting.aspx)
+* TelerikReporting v18.3.24.1112 (https://www.telerik.com/products/reporting.aspx)
 * Copyright 2024 Progress Software EAD. All rights reserved.
 *
 * Telerik Reporting commercial licenses may be obtained at
@@ -561,6 +561,8 @@ var telerikReportViewer = (function (exports) {
       cannotValidateType: "Cannot validate parameter of type {type}.",
       loadingFormats: "Loading...",
       loadingReport: "Loading report...",
+      loadingParameters: "Loading parameters...",
+      autoRunDisabled: "Please validate the report parameter values and press Preview to generate the report.",
       preparingDownload: "Preparing document to download. Please wait...",
       preparingPrint: "Preparing document to print. Please wait...",
       errorLoadingTemplates: "Error loading the report viewer's templates. (templateUrl = '{0}').",
@@ -779,8 +781,8 @@ var telerikReportViewer = (function (exports) {
       }
       function setPageSelector() {
         var pagers = document.querySelectorAll(".trv-report-pager");
-        var pageNumber = this._controller.getCurrentPageNumber();
-        var pageCount = this._controller.getPageCount();
+        var pageNumber = controller.getCurrentPageNumber();
+        var pageCount = controller.getPageCount();
         pagers.forEach((pager) => {
           pager.setAttribute("aria-label", stringFormat(stringResources.ariaLabelPageNumberSelector, [pageNumber, pageCount]));
           var pageInputs = pager.querySelectorAll("input[data-role=telerik_ReportViewer_PageNumberInput]");
@@ -1131,7 +1133,7 @@ var telerikReportViewer = (function (exports) {
         }),
         "refresh": new Command(
           function() {
-            controller.refreshReport(true);
+            controller.refreshReport(true, false);
           }
         ),
         "export": new Command(function(format) {
@@ -1552,6 +1554,7 @@ var telerikReportViewer = (function (exports) {
         if (pingMilliseconds <= 0) {
           return;
         }
+        pingMilliseconds = Math.min(pingMilliseconds, 2147483647);
         interval = setInterval(function() {
           serviceClient.keepClientAlive(clientID);
         }, pingMilliseconds);
@@ -2307,7 +2310,7 @@ var telerikReportViewer = (function (exports) {
             report: args.Report,
             parameters: fixDataContractJsonSerializer(args.ParameterValues)
           });
-          controller.refreshReport(false);
+          controller.refreshReport(false, true);
         },
         "navigateToUrl": function(action) {
           var args = action.Value;
@@ -2419,6 +2422,7 @@ var telerikReportViewer = (function (exports) {
         UPDATE_UI: "trv.UPDATE_UI",
         CSS_LOADED: "cssLoaded",
         RELOAD_PARAMETERS: "reloadParameters",
+        PARAMETERS_LOADED: "parametersLoaded",
         INTERACTIVE_ACTION_EXECUTING: "interactiveActionExecuting",
         INTERACTIVE_ACTION_ENTER: "interactiveActionEnter",
         INTERACTIVE_ACTION_LEAVE: "interactiveActionLeave",
@@ -2468,7 +2472,7 @@ var telerikReportViewer = (function (exports) {
               return this;
             }
             report = rs.report;
-            parameterValues = rs.parameters;
+            controller.setParameters(rs.parameters);
             changeReportSource(rs);
             return this;
           },
@@ -2489,6 +2493,7 @@ var telerikReportViewer = (function (exports) {
           },
           setParameters: function(paramValues) {
             parameterValues = paramValues;
+            controller.parametersLoaded();
           },
           setProcessedParameter: function(processedParamValues) {
             processedParameterValues = processedParamValues;
@@ -2566,6 +2571,7 @@ var telerikReportViewer = (function (exports) {
           },
           previewReport: function(ignoreCache, baseDocumentId, actionId) {
             controller.loadedReportChange();
+            controller.respectReportAutoRun = false;
             controller.refreshReportCore(ignoreCache, baseDocumentId, actionId);
           },
           refreshReportCore: function(ignoreCache, baseDocumentId, actionId) {
@@ -2603,7 +2609,7 @@ var telerikReportViewer = (function (exports) {
             }
             return paramsToBeExposed;
           },
-          refreshReport: function(ignoreCache, baseDocumentId, actionId) {
+          refreshReport: function(ignoreCache, respectAutoRun, baseDocumentId, actionId) {
             controller.loadedReportChange();
             if (clientHasExpired) {
               clientHasExpired = false;
@@ -2633,12 +2639,25 @@ var telerikReportViewer = (function (exports) {
                 appendInvalidReportParameterNames(invalidParameters);
                 controller.missingOrInvalidParameters();
               } else {
+                controller.respectReportAutoRun = respectAutoRun;
                 controller.setParameters(parameterValues2);
-                controller.refreshReportCore(ignoreCache, baseDocumentId, actionId);
+                if (controller.isReportAutoRun()) {
+                  controller.refreshReportCore(ignoreCache, baseDocumentId, actionId);
+                } else {
+                  controller.showNotification({ stringResources: "autoRunDisabled" });
+                }
               }
             });
             controller.reloadParameters(loadParametersPromise);
           },
+          isReportAutoRun: function() {
+            var _a;
+            var reportAutoRunParameter = true;
+            if (parameterValues) {
+              reportAutoRunParameter = (_a = parameterValues.trv_AutoRun) != null ? _a : true;
+            }
+            return !controller.respectReportAutoRun || reportAutoRunParameter;
+          },
           exportReport: function(format, deviceInfo) {
             exportReport(format, deviceInfo);
           },
@@ -2720,6 +2739,9 @@ var telerikReportViewer = (function (exports) {
           reloadParameters: function(...args) {
             return eventFactory(controller.Events.RELOAD_PARAMETERS, args);
           },
+          parametersLoaded: function(...args) {
+            return eventFactory(controller.Events.PARAMETERS_LOADED, args);
+          },
           exportStarted: function(...args) {
             return eventFactory(controller.Events.EXPORT_STARTED, args);
           },
@@ -2908,7 +2930,8 @@ var telerikReportViewer = (function (exports) {
       INTERACTIVE_ACTION_LEAVE: "INTERACTIVE_ACTION_LEAVE",
       VIEWER_TOOLTIP_OPENING: "VIEWER_TOOLTIP_OPENING",
       SEND_EMAIL_BEGIN: "SEND_EMAIL_BEGIN",
-      SEND_EMAIL_END: "SEND_EMAIL_END"
+      SEND_EMAIL_END: "SEND_EMAIL_END",
+      PARAMETERS_LOADED: "PARAMETERS_LOADED"
     };
 
     function HistoryManager(options) {
@@ -2970,11 +2993,11 @@ var telerikReportViewer = (function (exports) {
           });
         }
       }
-      function exec(currentRecord) {
+      function exec(currentRecord, reportChanged) {
         controller.setReportDocumentId(currentRecord.reportDocumentId);
         controller.setViewMode(currentRecord.viewMode);
         controller.setReportSource(currentRecord.reportSource);
-        controller.refreshReport(false, currentRecord.reportDocumentId);
+        controller.refreshReport(false, reportChanged, currentRecord.reportDocumentId);
         controller.navigateToPage(currentRecord.pageNumber);
       }
       function canMove(step) {
@@ -2993,9 +3016,13 @@ var telerikReportViewer = (function (exports) {
           newPos = length - 1;
         }
         if (newPos != position) {
+          var currentRecord = getCurrentRecord();
+          var currentReport = currentRecord.reportSource ? currentRecord.reportSource.report : "";
           history.position = newPos;
           saveSettings();
-          exec(getCurrentRecord());
+          var newRecord = getCurrentRecord();
+          var newReport = newRecord.reportSource ? newRecord.reportSource.report : "";
+          exec(newRecord, currentReport !== newReport);
         }
       }
       function removeTempRecordsFromHistory() {
@@ -3028,7 +3055,7 @@ var telerikReportViewer = (function (exports) {
         loadCurrent: function() {
           var rec = getCurrentRecord();
           if (rec) {
-            exec(rec);
+            exec(rec, false);
           }
           return Boolean(rec);
         }
@@ -4004,7 +4031,8 @@ var telerikReportViewer = (function (exports) {
         documentReady = false;
       }).beforeLoadParameters(function(event, initial) {
         if (initial) {
-          showError(stringResources.loadingReport);
+          clearPendingTimeoutIds();
+          showError(stringResources.loadingParameters);
         }
       }).beforeLoadReport(function() {
         documentReady = false;
@@ -4014,7 +4042,9 @@ var telerikReportViewer = (function (exports) {
         clearPendingTimeoutIds();
         clear();
         disablePagesArea(true);
-        showError(stringResources.loadingReport);
+        if (controller.isReportAutoRun()) {
+          showError(stringResources.loadingReport);
+        }
       }).beginLoadReport(function(event, args) {
         documentReady = true;
         invalidateCurrentlyLoadedPage();
@@ -6054,6 +6084,16 @@ var telerikReportViewer = (function (exports) {
           $li.attr("aria-label", $li[0].innerText);
         });
       }
+      function resetReportAndClearItems() {
+        documentMapNecessary = false;
+        showDocumentMap(false);
+        var r = controller.getReportSource().report;
+        var clearMapItems = currentReport !== r || !isVisible();
+        currentReport = r;
+        if (clearMapItems) {
+          clearDocumentMap();
+        }
+      }
       function clearDocumentMap() {
         displayDocumentMap([]);
       }
@@ -6119,14 +6159,10 @@ var telerikReportViewer = (function (exports) {
         }
       }
       function attach() {
-        controller.beginLoadReport(function() {
+        controller.beforeLoadParameters(function() {
+          resetReportAndClearItems();
+        }).beginLoadReport(function() {
           beginLoad();
-          var r = controller.getReportSource().report;
-          var clearMapItems = currentReport !== r || !isVisible();
-          currentReport = r;
-          if (clearMapItems) {
-            clearDocumentMap();
-          }
         }).reportLoadComplete(function(event, args) {
           if (args.documentMapAvailable) {
             documentMapNecessary = true;
@@ -6322,7 +6358,7 @@ var telerikReportViewer = (function (exports) {
         (error ? $.fn.addClass : $.fn.removeClass).call($placeholder, "trv-error");
       }
       function showPreviewButton() {
-        (allParametersAutoRefresh() ? $.fn.removeClass : $.fn.addClass).call($placeholder, "preview");
+        (allParametersAutoRefresh() && controller.isReportAutoRun() ? $.fn.removeClass : $.fn.addClass).call($placeholder, "preview");
       }
       function allParametersAutoRefresh() {
         var allAuto = Array.from(parameters).every((parameter) => {
@@ -6510,10 +6546,7 @@ var telerikReportViewer = (function (exports) {
       }
       var parametersAreaNecessary = false;
       function onLoadParametersComplete(params, successAction) {
-        parametersAreaNecessary = hasVisibleParameters(params);
-        if (!parametersAreaNecessary) {
-          showParametersArea(false);
-        }
+        showParametersAreaIfNecessary(params);
         fill(params);
         showError("");
         if (parametersAreaNecessary && parametersAreaVisible) {
@@ -6528,6 +6561,10 @@ var telerikReportViewer = (function (exports) {
         }
         endLoad();
       }
+      function showParametersAreaIfNecessary(params) {
+        parametersAreaNecessary = hasVisibleParameters(params) || !controller.isReportAutoRun();
+        showParametersArea(parametersAreaNecessary);
+      }
       function updateParameters(successAction) {
         acceptParameters(controller.loadParameters(recentParameterValues), successAction);
       }
@@ -6597,6 +6634,9 @@ var telerikReportViewer = (function (exports) {
       controller.reloadParameters(onReloadParameters).beforeLoadReport(function() {
         loadingCount = 0;
         beginLoad();
+      }).reportLoadComplete(function() {
+        showParametersAreaIfNecessary(parameters);
+        showPreviewButton();
       }).error(endLoad).pageReady(endLoad);
       controller.getParametersAreaState(function(event, args) {
         var parametersAreaNecessary2 = false;
@@ -8503,7 +8543,7 @@ var telerikReportViewer = (function (exports) {
       if (!validateOptions(options)) {
         return;
       }
-      var version = "18.2.24.806";
+      var version = "18.3.24.1112";
       options = $.extend({}, getDefaultOptions(svcApiUrl, version), options);
       settings = new ReportViewerSettings(
         persistanceKey,
@@ -8560,13 +8600,13 @@ var telerikReportViewer = (function (exports) {
           if (arguments.length === 0) {
             ignoreCache = true;
           }
-          controller.refreshReport(ignoreCache);
+          controller.refreshReport(ignoreCache, true);
           return viewer;
         },
         reportSource: function(rs) {
           if (rs || rs === null) {
             controller.setReportSource(rs);
-            controller.refreshReport(false);
+            controller.refreshReport(false, true);
             return viewer;
           }
           return controller.getReportSource();
@@ -8619,6 +8659,9 @@ var telerikReportViewer = (function (exports) {
         getReportParameters: function() {
           return controller.getReportParameters();
         },
+        isReportAutoRun: function() {
+          return controller.isReportAutoRun();
+        },
         authenticationToken: function(token) {
           if (token) {
             controller.setAuthenticationToken(token);
@@ -8694,7 +8737,8 @@ var telerikReportViewer = (function (exports) {
           INTERACTIVE_ACTION_LEAVE: controller.Events.INTERACTIVE_ACTION_LEAVE,
           VIEWER_TOOLTIP_OPENING: controller.Events.TOOLTIP_OPENING,
           SEND_EMAIL_BEGIN: controller.Events.SEND_EMAIL_STARTED,
-          SEND_EMAIL_END: controller.Events.SEND_EMAIL_READY
+          SEND_EMAIL_END: controller.Events.SEND_EMAIL_READY,
+          PARAMETERS_LOADED: controller.Events.PARAMETERS_LOADED
         };
         var $viewer = $(viewer);
         for (const [viewerEvent, controllerEvent] of Object.entries(eventMap)) {
@@ -8719,6 +8763,7 @@ var telerikReportViewer = (function (exports) {
         eventBinder(Events$1.VIEWER_TOOLTIP_OPENING, options.viewerToolTipOpening, true);
         eventBinder(Events$1.SEND_EMAIL_BEGIN, options.sendEmailBegin, true);
         eventBinder(Events$1.SEND_EMAIL_END, options.sendEmailEnd, true);
+        eventBinder(Events$1.PARAMETERS_LOADED, options.parametersLoaded, true);
       }
       function init() {
         $placeholder.html(templates["trv-report-viewer"]);
@@ -8944,7 +8989,7 @@ var telerikReportViewer = (function (exports) {
           options.ready.call(viewer);
         }
         if (pendingRefresh) {
-          controller.refreshReport(false);
+          controller.refreshReport(false, true);
         }
       }
       function loadStyleSheets(styleSheets) {