@topconsultnpm/sdkui-react 6.22.0-dev2.9 → 6.22.0-t2

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

@@ -1,11 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import TMDcmtPreview from './TMDcmtPreview';
-import { AccessLevelsEx, AppModules, ArchiveConstraints, ArchiveEngineByID, DcmtTypeListCacheService, 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 { 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 { 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 } from '../../../helper';
+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';
 import { StyledFormButtonsContainer, StyledLoadingContainer, StyledSpinner, StyledToolbarCardContainer } from '../../base/Styled';
@@ -26,6 +26,7 @@ import { useTMPanelManagerContext } from '../../layout/panelManager/TMPanelManag
 import TMPanelManagerContainer from '../../layout/panelManager/TMPanelManagerContainer';
 import { TMPanelManagerWithPersistenceProvider } from '../../layout/panelManager/TMPanelManagerWithPersistenceProvider';
 import { useWorkflowApprove } from '../../../hooks/useWorkflowApprove';
+import { useCaseFlowApprove } from '../../../hooks/useCaseFlowApprove';
 import TMBlogCommentForm from '../blog/TMBlogCommentForm';
 import WFDiagram from '../workflow/diagram/WFDiagram';
 import TMTooltip from '../../base/TMTooltip';
@@ -39,6 +40,8 @@ import TMToppyDraggableHelpCenter from '../assistant/TMToppyDraggableHelpCenter'
 import TMTaskForm from '../tasks/TMTaskForm';
 import { useDocumentOperations } from '../../../hooks/useDocumentOperations';
 import TMDcmtFormActionButtons from './TMDcmtFormActionButtons';
+import { useArchiveListForm } from '../../../hooks/useArchiveListForm';
+import TMMultiMasterDetailDcmtsForm from './TMMultiMasterDetailDcmtsForm';
 //#region Interfaces, Types and Enums
 /**
  * Definisce il contesto da cui è stato invocato il TMDcmtForm.
@@ -57,7 +60,7 @@ export var InvocationContext;
 let abortControllerLocal = new AbortController();
 ;
 //#endregion
-const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMode = FormModes.Update, invocationContext = InvocationContext.Default, showHeader = true, showBackButton = true, showDcmtFormSidebar = true, isClosable = false, showTodoDcmtForm = false, isExpertMode = SDKUI_Globals.userSettings.advancedSettings.expertMode === 1, isModal = false, titleModal, widthModal = "100%", heightModal = "100%", allowNavigation = true, canNext, canPrev, count, itemIndex, onNext, onPrev, inputFile = null, inputMids = [], connectorFileSave = undefined, isSharedDcmt = false, sharedSourceTID, sharedSourceDID, allowRelations = true, allowButtonsRefs = false, openS4TViewer = false, enableDragDropOverlay = false, editPdfForm = false, onClose, onSavedAsyncCallback, onSaveRecents, onWFOperationCompleted, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, onTaskCompleted, onTaskCreateRequest, moreInfoTasks, taskFormDialogComponent, handleNavigateToWGs, handleNavigateToDossiers, onReferenceClick, onOpenS4TViewerRequest, onOpenPdfEditorRequest, openFileUploaderPdfEditor, s4TViewerDialogComponent, onScanRequest, passToSearch, fetchRemoteCertificates, datagridUtility, graphometricManager }) => {
+const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMode = FormModes.Update, invocationContext = InvocationContext.Default, showHeader = true, showBackButton = true, showDcmtFormSidebar = true, isClosable = false, showTodoDcmtForm = false, isExpertMode = SDKUI_Globals.userSettings.advancedSettings.expertMode === 1, isModal = false, titleModal, widthModal = "100%", heightModal = "100%", allowNavigation = true, canNext, canPrev, count, itemIndex, onNext, onPrev, inputFile = null, inputMids = [], connectorFileSave = undefined, isSharedDcmt = false, sharedSourceTID, sharedSourceDID, allowRelations = true, allowButtonsRefs = false, openS4TViewer = false, enableDragDropOverlay = false, editPdfForm = false, onClose, onSavedAsyncCallback, onSaveRecents, onWFOperationCompleted, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, onTaskCompleted, onTaskCreateRequest, moreInfoTasks, taskFormDialogComponent, handleNavigateToWGs, handleNavigateToDossiers, onReferenceClick, onOpenS4TViewerRequest, onOpenPdfEditorRequest, openFileUploaderPdfEditor, s4TViewerDialogComponent, onScanRequest, passToSearch, archiveListMode, fetchRemoteCertificates, datagridUtility, graphometricManager }) => {
     const { onRefreshSearchAsyncDatagrid, onRefreshBlogDatagrid, onRefreshPreviewDatagrid } = datagridUtility || {};
     const floatingBarContainerRef = useRef(null);
     const [id, setID] = useState('');
@@ -96,6 +99,10 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
     const [isOpenFormulaEditor, setIsOpenFormulaEditor] = useState(false);
     const [currentTIDHasDetailRelations, setCurrentTIDHasDetailRelations] = useState();
     const [currentTIDHasMasterRelations, setCurrentTIDHasMasterRelations] = useState();
+    // Modale "Archivia documenti di dettaglio multipli" aperto dall'azione secondaria del form di archiviazione:
+    // dopo aver archiviato il master si apre il modale con il master appena archiviato come documento di partenza.
+    const [showMultiDetailArchiveModal, setShowMultiDetailArchiveModal] = useState(false);
+    const [multiDetailMasterDcmts, setMultiDetailMasterDcmts] = useState([]);
     const [currentDcmt, setCurrentDcmt] = useState();
     const [dcmtFile, setDcmtFile] = useState(null);
     const [focusedMetadataValue, setFocusedMetadataValue] = useState();
@@ -116,6 +123,10 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
     const [wfError, setWfError] = useState(null);
     const [metadataDcmtOrigin, setMetadataDcmtOrigin] = useState(null);
     const { workflowApproveData, getWorkItemsByDID } = useWorkflowApprove();
+    // Attività delle PRATICHE (CaseFlow) su questo documento. Come per il workflow
+    // la scoperta avviene QUI: da qualunque punto si apra il form, l'utente trova
+    // le sue azioni nel Toppy.
+    const { caseFlowWorkItems, completeCaseFlowWorkItem, rejectCaseFlowWorkItem } = useCaseFlowApprove(TID, DID);
     // Get the current device type (e.g., mobile, tablet, desktop) using a custom hook.
     const deviceType = useDeviceType();
     // This avoids unnecessary re-renders by only recalculating when deviceType changes.
@@ -325,6 +336,14 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
             }
             // Carica DTD e metadata
             let dtd = await DcmtTypeListCacheService.GetWithNotGrantedAsync(TID, DID, getMetadataResult);
+            // Le bozze dei gruppi di lavoro vivono su un tipo documento non autorizzato e quindi privo di
+            // permessi: si concede la sola lettura del file, altrimenti non sarebbe scaricabile dal form.
+            if (isNotGrantedDraftsDTD(dtd)) {
+                const perm = new DcmtTypePermission();
+                perm.canRetrieveFile = AccessLevels.Yes;
+                // Su una copia: GetWithNotGrantedAsync restituisce l'istanza in cache, condivisa con gli altri consumer
+                dtd = Object.assign(new DcmtTypeDescriptor(), dtd, { perm });
+            }
             setFromDTD(dtd);
             if (layoutMode === LayoutModes.Update || (layoutMode === LayoutModes.Ark && DID)) {
                 await setMetadataList(dtd?.metadata ?? [], getMetadataResult);
@@ -450,7 +469,7 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
             openTaskFormHandler,
         },
     });
-    const { handleSignApprove, checkoutInfo: { showCicoWaitPanel, cicoWaitPanelTitle, showCicoPrimaryProgress, cicoPrimaryProgressText, cicoPrimaryProgressValue, cicoPrimaryProgressMax, }, dcmtOperations: { abortController, showWaitPanel, showPrimary, waitPanelTitle, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, }, relatedDocumentsInfo: { isOpenDetails, isOpenMaster, checkRelatedDcmtsArchiveCapability, checkManyToManyCapability, }, toppyOperations: { updateShowApprovePopup, updateShowRejectPopup, updateShowReAssignPopup, updateShowMoreInfoPopup } } = features;
+    const { handleSignApprove, checkoutInfo: { showCicoWaitPanel, cicoWaitPanelTitle, showCicoPrimaryProgress, cicoPrimaryProgressText, cicoPrimaryProgressValue, cicoPrimaryProgressMax, }, dcmtOperations: { abortController, showWaitPanel, showPrimary, waitPanelTitle, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, }, relatedDocumentsInfo: { isOpenDetails, isOpenMaster, canArchiveDetailRelation, checkRelatedDcmtsArchiveCapability, checkManyToManyCapability, }, toppyOperations: { updateShowApprovePopup, updateShowRejectPopup, updateShowReAssignPopup, updateShowMoreInfoPopup } } = features;
     useEffect(() => {
         const fetchAllUsers = async () => {
             const users = await UserListCacheService.GetAllAsync();
@@ -804,11 +823,91 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
         // Verifica che ci siano riferimenti renderizzabili (solo Dossier o WorkingGroup)
         return dcmtReferences.some(ref => ref.objClass === ObjectClasses.Dossier || ref.objClass === ObjectClasses.WorkingGroup);
     }, [allowButtonsRefs, layoutMode, dcmtReferences, isOpenDetails, isOpenMaster]);
-    const isToppyVisible = useMemo(() => Boolean((showToppyForApprove || showToppyForCompleteMoreInfo || showToppyForReferences) && !openS4TViewer && !showTodoDcmtForm && !editPdfForm), [showToppyForApprove, showToppyForCompleteMoreInfo, showToppyForReferences, openS4TViewer, showTodoDcmtForm, editPdfForm]);
-    const isModified = useMemo(() => calcIsModified(formData, formDataOrig), [formData, formDataOrig]);
+    // 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]);
+    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);
+        if (!data || data.length === 0)
+            return;
+        for (let md of data) {
+            if (!md.mid)
+                continue;
+            if (md.mid > 99) {
+                const defaultValue = md.md?.defaultValue;
+                if (defaultValue) {
+                    if (FormulaHelper.isFormula(defaultValue)) {
+                        md.value = undefined;
+                    }
+                    else {
+                        md.value = defaultValue;
+                    }
+                }
+                else if (formDataOrig.find(metadata => metadata.mid === md.mid)?.value === undefined) {
+                    if (md.value)
+                        md.value = undefined;
+                }
+                else if (md.value && md.value.length > 0) {
+                    md.value = '';
+                }
+            }
+        }
+        setFormData(data);
+    }, [formData, formDataOrig]);
+    // Modalità "aggiungi a elenco" (archiviazione dettagli multipli): tutta la logica specifica è nell'hook.
+    const archiveList = useArchiveListForm({
+        mode: archiveListMode,
+        editingRowValues: inputMids,
+        formDataOrig,
+        formDataRef,
+        dcmtFileRef,
+        tid: TID,
+        isModal,
+        id,
+        clearForm: handleClearForm,
+    });
+    const isModified = useMemo(() => calcIsModified(formData, archiveList.referenceValues), [formData, archiveList.referenceValues]);
     const formToolbar = useMemo(() => _jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: '10px' }, children: [allowNavigation && canPrev != undefined && _jsx("p", { style: { textAlign: 'center', padding: '1px 4px', display: 'flex' }, children: `${itemIndex}/${count}` }), allowNavigation && canPrev != undefined && _jsx(TMSaveFormButtonPrevious, { btnStyle: 'icon', iconColor: 'white', isModified: isModified, formMode: formMode, canPrev: canPrev, onPrev: onPrev }), allowNavigation && canNext != undefined && _jsx(TMSaveFormButtonNext, { btnStyle: 'icon', iconColor: 'white', isModified: isModified, formMode: formMode, canNext: canNext, onNext: onNext }), layoutMode === LayoutModes.Update &&
-                _jsx(ContextMenu, { items: operationItems, trigger: "left", children: _jsx(IconMenuVertical, { color: 'white', cursor: 'pointer' }) }), layoutMode === LayoutModes.Ark &&
-                _jsx(TMTooltip, { content: SDKUI_Localizator.PassToSearch, position: 'bottom', children: _jsx(IconSearch, { style: { cursor: 'pointer' }, onClick: handlePassToSearch }) })] }), [allowNavigation, canPrev, canNext, itemIndex, count, isModified, formMode, onPrev, onNext, layoutMode, operationItems, handlePassToSearch]);
+                _jsx(ContextMenu, { items: operationItems, trigger: "left", children: _jsx(IconMenuVertical, { color: 'white', cursor: 'pointer' }) }), layoutMode === LayoutModes.Ark && !archiveList.enabled &&
+                _jsx(TMTooltip, { content: SDKUI_Localizator.PassToSearch, position: 'bottom', children: _jsx(IconSearch, { style: { cursor: 'pointer' }, onClick: handlePassToSearch }) })] }), [allowNavigation, canPrev, canNext, itemIndex, count, isModified, formMode, onPrev, onNext, layoutMode, operationItems, handlePassToSearch, archiveList.enabled]);
+    // Ricarica del pannello metadati: invalida le cache del tipo documento e del layout, così la
+    // definizione dei metadati e la disposizione del form vengono rilette dal server, poi ricostruisce il form
+    const reloadFormMetadataAsync = useCallback(async () => {
+        if (!TID)
+            return;
+        // refreshCache invalida la voce in cache e rilegge il tipo documento con i metadati:
+        // la GetWithNotGrantedAsync della load successiva trova quella appena aggiornata
+        await DcmtTypeListCacheService.GetAsync(TID, true, undefined, false, true);
+        LayoutCacheService.Remove(TID, layoutMode);
+        if (layoutMode === LayoutModes.Update)
+            LayoutCacheService.Remove(TID, LayoutModes.None);
+        await loadDocumentFormDataAsync();
+    }, [TID, layoutMode, loadDocumentFormDataAsync]);
+    // Il ricaricamento ricostruisce il form: con valori inseriti e non salvati chiede prima conferma.
+    // In archiviazione la ricostruzione sgancia anche il file, quindi va confermata pure in quel caso.
+    const handleRefreshFormMetadataAsync = useCallback(async () => {
+        const hasPendingChanges = isModified || (layoutMode === LayoutModes.Ark && !!dcmtFile);
+        if (!hasPendingChanges) {
+            await reloadFormMetadataAsync();
+            return;
+        }
+        const isConfirmed = await new Promise(resolve => {
+            let isAnswered = false;
+            TMMessageBoxManager.show({
+                parentId: isModal ? "TMDcmtFormShowConfirmForClose-" + id : undefined,
+                title: SDKUI_Localizator.Refresh,
+                message: SDKUI_Localizator.ConfirmOnCancel,
+                buttons: [ButtonNames.YES, ButtonNames.NO],
+                onButtonClick: (e) => { isAnswered = true; resolve(e === ButtonNames.YES); },
+                // Chiusura dalla X: senza questa la Promise non si risolverebbe e il loader resterebbe acceso
+                onClose: () => { if (!isAnswered)
+                    resolve(false); }
+            });
+        });
+        if (isConfirmed)
+            await reloadFormMetadataAsync();
+    }, [isModified, layoutMode, dcmtFile, isModal, id, reloadFormMetadataAsync]);
     const handleUndo = useCallback(() => {
         setFormData(structuredClone(formDataOrig));
     }, [formDataOrig]);
@@ -964,55 +1063,63 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
             const isDuplication = layoutMode === LayoutModes.Ark && DID;
             if (isDuplication)
                 onClose?.();
+            // Ritorna il DID del documento appena archiviato, così il chiamante può proseguire
+            // (es. aprire il modale di archiviazione dei documenti di dettaglio sul master appena creato).
+            return newDID;
         }
         catch (err) {
             TMExceptionBoxManager.show({ exception: err });
+            return undefined;
         }
         finally {
             setShowWaitPanelLocal(false);
             setUseWaitPanelLocalState(false);
         }
     }, [TID, connectorFileSave, onSavedAsyncCallback, onSaveRecents, onClose, DID, setMetadataList, handleReset, layoutMode, isSharedDcmt]);
+    // Messaggio di conferma dell'archiviazione in base al vincolo del tipo documento (ArchiveConstraints).
+    const getArchiveConfirmMessage = useCallback(() => {
+        // Con connectorFileSave il file viene prodotto dal connettore solo alla conferma: si assume che ci sarà.
+        const hasFile = !!connectorFileSave || !!dcmtFileRef.current;
+        switch (fromDTDRef.current?.archiveConstraint) {
+            // Solo metadati: il file non è previsto.
+            case ArchiveConstraints.OnlyMetadata: return SDKUI_Localizator.ArchiveDocument_Confirm;
+            // File obbligatorio: senza file il pulsante Archivia è disabilitato, quindi qui il file c'è.
+            case ArchiveConstraints.ContentCompulsory: return SDKUI_Localizator.ArchiveDocument_Confirm;
+            // Metadati e/o file: se il file manca lo segnala, come in v5.
+            default: return hasFile ? SDKUI_Localizator.ArchiveDocument_Confirm : SDKUI_Localizator.ArchiveOnlyMetadata_Confirm;
+        }
+    }, [connectorFileSave]);
     const handleConfirmAction = useCallback(async () => {
+        const isUpdate = layoutMode === LayoutModes.Update;
         TMMessageBoxManager.show({
             parentId: isModal ? "TMDcmtFormShowConfirmForClose-" + id : undefined,
             buttons: [ButtonNames.YES, ButtonNames.NO],
-            message: layoutMode === LayoutModes.Update ? SDKUI_Localizator.SaveQuestion : 'Sei sicuro di voler archiviare questo documento?',
-            onButtonClick(e) {
+            message: isUpdate ? SDKUI_Localizator.SaveQuestion : getArchiveConfirmMessage(),
+            onButtonClick: (e) => {
                 if (e !== ButtonNames.YES)
                     return;
-                layoutMode === LayoutModes.Update ? handleSave() : handleArchiveCompleted();
+                isUpdate ? handleSave() : handleArchiveCompleted();
             },
         });
-    }, [isModal, id, layoutMode, handleSave, handleArchiveCompleted]);
-    const handleClearForm = useCallback(() => {
-        let data = structuredClone(formData);
-        if (!data || data.length === 0)
-            return;
-        for (let md of data) {
-            if (!md.mid)
-                continue;
-            if (md.mid > 99) {
-                const defaultValue = md.md?.defaultValue;
-                if (defaultValue) {
-                    if (FormulaHelper.isFormula(defaultValue)) {
-                        md.value = undefined;
-                    }
-                    else {
-                        md.value = defaultValue;
-                    }
-                }
-                else if (formDataOrig.find(metadata => metadata.mid === md.mid)?.value === undefined) {
-                    if (md.value)
-                        md.value = undefined;
-                }
-                else if (md.value && md.value.length > 0) {
-                    md.value = '';
-                }
-            }
-        }
-        setFormData(data);
-    }, [formData, formDataOrig]);
+    }, [isModal, id, layoutMode, getArchiveConfirmMessage, handleSave, handleArchiveCompleted]);
+    // Azione secondaria del form di archiviazione: archivia il master e, subito dopo,
+    // apre il modale di archiviazione dei documenti di dettaglio multipli usando il master appena creato.
+    const handleArchiveMasterAndDetails = useCallback(async () => {
+        TMMessageBoxManager.show({
+            parentId: isModal ? "TMDcmtFormShowConfirmForClose-" + id : undefined,
+            buttons: [ButtonNames.YES, ButtonNames.NO],
+            message: SDKUI_Localizator.ArchiveMasterAndDetails_Confirm,
+            onButtonClick: async (e) => {
+                if (e !== ButtonNames.YES)
+                    return;
+                const newDID = await handleArchiveCompleted();
+                if (newDID === undefined || newDID === null)
+                    return;
+                setMultiDetailMasterDcmts([{ TID: TID, DID: newDID }]);
+                setShowMultiDetailArchiveModal(true);
+            },
+        });
+    }, [isModal, id, handleArchiveCompleted, TID]);
     const clearFormBtnDisabled = useMemo(() => formData.filter(md => md.mid && md.value && md.mid > 99 && md.value.length > 0).length > 0, [formData]);
     const archiveBtnDisabled = useMemo(() => layoutMode === LayoutModes.Update || (fromDTD?.archiveConstraint === ArchiveConstraints.ContentCompulsory && !dcmtFile) || validationItems.length > 0, [layoutMode, fromDTD?.archiveConstraint, dcmtFile, validationItems.length]);
     const undoBtnDisabled = useMemo(() => layoutMode === LayoutModes.Update || !isModified, [layoutMode, isModified]);
@@ -1021,10 +1128,14 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
     const metadataValuesSource = useMemo(() => {
         return applyMetadataFilter(formData, showAll, listMaxItems, TID);
     }, [showAll, formData, listMaxItems, TID]);
-    const metadataValuesSourceOrig = useMemo(() => {
-        return applyMetadataFilter(formDataOrig, showAll, listMaxItems, TID);
-    }, [showAll, formDataOrig, listMaxItems, TID]);
+    const metadataValuesSourceOrig = useMemo(() => 
+    // I valori di riferimento (in modifica riga includono i valori già caricati) li calcola l'hook:
+    // così i campi pre-compilati non si colorano di giallo finché l'utente non li cambia davvero.
+    applyMetadataFilter(archiveList.referenceValues, showAll, listMaxItems, TID), [showAll, archiveList.referenceValues, listMaxItems, TID]);
     const handleClose = useCallback(() => {
+        // Modalità "aggiungi a elenco": la X non archivia ma aggiorna l'elenco (gestita dall'hook).
+        if (archiveList.requestClose(isModified, onClose))
+            return;
         if (!isModified) {
             onClose?.();
             return;
@@ -1045,7 +1156,7 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
                 }
             }
         });
-    }, [isModified, onClose, isModal, id, handleSave]);
+    }, [isModified, onClose, isModal, id, handleSave, archiveList]);
     const getFormula = useCallback(() => {
         let fd = new FormulaDescriptor();
         fd.expression = FormulaHelper.isFormula(focusedMetadataValue?.value) ? FormulaHelper.removeFormulaTag(focusedMetadataValue?.value) : undefined;
@@ -1118,7 +1229,14 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
                                             break;
                                     }
                                 } }), _jsxs(StyledFormButtonsContainer, { children: [_jsx("div", { style: { display: 'flex', flexDirection: 'column', gap: 10 }, children: _jsx("div", { style: { display: 'flex', justifyContent: 'center', alignItems: 'center', gap: '8px' }, children: layoutMode === LayoutModes.Update ? _jsxs(_Fragment, { children: [_jsx(TMSaveFormButtonSave, { showTooltip: false, btnStyle: 'advanced', advancedColor: '#f09c0a', isModified: isModified, formMode: formMode, errorsCount: validationItems.filter(o => o.ResultType == ResultTypes.ERROR).length, onSaveAsync: handleConfirmAction }), _jsx(TMSaveFormButtonUndo, { btnStyle: 'toolbar', showTooltip: true, color: 'primary', isModified: isModified, formMode: formMode, onUndo: handleUndo })] }) :
-                                                _jsxs(_Fragment, { children: [_jsx(TMButton, { disabled: archiveBtnDisabled, btnStyle: 'advanced', icon: _jsx(IconBoxArchiveIn, {}), width: 'auto', showTooltip: false, caption: SDKUI_Localizator.Archive, advancedColor: TMColors.success, onClick: handleConfirmAction }), _jsx(TMButton, { disabled: !clearFormBtnDisabled, btnStyle: 'advanced', icon: _jsx(IconClear, {}), width: 'auto', showTooltip: false, caption: SDKUI_Localizator.Clear, advancedColor: TMColors.tertiary, onClick: handleClearForm }), DID && _jsx(TMButton, { disabled: undoBtnDisabled, btnStyle: 'advanced', icon: _jsx(IconUndo, {}), width: '150px', showTooltip: false, caption: SDKUI_Localizator.Undo, advancedColor: TMColors.tertiary, onClick: handleUndo })] }) }) }), customButton && _jsx(TMCustomButton, { button: customButton, formData: formData, selectedItems: [], onClose: () => setCustomButton(undefined) }), totalItems > listMaxItems &&
+                                                archiveList.enabled ?
+                                                    _jsxs(_Fragment, { children: [_jsx(TMButton, { disabled: archiveBtnDisabled, btnStyle: 'advanced', icon: _jsx(IconBoxArchiveIn, {}), width: 'auto', showTooltip: false, caption: archiveList.isEditingRow ? SDKUI_Localizator.Update : SDKUI_Localizator.Add, advancedColor: TMColors.success, onClick: archiveList.submit }), _jsx(TMButton, { disabled: !clearFormBtnDisabled, btnStyle: 'advanced', icon: _jsx(IconClear, {}), width: 'auto', showTooltip: false, caption: SDKUI_Localizator.Clear, advancedColor: TMColors.tertiary, onClick: handleClearForm })] }) :
+                                                    _jsxs(_Fragment, { children: [_jsx(TMButton, { disabled: archiveBtnDisabled, btnStyle: 'advanced', icon: _jsx(IconBoxArchiveIn, {}), width: canArchiveDetailRelation ? '120px' : 'auto', showTooltip: false, caption: SDKUI_Localizator.Archive, advancedColor: TMColors.success, onClick: handleConfirmAction, secondaryActions: canArchiveDetailRelation ? [{
+                                                                        name: SDKUI_Localizator.ArchiveMasterAndMultipleDetailDocuments,
+                                                                        icon: _jsx(IconArchiveMultipleDetailDocuments, {}),
+                                                                        disabled: archiveBtnDisabled,
+                                                                        onClick: handleArchiveMasterAndDetails,
+                                                                    }] : undefined }), _jsx(TMButton, { disabled: !clearFormBtnDisabled, btnStyle: 'advanced', icon: _jsx(IconClear, {}), width: 'auto', showTooltip: false, caption: SDKUI_Localizator.Clear, advancedColor: TMColors.tertiary, onClick: handleClearForm }), DID && _jsx(TMButton, { disabled: undoBtnDisabled, btnStyle: 'advanced', icon: _jsx(IconUndo, {}), width: '150px', showTooltip: false, caption: SDKUI_Localizator.Undo, advancedColor: TMColors.tertiary, onClick: handleUndo })] }) }) }), customButton && _jsx(TMCustomButton, { button: customButton, formData: formData, selectedItems: [], onClose: () => setCustomButton(undefined) }), totalItems > listMaxItems &&
                                         !isApprView &&
                                         TID !== SystemTIDs.Drafts &&
                                         !shouldShowAll &&
@@ -1149,6 +1267,8 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
         handleConfirmAction,
         handleUndo,
         handleClearForm,
+        canArchiveDetailRelation,
+        handleArchiveMasterAndDetails,
         isReadOnlyOriginCallback,
         metadataDcmtOrigin?.fromTID,
     ]);
@@ -1286,6 +1406,7 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
                         allowMaximize: !isMobile,
                         onBack: getOnBackHandler(true),
                         onClose: isClosable ? () => { } : undefined,
+                        onRefresh: handleRefreshFormMetadataAsync,
                         toolbar: allowNavigation ? formToolbar : _jsx(_Fragment, {})
                     },
                 },
@@ -1375,7 +1496,7 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
             },
         ];
         return panels;
-    }, [fromDTD, showBackButton, tmDcmtForm, tmBlog, tmSysMetadata, tmDcmtPreview, tmWF, tmDcmtTasks, isPreviewDisabled, isSysMetadataDisabled, isBoardDisabled, isWFDisabled, inputFile, isClosable, allTasks, DID, TID, isReadOnlyOriginCallback, metadataDcmtOrigin?.fromTID]);
+    }, [fromDTD, showBackButton, tmDcmtForm, tmBlog, tmSysMetadata, tmDcmtPreview, tmWF, tmDcmtTasks, isPreviewDisabled, isSysMetadataDisabled, isBoardDisabled, isWFDisabled, inputFile, isClosable, allTasks, DID, TID, isReadOnlyOriginCallback, metadataDcmtOrigin?.fromTID, handleRefreshFormMetadataAsync]);
     // Retrieves the current document form setting based on the normalized TID
     const getCurrentDcmtFormSetting = () => {
         const settings = SDKUI_Globals.userSettings.dcmtFormSettings;
@@ -1443,7 +1564,7 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
             for (const key of Object.keys(persistedState)) {
                 if (key === 'tmWF') {
                     // Hide tmWF
-                    newState[key] = { ...persistedState[key], visible: false };
+                    newState[key] = { ...persistedState[key], visible: false, width: '0%' };
                 }
                 else if (otherVisiblePanels.includes(key)) {
                     // Add extra width to visible panels
@@ -1470,6 +1591,8 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
         const persistedState = invocationContext === InvocationContext.Todo ? settings?.layoutToDo : settings?.layout;
         return persistedState?.['tmWF']?.visible ?? false;
     };
+    // Persisted tmWF visibility, read once at mount
+    const persistedWFVisibleRef = useRef(getPersistedWFVisible());
     const onBlogCommentFormCustomSave = useCallback(async (blogPost) => {
         try {
             if (!moreInfoTasks || moreInfoTasks.length === 0) {
@@ -1557,7 +1680,7 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
                         overflow: 'hidden'
                     }, children: [_jsxs("div", { style: { width: '100%', height: '100%', display: isOpenDetails || isOpenMaster ? 'none' : 'flex' }, children: [isNavigating && _jsx(Spinner, { description: SDKUI_Localizator.Loading, flat: false }), (fromDTD) && _jsx(TMLayoutWaitingContainer, { direction: 'vertical', showWaitPanel: useWaitPanelLocalState ? showWaitPanelLocal : showWaitPanel, showWaitPanelPrimary: useWaitPanelLocalState ? showPrimaryLocal : showPrimary, showWaitPanelSecondary: useWaitPanelLocalState ? showSecondaryLocal : showSecondary, waitPanelTitle: useWaitPanelLocalState ? waitPanelTitleLocal : waitPanelTitle, waitPanelTextPrimary: useWaitPanelLocalState ? waitPanelTextPrimaryLocal : waitPanelTextPrimary, waitPanelValuePrimary: useWaitPanelLocalState ? waitPanelValuePrimaryLocal : waitPanelValuePrimary, waitPanelMaxValuePrimary: useWaitPanelLocalState ? waitPanelMaxValuePrimaryLocal : waitPanelMaxValuePrimary, waitPanelTextSecondary: useWaitPanelLocalState ? waitPanelTextSecondaryLocal : waitPanelTextSecondary, waitPanelValueSecondary: useWaitPanelLocalState ? waitPanelValueSecondaryLocal : waitPanelValueSecondary, waitPanelMaxValueSecondary: useWaitPanelLocalState ? waitPanelMaxValueSecondaryLocal : waitPanelMaxValueSecondary, isCancelable: useWaitPanelLocalState ? dcmtFile ? dcmtFile.size >= 1000000 : false : true, abortController: useWaitPanelLocalState ? abortControllerLocal : abortController, children: _jsxs(TMLayoutWaitingContainer, { direction: 'vertical', showWaitPanel: showCicoWaitPanel, showWaitPanelPrimary: showCicoPrimaryProgress, waitPanelTitle: cicoWaitPanelTitle, waitPanelTextPrimary: cicoPrimaryProgressText, waitPanelValuePrimary: cicoPrimaryProgressValue, waitPanelMaxValuePrimary: cicoPrimaryProgressMax, isCancelable: true, abortController: abortControllerLocal, children: [(groupId && groupId.length > 0)
                                                 ? _jsxs(_Fragment, { children: [_jsx(PanelDisabledStateHandler, { isWFDisabled: isWFDisabled, isSysMetadataDisabled: isSysMetadataDisabled, isBoardDisabled: isBoardDisabled, isDcmtTasksDisabled: isDcmtTasksDisabled, isPreviewDisabled: isPreviewDisabled }), _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", parentId: groupId, showToolbar: showDcmtFormSidebar })] })
-                                                : _jsxs(TMPanelManagerWithPersistenceProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: defaultPanelDimensions, initialDimensions: defaultPanelDimensions, initialMobilePanelId: 'tmDcmtForm', isPersistenceEnabled: !isMobile && layoutMode !== LayoutModes.Ark ? hasSavedLayout() : false, persistPanelStates: !isMobile && layoutMode !== LayoutModes.Ark ? (state) => persistPanelStates(state) : undefined, persistedPanelStates: layoutMode !== LayoutModes.Ark ? getPersistedPanelStates() : undefined, children: [_jsx(PanelDisabledStateHandler, { isWFDisabled: isWFDisabled, isSysMetadataDisabled: isSysMetadataDisabled, isBoardDisabled: isBoardDisabled, isDcmtTasksDisabled: isDcmtTasksDisabled, isPreviewDisabled: isPreviewDisabled, persistedWFVisible: getPersistedWFVisible() }), _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", parentId: groupId, showToolbar: showDcmtFormSidebar })] }), isOpenDistinctValues &&
+                                                : _jsxs(TMPanelManagerWithPersistenceProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: defaultPanelDimensions, initialDimensions: defaultPanelDimensions, initialMobilePanelId: 'tmDcmtForm', isPersistenceEnabled: !isMobile && layoutMode !== LayoutModes.Ark ? hasSavedLayout() : false, persistPanelStates: !isMobile && layoutMode !== LayoutModes.Ark ? (state) => persistPanelStates(state) : undefined, persistedPanelStates: layoutMode !== LayoutModes.Ark ? getPersistedPanelStates() : undefined, children: [_jsx(PanelDisabledStateHandler, { isWFDisabled: isWFDisabled, isSysMetadataDisabled: isSysMetadataDisabled, isBoardDisabled: isBoardDisabled, isDcmtTasksDisabled: isDcmtTasksDisabled, isPreviewDisabled: isPreviewDisabled, persistedWFVisible: persistedWFVisibleRef.current }), _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", parentId: groupId, showToolbar: showDcmtFormSidebar })] }), isOpenDistinctValues &&
                                                 _jsx(TMDistinctValues, { tid: TID, mid: focusedMetadataValue?.mid, isModal: true, showHeader: false, layoutMode: layoutMode, onClosePanelCallback: () => setIsOpenDistinctValues(false), onSelectionChanged: (e) => {
                                                         if (!e)
                                                             return;
@@ -1571,12 +1694,13 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
                                                             isEditable: true,
                                                             value: FormulaHelper.addFormulaTag(newFormula.expression)
                                                         }));
-                                                    } }), (isModal && onClose) && _jsx("div", { id: "TMDcmtFormShowConfirmForClose-" + id })] }) }), _jsx(TMToppyDraggableHelpCenter, { isVisible: isToppyVisible, content: _jsx(TMDcmtFormActionButtons, { showToppyForApprove: showToppyForApprove, workItems: workItems, deviceType: deviceType, isMobile: isMobile, handleSignApprove: handleSignApprove, updateShowApprovePopup: updateShowApprovePopup, updateShowRejectPopup: updateShowRejectPopup, updateShowReAssignPopup: updateShowReAssignPopup, updateShowMoreInfoPopup: updateShowMoreInfoPopup, fromDTD: fromDTD, showToppyForCompleteMoreInfo: showToppyForCompleteMoreInfo, moreInfoTasks: moreInfoTasks, setShowCommentForm: setShowCommentForm, showToppyForReferences: showToppyForReferences, dcmtReferences: dcmtReferences, referenceActionMap: referenceActionMap, handleNavigateToReference: handleNavigateToReference, setShowMoreInfoTaskPopup: setShowMoreInfoTaskPopup, setShowMoreInfoTaskTask: setShowMoreInfoTaskTask }) })] }), (showCommentForm && TID && DID) &&
+                                                    } }), (isModal && onClose) && _jsx("div", { id: "TMDcmtFormShowConfirmForClose-" + id })] }) }), _jsx(TMToppyDraggableHelpCenter, { isVisible: isToppyVisible, content: _jsx(TMDcmtFormActionButtons, { showToppyForApprove: showToppyForApprove, workItems: workItems, caseFlowWorkItems: showToppyForCaseFlow ? caseFlowWorkItems : [], onCompleteCaseFlowWorkItem: completeCaseFlowWorkItem, onRejectCaseFlowWorkItem: rejectCaseFlowWorkItem, deviceType: deviceType, isMobile: isMobile, handleSignApprove: handleSignApprove, updateShowApprovePopup: updateShowApprovePopup, updateShowRejectPopup: updateShowRejectPopup, updateShowReAssignPopup: updateShowReAssignPopup, updateShowMoreInfoPopup: updateShowMoreInfoPopup, fromDTD: fromDTD, showToppyForCompleteMoreInfo: showToppyForCompleteMoreInfo, moreInfoTasks: moreInfoTasks, setShowCommentForm: setShowCommentForm, showToppyForReferences: showToppyForReferences, dcmtReferences: dcmtReferences, referenceActionMap: referenceActionMap, handleNavigateToReference: handleNavigateToReference, setShowMoreInfoTaskPopup: setShowMoreInfoTaskPopup, setShowMoreInfoTaskTask: setShowMoreInfoTaskTask }) })] }), (showCommentForm && TID && DID) &&
                             _jsx(TMBlogCommentForm, { maxLength: 500, context: blogCommentFormContext, onClose: handleBlogCommentFormClose, onCustomSave: onBlogCommentFormCustomSave, participants: emptyParticipants, showAttachmentsSection: false, allArchivedDocumentsFileItems: emptyArchivedDocumentsFileItems })] }), renderDcmtOperations, renderFloatingBar] }));
     };
     return (_jsxs("div", { style: { width: '100%', height: '100%' }, children: [(isModal && onClose)
                 ? _jsx(TMModal, { title: titleModal, onClose: handleClose, width: widthModal ?? '100%', height: heightModal ?? '100%', hidePopup: false, askClosingConfirm: true, children: _jsx("div", { style: { width: "100%", height: "100%", display: 'block', padding: "4px", position: 'relative' }, children: renderDcmtForm() }) })
-                : renderDcmtForm(), (showMoreInfoTaskPopup && showMoreInfoTaskTask && showMoreInfoTaskTask.id && handleNavigateToWGs && handleNavigateToDossiers && getAllTasks && deleteTaskByIdsCallback && addTaskCallback && editTaskCallback) && _jsx(TMTaskForm, { id: Number(showMoreInfoTaskTask.id), title: showMoreInfoTaskTask.name ?? 'N/A', formMode: FormModes.Update, onSaved: onSavedTaskFormCallback, editTaskCallback: editTaskCallback, onClose: () => { setShowMoreInfoTaskPopup(false); setShowMoreInfoTaskTask(undefined); }, onCancel: () => { setShowMoreInfoTaskPopup(false); setShowMoreInfoTaskTask(undefined); }, isModal: true, showBackButton: false, hasNavigation: false, width: taskModalSizes(deviceType, FormModes.Update).width, height: taskModalSizes(deviceType, FormModes.Update).height, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, visualizedTasks: [], currentTask: null, setCurrentTask: () => { }, selectedRowKeys: [], handleFocusedRowKeyChange: () => { }, onStatusChanged: () => { }, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback })] }));
+                : renderDcmtForm(), (showMoreInfoTaskPopup && showMoreInfoTaskTask && showMoreInfoTaskTask.id && handleNavigateToWGs && handleNavigateToDossiers && getAllTasks && deleteTaskByIdsCallback && addTaskCallback && editTaskCallback) && _jsx(TMTaskForm, { id: Number(showMoreInfoTaskTask.id), title: showMoreInfoTaskTask.name ?? 'N/A', formMode: FormModes.Update, onSaved: onSavedTaskFormCallback, editTaskCallback: editTaskCallback, onClose: () => { setShowMoreInfoTaskPopup(false); setShowMoreInfoTaskTask(undefined); }, onCancel: () => { setShowMoreInfoTaskPopup(false); setShowMoreInfoTaskTask(undefined); }, isModal: true, showBackButton: false, hasNavigation: false, width: taskModalSizes(deviceType, FormModes.Update).width, height: taskModalSizes(deviceType, FormModes.Update).height, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, visualizedTasks: [], currentTask: null, setCurrentTask: () => { }, selectedRowKeys: [], handleFocusedRowKeyChange: () => { }, onStatusChanged: () => { }, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback }), (showMultiDetailArchiveModal && fromDTD && multiDetailMasterDcmts.length > 0) &&
+                _jsx(TMMultiMasterDetailDcmtsForm, { dtd: fromDTD, masterDcmt: multiDetailMasterDcmts[0], onClose: () => { setShowMultiDetailArchiveModal(false); setMultiDetailMasterDcmts([]); }, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, showDcmtFormSidebar: showDcmtFormSidebar, showTodoDcmtForm: showTodoDcmtForm, openFileUploaderPdfEditor: openFileUploaderPdfEditor, graphometricManager: graphometricManager, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, fetchRemoteCertificates: fetchRemoteCertificates, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick, onTaskCreateRequest: onTaskCreateRequest })] }));
 };
 export default TMDcmtForm;
 /**
@@ -1719,6 +1843,8 @@ const PanelDisabledStateHandler = ({ isWFDisabled, isSysMetadataDisabled, isBoar
             setToolbarButtonDisabled('tmBlog', false);
         }
     }, [isBoardDisabled]);
+    // Tracks whether tmWF has already been restored from the persisted state
+    const didRestoreWF = useRef(false);
     useEffect(() => {
         if (isWFDisabled) {
             setToolbarButtonDisabled('tmWF', true);
@@ -1727,7 +1853,8 @@ const PanelDisabledStateHandler = ({ isWFDisabled, isSysMetadataDisabled, isBoar
         else {
             setToolbarButtonDisabled('tmWF', false);
             // Restore persisted visibility when WF becomes enabled
-            if (persistedWFVisible) {
+            if (persistedWFVisible && !didRestoreWF.current) {
+                didRestoreWF.current = true;
                 setPanelVisibilityById('tmWF', true);
             }
         }

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

@@ -2,9 +2,20 @@ import React from "react";
 import { DcmtTypeDescriptor, TaskDescriptor, ObjectRef } from "@topconsultnpm/sdk-ts";
 import { IWorkItemData } from "../../../ts";
 import { DeviceType } from "../../base/TMDeviceProvider";
+import { CaseFlowDcmtWorkItem } from "../../../hooks/useCaseFlowApprove";
 interface TMDcmtFormActionButtonsProps {
     showToppyForApprove: boolean;
     workItems: Array<IWorkItemData>;
+    /** Attività delle PRATICHE (CaseFlow) pendenti su QUESTO documento. */
+    caseFlowWorkItems?: Array<CaseFlowDcmtWorkItem>;
+    /**
+     * Completa l'attività di pratica. NON usato per la FIRMA: là si apre il viewer
+     * di firma ed è quello, a firma riuscita, a completare — esattamente come per
+     * i work item del workflow.
+     */
+    onCompleteCaseFlowWorkItem?: (item: CaseFlowDcmtWorkItem, comment?: string) => Promise<void>;
+    /** Rifiuta l'attività di pratica con un motivo. */
+    onRejectCaseFlowWorkItem?: (item: CaseFlowDcmtWorkItem, reason: string) => Promise<void>;
     deviceType: DeviceType | undefined;
     isMobile: boolean;
     handleSignApprove: () => void;
@@ -30,5 +41,5 @@ interface TMDcmtFormActionButtonsProps {
     setShowMoreInfoTaskPopup: React.Dispatch<React.SetStateAction<boolean>>;
     setShowMoreInfoTaskTask: React.Dispatch<React.SetStateAction<TaskDescriptor | undefined>>;
 }
-declare const TMDcmtFormActionButtons: (props: TMDcmtFormActionButtonsProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMDcmtFormActionButtons: (props: TMDcmtFormActionButtonsProps) => React.JSX.Element;
 export default TMDcmtFormActionButtons;

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

@@ -1,18 +1,34 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useMemo, useRef, useState } from "react";
 import { ObjectClasses, SDK_Globals } from "@topconsultnpm/sdk-ts";
-import { TASK_MORE_INFO_PREFIX_NAME, SDKUI_Localizator, PDGS_COLORS, calcResponsiveSizes } from "../../../helper";
+import { TASK_MORE_INFO_PREFIX_NAME, SDKUI_Localizator, PDGS_COLORS, calcResponsiveSizes, isSign4TopEnabled } from "../../../helper";
 import { TMColors } from "../../../utils/theme";
 import { StyledReferenceButton } from "../../base/Styled";
 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";
 const TMDcmtFormActionButtons = (props) => {
-    const { showToppyForApprove, workItems, deviceType, isMobile, handleSignApprove, updateShowApprovePopup, updateShowRejectPopup, updateShowReAssignPopup, updateShowMoreInfoPopup, fromDTD, showToppyForCompleteMoreInfo, moreInfoTasks, setShowCommentForm, showToppyForReferences, dcmtReferences, referenceActionMap, handleNavigateToReference, setShowMoreInfoTaskPopup, setShowMoreInfoTaskTask } = 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);
     const [showAllDossiersModal, setShowAllDossiersModal] = useState(false);
     const [showAllWorkingGroupsModal, setShowAllWorkingGroupsModal] = useState(false);
+    // Rifiuto di un'attività di pratica: il motivo è obbligatorio, quindi si passa
+    // da un dialogo. `busyItemId` disabilita i pulsanti dell'attività in corso.
+    const [rejectingItem, setRejectingItem] = useState(null);
+    const [rejectReason, setRejectReason] = useState('');
+    const [busyItemId, setBusyItemId] = useState(null);
+    const cfItems = useMemo(() => caseFlowWorkItems ?? [], [caseFlowWorkItems]);
+    const runCaseFlowAction = useCallback(async (item, action) => {
+        setBusyItemId(item.workItem.id ?? null);
+        try {
+            await action();
+        }
+        finally {
+            setBusyItemId(null);
+        }
+    }, []);
     const tasksNumber = useMemo(() => moreInfoTasks?.length ?? 0, [moreInfoTasks]);
     const firstTask = useMemo(() => {
         if (!moreInfoTasks || moreInfoTasks.length === 0)
@@ -31,19 +47,66 @@ const TMDcmtFormActionButtons = (props) => {
             return false;
         return true;
     }, [firstTask]);
-    const { hasMoreInfo, hasApprove, hasReferences } = useMemo(() => {
+    const { hasMoreInfo, hasApprove, hasReferences, hasCaseFlow } = useMemo(() => {
         const referencesExist = showToppyForReferences && dcmtReferences?.some(ref => ref.objClass === ObjectClasses.Dossier || ref.objClass === ObjectClasses.WorkingGroup);
         return {
             hasMoreInfo: Boolean(showToppyForCompleteMoreInfo),
             hasApprove: Boolean(showToppyForApprove),
-            hasReferences: Boolean(referencesExist)
+            hasReferences: Boolean(referencesExist),
+            hasCaseFlow: cfItems.length > 0
         };
     }, [
         showToppyForCompleteMoreInfo,
         showToppyForApprove,
         showToppyForReferences,
-        dcmtReferences
+        dcmtReferences,
+        cfItems
     ]);
+    /**
+     * Attività di pratica: contesto (pratica + testo dell'attività) e gli STESSI
+     * pulsanti dei work item del workflow (`WorkFlowOperationButtons`), così le due
+     * provenienze si comportano allo stesso modo davanti all'utente.
+     *
+     * La forma dei pulsanti la decide la CATEGORIA dell'attività, non il tipo
+     * documento: un'approvazione su un tipo abilitato alla firma non deve mostrare
+     * "Firma e approva" (per questo si passa `signFlow`). La firma richiede comunque
+     * il widget Sign4Top sul tipo, altrimenti il viewer non avrebbe come aprirsi.
+     *
+     * Per la FIRMA il pulsante apre il viewer (`handleSignApprove`, lo stesso del
+     * workflow) e il completamento avviene lì a firma riuscita: il form non sa
+     * firmare, e completare qui "a fiducia" chiuderebbe l'attività su un documento
+     * non firmato.
+     */
+    const renderCaseFlowWorkItemCard = (item) => {
+        const { caseflow, workItem } = item;
+        const isBusy = busyItemId === workItem.id;
+        const canSign = !!fromDTD?.widgets && isSign4TopEnabled(fromDTD.widgets);
+        const requiresSignature = isSignatureWorkItem(workItem) && canSign;
+        const description = workItem.description || getWorkItemActionName(caseflow, workItem);
+        return (_jsxs("div", { style: {
+                display: 'flex',
+                flexDirection: 'column',
+                alignItems: 'center',
+                textAlign: 'center',
+                gap: '10px',
+                cursor: 'default',
+            }, children: [description && (_jsx("div", { style: {
+                        maxWidth: '240px',
+                        paddingBottom: '8px',
+                        borderBottom: '1px solid rgba(255,255,255,0.25)',
+                        color: '#FFFFFF',
+                        fontSize: '0.95rem',
+                        fontWeight: 600,
+                        lineHeight: 1.3,
+                        letterSpacing: '0.2px',
+                        textShadow: '0 1px 2px rgba(0,0,0,0.35)',
+                        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
+                        ? () => { setRejectReason(''); setRejectingItem(item); }
+                        : undefined })] }, workItem.id));
+    };
     // Raggruppa references per categoria
     const { dossierRefs, workingGroupRefs } = useMemo(() => {
         const dossiers = dcmtReferences?.filter(ref => ref.objClass === ObjectClasses.Dossier) ?? [];
@@ -171,10 +234,17 @@ const TMDcmtFormActionButtons = (props) => {
                         e.currentTarget.style.transform = 'translateY(-50%)';
                     }, children: formatBadgeCount(othersCount) }))] }));
     };
-    return (_jsxs(_Fragment, { children: [_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: '10px' }, children: [hasMoreInfo && firstTask && isMoreInfoCardVisible && (_jsx("div", { style: { display: 'flex', gap: "10px", flexDirection: 'column', alignItems: 'center', paddingRight: tasksNumber > 1 ? '36px' : '0' }, children: renderMoreInfoCard(firstTask, tasksNumber > 1) })), hasMoreInfo && isMoreInfoCardVisible && hasApprove && _jsx(Divider, {}), hasApprove && (workItems.length === 1 ?
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: '10px' }, children: [hasMoreInfo && firstTask && isMoreInfoCardVisible && (_jsx("div", { style: { display: 'flex', gap: "10px", flexDirection: 'column', alignItems: 'center', paddingRight: tasksNumber > 1 ? '36px' : '0' }, children: renderMoreInfoCard(firstTask, tasksNumber > 1) })), hasMoreInfo && isMoreInfoCardVisible && hasCaseFlow && _jsx(Divider, {}), hasCaseFlow && (_jsx("div", { style: { display: 'flex', flexDirection: 'column', gap: '10px', alignItems: 'center' }, children: cfItems.map(item => renderCaseFlowWorkItemCard(item)) })), hasCaseFlow && hasApprove && _jsx(Divider, {}), hasMoreInfo && isMoreInfoCardVisible && !hasCaseFlow && hasApprove && _jsx(Divider, {}), hasApprove && (workItems.length === 1 ?
                         _jsx(WorkFlowOperationButtons, { dtd: fromDTD, deviceType: deviceType, onApprove: () => updateShowApprovePopup(true), onSignApprove: handleSignApprove, onReject: () => updateShowRejectPopup(true), onReAssign: () => updateShowReAssignPopup(true), onMoreInfo: () => updateShowMoreInfoPopup(true) })
                         :
-                            _jsxs("div", { style: { padding: 10, color: 'white', maxWidth: '180px', borderRadius: 10, background: '#1B1464 0% 0% no-repeat padding-box', border: '1px solid #FFFFFF' }, children: [`Questo documento è associato a ${workItems.length} workitem.`, _jsx("br", {}), `Per approvare, vai alla pagina "Approvazione workflow".`] })), (hasApprove && hasReferences) || (hasMoreInfo && isMoreInfoCardVisible && !hasApprove && hasReferences) ? (_jsx(Divider, {})) : null, hasReferences && (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: '10px', alignItems: 'center' }, children: [dossierRefs.length > 0 && (_jsx("div", { style: { paddingRight: dossierRefs.length > 1 ? '36px' : '0' }, children: renderReferenceCard(dossierRefs[0], dossierRefs, dossierRefs.length > 1, () => setShowAllDossiersModal(true)) })), workingGroupRefs.length > 0 && (_jsx("div", { style: { paddingRight: workingGroupRefs.length > 1 ? '36px' : '0' }, children: renderReferenceCard(workingGroupRefs[0], workingGroupRefs, workingGroupRefs.length > 1, () => setShowAllWorkingGroupsModal(true)) }))] }))] }), showAllMoreInfoModal && moreInfoTasks && moreInfoTasks.length > 1 && (_jsx(TMModal, { title: `Altre richieste maggiori informazioni (${moreInfoTasks.length - 1})`, onClose: () => setShowAllMoreInfoModal(false), width: calcResponsiveSizes(deviceType, '450px', '450px', '95%'), height: 'auto', children: _jsx("div", { style: {
+                            _jsxs("div", { style: { padding: 10, color: 'white', maxWidth: '180px', borderRadius: 10, background: '#1B1464 0% 0% no-repeat padding-box', border: '1px solid #FFFFFF' }, children: [`Questo documento è associato a ${workItems.length} workitem.`, _jsx("br", {}), `Per approvare, vai alla pagina "Approvazione workflow".`] })), (hasApprove && hasReferences) || (hasMoreInfo && isMoreInfoCardVisible && !hasApprove && hasReferences) ? (_jsx(Divider, {})) : null, hasReferences && (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: '10px', alignItems: 'center' }, children: [dossierRefs.length > 0 && (_jsx("div", { style: { paddingRight: dossierRefs.length > 1 ? '36px' : '0' }, children: renderReferenceCard(dossierRefs[0], dossierRefs, dossierRefs.length > 1, () => setShowAllDossiersModal(true)) })), workingGroupRefs.length > 0 && (_jsx("div", { style: { paddingRight: workingGroupRefs.length > 1 ? '36px' : '0' }, children: renderReferenceCard(workingGroupRefs[0], workingGroupRefs, workingGroupRefs.length > 1, () => setShowAllWorkingGroupsModal(true)) }))] }))] }), rejectingItem && onRejectCaseFlowWorkItem && (_jsx(TMModal, { title: rejectingItem.workItem.rejectLabel || SDKUI_Localizator.Reject, onClose: () => { setRejectingItem(null); setRejectReason(''); }, width: calcResponsiveSizes(deviceType, '450px', '450px', '95%'), height: 'auto', children: _jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 12, padding: 15 }, children: [_jsx("div", { style: { fontSize: 13, color: '#555' }, children: `${SDKUI_Localizator.Description}:` }), _jsx("textarea", { value: rejectReason, onChange: (e) => setRejectReason(e.target.value), rows: 4, style: { width: '100%', resize: 'vertical', fontFamily: 'inherit', fontSize: 13, padding: 8 } }), _jsxs("div", { style: { display: 'flex', justifyContent: 'flex-end', gap: 8 }, children: [_jsx(TMButton, { caption: SDKUI_Localizator.Cancel, showTooltip: false, onClick: () => { setRejectingItem(null); setRejectReason(''); } }), _jsx(TMButton, { caption: rejectingItem.workItem.rejectLabel || SDKUI_Localizator.Reject, color: 'error', showTooltip: false, disabled: !rejectReason.trim() || busyItemId === rejectingItem.workItem.id, onClick: () => {
+                                        const item = rejectingItem;
+                                        void runCaseFlowAction(item, async () => {
+                                            await onRejectCaseFlowWorkItem(item, rejectReason.trim());
+                                            setRejectingItem(null);
+                                            setRejectReason('');
+                                        });
+                                    } })] })] }) })), showAllMoreInfoModal && moreInfoTasks && moreInfoTasks.length > 1 && (_jsx(TMModal, { title: `Altre richieste maggiori informazioni (${moreInfoTasks.length - 1})`, onClose: () => setShowAllMoreInfoModal(false), width: calcResponsiveSizes(deviceType, '450px', '450px', '95%'), height: 'auto', children: _jsx("div", { style: {
                         display: 'flex',
                         flexDirection: 'column',
                         gap: '8px',

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import { DcmtInfo, DownloadModes, DownloadTypes } from '../../../ts';
 import { FileDescriptor } from '@topconsultnpm/sdk-ts';
 interface ITMDcmtIconProps {
@@ -16,5 +17,5 @@ interface ITMDcmtIconProps {
     /** Se true, renderizza il wait panel nel body tramite Portal (centrato a schermo intero) */
     usePortal?: boolean;
 }
-declare const TMDcmtIcon: ({ fileExtension, fileCount, isLexProt, isSigned, isMail, isShared, tid, did, downloadMode, tooltipContent, openInOffice, onDownloadDcmtsAsync, usePortal }: ITMDcmtIconProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMDcmtIcon: ({ fileExtension, fileCount, isLexProt, isSigned, isMail, isShared, tid, did, downloadMode, tooltipContent, openInOffice, onDownloadDcmtsAsync, usePortal }: ITMDcmtIconProps) => React.JSX.Element;
 export default TMDcmtIcon;