@topconsultnpm/sdkui-react 6.22.0-t1 → 6.22.0-t3

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 { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } 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';
@@ -13,7 +13,8 @@ import ShowAlert from '../../base/TMAlert';
 import TMButton from '../../base/TMButton';
 import { TMExceptionBoxManager, TMMessageBoxManager, ButtonNames } from '../../base/TMPopUp';
 import TMSpinner, { Spinner } from '../../base/TMSpinner';
-import { TMLayoutWaitingContainer } from '../../base/TMWaitPanel';
+import TMLayoutContainer from '../../base/TMLayout';
+import TMWaitPanelManager from '../../base/waitPanel/TMWaitPanelManager';
 import TMDistinctValues from '../../choosers/TMDistinctValues';
 import TMFormulaEditor, { FormulaDescriptor, FormulaHelper, FormulaTargets } from '../../editors/TMFormulaEditor';
 import TMMetadataValues, { AdvancedMenuButtons } from '../../editors/TMMetadataValues';
@@ -26,6 +27,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 +41,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,21 +61,10 @@ 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('');
-    const [showWaitPanelLocal, setShowWaitPanelLocal] = useState(false);
-    const [waitPanelTitleLocal, setWaitPanelTitleLocal] = useState('');
-    const [showPrimaryLocal, setShowPrimaryLocal] = useState(false);
-    const [waitPanelTextPrimaryLocal, setWaitPanelTextPrimaryLocal] = useState('');
-    const [waitPanelValuePrimaryLocal, setWaitPanelValuePrimaryLocal] = useState(0);
-    const [waitPanelMaxValuePrimaryLocal, setWaitPanelMaxValuePrimaryLocal] = useState(0);
-    const [showSecondaryLocal, setShowSecondaryLocal] = useState(false);
-    const [waitPanelTextSecondaryLocal, setWaitPanelTextSecondaryLocal] = useState('');
-    const [waitPanelValueSecondaryLocal, setWaitPanelValueSecondaryLocal] = useState(0);
-    const [waitPanelMaxValueSecondaryLocal, setWaitPanelMaxValueSecondaryLocal] = useState(0);
-    const [useWaitPanelLocalState, setUseWaitPanelLocalState] = useState(false);
     const [formData, setFormData] = useState([]);
     const [formDataOrig, setFormDataOrig] = useState([]);
     const [validationItems, setValidationItems] = useState([]);
@@ -96,6 +89,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 +113,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 +326,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 +459,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, relatedDocumentsInfo: { isOpenDetails, isOpenMaster, canArchiveDetailRelation, checkRelatedDcmtsArchiveCapability, checkManyToManyCapability, }, toppyOperations: { updateShowApprovePopup, updateShowRejectPopup, updateShowReAssignPopup, updateShowMoreInfoPopup } } = features;
     useEffect(() => {
         const fetchAllUsers = async () => {
             const users = await UserListCacheService.GetAllAsync();
@@ -804,11 +813,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]);
@@ -871,15 +960,15 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
         }
     }, [DID, TID, getSpecificChangedKeysWithValues, refreshMetadataAsync, onSavedAsyncCallback, onClose]);
     const handleArchiveCompleted = useCallback(async () => {
-        let firstBlock = true;
-        let maxFileSize = 0;
         let operationTitle = SDKUI_Localizator.Archiving;
-        setUseWaitPanelLocalState(true);
-        setShowWaitPanelLocal(true);
-        setShowPrimaryLocal(false);
-        setShowSecondaryLocal(true);
-        setWaitPanelTitleLocal(operationTitle);
         abortControllerLocal = new AbortController();
+        // Interrompi solo sopra il megabyte: sotto, l'upload finisce prima che serva.
+        const panel = TMWaitPanelManager.show({
+            title: operationTitle,
+            showCounters: false,
+            cancelable: (dcmtFileRef.current?.size ?? 0) >= 1000000,
+            onAbort: () => abortControllerLocal.abort(),
+        });
         const ae = new ArchiveEngineByID(SDK_Globals.tmSession);
         ae.TID = TID;
         ae.Metadata_ClearAll();
@@ -915,42 +1004,41 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
                 sharedDcmt.did = sharedSourceDID;
                 ae.SharedDcmt = sharedDcmt;
             }
+            // Fase 1: upload del file, la barra segue i byte.
             let newDID = await ae.ArchiveAsync(abortControllerLocal.signal, (pd) => {
-                if (firstBlock) {
-                    maxFileSize = pd.ProgressBarMaximum ?? 0;
-                    setWaitPanelMaxValueSecondaryLocal(maxFileSize);
-                    firstBlock = false;
-                }
-                setWaitPanelValueSecondaryLocal(pd.ProgressBarValue);
-                setWaitPanelTextSecondaryLocal(`${SDKUI_Localizator.Archiving}... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
+                const maxFileSize = pd.ProgressBarMaximum ?? 0;
                 if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                    // Cambia subito il titolo alla fase 2 quando l'upload termina
-                    // e mostra la progress bar primaria con valore iniziale 20%
-                    setWaitPanelTitleLocal(SDKUI_Localizator.ArchivingCompletionInProgress);
-                    setShowSecondaryLocal(false);
-                    setShowPrimaryLocal(true);
-                    setWaitPanelMaxValuePrimaryLocal(3);
-                    setWaitPanelValuePrimaryLocal(0.6); // 20% di 3
-                    setWaitPanelTextPrimaryLocal(SDKUI_Localizator.ArchivingCompletionInProgress);
-                    firstBlock = true;
+                    // Upload finito: fase 2 sulla stessa barra, tre passi, gia' al 20%.
+                    panel.update({
+                        title: SDKUI_Localizator.ArchivingCompletionInProgress,
+                        subtitle: SDKUI_Localizator.ArchivingCompletionInProgress,
+                        value: 0.6,
+                        max: 3,
+                    });
+                    return;
                 }
+                panel.update({
+                    value: pd.ProgressBarValue,
+                    max: maxFileSize,
+                    subtitle: `${SDKUI_Localizator.Archiving}... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`,
+                });
             });
             // Aggiorna lo stato locale immediatamente dopo il salvataggio riuscito
             // Questo garantisce che isModified diventi false anche se il reload fallisce
             const savedFormData = structuredClone(formDataRef.current);
             setFormDataOrig(savedFormData);
             formDataOrigRef.current = savedFormData;
-            // Fase 2: Completamento archiviazione (la progress bar primaria è già visibile dal callback)
+            // Fase 2: Completamento archiviazione (la barra a tre passi è già visibile dal callback)
             // Imposta il titolo anche qui per sicurezza, nel caso il callback non venga eseguito
-            setWaitPanelTitleLocal(SDKUI_Localizator.ArchivingCompletionInProgress);
+            panel.update({ title: SDKUI_Localizator.ArchivingCompletionInProgress, max: 3 });
             // Step 1/3: Aggiornamento griglia di ricerca
-            setWaitPanelValuePrimaryLocal(1);
+            panel.setValue(1);
             await onRefreshSearchAsyncDatagrid?.();
             // Step 2/3: Callback di salvataggio
-            setWaitPanelValuePrimaryLocal(2);
+            panel.setValue(2);
             await onSavedAsyncCallback?.(ae.TID, newDID);
             // Step 3/3: Aggiornamento lista metadati
-            setWaitPanelValuePrimaryLocal(3);
+            panel.setValue(3);
             // Usa fromDTDRef.current invece di fromDTD per evitare stale closure,
             // garantendo di avere il descrittore del tipo documento corrente.
             await setMetadataList(fromDTDRef.current?.metadata ?? [], undefined, true, newDID);
@@ -964,55 +1052,62 @@ 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);
+            panel.close();
         }
     }, [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 +1116,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 +1144,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;
@@ -1099,7 +1198,7 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
         const { checkoutStatus } = getDcmtCicoStatus(formData, allUsers, fromDTD);
         if (!checkoutStatus.isCheckedOut)
             return null;
-        return (_jsx(Ribbon, { "$isMobile": isMobile, children: _jsx(TMTooltip, { content: checkoutStatus.editLockTooltipText, position: "right", children: _jsx("span", { children: checkoutStatus.mode === 'editMode' ? SDKUI_Localizator.CheckOut : 'Locked' }) }) }));
+        return (_jsx(Ribbon, { $isMobile: isMobile, children: _jsx(TMTooltip, { content: checkoutStatus.editLockTooltipText, position: "right", children: _jsx("span", { children: checkoutStatus.mode === 'editMode' ? SDKUI_Localizator.CheckOut : 'Locked' }) }) }));
     }, [formData, fromDTD, isMobile]);
     const tmDcmtForm = useMemo(() => {
         return _jsxs(_Fragment, { children: [checkoutBadge && _jsx("div", { style: { padding: '10px', display: 'flex', justifyContent: 'center' }, children: checkoutBadge }), metadataValuesSource.length > 0 &&
@@ -1118,7 +1217,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 +1255,8 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
         handleConfirmAction,
         handleUndo,
         handleClearForm,
+        canArchiveDetailRelation,
+        handleArchiveMasterAndDetails,
         isReadOnlyOriginCallback,
         metadataDcmtOrigin?.fromTID,
     ]);
@@ -1286,6 +1394,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 +1484,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 +1552,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 +1579,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) {
@@ -1555,28 +1666,29 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
                         height: '100%',
                         position: 'relative',
                         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 &&
-                                                _jsx(TMDistinctValues, { tid: TID, mid: focusedMetadataValue?.mid, isModal: true, showHeader: false, layoutMode: layoutMode, onClosePanelCallback: () => setIsOpenDistinctValues(false), onSelectionChanged: (e) => {
-                                                        if (!e)
-                                                            return;
-                                                        setFormData((prevItems) => prevItems.map((item) => item.tid == e.tid && item.mid === e.mid ? { ...item, value: e.newValue } : item));
-                                                    } }), isOpenFormulaEditor &&
-                                                _jsx(TMFormulaEditor, { isModal: true, formMode: FormModes.Update, inputData: getFormula(), showBack: false, onClose: () => setIsOpenFormulaEditor(false), onApplied: (newFormula) => {
-                                                        setFormData((prevItems) => prevItems.map((item) => item.tid == newFormula.tid && item.mid === newFormula.mid ? { ...item, value: FormulaHelper.addFormulaTag(newFormula.expression), isSelected: true, isEditable: true } : item));
-                                                        setFocusedMetadataValue(prevState => ({
-                                                            ...prevState,
-                                                            isSelected: true,
-                                                            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) &&
+                    }, children: [_jsxs("div", { style: { width: '100%', height: '100%', display: isOpenDetails || isOpenMaster ? 'none' : 'flex' }, children: [isNavigating && _jsx(Spinner, { description: SDKUI_Localizator.Loading, flat: false }), (fromDTD) && _jsxs(TMLayoutContainer, { direction: 'vertical', 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: 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;
+                                                    setFormData((prevItems) => prevItems.map((item) => item.tid == e.tid && item.mid === e.mid ? { ...item, value: e.newValue } : item));
+                                                } }), isOpenFormulaEditor &&
+                                            _jsx(TMFormulaEditor, { isModal: true, formMode: FormModes.Update, inputData: getFormula(), showBack: false, onClose: () => setIsOpenFormulaEditor(false), onApplied: (newFormula) => {
+                                                    setFormData((prevItems) => prevItems.map((item) => item.tid == newFormula.tid && item.mid === newFormula.mid ? { ...item, value: FormulaHelper.addFormulaTag(newFormula.expression), isSelected: true, isEditable: true } : item));
+                                                    setFocusedMetadataValue(prevState => ({
+                                                        ...prevState,
+                                                        isSelected: true,
+                                                        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, 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)
+    return (_jsxs("div", { style: (isModal && onClose) ? { width: 0, height: 0 } : { 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 +1731,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 +1755,59 @@ 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 description = mvd.md?.description?.trim();
+            const message = description ? description : SDKUI_Localizator.InvalidFormatValue;
+            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 +1832,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 +1842,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);
             }
         }