@topconsultnpm/sdkui-react 6.22.0-dev3.9 → 6.22.0-dev4.10

package/lib/hooks/useDcmtOperations.js

@@ -1,7 +1,7 @@
-import { useState } from 'react';
+import { useEffect, useRef } from 'react';
 import { LocalizeDcmtOperationTypes } from '../helper/Enum_Localizator';
 import { SDK_Globals, RetrieveFileOptions, DcmtOpers, ResultTypes, RecentCategories, MetadataDataTypes, MetadataDataDomains, DataListCacheService, DcmtTypeListCacheService, TemplateTIDs } from '@topconsultnpm/sdk-ts';
-import { ShowAlert, TMResultManager, FormulaHelper, TMExceptionBoxManager, TMSpinner } from '../components';
+import { ShowAlert, TMResultManager, FormulaHelper, TMExceptionBoxManager, TMSpinner, TMWaitPanelManager } from '../components';
 import { Globalization, getExceptionMessage, dialogConfirmOperation, extensionHandler, downloadBase64File, SDKUI_Globals, dcmtsFileCacheDownload, CACHE_SIZE_LIMIT, clearDcmtsFileCache, dcmtsFileCachePreview, isDcmtFileInCache, removeDcmtsFileCache, SDKUI_Localizator, ZipManager } from '../helper';
 import { DcmtOperationTypes, DownloadTypes, FileExtensionHandler } from '../ts';
 import { useFileDialog, useFileSourceDialog } from './useInputDialog';
@@ -9,10 +9,6 @@ import { importCertificatesAsync } from '../helper/certificateImportHelper';
 import { isXMLFileExt } from '../helper/dcmtsHelper';
 import { ShowConfirm } from '../components/base/TMConfirm';
 import { generateTargetFileName } from '../components/features/documents/copyAndMergeDcmtsShared';
-/** Limite massimo di download paralleli accettato da `downloadDcmtsAsync`. */
-const MAX_DOWNLOAD_CONCURRENCY = 8;
-/** Intervallo minimo (ms) fra due aggiornamenti della progress bar di download. */
-const DOWNLOAD_PROGRESS_THROTTLE_MS = 100;
 const isScannerLicenseConfigured = () => {
     try {
         const scannerLicense = SDKUI_Globals.userSettings.advancedSettings.scannerLicense;
@@ -111,16 +107,24 @@ const getDownloadFileName = (file, dcmtInfo, useInputFileName = false) => {
     return `${baseFileName.slice(0, firstDot)}(${count})${baseFileName.slice(firstDot)}`;
 };
 export const useDcmtOperations = () => {
-    const [showWaitPanel, setShowWaitPanel] = useState(false);
-    const [waitPanelTitle, setWaitPanelTitle] = useState('');
-    const [showPrimary, setShowPrimary] = useState(false);
-    const [waitPanelTextPrimary, setWaitPanelTextPrimary] = useState('');
-    const [waitPanelValuePrimary, setWaitPanelValuePrimary] = useState(0);
-    const [waitPanelMaxValuePrimary, setWaitPanelMaxValuePrimary] = useState(0);
-    const [showSecondary, setShowSecondary] = useState(false);
-    const [waitPanelTextSecondary, setWaitPanelTextSecondary] = useState('');
-    const [waitPanelValueSecondary, setWaitPanelValueSecondary] = useState(0);
-    const [waitPanelMaxValueSecondary, setWaitPanelMaxValueSecondary] = useState(0);
+    // Pannello imperativo: l'avanzamento non passa da uno stato React.
+    const waitPanelRef = useRef(null);
+    /** Apre il wait panel dell'operazione. Interrompi agisce sull'abortController del ciclo. */
+    const openWaitPanel = (options) => {
+        waitPanelRef.current?.close();
+        const panel = TMWaitPanelManager.show({ cancelable: true, onAbort: () => abortController.abort(), ...options });
+        waitPanelRef.current = panel;
+        return panel;
+    };
+    const closeWaitPanel = (panel) => {
+        panel.close();
+        if (waitPanelRef.current === panel)
+            waitPanelRef.current = null;
+    };
+    /** Messaggio per il popover delle pill del pannello: il DID dice a quale documento si riferisce. */
+    const panelMessage = (dcmt, message) => `DID ${dcmt.DID}: ${message}`;
+    // Il pannello vive fuori dall'albero del chiamante: allo smontaggio va chiuso a mano.
+    useEffect(() => () => { waitPanelRef.current?.close(); waitPanelRef.current = null; }, []);
     const { OpenFileDialog } = useFileDialog();
     const [selectFileSource, FileSourceDialog] = useFileSourceDialog();
     const copyCompliantDcmtsAsync = async (inputDcmt, onFileDownloaded) => {
@@ -133,8 +137,14 @@ export const useDcmtOperations = () => {
         let returnDcmtInfos = [];
         const rfo = new RetrieveFileOptions();
         rfo.retrieveReason = DcmtOpers.ShowFile;
-        let firstBlock = true;
-        let maxFileSize = 0;
+        // Gira dentro runOperationAsync: i byte vanno sulla barra secondaria del pannello gia' aperto.
+        const publishSecondary = (pd, label) => {
+            const max = pd.ProgressBarMaximum ?? 0;
+            const completed = pd.ProgressBarValue === pd.ProgressBarMaximum;
+            waitPanelRef.current?.setSecondary(completed
+                ? { value: 0, max: 0, text: '' }
+                : { value: pd.ProgressBarValue, max, text: `${label} ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(max, true)}` });
+        };
         let signerInfoDescriptor = undefined;
         if (inputDcmt?.FILEEXT == undefined || inputDcmt.FILEEXT == '') {
             throw new Error('WARNING#' + SDKUI_Localizator.MetadataOnlyDocument);
@@ -183,21 +193,7 @@ export const useDcmtOperations = () => {
             else
                 throw new Error('IdC non firmato e non marcato temporalmente!');
             //Ricerca dell'impronta SHA256 nel contenuto dell'IdC
-            let fileIdC = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(serachResultIdC.dtdResult.rows[0][0], serachResultIdC.dtdResult.rows[0][1], rfo, abortController.signal, (pd) => {
-                if (firstBlock) {
-                    maxFileSize = pd.ProgressBarMaximum ?? 0;
-                    setWaitPanelMaxValueSecondary(maxFileSize);
-                    firstBlock = false;
-                }
-                setWaitPanelValueSecondary(pd.ProgressBarValue);
-                setWaitPanelTextSecondary(`Downloading IdC... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                    setWaitPanelMaxValueSecondary(0);
-                    setWaitPanelValueSecondary(0);
-                    setWaitPanelTextSecondary('');
-                    firstBlock = true;
-                }
-            });
+            let fileIdC = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(serachResultIdC.dtdResult.rows[0][0], serachResultIdC.dtdResult.rows[0][1], rfo, abortController.signal, (pd) => publishSecondary(pd, 'Downloading IdC...'));
             let hashOk = false;
             if (fileIdC) {
                 try {
@@ -214,21 +210,7 @@ export const useDcmtOperations = () => {
                 throw new Error('Impronta non trovata nel file IdC o non corrispondente a quella del documento');
             }
             let file;
-            file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmt.TID, inputDcmt.DID, rfo, abortController.signal, (pd) => {
-                if (firstBlock) {
-                    maxFileSize = pd.ProgressBarMaximum ?? 0;
-                    setWaitPanelMaxValueSecondary(maxFileSize);
-                    firstBlock = false;
-                }
-                setWaitPanelValueSecondary(pd.ProgressBarValue);
-                setWaitPanelTextSecondary(`Downloading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                    setWaitPanelMaxValueSecondary(0);
-                    setWaitPanelValueSecondary(0);
-                    setWaitPanelTextSecondary('');
-                    firstBlock = true;
-                }
-            });
+            file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmt.TID, inputDcmt.DID, rfo, abortController.signal, (pd) => publishSecondary(pd, 'Downloading...'));
             if (file && fileIdC) {
                 returnDcmtFiles.push(file);
                 returnDcmtInfos.push(inputDcmt);
@@ -261,7 +243,7 @@ export const useDcmtOperations = () => {
             ShowAlert({ message: SDKUI_Localizator.ZipCreatedSavedInFolder.replaceParams(zipFileName, "Zip creato con successo"), mode: 'success', duration: 5000, title: SDKUI_Localizator.CompressToZipFile });
         }
     };
-    const _downloadDcmtsAsync = async (inputDcmts, downloadMode = "download", onFileDownloaded, skipConfirmation = false, retrieveOptions, useCache = true, showSuccessAlert = true, useInputFileName = false, downloadConcurrency = 1) => {
+    const _downloadDcmtsAsync = async (inputDcmts, downloadMode = "download", onFileDownloaded, skipConfirmation = false, retrieveOptions, useCache = true, showSuccessAlert = true, useInputFileName = false) => {
         if (inputDcmts === undefined)
             return;
         if (inputDcmts.length <= 0)
@@ -285,86 +267,61 @@ export const useDcmtOperations = () => {
             }
         }
         let operationTitle = 'Download File';
-        setShowWaitPanel(true);
-        setShowPrimary(inputDcmts.length > 1);
-        setShowSecondary(true);
-        setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
-        // Riferimento const: il narrowing su inputDcmts non sopravvive dentro le closure del pool.
+        // Riferimento const: il narrowing su inputDcmts non sopravvive dentro le closure.
         const dcmts = inputDcmts;
-        /**
-         * Ogni richiesta usa la propria istanza di RetrieveFileOptions: con il pool più
-         * download sono in volo contemporaneamente e non possono condividere lo stesso oggetto.
-         */
-        const buildRetrieveFileOptions = (dcmt) => {
-            const rfo = new RetrieveFileOptions();
-            rfo.retrieveReason = retrieveOptions?.retrieveReason ?? DcmtOpers.ShowFile;
-            if (retrieveOptions?.cvtFormat !== undefined)
-                rfo.cvtFormat = retrieveOptions.cvtFormat;
-            if (retrieveOptions?.generalRetrieveFormat !== undefined)
-                rfo.generalRetrieveFormat = retrieveOptions.generalRetrieveFormat;
-            rfo.invoiceRetrieveFormat = retrieveOptions?.invoiceRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
-            rfo.orderRetrieveFormat = retrieveOptions?.orderRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
-            return rfo;
-        };
-        const results = new Array(dcmts.length);
-        setWaitPanelMaxValuePrimary(dcmts.length);
-        // ---- Progress secondaria: aggregata sui download in volo e throttlata ----
-        // Gli eventi di avanzamento di axios arrivano a ogni chunk: senza throttle ognuno
-        // provoca un re-render dell'intera form (relation viewer compreso).
-        const inFlightBytes = new Map();
-        let pendingSecondary;
-        let secondaryTimer;
-        const flushSecondaryProgress = () => {
-            secondaryTimer = undefined;
-            if (!pendingSecondary)
-                return;
-            setWaitPanelMaxValueSecondary(pendingSecondary.max);
-            setWaitPanelValueSecondary(pendingSecondary.value);
-            setWaitPanelTextSecondary(pendingSecondary.text);
-            pendingSecondary = undefined;
-        };
-        const publishSecondaryProgress = () => {
-            let loaded = 0;
-            let total = 0;
-            for (const bytes of inFlightBytes.values()) {
-                loaded += bytes.loaded;
-                total += bytes.total;
-            }
-            pendingSecondary = total > 0
-                ? { value: loaded, max: total, text: `Downloading... ${Globalization.getNumberDisplayValue(loaded, true)} / ${Globalization.getNumberDisplayValue(total, true)}` }
-                : { value: 0, max: 0, text: '' };
-            if (secondaryTimer === undefined)
-                secondaryTimer = setTimeout(flushSecondaryProgress, DOWNLOAD_PROGRESS_THROTTLE_MS);
+        // Con un solo documento c'e' un avanzamento solo, quello dei byte, e sta sulla barra
+        // principale: la doppia barra (documenti + byte) serve solo all'elaborazione multipla.
+        const isBatch = dcmts.length > 1;
+        const panel = openWaitPanel({
+            title: operationTitle,
+            max: isBatch ? dcmts.length : 0,
+            showSecondary: isBatch,
+            showCounters: isBatch,
+            primaryLabel: isBatch ? SDKUI_Localizator.Documents : undefined,
+            secondaryLabel: isBatch ? 'File corrente' : undefined,
+        });
+        const rfo = new RetrieveFileOptions();
+        rfo.retrieveReason = retrieveOptions?.retrieveReason ?? DcmtOpers.ShowFile;
+        if (retrieveOptions?.cvtFormat !== undefined)
+            rfo.cvtFormat = retrieveOptions.cvtFormat;
+        if (retrieveOptions?.generalRetrieveFormat !== undefined)
+            rfo.generalRetrieveFormat = retrieveOptions.generalRetrieveFormat;
+        rfo.invoiceRetrieveFormat = retrieveOptions?.invoiceRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
+        rfo.orderRetrieveFormat = retrieveOptions?.orderRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
+        const results = [];
+        // Il pannello coalesce le scritture in un flush per frame: nessun throttle serve.
+        const publishBytes = (loaded, total) => {
+            const text = total > 0
+                ? `Downloading... ${Globalization.getNumberDisplayValue(loaded, true)} / ${Globalization.getNumberDisplayValue(total, true)}`
+                : '';
+            if (isBatch)
+                panel.setSecondary({ value: loaded, max: total, text });
+            else
+                panel.update({ value: loaded, max: total, subtitle: text });
         };
-        // ---- Pool di download ----
-        let nextIndex = 0;
-        let started = 0;
+        // ---- Download sequenziale: un documento per volta ----
         let completed = 0;
-        let abortReported = false;
         const downloadOne = async (i) => {
-            started++;
-            setWaitPanelTextPrimary(`Download file ${started} di ${dcmts.length}`);
+            if (isBatch)
+                panel.setSubtitle(`Download file ${i + 1} di ${dcmts.length}`);
             let file;
             const cacheKey = `${dcmts[i].TID}-${dcmts[i].DID}`;
             if (useCache && dcmtsFileCacheDownload.has(cacheKey)) {
                 file = dcmtsFileCacheDownload.get(cacheKey);
             }
             else {
-                inFlightBytes.set(i, { loaded: 0, total: 0 });
                 try {
-                    file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(dcmts[i].TID, dcmts[i].DID, buildRetrieveFileOptions(dcmts[i]), abortController.signal, (pd) => {
-                        inFlightBytes.set(i, { loaded: pd.ProgressBarValue, total: pd.ProgressBarMaximum ?? 0 });
-                        publishSecondaryProgress();
-                    });
+                    file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(dcmts[i].TID, dcmts[i].DID, rfo, abortController.signal, (pd) => publishBytes(pd.ProgressBarValue, pd.ProgressBarMaximum ?? 0));
                 }
                 finally {
-                    inFlightBytes.delete(i);
-                    publishSecondaryProgress();
+                    if (isBatch)
+                        publishBytes(0, 0);
                 }
             }
             completed++;
-            setWaitPanelValuePrimary(completed);
+            if (isBatch)
+                panel.setValue(completed);
             if (downloadMode === "openInNewWindow") {
                 if (onFileDownloaded && file) {
                     onFileDownloaded(file, dcmts[i]);
@@ -400,48 +357,34 @@ export const useDcmtOperations = () => {
                 }
                 dcmtsFileCacheDownload.set(cacheKey, file);
             }
-            results[i] = { rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.SUCCESS };
+            results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.SUCCESS });
         };
-        const runWorker = async () => {
-            while (true) {
-                const i = nextIndex++;
-                if (i >= dcmts.length)
-                    return;
-                if (abortController.signal.aborted) {
-                    // Un solo avviso di interruzione anche quando più worker si fermano insieme.
-                    if (!abortReported) {
-                        abortReported = true;
-                        results[i] = { rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${completed} documenti` };
-                    }
-                    return;
-                }
-                try {
-                    await downloadOne(i);
-                }
-                catch (ex) {
-                    results[i] = { rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(ex) };
-                    const err = ex;
-                    if (err.name === 'CanceledError') {
-                        ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
-                    }
+        for (let i = 0; i < dcmts.length; i++) {
+            // Con la conferma di interruzione aperta il ciclo si ferma qui invece di
+            // continuare a scaricare dietro al dialogo.
+            await panel.waitWhilePaused();
+            if (abortController.signal.aborted) {
+                const description = SDKUI_Localizator.OperationDcmtsInterrupted.replaceParams(completed);
+                results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.WARNING, description });
+                panel.warning(1, description);
+                break;
+            }
+            try {
+                await downloadOne(i);
+                panel.ok();
+            }
+            catch (ex) {
+                const description = getExceptionMessage(ex);
+                results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.ERROR, description });
+                panel.error(1, panelMessage(dcmts[i], description));
+                const err = ex;
+                if (err.name === 'CanceledError') {
+                    ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
                 }
             }
-        };
-        // `|| 1` intercetta NaN/0/negativi: senza, Array.from({length: NaN}) non creerebbe
-        // alcun worker e il download terminerebbe in silenzio senza scaricare nulla.
-        const workers = Math.max(1, Math.min(Math.trunc(downloadConcurrency) || 1, MAX_DOWNLOAD_CONCURRENCY, dcmts.length));
-        await Promise.all(Array.from({ length: workers }, () => runWorker()));
-        if (secondaryTimer !== undefined)
-            clearTimeout(secondaryTimer);
-        const result = results.filter((r) => r !== undefined);
-        setWaitPanelTextPrimary('');
-        setWaitPanelMaxValuePrimary(0);
-        setWaitPanelValuePrimary(0);
-        setWaitPanelTextSecondary('');
-        setWaitPanelMaxValueSecondary(0);
-        setWaitPanelValueSecondary(0);
-        setShowWaitPanel(false);
-        TMResultManager.show(result, operationTitle, "TID", "DID", undefined, undefined, showSuccessAlert);
+        }
+        closeWaitPanel(panel);
+        TMResultManager.show(results, operationTitle, "TID", "DID", undefined, undefined, showSuccessAlert);
     };
     const _downloadAttachmentsAsync = async (inputDcmts, confirmAttachments, showSuccessAlert = true) => {
         if (inputDcmts === undefined)
@@ -482,7 +425,7 @@ export const useDcmtOperations = () => {
                 // Download the selected files
                 for (let i = 0; i < selectedFiles.length; i++) {
                     if (abortController.signal.aborted) {
-                        result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${i + 1} documenti` });
+                        result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: SDKUI_Localizator.OperationItemsInterrupted.replaceParams(i) });
                         break;
                     }
                     let fd = files.find(f => f.name === selectedFiles[i]);
@@ -505,13 +448,12 @@ export const useDcmtOperations = () => {
     };
     const downloadDcmtsAsync = async (params) => {
         const { inputDcmts, downloadType = DownloadTypes.Attachment, downloadMode = "download", onFileDownloaded, confirmAttachments, skipConfirmation = false, retrieveOptions, useCache = true, showSuccessAlert = true, useInputFileName = false, // Default: usa il nome dal backend
-        downloadConcurrency = 1, // Default: sequenziale
          } = params;
         switch (downloadType) {
             // Per il download di documenti, passa useInputFileName per controllare la priorità del nome
-            case DownloadTypes.Dcmt: return await _downloadDcmtsAsync(inputDcmts, downloadMode, onFileDownloaded, skipConfirmation, retrieveOptions, useCache, showSuccessAlert, useInputFileName, downloadConcurrency);
+            case DownloadTypes.Dcmt: return await _downloadDcmtsAsync(inputDcmts, downloadMode, onFileDownloaded, skipConfirmation, retrieveOptions, useCache, showSuccessAlert, useInputFileName);
             case DownloadTypes.Attachment: return await _downloadAttachmentsAsync(inputDcmts, confirmAttachments, showSuccessAlert);
-            default: return await _downloadDcmtsAsync(inputDcmts, undefined, undefined, skipConfirmation, retrieveOptions, useCache, showSuccessAlert, useInputFileName, downloadConcurrency);
+            default: return await _downloadDcmtsAsync(inputDcmts, undefined, undefined, skipConfirmation, retrieveOptions, useCache, showSuccessAlert, useInputFileName);
         }
     };
     const uploadDcmtsAsync = async (inputDcmts, operationTitle, operType, actionAfterOperationAsync) => {
@@ -576,22 +518,38 @@ export const useDcmtOperations = () => {
         }
         if (!file)
             return;
-        setShowWaitPanel(true);
-        setShowPrimary(inputDcmts.length > 1);
-        setShowSecondary(true);
-        setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
+        // Come nel download: con un solo documento resta il solo avanzamento in byte.
+        const isBatch = inputDcmts.length > 1;
+        const panel = openWaitPanel({
+            title: operationTitle,
+            max: isBatch ? inputDcmts.length : 0,
+            showSecondary: isBatch,
+            showCounters: isBatch,
+            primaryLabel: isBatch ? SDKUI_Localizator.Documents : undefined,
+            secondaryLabel: isBatch ? 'File corrente' : undefined,
+        });
+        const publishBytes = (loaded, total) => {
+            const text = total > 0
+                ? `Uploading... ${Globalization.getNumberDisplayValue(loaded, true)} / ${Globalization.getNumberDisplayValue(total, true)}`
+                : '';
+            if (isBatch)
+                panel.setSecondary({ value: loaded, max: total, text });
+            else
+                panel.update({ value: loaded, max: total, subtitle: text });
+        };
         let result = [];
-        setWaitPanelMaxValuePrimary(inputDcmts.length);
-        let firstBlock = true;
-        let maxFileSize = 0;
         for (let i = 0; i < inputDcmts.length; i++) {
+            await panel.waitWhilePaused();
             if (abortController.signal.aborted) {
-                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${i + 1} documenti` });
+                const description = SDKUI_Localizator.OperationDcmtsInterrupted.replaceParams(i);
+                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description });
+                panel.warning(1, description);
                 break;
             }
             try {
-                setWaitPanelTextPrimary(`${SDKUI_Localizator.FileUpload} ${i + 1} di ${inputDcmts.length}`);
+                if (isBatch)
+                    panel.setSubtitle(`${SDKUI_Localizator.FileUpload} ${i + 1} di ${inputDcmts.length}`);
                 const cacheKey = `${inputDcmts[i].TID}-${inputDcmts[i].DID}`;
                 if (dcmtsFileCachePreview.has(cacheKey))
                     removeDcmtsFileCache(cacheKey);
@@ -599,41 +557,31 @@ export const useDcmtOperations = () => {
                 if (ue) {
                     ue.TID = inputDcmts[i].TID;
                     ue.DID = inputDcmts[i].DID;
-                    await ue.SubstituteFileAsync(file, operType, undefined, abortController.signal, (pd) => {
-                        if (firstBlock) {
-                            maxFileSize = pd.ProgressBarMaximum ?? 0;
-                            setWaitPanelMaxValueSecondary(maxFileSize);
-                            firstBlock = false;
-                        }
-                        setWaitPanelValueSecondary(pd.ProgressBarValue);
-                        setWaitPanelTextSecondary(`Uploading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                        if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                            setWaitPanelMaxValueSecondary(0);
-                            setWaitPanelValueSecondary(0);
-                            setWaitPanelTextSecondary('');
-                            firstBlock = true;
-                        }
-                    });
+                    await ue.SubstituteFileAsync(file, operType, undefined, abortController.signal, 
+                    // Byte finiti ma il server elabora ancora: la barra si azzera invece di restare al 100%.
+                    (pd) => pd.ProgressBarValue === pd.ProgressBarMaximum
+                        ? publishBytes(0, 0)
+                        : publishBytes(pd.ProgressBarValue, pd.ProgressBarMaximum ?? 0));
+                }
+                if (isBatch) {
+                    publishBytes(0, 0);
+                    panel.setValue(i + 1);
                 }
-                setWaitPanelValuePrimary(i + 1);
                 result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.SUCCESS });
+                panel.ok();
             }
             catch (ex) {
-                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(ex) });
+                const description = getExceptionMessage(ex);
+                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.ERROR, description });
+                panel.error(1, panelMessage(inputDcmts[i], description));
                 const err = ex;
                 if (err.name === 'CanceledError') {
                     ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
                 }
             }
         }
-        setWaitPanelTextPrimary('');
-        setWaitPanelMaxValuePrimary(0);
-        setWaitPanelValuePrimary(0);
-        setWaitPanelTextSecondary('');
-        setWaitPanelMaxValueSecondary(0);
-        setWaitPanelValueSecondary(0);
+        closeWaitPanel(panel);
         actionAfterOperationAsync?.();
-        setShowWaitPanel(false);
         TMResultManager.show(result, operationTitle, "TID", "DID");
     };
     const getDcmtFileAsync = async (inputDcmt, rfo, operationTitle, keepWaitPanelPrimary, bypassCache = false) => {
@@ -644,29 +592,21 @@ export const useDcmtOperations = () => {
         const cacheKey = `${inputDcmt.TID}-${inputDcmt.DID}`;
         if (!bypassCache && dcmtsFileCachePreview.has(cacheKey))
             return { file: dcmtsFileCachePreview.get(cacheKey), isFromCache: true };
-        setShowWaitPanel(true);
-        setShowPrimary(keepWaitPanelPrimary);
-        setShowSecondary(true);
-        setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
-        let firstBlock = true;
-        let maxFileSize = 0;
+        // Un file solo: l'unico avanzamento e' quello in byte e sta sulla barra principale.
+        const panel = openWaitPanel({
+            title: operationTitle,
+            subtitle: extensionHandler(inputDcmt.FILEEXT ?? '') === FileExtensionHandler.CONVERTIBLE ? 'Conversione file in corso...' : 'Recupero file in corso...',
+            showCounters: false,
+        });
         try {
-            setWaitPanelTextSecondary(extensionHandler(inputDcmt.FILEEXT ?? '') === FileExtensionHandler.CONVERTIBLE ? 'Conversione file in corso...' : 'Recupero file in corso...');
             const file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmt?.TID, inputDcmt?.DID, rfo, abortController.signal, (pd) => {
-                if (firstBlock) {
-                    maxFileSize = pd.ProgressBarMaximum ?? 0;
-                    setWaitPanelMaxValueSecondary(maxFileSize);
-                    firstBlock = false;
-                }
-                setWaitPanelValueSecondary(pd.ProgressBarValue);
-                setWaitPanelTextSecondary(`Downloading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                    setWaitPanelMaxValueSecondary(0);
-                    setWaitPanelValueSecondary(0);
-                    setWaitPanelTextSecondary('');
-                    firstBlock = true;
-                }
+                const max = pd.ProgressBarMaximum ?? 0;
+                panel.update({
+                    value: pd.ProgressBarValue,
+                    max,
+                    subtitle: `Downloading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(max, true)}`,
+                });
             });
             if (dcmtsFileCachePreview.size >= CACHE_SIZE_LIMIT) {
                 const oldestKey = dcmtsFileCachePreview.keys().next().value;
@@ -678,10 +618,7 @@ export const useDcmtOperations = () => {
             return { file: file, isFromCache: false };
         }
         finally {
-            setWaitPanelTextSecondary('');
-            setWaitPanelMaxValueSecondary(0);
-            setWaitPanelValueSecondary(0);
-            setShowWaitPanel(false);
+            closeWaitPanel(panel);
         }
     };
     const getDisplayValueMetadataValueDescriptor = async (mvd) => {
@@ -738,19 +675,27 @@ export const useDcmtOperations = () => {
                 return;
             }
             let zipEntries = [];
-            setShowWaitPanel(true);
-            setShowPrimary(true);
-            setShowSecondary(false);
-            setWaitPanelTitle(operationTitle);
             abortController = new AbortController();
+            // La copia conforme scarica due file per documento: e' l'unica operazione del ciclo
+            // con un avanzamento di dettaglio, e gli serve la seconda barra.
+            const isCopyCompliant = dcmtOperationType === DcmtOperationTypes.CopyCompliant;
+            const panel = openWaitPanel({
+                title: operationTitle,
+                max: inputDcmts.length,
+                showSecondary: isCopyCompliant,
+                primaryLabel: isCopyCompliant ? SDKUI_Localizator.Documents : undefined,
+                secondaryLabel: isCopyCompliant ? 'File corrente' : undefined,
+            });
             let result = [];
-            setWaitPanelMaxValuePrimary(inputDcmts.length);
             for (let i = 0; i < inputDcmts.length; i++) {
+                await panel.waitWhilePaused();
                 if (abortController.signal.aborted) {
-                    result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${i + 1} documenti` });
+                    const description = SDKUI_Localizator.OperationDcmtsInterrupted.replaceParams(i);
+                    result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description });
+                    panel.warning(1, description);
                     break;
                 }
-                setWaitPanelTextPrimary(`Documento ${i + 1} di ${inputDcmts.length}`);
+                panel.setSubtitle(`Documento ${i + 1} di ${inputDcmts.length}`);
                 try {
                     switch (dcmtOperationType) {
                         case DcmtOperationTypes.AddToFavs:
@@ -855,33 +800,36 @@ export const useDcmtOperations = () => {
                             const importWarnings = await importCertificatesAsync(inputDcmts[i], i, fetchRemoteCertificates, abortController.signal);
                             if (importWarnings) {
                                 result.push(...importWarnings);
+                                importWarnings.forEach(w => panel.warning(1, panelMessage(inputDcmts[i], w.description ?? '')));
                             }
                             break;
                         }
                     }
                     result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.SUCCESS });
+                    panel.ok();
                 }
                 catch (ex) {
                     let msg = getExceptionMessage(ex);
                     if (msg.startsWith('WARNING#')) {
-                        result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: msg.replace('WARNING#', '') });
+                        const description = msg.replace('WARNING#', '');
+                        result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description });
+                        panel.warning(1, panelMessage(inputDcmts[i], description));
                     }
-                    else
+                    else {
                         result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.ERROR, description: msg });
+                        panel.error(1, panelMessage(inputDcmts[i], msg));
+                    }
                     const err = ex;
                     if (err.name === 'CanceledError') {
                         ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
                     }
                 }
-                setWaitPanelValuePrimary(i + 1);
+                panel.setValue(i + 1);
             }
             if (zipEntries.length > 0) {
                 await zipDocuments(zipEntries, dcmtOperationType, inputDcmts[0].TID);
             }
-            setWaitPanelMaxValuePrimary(0);
-            setWaitPanelValuePrimary(0);
-            setWaitPanelTextPrimary('');
-            setShowWaitPanel(false);
+            closeWaitPanel(panel);
             actionAfterOperationAsync?.();
             TMResultManager.show(result, operationTitle, "TID", "DID");
         };
@@ -894,7 +842,6 @@ export const useDcmtOperations = () => {
         }
     };
     return {
-        abortController, showWaitPanel, showPrimary, waitPanelTitle, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary,
         downloadDcmtsAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache, runOperationAsync, FileSourceDialog
     };
 };

package/lib/hooks/useDocumentOperations.d.ts

@@ -63,6 +63,7 @@ export interface UIConfigProps {
     toppyHelpCenterUsePortal?: boolean;
     inputDcmtFormLayoutMode?: LayoutModes;
     graphometricManager?: IGraphometricManagerProp;
+    showSelector?: boolean;
 }
 export interface TasksProps {
     allTasks?: Array<TaskDescriptor>;