@topconsultnpm/sdkui-react 6.22.0-dev4.16 → 6.22.0-dev4.18

package/lib/components/features/documents/TMDcmtForm.d.ts

@@ -13,7 +13,12 @@ export declare enum InvocationContext {
     /** Invocato dalla pagina Todo/Task */
     Todo = "todo",
     /** Invocato dalla pagina WorkflowCtrl */
-    WorkflowCtrl = "workflowCtrl"
+    WorkflowCtrl = "workflowCtrl",
+    /**
+     * Invocato dal dettaglio di una pratica: il Toppy non mostra le attività di
+     * pratica, perché la pratica le ha già nella propria barra azioni.
+     */
+    CaseFlow = "caseFlow"
 }
 interface ITMDcmtFormProps {
     TID?: number;

package/lib/components/features/documents/TMDcmtForm.js

@@ -4,7 +4,7 @@ import TMDcmtPreview from './TMDcmtPreview';
 import { AccessLevels, AccessLevelsEx, AppModules, ArchiveConstraints, ArchiveEngineByID, DcmtTypeDescriptor, DcmtTypeListCacheService, DcmtTypePermission, DossierCacheService, LayoutCacheService, LayoutModes, MetadataDataDomains, MetadataDataTypes, MetadataFormats, ObjectClasses, ResultTypes, SDK_Globals, SDK_Localizator, SystemMIDsAsNumber, SystemTIDs, Task_States, TID_DID, UpdateEngineByID, UserListCacheService, ValidationItem, WorkflowCacheService, WorkingGroupCacheService, WorkItemMetadataNames } from '@topconsultnpm/sdk-ts';
 import { FormModes, SearchResultContext } from '../../../ts';
 import { DeviceType, useDeviceType } from '../../base/TMDeviceProvider';
-import { getWorkItemSetIDAsync, handleArchiveVisibility, searchResultToMetadataValues } from '../../../helper/queryHelper';
+import { getDcmtMetadataValuesAsync, getTraceShowFileMids, getWorkItemSetIDAsync, handleArchiveVisibility, searchResultToMetadataValues } from '../../../helper/queryHelper';
 import { genUniqueId, IconShow, SDKUI_Localizator, updateMruTids, IconBoard, IconDcmtTypeSys, calcIsModified, IconMenuVertical, Globalization, getListMaxItems, getSystemMetadata, IconBoxArchiveIn, IconClear, IconUndo, SDKUI_Globals, IconPreview, isTaskMoreInfo, IconWorkflow, IconSearch, deepCompare, IconActivity, getExceptionMessage, isApprovalWorkflowView, getDcmtCicoStatus, buildWorkItemsFromWFCtrl, IconLock, getDcmtFormToolbarVisibility, taskModalSizes, IconArchiveMultipleDetailDocuments, isNotGrantedDraftsDTD } from '../../../helper';
 import { hasDetailRelations, hasMasterRelations } from '../../../helper/dcmtsHelper';
 import { Gutters, TMColors } from '../../../utils/theme';
@@ -56,6 +56,11 @@ export var InvocationContext;
     InvocationContext["Todo"] = "todo";
     /** Invocato dalla pagina WorkflowCtrl */
     InvocationContext["WorkflowCtrl"] = "workflowCtrl";
+    /**
+     * Invocato dal dettaglio di una pratica: il Toppy non mostra le attività di
+     * pratica, perché la pratica le ha già nella propria barra azioni.
+     */
+    InvocationContext["CaseFlow"] = "caseFlow";
     // Aggiungi qui altri contesti futuri secondo necessità
 })(InvocationContext || (InvocationContext = {}));
 let abortControllerLocal = new AbortController();
@@ -385,6 +390,29 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
     const triggerPreviewRefresh = useCallback(async () => {
         setRefreshPreviewTrigger(prev => prev + 1);
     }, []);
+    // Dopo il recupero del file in anteprima aggiorna solo i metadati "Mostra file"
+    const refreshTraceShowFileMetadataAsync = useCallback(async () => {
+        const traceMids = getTraceShowFileMids(fromDTDRef.current);
+        if (!TID || !DID || traceMids.length === 0)
+            return;
+        try {
+            const res = await getDcmtMetadataValuesAsync(TID, DID, traceMids);
+            const row = res?.dtdResult?.rows?.[0];
+            const mids = res?.selectMIDs ?? [];
+            if (!row)
+                return;
+            // Anche l'originale, altrimenti il form risulterebbe modificato
+            const patchTraceValues = (list) => list.map(md => traceMids.includes(md.mid) && mids.includes(md.mid) ? { ...md, value: row[mids.indexOf(md.mid)] } : md);
+            setFormData(patchTraceValues);
+            setFormDataOrig(patchTraceValues);
+            formDataOrigRef.current = patchTraceValues(formDataOrigRef.current);
+            // Aggiorna anche la riga della griglia dei risultati con lo stesso risultato
+            await onSavedAsyncCallback?.(TID, DID, res);
+        }
+        catch (e) {
+            console.error('Errore aggiornamento metadati "Mostra file":', e);
+        }
+    }, [TID, DID, onSavedAsyncCallback]);
     const openTaskFormHandler = (onTaskCreated) => {
         if (!currentDcmt || !fromDTD)
             return;
@@ -814,8 +842,10 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
         return dcmtReferences.some(ref => ref.objClass === ObjectClasses.Dossier || ref.objClass === ObjectClasses.WorkingGroup);
     }, [allowButtonsRefs, layoutMode, dcmtReferences, isOpenDetails, isOpenMaster]);
     // Attività di pratica: stesse condizioni dell'approvazione workflow (documento
-    // in consultazione, senza errori, non dentro master/detail).
-    const showToppyForCaseFlow = useMemo(() => layoutMode === LayoutModes.Update && !fetchError && caseFlowWorkItems.length > 0 && !isOpenDetails && !isOpenMaster, [layoutMode, fetchError, caseFlowWorkItems.length, isOpenDetails, isOpenMaster]);
+    // in consultazione, senza errori, non dentro master/detail). Aperto dal
+    // dettaglio di una pratica, il form non le ripete.
+    const showToppyForCaseFlow = useMemo(() => layoutMode === LayoutModes.Update && !fetchError && caseFlowWorkItems.length > 0 && !isOpenDetails && !isOpenMaster
+        && invocationContext !== InvocationContext.CaseFlow, [layoutMode, fetchError, caseFlowWorkItems.length, isOpenDetails, isOpenMaster, invocationContext]);
     const isToppyVisible = useMemo(() => Boolean((showToppyForApprove || showToppyForCompleteMoreInfo || showToppyForReferences || showToppyForCaseFlow) && !openS4TViewer && !showTodoDcmtForm && !editPdfForm), [showToppyForApprove, showToppyForCompleteMoreInfo, showToppyForReferences, showToppyForCaseFlow, openS4TViewer, showTodoDcmtForm, editPdfForm]);
     const handleClearForm = useCallback(() => {
         let data = structuredClone(formData);
@@ -1262,7 +1292,7 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
     ]);
     const tmBlog = useMemo(() => _jsx(TMDcmtBlog, { tid: TID, did: DID, fetchBlogDataTrigger: refreshBlogTrigger, onRefreshBlogDatagrid: onRefreshBlogDatagrid, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), [TID, DID, allTasks, refreshBlogTrigger, handleNavigateToWGs, handleNavigateToDossiers]);
     const tmSysMetadata = useMemo(() => _jsx(TMMetadataValues, { layoutMode: layoutMode, openChooserBySingleClick: !isOpenDistinctValues, TID: TID, isReadOnly: true, deviceType: deviceType, metadataValues: formData.filter(o => (o.mid != undefined && o.mid <= 100)), metadataValuesOrig: formData.filter(o => (o.mid != undefined && o.mid <= 100)), validationItems: [], inputMids: inputMids }), [TID, layoutMode, formData, deviceType, inputMids]);
-    const tmDcmtPreview = useMemo(() => _jsx(TMDcmtPreviewWrapper, { refreshPreviewTrigger: refreshPreviewTrigger, fromDTD: fromDTD, currentDcmt: currentDcmt, dcmtFile: dcmtFile ?? inputFile, deviceType: deviceType, onBack: getOnBackHandler(), layoutMode: layoutMode, onFileUpload: (file) => { setDcmtFile(file); }, openFileUploaderPdfEditor: openFileUploaderPdfEditor, enableDragDropOverlay: enableDragDropOverlay, onScanRequest: onScanRequest }), [currentDcmt, dcmtFile, deviceType, fromDTD, layoutMode, inputFile, enableDragDropOverlay, setDcmtFile, onScanRequest, openFileUploaderPdfEditor, refreshPreviewTrigger]);
+    const tmDcmtPreview = useMemo(() => _jsx(TMDcmtPreviewWrapper, { refreshPreviewTrigger: refreshPreviewTrigger, fromDTD: fromDTD, currentDcmt: currentDcmt, dcmtFile: dcmtFile ?? inputFile, deviceType: deviceType, onBack: getOnBackHandler(), layoutMode: layoutMode, onFileUpload: (file) => { setDcmtFile(file); }, openFileUploaderPdfEditor: openFileUploaderPdfEditor, enableDragDropOverlay: enableDragDropOverlay, onScanRequest: onScanRequest, onFileRetrieved: refreshTraceShowFileMetadataAsync }), [currentDcmt, dcmtFile, deviceType, fromDTD, layoutMode, inputFile, enableDragDropOverlay, setDcmtFile, onScanRequest, openFileUploaderPdfEditor, refreshPreviewTrigger, refreshTraceShowFileMetadataAsync]);
     const tmWF = useMemo(() => {
         if (isWFDataLoading) {
             return (_jsx("div", { style: {
@@ -1868,11 +1898,11 @@ const PanelDisabledStateHandler = ({ isWFDisabled, isSysMetadataDisabled, isBoar
     }, [isPreviewDisabled]);
     return null;
 };
-const TMDcmtPreviewWrapper = ({ refreshPreviewTrigger, fromDTD, currentDcmt, layoutMode, dcmtFile, deviceType, isVisible, onFileUpload, openFileUploaderPdfEditor, enableDragDropOverlay = false, onScanRequest, onBack }) => {
+const TMDcmtPreviewWrapper = ({ refreshPreviewTrigger, fromDTD, currentDcmt, layoutMode, dcmtFile, deviceType, isVisible, onFileUpload, openFileUploaderPdfEditor, enableDragDropOverlay = false, onScanRequest, onBack, onFileRetrieved }) => {
     const { setPanelVisibilityById, toggleMaximize, isResizingActive, countVisibleLeafPanels, panelVisibility } = useTMPanelManagerContext();
     const isMobile = deviceType === DeviceType.MOBILE;
     return (layoutMode === LayoutModes.Update ?
-        _jsx(TMDcmtPreview, { dcmtData: currentDcmt, isVisible: isVisible, onClosePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => setPanelVisibilityById('tmDcmtPreview', false) : undefined, allowMaximize: !isMobile && countVisibleLeafPanels() > 1, onMaximizePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => toggleMaximize("tmDcmtPreview") : undefined, onBack: onBack, isResizingActive: isResizingActive }, refreshPreviewTrigger) :
+        _jsx(TMDcmtPreview, { dcmtData: currentDcmt, isVisible: isVisible, onClosePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => setPanelVisibilityById('tmDcmtPreview', false) : undefined, allowMaximize: !isMobile && countVisibleLeafPanels() > 1, onMaximizePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => toggleMaximize("tmDcmtPreview") : undefined, onBack: onBack, isResizingActive: isResizingActive, onFileRetrieved: onFileRetrieved }, refreshPreviewTrigger) :
         _jsx(TMFileUploader, { fromDTD: fromDTD, onFileUpload: onFileUpload, openFileUploaderPdfEditor: openFileUploaderPdfEditor, onClose: (!isMobile && countVisibleLeafPanels() > 1) ? () => setPanelVisibilityById('tmDcmtPreview', false) : undefined, isRequired: fromDTD?.archiveConstraint === ArchiveConstraints.ContentCompulsory && dcmtFile === null, defaultBlob: dcmtFile, deviceType: deviceType, isResizingActive: isResizingActive, enableDragDropOverlay: panelVisibility['tmDcmtPreview'] && enableDragDropOverlay, onScanRequest: onScanRequest }));
 };
 const Ribbon = styled.div `

package/lib/components/features/documents/TMDcmtFormActionButtons.js

@@ -8,7 +8,7 @@ import TMButton from "../../base/TMButton";
 import TMModal from "../../base/TMModal";
 import TMTooltip from "../../base/TMTooltip";
 import { WorkFlowOperationButtons } from "../workflow/TMWorkflowPopup";
-import { getWorkItemActionName, isSignatureWorkItem } from "../../../services/caseflow/caseFlowWorkItemUtils";
+import { getWorkItemActionName, isAcknowledgmentWorkItem, isSignatureWorkItem } from "../../../services/caseflow/caseFlowWorkItemUtils";
 const TMDcmtFormActionButtons = (props) => {
     const { showToppyForApprove, workItems, caseFlowWorkItems, onCompleteCaseFlowWorkItem, onRejectCaseFlowWorkItem, deviceType, isMobile, handleSignApprove, updateShowApprovePopup, updateShowRejectPopup, updateShowReAssignPopup, updateShowMoreInfoPopup, fromDTD, showToppyForCompleteMoreInfo, moreInfoTasks, setShowCommentForm, showToppyForReferences, dcmtReferences, referenceActionMap, handleNavigateToReference, setShowMoreInfoTaskPopup, setShowMoreInfoTaskTask } = props;
     const [showAllMoreInfoModal, setShowAllMoreInfoModal] = useState(false);
@@ -103,7 +103,10 @@ const TMDcmtFormActionButtons = (props) => {
                         whiteSpace: 'pre-line',
                     }, children: description })), _jsx(WorkFlowOperationButtons, { dtd: fromDTD, deviceType: deviceType, signFlow: requiresSignature, approveDisable: isBusy, signApproveDisable: isBusy, rejectDisable: isBusy, onSignApprove: handleSignApprove, onApprove: onCompleteCaseFlowWorkItem
                         ? () => void runCaseFlowAction(item, () => onCompleteCaseFlowWorkItem(item))
-                        : undefined, onReject: onRejectCaseFlowWorkItem
+                        : undefined, 
+                    // La presa visione non si rifiuta, come nella pratica: senza
+                    // handler il pulsante non viene mostrato.
+                    onReject: onRejectCaseFlowWorkItem && !isAcknowledgmentWorkItem(workItem)
                         ? () => { setRejectReason(''); setRejectingItem(item); }
                         : undefined })] }, workItem.id));
     };

package/lib/components/features/documents/TMDcmtPreview.d.ts

@@ -12,6 +12,8 @@ interface ITMDcmtPreviewProps {
     onBack?: () => void;
     allowMaximize?: boolean;
     onMaximizePanel?: () => void;
+    /** File scaricato dal server con tracciatura "Mostra file": i metadati trace sono stati aggiornati */
+    onFileRetrieved?: (tid: number | undefined, did: number | undefined) => void;
 }
 declare const TMDcmtPreview: React.FC<ITMDcmtPreviewProps>;
 export default TMDcmtPreview;

package/lib/components/features/documents/TMDcmtPreview.js

@@ -22,7 +22,7 @@ const ErrorContent = ({ error, isAbortError, onRetry }) => {
     }
     return _jsx(TMNothingToShow, { icon: _jsx(IconCloseOutline, { fontSize: 92, color: TMColors.error }), text: error });
 };
-const TMDcmtPreview = ({ dcmtData, isResizingActive, isVisible, canNext, canPrev, onClosePanel, onBack, onNext, onPrev, allowMaximize = true, onMaximizePanel }) => {
+const TMDcmtPreview = ({ dcmtData, isResizingActive, isVisible, canNext, canPrev, onClosePanel, onBack, onNext, onPrev, allowMaximize = true, onMaximizePanel, onFileRetrieved }) => {
     const [dcmtBlob, setDcmtBlob] = useState(undefined);
     const [showPreview, setShowPreview] = useState(false);
     const [isFromCache, setIsFromCache] = useState(false);
@@ -122,20 +122,25 @@ const TMDcmtPreview = ({ dcmtData, isResizingActive, isVisible, canNext, canPrev
             }
         }
     };
-    const loadDocumentWithCache = async () => {
+    /** @param isShown false se a video resta la richiesta di conferma: il file non è visualizzato */
+    const loadDocumentWithCache = async (isShown = true) => {
         const rfo = new RetrieveFileOptions();
-        rfo.retrieveReason = DcmtOpers.ShowFile;
+        // Senza impostazione salvata l'anteprima non aggiorna la tracciatura "Mostra file"
+        rfo.retrieveReason = isShown && SDKUI_Globals.userSettings?.searchSettings?.previewTracksShowFile === true ? DcmtOpers.ShowFile : DcmtOpers.None;
         rfo.generalRetrieveFormat = GeneralRetrieveFormats.OriginalUnsigned;
         rfo.cvtFormat = extensionHandler(dcmtData?.fileExt) === FileExtensionHandler.CONVERTIBLE ? FileFormats.PDF : FileFormats.None;
         rfo.invoiceRetrieveFormat = SDKUI_Globals.userSettings?.searchSettings.invoiceRetrieveFormat;
         rfo.orderRetrieveFormat = SDKUI_Globals.userSettings?.searchSettings.orderRetrieveFormat;
         try {
             await sleep(300); //wait for DX-DataGrid selectionChanged
-            let dcmtFile = await getDcmtFileAsync({ TID: dcmtData?.tid, DID: dcmtData?.did, FILEEXT: dcmtData?.fileExt }, rfo, 'Anteprima', false);
+            let dcmtFile = await getDcmtFileAsync({ TID: dcmtData?.tid, DID: dcmtData?.did, FILEEXT: dcmtData?.fileExt }, rfo, 'Anteprima', false, !isShown);
             setDcmtBlob(dcmtFile?.file);
             setIsFromCache(!!dcmtFile?.isFromCache);
             setError('');
             setIsAbortError(false);
+            // Dalla cache l'API non è stata chiamata: la tracciatura non è cambiata
+            if (dcmtFile?.file && !dcmtFile.isFromCache && rfo.retrieveReason === DcmtOpers.ShowFile)
+                onFileRetrieved?.(dcmtData?.tid, dcmtData?.did);
         }
         catch (ex) {
             const err = ex;
@@ -179,7 +184,7 @@ const TMDcmtPreview = ({ dcmtData, isResizingActive, isVisible, canNext, canPrev
         setIsAbortError(false);
         setDcmtBlob(undefined);
         try {
-            isBasketMode ? await loadBasketFile() : await loadDocumentWithCache();
+            isBasketMode ? await loadBasketFile() : await loadDocumentWithCache(showPreview);
         }
         catch (error) {
             console.error('Error reopening document:', error);

package/lib/components/features/search/TMSearchResult.js

@@ -3,7 +3,7 @@ import React, { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useSta
 import styled from 'styled-components';
 import { LoadIndicator } from 'devextreme-react';
 import { AppModules, DataColumnTypes, DataListViewModes, DcmtTypeListCacheService, LayoutCacheService, LayoutModes, MetadataDataDomains, SDK_Globals, SystemMIDsAsNumber, UserListCacheService, } from '@topconsultnpm/sdk-ts';
-import { customizeSearchByDisplayText, deepCompare, formatDateTimeByMetadataFormat, formatNumberByMetadataFormat, generateUniqueColumnKeys, genUniqueId, getColumnFormatInfo, getDateDisplayText, getNumberDisplayText, getSearchToolbarVisibility, IconAll, IconBoard, IconDcmtTypeSys, IconDelete, IconDuplicate, IconEdit, IconMenuVertical, IconPlatform, IconRefresh, IconSearchCheck, IconShow, isApprovalWorkflowView, isSign4TopEnabled, searchResultDescriptorToSimpleArray, searchResultToMetadataValues, SDKUI_Globals, SDKUI_Localizator, IconCloseOutline, getSearchResultPanelLayout, getSearchResultPanelLayoutSignature, hasSearchResultPanelLayout, saveSearchResultPanelLayout, subscribeSearchResultPanelLayout, VIRTUAL_RENDERING_THRESHOLD, VIRTUAL_RENDERING_CELL_THRESHOLD } from '../../../helper';
+import { customizeSearchByDisplayText, deepCompare, formatDateTimeByMetadataFormat, formatNumberByMetadataFormat, generateUniqueColumnKeys, genUniqueId, getColumnFormatInfo, getDateDisplayText, getNumberDisplayText, getSearchToolbarVisibility, IconAll, IconBoard, IconDcmtTypeSys, IconDelete, IconDuplicate, IconEdit, IconMenuVertical, IconPlatform, IconRefresh, IconSearchCheck, IconShow, isApprovalWorkflowView, isSign4TopEnabled, searchResultDescriptorToSimpleArray, searchResultToMetadataValues, getTraceShowFileMids, getDcmtMetadataValuesAsync, SDKUI_Globals, SDKUI_Localizator, IconCloseOutline, getSearchResultPanelLayout, getSearchResultPanelLayoutSignature, hasSearchResultPanelLayout, saveSearchResultPanelLayout, subscribeSearchResultPanelLayout, VIRTUAL_RENDERING_THRESHOLD, VIRTUAL_RENDERING_CELL_THRESHOLD } from '../../../helper';
 import { CounterItemKey, formatCount } from '../../base/TMCounterContainer';
 import { getDcmtCicoStatus } from '../../../helper/checkinCheckoutManager';
 import { DcmtOperationTypes, SearchResultContext, } from '../../../ts';
@@ -285,6 +285,23 @@ handleNavigateToWGs, handleNavigateToDossiers, fetchRemoteCertificates, graphome
         if (refreshUI)
             setLastUpdateSearchTime(new Date(Date.now()));
     };
+    // Ref alla versione corrente: l'anteprima è memoizzata e la funzione si ricrea a ogni render
+    const refreshFocusedDataRowRef = useRef(refreshFocusedDataRowAsync);
+    refreshFocusedDataRowRef.current = refreshFocusedDataRowAsync;
+    // Anteprima scaricata dal server con tracciatura "Mostra file": aggiorna solo la riga del documento
+    const onPreviewFileRetrieved = useCallback(async (tid, did) => {
+        const traceMids = getTraceShowFileMids(fromDTD);
+        if (!tid || !did || traceMids.length === 0)
+            return;
+        try {
+            const res = await getDcmtMetadataValuesAsync(tid, did, traceMids);
+            if (res)
+                await refreshFocusedDataRowRef.current(tid, did, true, res);
+        }
+        catch (e) {
+            console.error('Errore aggiornamento metadati "Mostra file":', e);
+        }
+    }, [fromDTD]);
     // Refreshes metadata for selected documents (or focused one) and triggers grid re-render
     const onRefreshDataRowsAsync = async () => {
         let dcmts = getSelectedDcmtsOrFocused(selectedItems, focusedItem);
@@ -829,7 +846,7 @@ handleNavigateToWGs, handleNavigateToDossiers, fetchRemoteCertificates, graphome
     const isSearchResultOnScreen = isVisible && !isOpenDcmtForm && !isOpenDetails && !isOpenMaster;
     const tmBlog = useMemo(() => _jsx(TMDcmtBlog, { tid: focusedItem?.TID, did: focusedItem?.DID, isPageVisible: isSearchResultOnScreen, fetchBlogDataTrigger: refreshBlogTrigger, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), [focusedItem, allTasks, refreshBlogTrigger, isSearchResultOnScreen, handleNavigateToWGs, handleNavigateToDossiers, onRefreshBlogDatagrid]);
     const tmSysMetadata = useMemo(() => _jsx(TMMetadataValues, { layoutMode: LayoutModes.Update, openChooserBySingleClick: true, TID: focusedItem?.TID, isReadOnly: true, deviceType: deviceType, metadataValues: currentMetadataValues.filter(o => (o.mid != undefined && o.mid <= 100)), metadataValuesOrig: currentMetadataValues.filter(o => (o.mid != undefined && o.mid <= 100)), validationItems: [] }), [focusedItem, currentMetadataValues, deviceType]);
-    const tmDcmtPreview = useMemo(() => _jsx(TMDcmtPreviewWrapper, { refreshPreviewTrigger: refreshPreviewTrigger, currentDcmt: currentDcmt, isPageVisible: isSearchResultOnScreen, onBack: backHandlerSecondary }), [currentDcmt, refreshPreviewTrigger, isSearchResultOnScreen, backHandlerSecondary]);
+    const tmDcmtPreview = useMemo(() => _jsx(TMDcmtPreviewWrapper, { refreshPreviewTrigger: refreshPreviewTrigger, currentDcmt: currentDcmt, isPageVisible: isSearchResultOnScreen, onBack: backHandlerSecondary, onFileRetrieved: onPreviewFileRetrieved }), [currentDcmt, refreshPreviewTrigger, isSearchResultOnScreen, backHandlerSecondary, onPreviewFileRetrieved]);
     // Auto-fetch indexing info when drawer is open and focusedItem changes
     useEffect(() => {
         if (!focusedItem || !showIndexingInfo)
@@ -1746,11 +1763,11 @@ const PanelDisabledStateHandler = ({ isBoardDisabled, savedBlogVisible = false }
     }, [isBoardDisabled, savedBlogVisible]);
     return null;
 };
-const TMDcmtPreviewWrapper = ({ refreshPreviewTrigger, currentDcmt, isVisible, isPageVisible = true, onBack }) => {
+const TMDcmtPreviewWrapper = ({ refreshPreviewTrigger, currentDcmt, isVisible, isPageVisible = true, onBack, onFileRetrieved }) => {
     const { setPanelVisibilityById, toggleMaximize, isResizingActive, countVisibleLeafPanels } = useTMPanelManagerContext();
     const deviceType = useDeviceType();
     const isMobile = deviceType === DeviceType.MOBILE;
-    return (_jsx(TMDcmtPreview, { dcmtData: currentDcmt, onClosePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => setPanelVisibilityById('tmDcmtPreview', false) : undefined, onBack: onBack, allowMaximize: !isMobile && countVisibleLeafPanels() > 1, onMaximizePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => toggleMaximize("tmDcmtPreview") : undefined, isResizingActive: isResizingActive, isVisible: isVisible && isPageVisible }, refreshPreviewTrigger));
+    return (_jsx(TMDcmtPreview, { dcmtData: currentDcmt, onClosePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => setPanelVisibilityById('tmDcmtPreview', false) : undefined, onBack: onBack, allowMaximize: !isMobile && countVisibleLeafPanels() > 1, onMaximizePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => toggleMaximize("tmDcmtPreview") : undefined, isResizingActive: isResizingActive, isVisible: isVisible && isPageVisible, onFileRetrieved: onFileRetrieved }, refreshPreviewTrigger));
 };
 // Styled Components
 const StyledPlaceholder = styled.div `

package/lib/components/features/workflow/TMWorkflowPopup.js

@@ -66,7 +66,7 @@ export const WorkFlowOperationButtons = (props) => {
         }
         return false;
     }, [dtd, signFlow]);
-    return (_jsx(StyledWorkFlowOperationButtonsContainer, { $isMobile: isMobile, children: isSignWorkflow ? (_jsxs(_Fragment, { children: [_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconSignaturePencil, {}), caption: SDKUI_Localizator.SignatureAndApprove, width: "160px", disabled: signApproveDisable, onClick: () => !signApproveDisable && onSignApprove?.(), onMouseDown: e => e.stopPropagation(), advancedColor: "#1a9a49", color: "success" }), _jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconCloseOutline, {}), caption: SDKUI_Localizator.Reject, disabled: rejectDisable, onClick: () => !rejectDisable && onReject?.(), onMouseDown: e => e.stopPropagation(), advancedColor: TMColors.error, color: "error" }), onMoreInfo && (_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconInfo, { fontSize: 16 }), caption: SDKUI_Localizator.MoreInformation, width: "180px", disabled: infoDisable, onClick: () => !infoDisable && onMoreInfo?.(), onMouseDown: e => e.stopPropagation(), advancedColor: TMColors.info, color: "info" }))] })) : (_jsxs(_Fragment, { children: [_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconApply, {}), caption: SDKUI_Localizator.Approve, disabled: approveDisable, onClick: () => !approveDisable && onApprove?.(), advancedColor: "#1a9a49", color: "success" }), _jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconCloseOutline, {}), caption: SDKUI_Localizator.Reject, disabled: rejectDisable, onClick: () => !rejectDisable && onReject?.(), advancedColor: TMColors.error, color: "error" }), onReAssign && (_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconUser, { fontSize: 16 }), caption: SDKUI_Localizator.Reassign, disabled: reassignDisable, onClick: () => !reassignDisable && onReAssign?.(), advancedColor: TMColors.tertiary, color: "tertiary" })), onMoreInfo && (_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconInfo, { fontSize: 16 }), caption: SDKUI_Localizator.MoreInformation, width: "180px", disabled: infoDisable, onClick: () => !infoDisable && onMoreInfo?.(), advancedColor: TMColors.info, color: "info" }))] })) }));
+    return (_jsx(StyledWorkFlowOperationButtonsContainer, { $isMobile: isMobile, children: isSignWorkflow ? (_jsxs(_Fragment, { children: [_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconSignaturePencil, {}), caption: SDKUI_Localizator.SignatureAndApprove, width: "160px", disabled: signApproveDisable, onClick: () => !signApproveDisable && onSignApprove?.(), onMouseDown: e => e.stopPropagation(), advancedColor: "#1a9a49", color: "success" }), onReject && (_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconCloseOutline, {}), caption: SDKUI_Localizator.Reject, disabled: rejectDisable, onClick: () => !rejectDisable && onReject?.(), onMouseDown: e => e.stopPropagation(), advancedColor: TMColors.error, color: "error" })), onMoreInfo && (_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconInfo, { fontSize: 16 }), caption: SDKUI_Localizator.MoreInformation, width: "180px", disabled: infoDisable, onClick: () => !infoDisable && onMoreInfo?.(), onMouseDown: e => e.stopPropagation(), advancedColor: TMColors.info, color: "info" }))] })) : (_jsxs(_Fragment, { children: [_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconApply, {}), caption: SDKUI_Localizator.Approve, disabled: approveDisable, onClick: () => !approveDisable && onApprove?.(), advancedColor: "#1a9a49", color: "success" }), onReject && (_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconCloseOutline, {}), caption: SDKUI_Localizator.Reject, disabled: rejectDisable, onClick: () => !rejectDisable && onReject?.(), advancedColor: TMColors.error, color: "error" })), onReAssign && (_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconUser, { fontSize: 16 }), caption: SDKUI_Localizator.Reassign, disabled: reassignDisable, onClick: () => !reassignDisable && onReAssign?.(), advancedColor: TMColors.tertiary, color: "tertiary" })), onMoreInfo && (_jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx(IconInfo, { fontSize: 16 }), caption: SDKUI_Localizator.MoreInformation, width: "180px", disabled: infoDisable, onClick: () => !infoDisable && onMoreInfo?.(), advancedColor: TMColors.info, color: "info" }))] })) }));
 };
 export const WorkFlowApproveRejectPopUp = ({ TID = 0, DID = 0, deviceType = DeviceType.DESKTOP, isReject, selectedItems = [], onClose, onCompleted }) => {
     const { refreshWorkflowApprove } = useWorkflowApprove();

package/lib/helper/SDKUI_Globals.d.ts

@@ -92,6 +92,7 @@ export declare class SearchSettings {
     mruTIDs: number[];
     defaultTree: number;
     previewThreshold: number;
+    previewTracksShowFile: boolean;
     pageSize: number;
     maxDcmtsToBeReturned: number;
     floatingMenuBar: FloatingMenuBarSettings;

package/lib/helper/SDKUI_Globals.js

@@ -158,6 +158,7 @@ export class SearchSettings {
         this.mruTIDs = [];
         this.defaultTree = -1;
         this.previewThreshold = DEFAULT_PREVIEW_THRESHOLD;
+        this.previewTracksShowFile = false; // Se attivo, l'anteprima aggiorna la tracciatura "Mostra file" del documento
         this.pageSize = DEFAULT_PAGE_SIZE;
         this.maxDcmtsToBeReturned = DEFAULT_MAX_DCMTS_TO_BE_RETURNED;
         this.floatingMenuBar = new FloatingMenuBarSettings();

package/lib/helper/queryHelper.d.ts

@@ -1,4 +1,4 @@
-import { MetadataDescriptor, MetadataDataDomains, SystemMIDsAsNumber, MetadataDataTypes, QueryDescriptor, SelectItem, DataTableDescriptor, LayoutModes, QueryOperators, SavedQueryDescriptor } from '@topconsultnpm/sdk-ts';
+import { MetadataDescriptor, MetadataDataDomains, SystemMIDsAsNumber, MetadataDataTypes, QueryDescriptor, SelectItem, DataTableDescriptor, LayoutModes, QueryOperators, SavedQueryDescriptor, DcmtTypeDescriptor, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
 import { MetadataValueDescriptorEx } from '../ts';
 export type TID_Alias = {
     tid: number;
@@ -8,7 +8,7 @@ export declare const getTIDsByQd: (qd: QueryDescriptor | undefined) => TID_Alias
 /** Restituisce i tipi documento (con metadati) referenziati da qd.
  *  Con refreshCache = true i descrittori vengono riletti dal server, così la lista dei metadati
  *  recepisce quelli aggiunti o rimossi dopo il popolamento della cache. */
-export declare const getDcmtTypesByQdAsync: (qd: QueryDescriptor, refreshCache?: boolean) => Promise<import("@topconsultnpm/sdk-ts").DcmtTypeDescriptor[]>;
+export declare const getDcmtTypesByQdAsync: (qd: QueryDescriptor, refreshCache?: boolean) => Promise<DcmtTypeDescriptor[]>;
 export declare const displayMetadataValue: (md: MetadataDescriptor | undefined, value: string | undefined, valueEmptyDescription?: string) => string;
 export declare const IsParametricQuery: (qd: QueryDescriptor | undefined) => boolean;
 export declare const addHiddenSelectItem: (select: SelectItem[], tid: number | undefined, mid: SystemMIDsAsNumber) => void;
@@ -20,5 +20,12 @@ export declare const getWorkItemSetIDAsync: (vid: number, did: number) => Promis
 /** Id assegnato alla ricerca di sistema con tutti i documenti: non è in cache, va ricostruita a runtime con getSysAllDcmtsSQD */
 export declare const SYS_ALL_DCMTS_SQD_ID = 1;
 export declare const getSysAllDcmtsSQD: (tid: number | undefined, easyOr: boolean) => Promise<SavedQueryDescriptor>;
+/** MID dei metadati con tracciatura "Mostra file" del tipo documento */
+export declare const getTraceShowFileMids: (dtd: DcmtTypeDescriptor | undefined) => number[];
+/**
+ * Legge solo i metadati indicati del documento con una ricerca mirata.
+ * Se la ricerca fallisce o non li restituisce tutti (es. permessi), ripiega sulla GetMetadata completa.
+ */
+export declare const getDcmtMetadataValuesAsync: (tid: number, did: number, mids: number[]) => Promise<SearchResultDescriptor | undefined>;
 export declare const searchResultToMetadataValues: (tid: number | undefined, dtd: DataTableDescriptor | undefined, rows: string[], mids: number[], metadata: MetadataDescriptor[], layoutMode: LayoutModes, isReadOnlyOrigin?: boolean) => MetadataValueDescriptorEx[];
 export declare const handleArchiveVisibility: (md: MetadataDescriptor) => boolean;

package/lib/helper/queryHelper.js

@@ -1,4 +1,4 @@
-import { AccessLevels, MetadataDataDomains, DcmtTypeListCacheService, SystemMIDsAsNumber, MetadataDataTypes, QueryDescriptor, QueryFunctions, SelectItem, SelectItemVisibilities, FromItem, LayoutModes, QueryOperators, SavedQueryDescriptor, SearchEngine, WhereItem, OrderByItem, SDK_Globals, AppModules, SystemTIDs, WorkItemMetadataNames, PlatformObjectValidator } from '@topconsultnpm/sdk-ts';
+import { AccessLevels, MetadataDataDomains, DcmtTypeListCacheService, SystemMIDsAsNumber, MetadataDataTypes, QueryDescriptor, QueryFunctions, SelectItem, SelectItemVisibilities, FromItem, LayoutModes, QueryOperators, SavedQueryDescriptor, SearchEngine, WhereItem, OrderByItem, SDK_Globals, AppModules, SystemTIDs, WorkItemMetadataNames, PlatformObjectValidator, MetadataSpecials } from '@topconsultnpm/sdk-ts';
 import { DateDisplayTypes, Globalization } from './Globalization';
 import { ChronologyMIDs, DraftsMIDs, MetadataValueDescriptorEx } from '../ts';
 import { SDKUI_Localizator } from './SDKUI_Localizator';
@@ -265,6 +265,44 @@ export const getSysAllDcmtsSQD = async (tid, easyOr) => {
     sqd.qd = await getQD(tid, easyOr, SDKUI_Globals.userSettings.searchSettings?.maxDcmtsToBeReturned ?? 1000);
     return sqd;
 };
+/** MID dei metadati con tracciatura "Mostra file" del tipo documento */
+export const getTraceShowFileMids = (dtd) => dtd?.metadata?.filter(md => md.special === MetadataSpecials.Trace_ShowFile && md.id !== undefined).map(md => md.id) ?? [];
+/**
+ * Legge solo i metadati indicati del documento con una ricerca mirata.
+ * Se la ricerca fallisce o non li restituisce tutti (es. permessi), ripiega sulla GetMetadata completa.
+ */
+export const getDcmtMetadataValuesAsync = async (tid, did, mids) => {
+    const searchEngine = SDK_Globals.tmSession?.NewSearchEngine();
+    try {
+        let qd = SearchEngine.NewQueryDescriptor();
+        if (qd.from) {
+            qd.from.tid = tid;
+            qd.select = mids.map(mid => {
+                let si = new SelectItem();
+                si.tid = tid;
+                si.mid = mid;
+                si.visibility = SelectItemVisibilities.Visible;
+                return si;
+            });
+            let wiDID = new WhereItem();
+            wiDID.tid = tid;
+            wiDID.mid = SystemMIDsAsNumber.DID;
+            wiDID.operator = QueryOperators.Equal;
+            wiDID.value1 = did.toString();
+            wiDID.or = false;
+            wiDID.leftBrackets = '(';
+            wiDID.rightBrackets = ')';
+            qd.where = [wiDID];
+            const result = await searchEngine?.SearchByIDAsync(qd);
+            if (result?.dtdResult?.rows?.[0] && mids.every(mid => result.selectMIDs?.includes(mid)))
+                return result;
+        }
+    }
+    catch (e) {
+        console.warn('Ricerca mirata dei metadati non riuscita, uso GetMetadata:', e);
+    }
+    return await searchEngine?.GetMetadataAsync(tid, did, true);
+};
 export const searchResultToMetadataValues = (tid, dtd, rows, mids, metadata, layoutMode, isReadOnlyOrigin = false) => {
     if (!metadata || metadata.length === 0) {
         return [];

package/lib/hooks/useCaseFlowApprove.js

@@ -1,7 +1,8 @@
 import { useCallback, useEffect, useState } from 'react';
-import { SDK_Globals } from '@topconsultnpm/sdk-ts';
+import { CF_WorkItemCategories, SDK_Globals } from '@topconsultnpm/sdk-ts';
 import { CaseFlowService } from '../services/caseflow/CaseFlowService';
-import { getWorkItemTargetDoc, isMoreInfoWorkItem, isSignatureWorkItem } from '../services/caseflow/caseFlowWorkItemUtils';
+import { getWorkItemTargetDoc, isSignatureWorkItem } from '../services/caseflow/caseFlowWorkItemUtils';
+import { isFinalActionSync } from '../services/caseflow/caseFlowNameCache';
 const CASEFLOW_APPROVE_CHANGED_EVENT = 'onCaseFlowApproveChange';
 let cache = [];
 let inFlight;
@@ -16,10 +17,27 @@ const notifyChanged = () => {
         return;
     window.dispatchEvent(new CustomEvent(CASEFLOW_APPROVE_CHANGED_EVENT));
 };
+/**
+ * Categorie che si completano DAL DOCUMENTO: firmarlo, approvarlo, prenderne
+ * visione. Le altre si completano nella pratica, perché il Toppy del form offre
+ * solo Approva/Rifiuta e non saprebbe fare il resto:
+ * - Caricamento manuale (Upload): il commento è obbligatorio (TMC-2822);
+ * - Generica / caricamento automatico: si chiude da sola quando il documento
+ *   viene agganciato;
+ * - Completamento dati: vanno inseriti i valori dei metadati;
+ * - Verifica bloccante: sblocca o interrompe la pratica;
+ * - Richiesta informazioni: ha una risposta, non un esito.
+ */
+const DOCUMENT_CATEGORIES = new Set([
+    CF_WorkItemCategories.Approval,
+    CF_WorkItemCategories.Signature,
+    CF_WorkItemCategories.Acknowledgment,
+]);
 /**
  * Ricarica la cache: i workitem pendenti dell'utente, risolti sul documento su
- * cui lavorano. Le richieste di informazioni sono escluse (si rispondono nella
- * pratica, non sul documento) come i workitem senza documento.
+ * cui lavorano. Restano fuori le categorie che non si completano dal documento
+ * (vedi DOCUMENT_CATEGORIES), le azioni che chiudono la pratica e i workitem
+ * senza documento.
  */
 const reload = async () => {
     const userId = SDK_Globals.tmSession?.SessionDescr?.userID;
@@ -30,8 +48,7 @@ const reload = async () => {
     const groups = await CaseFlowService.getMyPendingWorkItems(userId);
     const resolved = [];
     for (const { caseflow, workItems } of groups) {
-        // Le richieste di informazioni si rispondono nella pratica, non sul documento.
-        const relevant = workItems.filter(wi => !isMoreInfoWorkItem(wi));
+        const relevant = workItems.filter(wi => DOCUMENT_CATEGORIES.has(wi.workItemCategory));
         if (relevant.length === 0)
             continue;
         // Il TID dell'azione è autorato sul TEMPLATE e non materializzato
@@ -47,6 +64,14 @@ const reload = async () => {
             instance = (await CaseFlowService.getCaseflow(instance.id, instance.cftid)) ?? instance;
         }
         for (const wi of relevant) {
+            // Un'azione che chiude la pratica richiede il motivo, che il Toppy del
+            // documento non chiede: si completa nella pratica. Il template è già
+            // risolto qui sopra, quindi `isFinal` è noto.
+            // La Firma resta: firmare si può solo da qui (l'ospite non ha altra
+            // strada). Fallirà il solo completamento automatico, che l'utente fa
+            // poi nella pratica scrivendo il motivo, con la firma già apposta.
+            if (!isSignatureWorkItem(wi) && isFinalActionSync(caseflow.cftid, wi.actionID))
+                continue;
             const target = getWorkItemTargetDoc(instance, wi);
             if (!target)
                 continue;

package/lib/services/caseflow/caseFlowNameCache.d.ts

@@ -30,3 +30,8 @@ export declare function primeActionNames(template?: CaseFlowTemplateDescriptor |
  * l'azione non lavora su un documento (o il template non è ancora risolto).
  */
 export declare function getActionTidSync(cftid?: number, actionID?: number): number | undefined;
+/**
+ * true se l'azione del template chiude la pratica (`isFinal`). Con il template
+ * non ancora risolto ritorna false.
+ */
+export declare function isFinalActionSync(cftid?: number, actionID?: number): boolean;

package/lib/services/caseflow/caseFlowNameCache.js

@@ -95,6 +95,11 @@ export function primeActionNames(template) {
         actionNameCache.set(actionKey(cftid, a.id), a.name ?? '');
         if (a.actionTID != null && a.actionTID > 0)
             actionTidCache.set(actionKey(cftid, a.id), a.actionTID);
+        // Il template può essere stato modificato: la chiave va anche tolta.
+        if (a.isFinal)
+            finalActionKeys.add(actionKey(cftid, a.id));
+        else
+            finalActionKeys.delete(actionKey(cftid, a.id));
     }
 }
 // ---- TID documento per azione (per template) --------------------------------
@@ -114,3 +119,17 @@ export function getActionTidSync(cftid, actionID) {
         return undefined;
     return actionTidCache.get(actionKey(cftid, actionID));
 }
+// ---- Azioni che chiudono la pratica (per template) ---------------------------
+//
+// Anche `isFinal` vive solo SUL TEMPLATE: sull'azione d'istanza arriva sempre
+// false. Popolata da {@link primeActionNames} come le cache qui sopra.
+const finalActionKeys = new Set();
+/**
+ * true se l'azione del template chiude la pratica (`isFinal`). Con il template
+ * non ancora risolto ritorna false.
+ */
+export function isFinalActionSync(cftid, actionID) {
+    if (cftid == null || actionID == null)
+        return false;
+    return finalActionKeys.has(actionKey(cftid, actionID));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@topconsultnpm/sdkui-react",
-    "version": "6.22.0-dev4.16",
+    "version": "6.22.0-dev4.18",
     "description": "",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1",