@topconsultnpm/sdkui-react 6.22.0-dev2.39 → 6.22.0-dev2.40

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

@@ -8,6 +8,11 @@ interface TMMultiMasterDetailDcmtsFormProps {
     masterDcmt: DcmtInfo;
     /** Funzione per la chiusura del modale */
     onClose: () => void;
+    /** true se nella lista da cui è stato aperto il modale c'è un documento precedente/successivo */
+    canNavigateMaster?: (dir: 'next' | 'prev') => boolean;
+    /** Sposta il focus della lista di provenienza: il master del modale segue quel documento.
+     *  Senza questa callback le frecce di navigazione non si mostrano */
+    onNavigateMaster?: (dir: 'next' | 'prev') => void;
     allTasks?: Array<TaskDescriptor>;
     getAllTasks?: () => Promise<void>;
     deleteTaskByIdsCallback?: (deletedTaskIds: Array<number>) => Promise<void>;

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

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { LayoutModes } from "@topconsultnpm/sdk-ts";
 import { LoadIndicator } from "devextreme-react/load-indicator";
 import { SearchResultContext } from "../../../ts";
-import { getFullFileExtension, getMultiDetailModalSize, getMultiDetailPanelStates, hasMultiDetailPanelStates, hoverStyle, IconArchive, IconDelete, IconDuplicate, IconEdit, IconEraser, IconInfo, IconMenuVertical, IconRefresh, IconSearch, IconSearchCheck, saveMultiDetailModalSize, saveMultiDetailPanelStates, SDKUI_Localizator } from "../../../helper";
+import { getFullFileExtension, getMultiDetailModalSize, getMultiDetailPanelStates, hasMultiDetailPanelStates, hoverStyle, IconArchive, IconArrowDown, IconArrowUp, IconDelete, IconDuplicate, IconEdit, IconEraser, IconInfo, IconMenuVertical, IconRefresh, IconSearch, IconSearchCheck, saveMultiDetailModalSize, saveMultiDetailPanelStates, SDKUI_Localizator } from "../../../helper";
 import { TMColors } from "../../../utils/theme";
 import { DeviceType, useDeviceType } from "../../base/TMDeviceProvider";
 import { TMLayoutWaitingContainer } from "../../base/TMWaitPanel";
@@ -26,6 +26,8 @@ const styles = {
     header: { display: 'flex', alignItems: 'center', justifyContent: 'center', padding: '6px 12px', borderBottom: `1px solid ${TMColors.card_background}`, flexShrink: 0 },
     // Opzioni nella barra del titolo: stesse misure e colore della chiusura DevExtreme (.dx-popup-title .dx-closebutton)
     titleMenuIcon: { display: 'inline-flex', alignItems: 'center', justifyContent: 'center', width: '18px', height: '18px', margin: '1px 0 0', color: `var(--dx-color-text, ${TMColors.text_normal})`, cursor: 'pointer' },
+    titleMenuIconDisabled: { cursor: 'default', opacity: 0.4 },
+    titleActions: { display: 'inline-flex', alignItems: 'center', gap: '10px' },
     loader: { display: 'flex', flex: 1, alignItems: 'center', justifyContent: 'center' },
     summaryContainer: { display: 'flex', flexDirection: 'column', flex: 1, padding: '8px 12px 10px', minHeight: 0, gap: '8px' },
     // I pannelli ripartiscono l'altezza in percentuale: serve un'altezza definita che non dipenda dal
@@ -45,8 +47,8 @@ const styles = {
 /** Sezione mostrata per prima su mobile, dove i pannelli si vedono uno alla volta */
 const MOBILE_SECTION = 'archiveList';
 const TMMultiMasterDetailDcmtsForm = (props) => {
-    const { dtd, masterDcmt, onClose, allTasks, getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, showDcmtFormSidebar, showTodoDcmtForm, openFileUploaderPdfEditor, graphometricManager, editPdfForm, openS4TViewer, showToppyDraggableHelpCenter, toppyHelpCenterUsePortal, fetchRemoteCertificates, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onReferenceClick, onTaskCreateRequest, onRefreshAfterAddDcmtToFavs, onFileOpened, passToArchiveCallback, openWGsCopyMoveForm } = props;
-    const { isLoading, isSummaryReady, phase, setPhase, detailRelationItems, selectedRelation, selectedItem, hasMultipleTypes, selectRelation, backToTypeSelection, isBackLocked, closeModal, sectionsOpen, setSectionOpen, openAllSections, clearLayout, layoutResetToken, hasSavedLayout, setHasSavedLayout, canUpdateMaster, masterFieldsCount, getMasterMetadataAsync, masterInfoReloadToken, isOpenMasterForm, setIsOpenMasterForm, handleMasterSavedAsync, archivedDetailResults, archivedDetailsCount, isLoadingArchivedDetails, refreshArchivedDetailsAsync, detailColumns, detailSupportsFile, archiveRows, currentRows, focusedRowKey, setFocusedRowKey, selectedRowKeys, setSelectedRowKeys, isOpenAddForm, editingRowId, editingRow, formInputMids, openAddForm, openEditForm, closeAddForm, deleteRow, duplicateRow, upsertRow, updateRowValues, copyArchivedDetailToRows, stopOnFirstError, setStopOnFirstError, isArchiving, archiveAllAsync, waitPanel, abortController, } = useMultiMasterDetailDcmts({ dtd, masterDcmt, onClose });
+    const { dtd, masterDcmt, onClose, canNavigateMaster, onNavigateMaster, allTasks, getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, showDcmtFormSidebar, showTodoDcmtForm, openFileUploaderPdfEditor, graphometricManager, editPdfForm, openS4TViewer, showToppyDraggableHelpCenter, toppyHelpCenterUsePortal, fetchRemoteCertificates, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onReferenceClick, onTaskCreateRequest, onRefreshAfterAddDcmtToFavs, onFileOpened, passToArchiveCallback, openWGsCopyMoveForm } = props;
+    const { isLoading, isSummaryReady, phase, setPhase, detailRelationItems, selectedRelation, selectedItem, hasMultipleTypes, selectRelation, backToTypeSelection, isBackLocked, closeModal, isMasterNavigationEnabled, canNavigateMasterPrev, canNavigateMasterNext, navigateMaster, sectionsOpen, setSectionOpen, openAllSections, clearLayout, layoutResetToken, hasSavedLayout, setHasSavedLayout, canUpdateMaster, masterFieldsCount, getMasterMetadataAsync, masterInfoReloadToken, isOpenMasterForm, setIsOpenMasterForm, handleMasterSavedAsync, archivedDetailResults, archivedDetailsCount, isLoadingArchivedDetails, refreshArchivedDetailsAsync, detailColumns, detailSupportsFile, archiveRows, currentRows, focusedRowKey, setFocusedRowKey, selectedRowKeys, setSelectedRowKeys, isOpenAddForm, editingRowId, editingRow, formInputMids, openAddForm, openEditForm, closeAddForm, deleteRow, duplicateRow, upsertRow, updateRowValues, copyArchivedDetailToRows, stopOnFirstError, setStopOnFirstError, isArchiving, archiveAllAsync, waitPanel, abortController, } = useMultiMasterDetailDcmts({ dtd, masterDcmt, onClose, canNavigateMaster, onNavigateMaster });
     const deviceType = useDeviceType();
     // Su mobile il panel manager mostra un pannello alla volta: le sezioni si raggiungono dalla sua barra
     const isMobile = useMemo(() => deviceType === DeviceType.MOBILE, [deviceType]);
@@ -176,6 +178,20 @@ const TMMultiMasterDetailDcmtsForm = (props) => {
             return undefined;
         return (_jsx(ContextMenu, { trigger: 'left', items: optionsMenuItems, children: _jsx(TMTooltip, { content: SDKUI_Localizator.Options, children: _jsx("span", { style: styles.titleMenuIcon, "aria-label": SDKUI_Localizator.Options, children: _jsx(IconMenuVertical, { fontSize: 16, color: "white" }) }) }) }));
     };
+    const renderMasterNavigation = () => {
+        if (!isMasterNavigationEnabled)
+            return undefined;
+        const renderArrow = (dir, isEnabled, icon, tooltip) => (_jsx(TMTooltip, { content: tooltip, children: _jsx("span", { role: 'button', "aria-label": tooltip, "aria-disabled": !isEnabled, onClick: isEnabled ? () => navigateMaster(dir) : undefined, style: { ...styles.titleMenuIcon, ...(isEnabled ? {} : styles.titleMenuIconDisabled) }, children: icon }) }));
+        return (_jsxs(_Fragment, { children: [renderArrow('prev', canNavigateMasterPrev, _jsx(IconArrowUp, { fontSize: 16, color: "white" }), SDKUI_Localizator.Previous), renderArrow('next', canNavigateMasterNext, _jsx(IconArrowDown, { fontSize: 16, color: "white" }), SDKUI_Localizator.Next)] }));
+    };
+    // Azioni nella barra del titolo: navigazione del master e opzioni del layout
+    const renderTitleActions = () => {
+        const navigation = renderMasterNavigation();
+        const optionsMenu = renderOptionsMenu();
+        if (!navigation && !optionsMenu)
+            return undefined;
+        return _jsxs("div", { style: styles.titleActions, children: [navigation, optionsMenu] });
+    };
     // ----- Sezione: informazioni del master -----------------------------------------------------
     const renderMasterInfo = (panel) => {
         const isOpen = sectionsOpen.masterInfo;
@@ -287,7 +303,7 @@ const TMMultiMasterDetailDcmtsForm = (props) => {
         return null;
     return _jsxs(_Fragment, { children: [_jsx(TMLayoutWaitingContainer, { direction: 'vertical', ...waitPanel, isCancelable: true, abortController: abortController, usePortal: true, children: _jsx(TMModal, { width: modalSize.width, height: modalSize.height, onClose: closeModal, onResized: persistModalSize, 
                     // Cancellato il layout il popup torna alle dimensioni di default
-                    sizeResetToken: layoutResetToken, title: modalTitle, hidePopup: false, askClosingConfirm: archiveRows.length > 0, recenterOnResize: true, titleActions: renderOptionsMenu(), children: _jsxs("div", { style: styles.content, children: [hasMultipleTypes && _jsx("div", { style: styles.header, children: renderStepper({
+                    sizeResetToken: layoutResetToken, title: modalTitle, hidePopup: false, askClosingConfirm: archiveRows.length > 0, recenterOnResize: true, titleActions: renderTitleActions(), children: _jsxs("div", { style: styles.content, children: [hasMultipleTypes && _jsx("div", { style: styles.header, children: renderStepper({
                                     steps,
                                     phase,
                                     hasMultipleTypes,

package/lib/helper/SDKUI_Localizator.d.ts

@@ -96,6 +96,7 @@ export declare class SDKUI_Localizator {
     static get CancelCheckOut(): string;
     static get Cancel(): "Abbrechen" | "Cancel" | "Anular" | "Annuler" | "Cancelar" | "Annulla";
     static get CancelAndClose(): string;
+    static get ChangeMasterWithoutArchiving_Confirm(): "Beim Wechsel des Dokuments werden die eingegebenen Details verworfen und nicht archiviert. Fortfahren?" | "Changing document will discard the entered details without archiving them. Continue?" | "Al cambiar de documento, los detalles introducidos se descartarán sin archivarse. ¿Continuar?" | "En changeant de document, les détails saisis seront abandonnés sans être archivés. Continuer ?" | "Ao mudar de documento, os detalhes introduzidos serão descartados sem serem arquivados. Continuar?" | "Cambiando documento, i dettagli inseriti verranno scartati senza essere archiviati. Continuare?";
     static get ChangePassword(): "Kennwort ändern" | "Change password" | "Cambiar la contraseña" | "Changer le mot de passe" | "Alterar a senha" | "Cambia password";
     static get ChangeStatusTo(): string;
     static get CharactersRemaining(): "verbleibende Zeichen" | "characters remaining" | "caracteres restantes" | "caractères restants" | "caratteri rimanenti";

package/lib/helper/SDKUI_Localizator.js

@@ -915,6 +915,16 @@ export class SDKUI_Localizator {
             default: return "Annulla e chiudi";
         }
     }
+    static get ChangeMasterWithoutArchiving_Confirm() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Beim Wechsel des Dokuments werden die eingegebenen Details verworfen und nicht archiviert. Fortfahren?";
+            case CultureIDs.En_US: return "Changing document will discard the entered details without archiving them. Continue?";
+            case CultureIDs.Es_ES: return "Al cambiar de documento, los detalles introducidos se descartarán sin archivarse. ¿Continuar?";
+            case CultureIDs.Fr_FR: return "En changeant de document, les détails saisis seront abandonnés sans être archivés. Continuer ?";
+            case CultureIDs.Pt_PT: return "Ao mudar de documento, os detalhes introduzidos serão descartados sem serem arquivados. Continuar?";
+            default: return "Cambiando documento, i dettagli inseriti verranno scartati senza essere archiviati. Continuare?";
+        }
+    }
     static get ChangePassword() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Kennwort ändern";

package/lib/hooks/useDocumentOperations.js

@@ -1371,6 +1371,10 @@ export const useDocumentOperations = (props) => {
         dcmtUtility,
         fetchRemoteCertificates
     };
+    // Navigazione del master nell'archiviazione multipla dei dettagli: il modale prende il documento
+    // con il focus, quindi le frecce hanno senso solo senza selezione a checkbox, che ha la precedenza
+    // sul focus e terrebbe il master fermo (vedi getSelectedDcmtsOrFocused)
+    const canNavigateMultiDetailMaster = !!canNavigateHandler && !!onNavigateHandler && selectedItems.length === 0 && selectedDcmtInfos.length === 1;
     const masterDetailMasterCommonProps = {
         deviceType,
         isForMaster: true,
@@ -1408,7 +1412,7 @@ export const useDocumentOperations = (props) => {
                             onRefreshPreviewDatagrid
                         }, fetchRemoteCertificates: fetchRemoteCertificates, graphometricManager: graphometricManager })) }), (showHistory && dtd && selectedDcmtInfos.length > 0) && _jsx(TMViewHistoryDcmt, { fromDTD: dtd, deviceType: deviceType, inputDcmt: selectedDcmtInfos[0], onClose: hideHistoryCallback, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), (commentFormState.show && selectedDcmtInfos.length > 0) && _jsx(TMBlogCommentForm, { context: { engine: 'SearchEngine', object: { tid: selectedDcmtInfos[0].TID, did: selectedDcmtInfos[0].DID } }, onClose: hideCommentFormCallback, refreshCallback: onRefreshBlog, participants: [], showAttachmentsSection: true, allArchivedDocumentsFileItems: convertSearchResultDescriptorToFileItems(currentSearchResults ?? []), isCommentRequired: commentFormState.isRequired, removeAndEditAttachment: commentFormState.removeAndEditAttachment, selectedAttachmentDid: [Number(selectedDcmtInfos[0].DID)] }), (showCheckoutInformationForm && dtd && selectedDcmtInfos.length > 0) &&
                 _jsx(TMDcmtCheckoutInfoForm, { dtdName: dtd.name ?? SDKUI_Localizator.SearchResult, selectedDcmtOrFocused: selectedDcmtInfos[0], onClose: hideCheckoutInformationFormCallback }), isOpenDetailsModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenDetailsModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetailsModal(false) }) }), _jsx(StyledMultiViewPanel, { "$isVisible": isOpenDetails, children: isOpenDetails && _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetails(false) }) }), (isOpenMultiDetailModal && dtd) &&
-                _jsx(TMMultiMasterDetailDcmtsForm, { dtd: dtd, masterDcmt: selectedDcmtInfos[0], onClose: () => setIsOpenMultiDetailModal(false), 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, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, fetchRemoteCertificates: fetchRemoteCertificates, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick, onTaskCreateRequest: onTaskCreateRequest, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, onFileOpened: onFileOpened, passToArchiveCallback: passToArchiveCallback, openWGsCopyMoveForm: openWGsCopyMoveForm }), isOpenMasterModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenMasterModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMasterModal(false) }) }), _jsxs(StyledMultiViewPanel, { "$isVisible": isOpenMaster, children: [isOpenMaster && _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMaster(false) }), secondaryMasterDcmts.length > 0 && secondaryMasterDcmts.map((dcmt, index) => {
+                _jsx(TMMultiMasterDetailDcmtsForm, { dtd: dtd, masterDcmt: selectedDcmtInfos[0], onClose: () => setIsOpenMultiDetailModal(false), canNavigateMaster: canNavigateMultiDetailMaster ? canNavigateHandler : undefined, onNavigateMaster: canNavigateMultiDetailMaster ? onNavigateHandler : undefined, 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, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, fetchRemoteCertificates: fetchRemoteCertificates, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick, onTaskCreateRequest: onTaskCreateRequest, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, onFileOpened: onFileOpened, passToArchiveCallback: passToArchiveCallback, openWGsCopyMoveForm: openWGsCopyMoveForm }), isOpenMasterModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenMasterModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMasterModal(false) }) }), _jsxs(StyledMultiViewPanel, { "$isVisible": isOpenMaster, children: [isOpenMaster && _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMaster(false) }), secondaryMasterDcmts.length > 0 && secondaryMasterDcmts.map((dcmt, index) => {
                         return (_jsx(StyledModalContainer, { style: { backgroundColor: 'white' }, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, inputDcmts: [dcmt], allowNavigation: false, onBack: () => handleRemoveItem(dcmt.TID, dcmt.DID) }) }, `${index}-${dcmt.DID}`));
                     })] }), isOpenArchiveRelationForm && _jsx(TMDcmtForm, { isModal: true, titleModal: SDKUI_Localizator.Archive + ' - ' + (archiveType === 'detail' ? SDKUI_Localizator.DcmtsDetail : SDKUI_Localizator.DcmtsMaster), TID: archiveRelatedDcmtFormTID, layoutMode: LayoutModes.Ark, inputMids: archiveRelatedDcmtFormMids, showBackButton: false, allowButtonsRefs: false, onClose: () => {
                     setIsOpenArchiveRelationForm(false);

package/lib/hooks/useMultiMasterDetailDcmts.d.ts

@@ -36,12 +36,16 @@ interface UseMultiMasterDetailDcmtsParams {
     masterDcmt: DcmtInfo;
     /** Chiusura del modale */
     onClose: () => void;
+    /** true se nella lista di provenienza c'è un documento precedente/successivo su cui spostare il master */
+    canNavigateMaster?: (dir: 'next' | 'prev') => boolean;
+    /** Sposta il focus della lista di provenienza: il master arriva da lì e cambia da sé (vedi masterDcmt) */
+    onNavigateMaster?: (dir: 'next' | 'prev') => void;
 }
 /**
  * Logica dell'archiviazione multipla dei dettagli: relazioni, sezioni, righe del riepilogo e
  * archiviazione. Il rendering sta in TMMultiMasterDetailDcmtsForm
  */
-export declare const useMultiMasterDetailDcmts: ({ dtd, masterDcmt, onClose }: UseMultiMasterDetailDcmtsParams) => {
+export declare const useMultiMasterDetailDcmts: ({ dtd, masterDcmt, onClose, canNavigateMaster, onNavigateMaster }: UseMultiMasterDetailDcmtsParams) => {
     isLoading: boolean;
     isSummaryReady: boolean;
     phase: MultiDetailArchivePhase;
@@ -54,6 +58,10 @@ export declare const useMultiMasterDetailDcmts: ({ dtd, masterDcmt, onClose }: U
     backToTypeSelection: () => void;
     isBackLocked: boolean;
     closeModal: () => void;
+    isMasterNavigationEnabled: boolean;
+    canNavigateMasterPrev: boolean;
+    canNavigateMasterNext: boolean;
+    navigateMaster: (dir: "next" | "prev") => void;
     sectionsOpen: Record<AccordionSection, boolean>;
     setSectionOpen: (section: AccordionSection, isOpen: boolean) => void;
     openAllSections: () => void;

package/lib/hooks/useMultiMasterDetailDcmts.js

@@ -33,7 +33,7 @@ const CLOSED_WAIT_PANEL = {
  * Logica dell'archiviazione multipla dei dettagli: relazioni, sezioni, righe del riepilogo e
  * archiviazione. Il rendering sta in TMMultiMasterDetailDcmtsForm
  */
-export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose }) => {
+export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose, canNavigateMaster, onNavigateMaster }) => {
     const { renderDataListCell, loadDataListsAsync } = useDataListItem();
     const [isLoading, setIsLoading] = useState(true);
     const [phase, setPhase] = useState(MultiDetailArchivePhase.SelectDcmtType);
@@ -88,13 +88,14 @@ export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose }) => {
     // =============================================================================================
     // MASTER
     // =============================================================================================
-    // Metadati del master indicizzati per mid: il master è fisso, quindi si legge una sola volta
-    // e la cache si invalida solo se cambia il documento (TID/DID) o dopo un salvataggio
+    /** Identifica il master: cambia quando la navigazione sposta il modale su un altro documento */
+    const masterKey = `${masterDcmt?.TID}_${masterDcmt?.DID}`;
+    // Metadati del master indicizzati per mid: si leggono una sola volta per documento e la cache
+    // si invalida se cambia il master (TID/DID) o dopo un suo salvataggio
     const masterMetadataCacheRef = useRef(undefined);
     const getMasterMetadataAsync = () => {
-        const key = `${masterDcmt?.TID}_${masterDcmt?.DID}`;
-        if (masterMetadataCacheRef.current?.key !== key) {
-            masterMetadataCacheRef.current = { key, promise: getDcmtMetadataByMid(masterDcmt) };
+        if (masterMetadataCacheRef.current?.key !== masterKey) {
+            masterMetadataCacheRef.current = { key: masterKey, promise: getDcmtMetadataByMid(masterDcmt) };
         }
         return masterMetadataCacheRef.current.promise;
     };
@@ -103,6 +104,21 @@ export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose }) => {
         setMasterInfoReloadToken(token => token + 1);
         setIsOpenMasterForm(false);
     };
+    // La navigazione ha spostato il modale su un altro master: le righe del riepilogo erano del
+    // documento precedente e sono già state scartate con conferma (vedi navigateMaster).
+    // Il tipo di dettaglio scelto resta: nella lista di provenienza i documenti sono dello stesso tipo
+    const previousMasterKeyRef = useRef(masterKey);
+    useEffect(() => {
+        if (previousMasterKeyRef.current === masterKey)
+            return;
+        previousMasterKeyRef.current = masterKey;
+        setArchiveRows([]);
+        setFocusedRowKey(undefined);
+        setSelectedRowKeys([]);
+        setIsOpenAddForm(false);
+        setEditingRowId(undefined);
+        setIsOpenMasterForm(false);
+    }, [masterKey]);
     // Associazioni della relazione valorizzate dal master, per pre-compilare il dettaglio
     const getMasterAssociationsForDetailAsync = async (relation) => {
         if (!relation)
@@ -112,7 +128,8 @@ export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose }) => {
     // =============================================================================================
     // RELAZIONI E STRUTTURA DEL DETTAGLIO
     // =============================================================================================
-    // Relazioni di dettaglio archiviabili; con una sola relazione si salta la scelta del tipo
+    // Relazioni di dettaglio archiviabili; con una sola relazione si salta la scelta del tipo.
+    // Dipende dal tipo del master: la navigazione resta nella stessa lista, quindi di norma non cambia
     useEffect(() => {
         const loadAsync = async () => {
             try {
@@ -148,7 +165,7 @@ export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose }) => {
             }
         };
         loadAsync();
-    }, []);
+    }, [dtd?.id]);
     // Colonne della griglia di riepilogo e supporto al file del tipo selezionato
     useEffect(() => {
         const loadDetailStructureAsync = async () => {
@@ -215,14 +232,15 @@ export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose }) => {
             setIsLoadingArchivedDetails(false);
         }
     };
-    // I risultati seguono il tipo documento selezionato e si caricano anche a sezione chiusa: il contatore
-    // nella testata e nella barra dei pannelli deve essere corretto senza dover aprire la sezione
+    // I risultati seguono il tipo documento selezionato e il master (che cambia con la navigazione), e si
+    // caricano anche a sezione chiusa: il contatore nella testata e nella barra dei pannelli deve essere
+    // corretto senza dover aprire la sezione
     useEffect(() => {
         setArchivedDetailResults([]);
         areArchivedDetailsLoadedRef.current = false;
         if (selectedRelation?.detailTID !== undefined)
             refreshArchivedDetailsAsync();
-    }, [selectedRelation?.detailTID]);
+    }, [selectedRelation?.detailTID, masterKey]);
     // =============================================================================================
     // SEZIONI
     // =============================================================================================
@@ -298,6 +316,32 @@ export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose }) => {
                 onClose(); },
         });
     };
+    // Navigazione del master sulla lista di provenienza: senza la sua callback le frecce non si mostrano
+    const canNavigateMasterPrev = !!onNavigateMaster && (canNavigateMaster?.('prev') ?? false);
+    const canNavigateMasterNext = !!onNavigateMaster && (canNavigateMaster?.('next') ?? false);
+    const isMasterNavigationEnabled = !!onNavigateMaster;
+    /**
+     * Sposta il master sul documento precedente/successivo della lista di provenienza. Le righe già
+     * inserite appartengono al master corrente: si perdono, quindi prima si chiede conferma
+     */
+    const navigateMaster = (dir) => {
+        if (!onNavigateMaster)
+            return;
+        if (dir === 'prev' ? !canNavigateMasterPrev : !canNavigateMasterNext)
+            return;
+        if (archiveRows.length === 0) {
+            onNavigateMaster(dir);
+            return;
+        }
+        TMMessageBoxManager.show({
+            title: SDKUI_Localizator.Archive,
+            message: SDKUI_Localizator.ChangeMasterWithoutArchiving_Confirm,
+            buttons: [ButtonNames.YES, ButtonNames.NO],
+            // Le righe le azzera l'effetto sul cambio di master, non serve svuotarle qui
+            onButtonClick: (button) => { if (button === ButtonNames.YES)
+                onNavigateMaster(dir); },
+        });
+    };
     // =============================================================================================
     // RIGHE DEL RIEPILOGO
     // =============================================================================================
@@ -694,6 +738,8 @@ export const useMultiMasterDetailDcmts = ({ dtd, masterDcmt, onClose }) => {
         isLoading, isSummaryReady, phase, setPhase,
         detailRelationItems, selectedRelation, selectedItem, hasMultipleTypes,
         selectRelation, backToTypeSelection, isBackLocked, closeModal,
+        // Navigazione del master sulla lista di provenienza
+        isMasterNavigationEnabled, canNavigateMasterPrev, canNavigateMasterNext, navigateMaster,
         // Sezioni
         sectionsOpen, setSectionOpen, openAllSections, clearLayout, layoutResetToken,
         hasSavedLayout, setHasSavedLayout,

package/package.json

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