@topconsultnpm/sdkui-react 6.22.0-t1 → 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, 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;
 /**
@@ -1619,6 +1743,8 @@ export const validateMetadataList = (mvdList = []) => {
         if (isValidForValidation(mvd)) {
             validateRequiredField(mvd, value, validationItems);
             validateMaxLength(mvd, value, validationItems);
+            validateCustomRegEx(mvd, value, validationItems);
+            validateFormatRegEx(mvd, value, validationItems);
         }
         return validationItems;
     }, []);
@@ -1641,8 +1767,58 @@ const validateMaxLength = (mvd, value, validationItems) => {
     const isTextOrNumber = mvd.md?.dataType === MetadataDataTypes.Varchar || mvd.md?.dataType === MetadataDataTypes.Number;
     const isFormula = FormulaHelper.isFormula(value);
     if (isTextOrNumber && !isFormula && mvd.md?.length && value.replace(regex, '').length > maxLength) {
-        const message = `"${mvd.md.nameLoc ?? "no-name"}" ha superata massimo lunghezza di ${maxLength} caratteri.`;
-        validationItems.push(new ValidationItem(ResultTypes.ERROR, mvd.md.nameLoc ?? "", message));
+        const fieldName = mvd.md?.nameLoc ?? mvd.md?.name ?? SDKUI_Localizator.Field;
+        const message = SDKUI_Localizator.MaxLengthExceeded.replaceParams(fieldName, maxLength);
+        validationItems.push(new ValidationItem(ResultTypes.ERROR, fieldName, message));
+    }
+};
+const validateCustomRegEx = (mvd, value, validationItems) => {
+    const pattern = mvd.md?.format?.formatCustom;
+    if (mvd.md?.format?.format !== MetadataFormats.CustomRegEx || !pattern)
+        return;
+    // Valore vuoto: ci pensa validateRequiredField; formule: non validabili con regex
+    if (!value.trim() || FormulaHelper.isFormula(value))
+        return;
+    try {
+        const regex = new RegExp(`^(?:${pattern})$`);
+        if (!regex.test(value)) {
+            const fieldName = mvd.md?.nameLoc ?? mvd.md?.name ?? SDKUI_Localizator.Field;
+            const message = SDKUI_Localizator.FormatNotRespected.replaceParams(fieldName, pattern);
+            validationItems.push(new ValidationItem(ResultTypes.ERROR, fieldName, message));
+        }
+    }
+    catch {
+        // Pattern regex non valido: nessuna validazione, accetta qualsiasi valore
+    }
+};
+// Regex predefinite per i formati standard (EMail, Partita IVA, Codice Fiscale)
+const FORMAT_REGEX_RULES = [
+    {
+        format: MetadataFormats.EMail,
+        regex: /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/,
+        message: (name) => SDKUI_Localizator.InvalidEmailAddress.replaceParams(name)
+    },
+    {
+        format: MetadataFormats.PartitaIva,
+        regex: /^[0-9]{11}$/,
+        message: (name) => SDKUI_Localizator.InvalidVatNumber.replaceParams(name)
+    },
+    {
+        // Persone fisiche (16 caratteri, incluse le lettere di omocodia) o soggetti giuridici (11 cifre)
+        format: MetadataFormats.CodiceFiscale,
+        regex: /^(?:[A-Z]{6}[0-9LMNPQRSTUV]{2}[ABCDEHLMPRST][0-9LMNPQRSTUV]{2}[A-Z][0-9LMNPQRSTUV]{3}[A-Z]|[0-9]{11})$/i,
+        message: (name) => SDKUI_Localizator.InvalidTaxCode.replaceParams(name)
+    }
+];
+const validateFormatRegEx = (mvd, value, validationItems) => {
+    const rule = FORMAT_REGEX_RULES.find(r => r.format === mvd.md?.format?.format);
+    if (!rule)
+        return;
+    // Valore vuoto: ci pensa validateRequiredField; formule: non validabili con regex
+    if (!value.trim() || FormulaHelper.isFormula(value))
+        return;
+    if (!rule.regex.test(value)) {
+        validationItems.push(new ValidationItem(ResultTypes.ERROR, mvd.md?.nameLoc ?? "", rule.message(mvd.md?.nameLoc ?? SDKUI_Localizator.Field)));
     }
 };
 //#endregion Validation
@@ -1667,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);
@@ -1675,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;