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

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

@@ -132,6 +132,19 @@ export interface TMRelationViewerProps {
      * Useful to disable interactions (like context menu) during loading.
      */
     onLoadingStateChanged?: (isLoading: boolean) => void;
+    /**
+     * Invoked on mount to hand over a function that stops the ongoing correlations
+     * calculation: no further GetMetadata calls are performed and only the
+     * correlations already calculated are kept.
+     * The function is synchronous, so it can be safely called right before
+     * unmounting the viewer (e.g. when navigating back).
+     */
+    onStopCalculationReady?: (stopCalculation: () => void) => void;
+    /**
+     * Callback invoked when the calculation has actually been stopped
+     * (loadData terminated after an abort request).
+     */
+    onCalculationStopped?: () => void;
 }
 /**
  * Check if document type has detail relations
@@ -150,7 +163,7 @@ export declare const getDisplayValueByColumn: (col: DataColumnDescriptor | undef
  * For each document, fetches complete metadata using GetMetadataAsync to ensure
  * all metadata properties (isSpecialSearchOutput, permissions, etc.) are available
  */
-export declare const searchResultToDataSource: (searchResult: SearchResultDescriptor | undefined, hideSysMetadata?: boolean) => Promise<any[]>;
+export declare const searchResultToDataSource: (searchResult: SearchResultDescriptor | undefined, hideSysMetadata?: boolean, signal?: AbortSignal) => Promise<any[]>;
 export declare const DEFAULT_RELATION_EXPAND_LEVEL = 4;
 declare const TMRelationViewer: React.FC<TMRelationViewerProps>;
 export default TMRelationViewer;

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

@@ -70,7 +70,7 @@ export const getDisplayValueByColumn = (col, value) => {
  * For each document, fetches complete metadata using GetMetadataAsync to ensure
  * all metadata properties (isSpecialSearchOutput, permissions, etc.) are available
  */
-export const searchResultToDataSource = async (searchResult, hideSysMetadata) => {
+export const searchResultToDataSource = async (searchResult, hideSysMetadata, signal) => {
     const rows = searchResult?.dtdResult?.rows ?? [];
     const output = [];
     // Find TID and DID column indices
@@ -78,6 +78,9 @@ export const searchResultToDataSource = async (searchResult, hideSysMetadata) =>
     const tidColIndex = columns.findIndex(col => col.caption?.toUpperCase() === 'TID');
     const didColIndex = columns.findIndex(col => col.caption?.toUpperCase() === 'DID');
     for (let index = 0; index < rows.length; index++) {
+        // Interruzione richiesta dall'utente: restituisce i documenti già elaborati
+        if (signal?.aborted)
+            break;
         const row = rows[index];
         // Extract TID and DID from row
         const tid = tidColIndex >= 0 ? Number(row[tidColIndex]) : searchResult?.fromTID;
@@ -144,7 +147,7 @@ export const searchResultToDataSource = async (searchResult, hideSysMetadata) =>
     return output;
 };
 export const DEFAULT_RELATION_EXPAND_LEVEL = 4; // Default maximum depth level for expansion (can be adjusted)
-const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndicator = true, allowShowZeroDcmts = true, initialShowZeroDcmts = false, allowedTIDs, allowMultipleSelection = false, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onAllItemsChanged, onDocumentDoubleClick, customItemRender, customDocumentStyle, customMainContainerContent, customDocumentContent, showMetadataNames = false, maxDepthLevel = 2, invertMasterNavigation = true, additionalStaticItems, showMainDocument = true, labelMainContainer, onNoRelationsFound, onItemContextMenu, focusedItemFormData = [], showExpandAllButton = false, defaultExpandAll = false, onLoadingStateChanged }) => {
+const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndicator = true, allowShowZeroDcmts = true, initialShowZeroDcmts = false, allowedTIDs, allowMultipleSelection = false, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onAllItemsChanged, onDocumentDoubleClick, customItemRender, customDocumentStyle, customMainContainerContent, customDocumentContent, showMetadataNames = false, maxDepthLevel = 2, invertMasterNavigation = true, additionalStaticItems, showMainDocument = true, labelMainContainer, onNoRelationsFound, onItemContextMenu, focusedItemFormData = [], showExpandAllButton = false, defaultExpandAll = false, onLoadingStateChanged, onStopCalculationReady, onCalculationStopped }) => {
     // State
     const [dcmtTypes, setDcmtTypes] = useState([]);
     const [treeData, setTreeData] = useState([]);
@@ -159,6 +162,8 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
     const [waitPanelValuePrimary, setWaitPanelValuePrimary] = useState(0);
     const [waitPanelMaxValuePrimary, setWaitPanelMaxValuePrimary] = useState(0);
     const [abortController] = useState(new AbortController());
+    // True quando l'utente ha interrotto il calcolo delle correlazioni (pulsante "Interrompi")
+    const [loadStoppedByUser, setLoadStoppedByUser] = useState(false);
     const [showExpansionWaitPanel, setShowExpansionWaitPanel] = useState(false);
     const [expansionWaitPanelText, setExpansionWaitPanelText] = useState('');
     const [expansionWaitPanelValue, setExpansionWaitPanelValue] = useState(0);
@@ -191,6 +196,27 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
         const isLoading = showWaitPanel || showExpansionWaitPanel;
         onLoadingStateChanged?.(isLoading);
     }, [showWaitPanel, showExpansionWaitPanel, onLoadingStateChanged]);
+    // Mantiene l'AbortController dell'espansione in corso accessibile da callback stabili
+    const expansionAbortControllerRef = React.useRef(undefined);
+    useEffect(() => {
+        expansionAbortControllerRef.current = expansionAbortController;
+    }, [expansionAbortController]);
+    /**
+     * Interrompe il calcolo delle correlazioni (iniziale e/o espansione in corso):
+     * non vengono eseguite ulteriori chiamate GetMetadata e vengono mantenute
+     * solo le correlazioni già calcolate.
+     * È sincrona: può essere invocata immediatamente prima di smontare il viewer
+     * (es. pulsante "Indietro"), quando un effect non farebbe in tempo.
+     */
+    const stopCalculation = useCallback(() => {
+        if (!abortController.signal.aborted)
+            abortController.abort();
+        expansionAbortControllerRef.current?.abort();
+    }, [abortController]);
+    // Espone la funzione di interruzione al componente padre
+    useEffect(() => {
+        onStopCalculationReady?.(stopCalculation);
+    }, [onStopCalculationReady, stopCalculation]);
     // Sincronizza expandLevel quando userSettings.searchSettings.relationExpandLevel cambia
     useEffect(() => {
         const globalExpandLevel = SDKUI_Globals.userSettings?.searchSettings?.relationExpandLevel;
@@ -220,7 +246,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
     /**
      * Recursively retrieve detail documents (adapted from TMMasterDetailDcmts.tsx)
      */
-    const getDetailDcmtsAsync = useCallback(async (mTID, mDID, maxLevel) => {
+    const getDetailDcmtsAsync = useCallback(async (mTID, mDID, maxLevel, signal) => {
         const items = [];
         if (!mTID)
             return [];
@@ -240,6 +266,9 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                 return items;
             const results = await searchEngine.GetAllDetailDcmtsAsync(mTID, mDID) ?? [];
             for (const searchResult of results) {
+                // Interruzione richiesta dall'utente: restituisce le correlazioni già calcolate
+                if (signal?.aborted)
+                    break;
                 // Skip if allowedTIDs is set and this TID is not allowed
                 if (allowedTIDs && searchResult.fromTID && !allowedTIDs.includes(searchResult.fromTID)) {
                     continue;
@@ -261,7 +290,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                     expanded: false,
                     hidden: false
                 };
-                const source = await searchResultToDataSource(searchResult);
+                const source = await searchResultToDataSource(searchResult, undefined, signal);
                 if (source && source.length > 0) {
                     const dcmtDetails = [];
                     // Check once if this document type can have detail relations
@@ -307,7 +336,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
     /**
      * Recursively retrieve master documents
      */
-    const getMasterDcmtsAsync = useCallback(async (dTID, dDID, maxLevel) => {
+    const getMasterDcmtsAsync = useCallback(async (dTID, dDID, maxLevel, signal) => {
         const items = [];
         if (!dTID)
             return [];
@@ -327,6 +356,9 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                 return items;
             const results = await searchEngine.GetAllMasterDcmtsAsync(dTID, dDID) ?? [];
             for (const searchResult of results) {
+                // Interruzione richiesta dall'utente: restituisce le correlazioni già calcolate
+                if (signal?.aborted)
+                    break;
                 // Skip if allowedTIDs is set and this TID is not allowed
                 if (allowedTIDs && searchResult.fromTID && !allowedTIDs.includes(searchResult.fromTID)) {
                     continue;
@@ -348,7 +380,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                     expanded: false,
                     hidden: false
                 };
-                const source = await searchResultToDataSource(searchResult);
+                const source = await searchResultToDataSource(searchResult, undefined, signal);
                 if (source && source.length > 0) {
                     const dcmtMasters = [];
                     // Check once if this document type can have master relations (for inverted mode)
@@ -576,7 +608,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             }
             const dtd = await DcmtTypeListCacheService.GetAsync(dcmt.TID);
             // Parse document values
-            const docValues = await searchResultToDataSource(result);
+            const docValues = await searchResultToDataSource(result, undefined, abortController.signal);
             const docRow = docValues.length > 0 ? docValues[0] : undefined;
             // Generate unique GUID for this container
             const containerGUID = genUniqueId();
@@ -585,16 +617,21 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             // ========================================================================
             if (isForMaster && !invertMasterNavigation) {
                 // Carica i master documents
-                const masterDocs = await getMasterDcmtsAsync(dcmt.TID, dcmt.DID, maxDepthLevel);
+                const masterDocs = await getMasterDcmtsAsync(dcmt.TID, dcmt.DID, maxDepthLevel, abortController.signal);
                 // Per ogni master, carica i suoi detail (incluso il documento corrente)
                 for (const masterContainer of masterDocs) {
+                    if (abortController.signal.aborted)
+                        break;
                     if (!masterContainer.items)
                         continue;
                     // Per ogni master document nel container, carica i detail
                     for (const masterDoc of masterContainer.items) {
+                        // Interruzione richiesta dall'utente: mantiene i dati già calcolati
+                        if (abortController.signal.aborted)
+                            break;
                         if (masterDoc.tid && masterDoc.did) {
                             // Carica i detail del master (incluso il documento di partenza)
-                            const detailDocs = await getDetailDcmtsAsync(masterDoc.tid, masterDoc.did, 1);
+                            const detailDocs = await getDetailDcmtsAsync(masterDoc.tid, masterDoc.did, 1, abortController.signal);
                             masterDoc.items = detailDocs;
                             masterDoc.itemsCount = detailDocs.length;
                             masterDoc.isLoaded = true;
@@ -627,8 +664,8 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             else {
                 // Load related documents (detail or master based on isForMaster flag)
                 const relatedDocs = isForMaster
-                    ? await getMasterDcmtsAsync(dcmt.TID, dcmt.DID, maxDepthLevel)
-                    : await getDetailDcmtsAsync(dcmt.TID, dcmt.DID, maxDepthLevel);
+                    ? await getMasterDcmtsAsync(dcmt.TID, dcmt.DID, maxDepthLevel, abortController.signal)
+                    : await getDetailDcmtsAsync(dcmt.TID, dcmt.DID, maxDepthLevel, abortController.signal);
                 // Se showMainDocument è false, mostra i container dei dettagli direttamente sotto il container principale
                 if (!showMainDocument) {
                     // Check if a container for this TID already exists in the tree
@@ -775,8 +812,15 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             // Check recursively if there are any actual documents
             return hasNoActualDocuments(container.items);
         });
+        // Calcolo interrotto dall'utente: mostra solo ciò che è stato calcolato,
+        // senza notificare l'assenza di correlazioni (il risultato è parziale, non definitivo)
+        const wasStopped = abortController.signal.aborted;
+        if (wasStopped) {
+            setLoadStoppedByUser(true);
+            onCalculationStopped?.();
+        }
         // If no relations found, notify parent
-        if (hasNoRelations && onNoRelationsFound) {
+        if (!wasStopped && hasNoRelations && onNoRelationsFound) {
             onNoRelationsFound();
         }
         // Update metadata error count state
@@ -804,7 +848,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
         // Now it will correctly detect expanded nodes and add infoMessage if all children are hidden
         const processedTree = updateHiddenProperty(expandedTree);
         setTreeData(processedTree);
-    }, [inputDcmts, dcmtTypes, maxDepthLevel, isForMaster, invertMasterNavigation, getDetailDcmtsAsync, getMasterDcmtsAsync, abortController, updateHiddenProperty, showMainDocument, labelMainContainer, onNoRelationsFound]);
+    }, [inputDcmts, dcmtTypes, maxDepthLevel, isForMaster, invertMasterNavigation, getDetailDcmtsAsync, getMasterDcmtsAsync, abortController, updateHiddenProperty, showMainDocument, labelMainContainer, onNoRelationsFound, onCalculationStopped]);
     /**
      * Merge main tree data with additional static items
      */
@@ -1047,15 +1091,15 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                 let loadedItems = [];
                 if (isForMaster && !invertMasterNavigation) {
                     // Original mode: detail documents load detail documents (natural detail→detail navigation)
-                    loadedItems = await getDetailDcmtsAsync(node.tid, node.did, 1);
+                    loadedItems = await getDetailDcmtsAsync(node.tid, node.did, 1, newAbortController.signal);
                 }
                 else if (isForMaster) {
                     // Inverted master mode: load master documents
-                    loadedItems = await getMasterDcmtsAsync(node.tid, node.did, 1);
+                    loadedItems = await getMasterDcmtsAsync(node.tid, node.did, 1, newAbortController.signal);
                 }
                 else {
                     // Standard mode: load detail documents
-                    loadedItems = await getDetailDcmtsAsync(node.tid, node.did, 1);
+                    loadedItems = await getDetailDcmtsAsync(node.tid, node.did, 1, newAbortController.signal);
                 }
                 // Espandi automaticamente il primo container se ci sono documenti correlati
                 if (loadedItems.length > 0 && loadedItems[0].isContainer) {
@@ -1417,13 +1461,13 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                             let loadedItems = [];
                             // Carica i documenti correlati (detail o master in base alla modalità)
                             if (isForMaster && !invertMasterNavigation) {
-                                loadedItems = await getDetailDcmtsAsync(node.tid, node.did, 1);
+                                loadedItems = await getDetailDcmtsAsync(node.tid, node.did, 1, newAbortController.signal);
                             }
                             else if (isForMaster) {
-                                loadedItems = await getMasterDcmtsAsync(node.tid, node.did, 1);
+                                loadedItems = await getMasterDcmtsAsync(node.tid, node.did, 1, newAbortController.signal);
                             }
                             else {
-                                loadedItems = await getDetailDcmtsAsync(node.tid, node.did, 1);
+                                loadedItems = await getDetailDcmtsAsync(node.tid, node.did, 1, newAbortController.signal);
                             }
                             // Applica le regole di visibilità (showZeroDcmts)
                             expandedNode.items = updateHiddenProperty(loadedItems);
@@ -1524,6 +1568,10 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
         return _jsx("div", { style: { padding: '20px', textAlign: 'center' }, children: _jsx(TMWaitPanel, { title: SDKUI_Localizator.LoadingDetailDocuments, showPrimary: true, textPrimary: waitPanelTextPrimary, valuePrimary: waitPanelValuePrimary, maxValuePrimary: waitPanelMaxValuePrimary, isCancelable: true, abortController: abortController, onAbortClick: () => { setTimeout(() => { abortController.abort(); }, 1000); } }) });
     }
     if (mergedTreeData.length === 0) {
+        // Calcolo interrotto dall'utente prima di aver calcolato qualsiasi correlazione
+        if (loadStoppedByUser) {
+            return _jsx(TMToppyMessage, { message: SDKUI_Localizator.RelationsCalculationStopped });
+        }
         // Se NON isForMaster e tutti i GetMetadataAsync sono falliti
         if (!isForMaster && metadataErrorCount === inputDcmts.length) {
             return _jsx(TMToppyMessage, { message: SDKUI_Localizator.DocumentsNotAvailableOrNoCorrelations });
@@ -1534,7 +1582,8 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
         return _jsx("div", { style: { padding: '20px', textAlign: 'center', color: '#666' }, children: SDKUI_Localizator.NoRelationsAvailable });
     }
     // Se isForMaster e non ci sono master documents disponibili
-    if (isForMaster && totalMasterDocuments === 0) {
+    // (se il calcolo è stato interrotto l'albero parziale viene comunque mostrato)
+    if (isForMaster && totalMasterDocuments === 0 && !loadStoppedByUser) {
         return _jsx(TMToppyMessage, { message: SDKUI_Localizator.NoMasterDocumentsAvailable });
     }
     return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', height: '100%', minHeight: 0, width: '100%' }, children: [showExpandAllButton && (_jsxs("div", { style: { flexShrink: 0, display: 'flex', alignItems: 'center', gap: '6px', height: '40px', paddingLeft: '10px', backgroundColor: TMColors.toolbar_background }, children: [_jsx(TMTooltip, { content: expandLevel === 0

package/lib/components/features/search/TMDcmtCheckoutInfoForm.d.ts

@@ -1,8 +1,9 @@
+import React from "react";
 import { DcmtInfo } from "../../../ts";
 interface TMDcmtCheckoutInfoFormProps {
     dtdName: string;
     selectedDcmtOrFocused: DcmtInfo;
     onClose: () => void;
 }
-declare const TMDcmtCheckoutInfoForm: (props: TMDcmtCheckoutInfoFormProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMDcmtCheckoutInfoForm: (props: TMDcmtCheckoutInfoFormProps) => React.JSX.Element;
 export default TMDcmtCheckoutInfoForm;

package/lib/components/features/search/TMMetadataOutputForm.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 import { MetadataDescriptor, QueryDescriptor, SelectItem } from "@topconsultnpm/sdk-ts";
 interface TMMetadataOutputFormProps {
     /** QueryDescriptor da cui estrarre i metadati disponibili */
@@ -13,5 +14,5 @@ interface TMMetadataOutputFormProps {
     /** Callback chiamata quando l'utente conferma la selezione dei SelectItem */
     onChoose?: (selectItems: SelectItem[] | undefined) => void;
 }
-declare const TMMetadataOutputForm: (props: TMMetadataOutputFormProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMMetadataOutputForm: (props: TMMetadataOutputFormProps) => React.JSX.Element;
 export default TMMetadataOutputForm;

package/lib/components/features/search/TMMetadataSorterForm.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 import { MetadataDescriptor, OrderByItem, QueryDescriptor } from "@topconsultnpm/sdk-ts";
 interface TMMetadataSorterFormProps {
     /** QueryDescriptor da cui estrarre i metadati disponibili */
@@ -13,5 +14,5 @@ interface TMMetadataSorterFormProps {
     /** Callback chiamata quando l'utente conferma la selezione degli OrderByItem */
     onChoose?: (orderByItems: OrderByItem[] | undefined) => void;
 }
-declare const TMMetadataSorterForm: (props: TMMetadataSorterFormProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMMetadataSorterForm: (props: TMMetadataSorterFormProps) => React.JSX.Element;
 export default TMMetadataSorterForm;

package/lib/components/features/search/TMSavedQuerySelector.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { SavedQueryDescriptor } from '@topconsultnpm/sdk-ts';
-export declare const getTooltipBySqd: (sqd: SavedQueryDescriptor | undefined) => import("react/jsx-runtime").JSX.Element | null;
+export declare const getTooltipBySqd: (sqd: SavedQueryDescriptor | undefined) => React.JSX.Element | null;
 interface ITMSavedQuerySelectorProps {
     height?: string;
     items?: SavedQueryDescriptor[];
@@ -12,5 +12,5 @@ interface ITMSavedQuerySelectorProps {
     refreshFavoriteSavedQueries?: (sqd: SavedQueryDescriptor) => void;
     onRefreshData?: () => void;
 }
-declare const TMSavedQuerySelector: React.MemoExoticComponent<({ items, selectedId, allowShowSearch, height, manageDefault, onItemClick, onDeleted, refreshFavoriteSavedQueries, onRefreshData }: ITMSavedQuerySelectorProps) => import("react/jsx-runtime").JSX.Element>;
+declare const TMSavedQuerySelector: React.MemoExoticComponent<({ items, selectedId, allowShowSearch, height, manageDefault, onItemClick, onDeleted, refreshFavoriteSavedQueries, onRefreshData }: ITMSavedQuerySelectorProps) => React.JSX.Element>;
 export default TMSavedQuerySelector;

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

@@ -5,13 +5,13 @@ import TMSavedQuerySelector from './TMSavedQuerySelector';
 import TMTreeSelector from './TMTreeSelector';
 import { TabPanel, Item } from 'devextreme-react/tab-panel';
 import TMSearchQueryPanel, { refreshLastSearch } from './TMSearchQueryPanel';
-import { getSysAllDcmtsSQD, IconFilter, IconRecentlyViewed, IconSavedQuery, IconTree, mergeSearchResultsAppend, removeMruTid, SDKUI_Globals, SDKUI_Localizator, updateMruTids } from '../../../helper';
+import { getSysAllDcmtsSQD, SYS_ALL_DCMTS_SQD_ID, IconFilter, IconRecentlyViewed, IconSavedQuery, IconTree, mergeSearchResultsAppend, removeMruTid, SDKUI_Globals, SDKUI_Localizator, updateMruTids } from '../../../helper';
 import TMSearchResult from './TMSearchResult';
 import TMRecentsManager from '../../grids/TMRecentsManager';
 import { SearchResultContext } from '../../../ts';
 import { useDeviceType, DeviceType } from '../../base/TMDeviceProvider';
 import { StyledMultiViewPanel } from '../../base/Styled';
-import { useTMPanelManagerContext } from '../../layout/panelManager/TMPanelManagerContext';
+import { TMPanelManagerProvider, useTMPanelManagerContext } from '../../layout/panelManager/TMPanelManagerContext';
 import TMPanelManagerContainer from '../../layout/panelManager/TMPanelManagerContainer';
 import { TMPanelManagerWithPersistenceProvider } from '../../layout/panelManager/TMPanelManagerWithPersistenceProvider';
 import { TMExceptionBoxManager } from '../../base/TMPopUp';
@@ -32,7 +32,7 @@ const TMSearch = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTask
     const [currentSearchView, setCurrentSearchView] = useState(TMSearchViews.Search);
     const [currentSQDMode, setCurrentSQDMode] = useState(1);
     const [lastQdSearched, setLastQdSearched] = useState();
-    const [showSearchResults, setShowSearchResults] = useState(true);
+    const [showSearchResults, setShowSearchResults] = useState(!onlyShowSearchQueryPanel);
     const [maxDcmtsToBeReturned, setMaxDcmtsToBeReturned] = useState(SDKUI_Globals.userSettings.searchSettings?.maxDcmtsToBeReturned ?? 1000);
     const deviceType = useDeviceType();
     useEffect(() => {
@@ -152,6 +152,42 @@ const TMSearch = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTask
         if (sqdToBeSet)
             await setSqdAsync?.(sqdToBeSet);
     }, []);
+    // --- REFRESH DEI PANNELLI ---
+    // Scorciatoie: rilegge dal server l'elenco dei tipi documento, così le scorciatoie riflettono
+    // quelli aggiunti o rimossi. La nuova identità di mruTIDs fa ricaricare i descrittori a TMRecentsManager.
+    const refreshRecentsAsync = useCallback(async () => {
+        DcmtTypeListCacheService.RemoveAllWithoutMetadata();
+        await DcmtTypeListCacheService.GetAllWithoutMetadataAsync();
+        setMruTIDs([...SDKUI_Globals.userSettings.searchSettings.mruTIDs]);
+    }, []);
+    // Ricerche rapide: invalida la cache delle saved query e ricarica l'elenco del tipo documento corrente
+    const refreshSavedQueriesAsync = useCallback(async () => {
+        // loadDataSQDsAsync riporta la selezione sulla prima tab: il refresh non deve spostare quella scelta dall'utente
+        const sqdMode = currentSQDMode;
+        await loadDataSQDsAsync(true, fromDTD?.id ?? currentTID);
+        setCurrentSQDMode(sqdMode);
+    }, [fromDTD?.id, currentTID, currentSQDMode]);
+    // Pannello dei metadati: rilegge dal server i metadati del tipo documento e la definizione della
+    // ricerca rapida corrente, con cui il pannello ricostruisce i filtri (i valori digitati vengono persi)
+    const refreshSearchQueryPanelAsync = useCallback(async () => {
+        const tid = fromDTD?.id ?? currentTID;
+        if (!tid)
+            return;
+        const dtd = await DcmtTypeListCacheService.GetAsync(tid, true, undefined, false, true);
+        setFromDTD(dtd);
+        // Passare da undefined forza la ricostruzione dei filtri anche quando la query selezionata non cambia
+        const sqdToRestore = currentSQD;
+        SavedQueryCacheService.Remove();
+        await setSQDAsync(undefined);
+        // La ricerca di sistema non è in cache: va ricostruita, così recepisce i metadati appena riletti
+        await setSQDAsync(sqdToRestore?.id === SYS_ALL_DCMTS_SQD_ID ? await getSysAllDcmtsSQD(tid, false) : sqdToRestore);
+        // mruTIDs è tra le dipendenze perché setSQDAsync lo legge
+    }, [fromDTD?.id, currentTID, currentSQD, mruTIDs]);
+    // Prima di ogni ricerca il pannello rilegge i metadati del tipo documento: si recepisce il descrittore
+    // aggiornato, così anche il resto della vista (titoli, badge, form dei metadati) lavora sulla lista corrente
+    const handleDcmtTypeReloaded = useCallback((dtd) => {
+        setFromDTD(dtd);
+    }, []);
     const onRefreshSearchAsyncDatagrid = async () => {
         try {
             if (lastQdSearched) {
@@ -208,10 +244,11 @@ const TMSearch = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTask
             SDKUI_Globals.userSettings.searchSettings.mruTIDs = newMruTIDS;
             setMruTIDs(newMruTIDS);
         } }), [mruTIDs, currentMruTID, deviceType]);
-    const tmSearchQueryPanelElement = useMemo(() => _jsx(TMSearchQueryPanelWrapper, { passToArchiveCallback: passToArchiveCallback, isExpertMode: isExpertMode, showBackToResultButton: searchResult.length > 0, fromDTD: fromDTD, SQD: currentSQD, inputMids: inputMids, maxDcmtsToBeReturned: maxDcmtsToBeReturned, onBackToResult: () => { setCurrentSearchView(TMSearchViews.Result); }, onSearchCompleted: handleSearchCompleted, onSqdSaved: async (newSqd) => {
+    const tmSearchQueryPanelElement = useMemo(() => _jsx(TMSearchQueryPanelWrapper, { isSearchViewOnScreen: currentSearchView === TMSearchViews.Search, passToArchiveCallback: passToArchiveCallback, isExpertMode: isExpertMode, showBackToResultButton: searchResult.length > 0, fromDTD: fromDTD, SQD: currentSQD, inputMids: inputMids, maxDcmtsToBeReturned: maxDcmtsToBeReturned, onBackToResult: () => { if (onlyShowSearchQueryPanel)
+            setShowSearchResults(true); setCurrentSearchView(TMSearchViews.Result); }, onSearchCompleted: handleSearchCompleted, onRefreshRequested: refreshSearchQueryPanelAsync, onDcmtTypeReloaded: handleDcmtTypeReloaded, onSqdSaved: async (newSqd) => {
             await loadDataSQDsAsync(true, newSqd.masterTID);
             await setSQDAsync(newSqd);
-        } }), [fromDTD, showSearchResults, setShowSearchResults, currentSQD, isExpertMode, mruTIDs, searchResult, passToArchiveCallback, inputMids, maxDcmtsToBeReturned, handleSearchCompleted]);
+        } }), [fromDTD, showSearchResults, setShowSearchResults, currentSQD, currentSearchView, isExpertMode, mruTIDs, searchResult, passToArchiveCallback, inputMids, maxDcmtsToBeReturned, handleSearchCompleted, refreshSearchQueryPanelAsync, handleDcmtTypeReloaded, onlyShowSearchQueryPanel]);
     const tmSavedQuerySelectorElement = useMemo(() => _jsxs(TabPanel, { width: "100%", height: "100%", showNavButtons: true, repaintChangesOnly: true, selectedIndex: currentSQDMode, onSelectedIndexChange: (index) => setCurrentSQDMode(index), children: [(currentTID || currentSQD) ? _jsx(Item, { title: fromDTD?.nameLoc, children: _jsx(TMSavedQuerySelectorWrapper, { allowShowSearch: false, items: filteredByTIDSQDs, selectedId: currentSQD?.id, onRefreshData: () => { loadDataSQDsAsync(true); }, onItemClick: (sqd) => {
                         onSQDItemClick(sqd, setSQDAsync);
                     }, onDeleted: (sqd) => onSQDDeleted(sqd, sqd.id == currentSQD?.id ? filteredByTIDSQDs.find(o => o.id == 1) : currentSQD, setSQDAsync), refreshFavoriteSavedQueries: refreshFavoriteSavedQueries }) }) : _jsx(_Fragment, {}), _jsx(Item, { title: SDKUI_Localizator.AllFemale, children: _jsx(TMSavedQuerySelectorWrapper, { allowShowSearch: true, items: allSQDs, manageDefault: false, onItemClick: (sqd) => {
@@ -263,7 +300,14 @@ const TMSearch = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTask
         {
             id: 'TMRecentsManager',
             name: SDKUI_Localizator.Shortcuts,
-            contentOptions: { component: tmRecentsManagerElement, panelContainer: { title: SDKUI_Localizator.Shortcuts, totalItems: mruTIDs.length } },
+            contentOptions: {
+                component: tmRecentsManagerElement,
+                panelContainer: {
+                    title: SDKUI_Localizator.Shortcuts,
+                    totalItems: mruTIDs.length,
+                    onRefresh: refreshRecentsAsync
+                }
+            },
             toolbarOptions: { icon: _jsx(IconRecentlyViewed, { fontSize: 24 }), visible: true, orderNumber: 2, isActive: allInitialPanelVisibility['TMRecentsManager'] }
         },
         {
@@ -275,11 +319,33 @@ const TMSearch = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTask
         {
             id: 'TMSavedQuerySelector',
             name: SDK_Localizator.SavedQueries,
-            contentOptions: { component: tmSavedQuerySelectorElement, panelContainer: { title: SDK_Localizator.SavedQueries } },
+            contentOptions: {
+                component: tmSavedQuerySelectorElement,
+                panelContainer: {
+                    title: SDK_Localizator.SavedQueries,
+                    onRefresh: refreshSavedQueriesAsync
+                }
+            },
             toolbarOptions: { icon: _jsx(IconSavedQuery, { fontSize: 24 }), visible: true, orderNumber: 4, isActive: allInitialPanelVisibility['TMSavedQuerySelector'] }
         }
-    ], [tmTreeSelectorElement, showSearchResults, tmRecentsManagerElement, tmSearchQueryPanelElement, tmSavedQuerySelectorElement, fromDTD, mruTIDs]);
-    return (_jsxs(_Fragment, { children: [showSearchResults ? _jsx(StyledMultiViewPanel, { "$isVisible": currentSearchView === TMSearchViews.Search, children: _jsx(TMPanelManagerWithPersistenceProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'TMRecentsManager', isPersistenceEnabled: !isMobile ? hasSavedLayout() : false, persistPanelStates: !isMobile ? (state) => persistPanelStates(state) : undefined, persistedPanelStates: getPersistedPanelStates(), children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true, minPanelSizePx: !isMobile ? 250 : 150 }) }) }) : tmSearchQueryPanelElement, showSearchResults && _jsx(TMSearchResult, { isVisible: isVisible && currentSearchView === TMSearchViews.Result, context: SearchResultContext.METADATA_SEARCH, searchResults: searchResult, floatingActionConfig: floatingActionConfig, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, openInOffice: openInOffice, onRefreshSearchAsyncDatagrid: onRefreshSearchAsyncDatagrid, onClose: () => { onlyShowSearchQueryPanel ? setShowSearchResults(false) : setCurrentSearchView(TMSearchViews.Search); }, onFileOpened: onFileOpened, onTaskCreateRequest: onTaskCreateRequest, openWGsCopyMoveForm: openWGsCopyMoveForm, editPdfForm: editPdfForm, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, openFileUploaderPdfEditor: openFileUploaderPdfEditor, passToArchiveCallback: passToArchiveCallback, onSelectedTIDChanged: onCurrentTIDChangedCallback, showTodoDcmtForm: showTodoDcmtForm, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, inputDID: inputDID, formAutoOpen: formAutoOpen, fetchRemoteCertificates: fetchRemoteCertificates, graphometricManager: graphometricManager })] }));
+    ], [tmTreeSelectorElement, showSearchResults, tmRecentsManagerElement, tmSearchQueryPanelElement, tmSavedQuerySelectorElement, fromDTD, mruTIDs, refreshRecentsAsync, refreshSavedQueriesAsync]);
+    // Quando è visibile solo il pannello di ricerca (es. modale di abbinamento molti a molti) serve
+    const singlePanelVisibility = { 'TMSearchQueryPanel': true };
+    const singlePanelDimensions = { 'TMSearchQueryPanel': { width: '100%', height: '100%' } };
+    const singlePanelDefinition = useMemo(() => [
+        {
+            id: 'TMSearchQueryPanel',
+            name: fromDTD?.nameLoc ?? SDKUI_Localizator.Search_Metadata,
+            contentOptions: { component: tmSearchQueryPanelElement },
+            toolbarOptions: { icon: _jsx(IconFilter, { fontSize: 24 }), visible: false, orderNumber: 1, isActive: true }
+        }
+    ], [tmSearchQueryPanelElement, fromDTD]);
+    return (_jsxs(_Fragment, { children: [onlyShowSearchQueryPanel
+                // Il pannello di ricerca resta montato anche quando sono a schermo i risultati: tornando
+                // indietro si ritrova l'ultima ricerca impostata, senza rimontaggi che ne resettano i filtri
+                ? _jsx(StyledMultiViewPanel, { "$isVisible": !showSearchResults, children: _jsx(TMPanelManagerProvider, { panels: singlePanelDefinition, initialVisibility: singlePanelVisibility, defaultDimensions: singlePanelDimensions, initialDimensions: singlePanelDimensions, initialMobilePanelId: 'TMSearchQueryPanel', children: tmSearchQueryPanelElement }) })
+                : _jsx(StyledMultiViewPanel, { "$isVisible": currentSearchView === TMSearchViews.Search, children: _jsx(TMPanelManagerWithPersistenceProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'TMRecentsManager', isPersistenceEnabled: !isMobile ? hasSavedLayout() : false, persistPanelStates: !isMobile ? (state) => persistPanelStates(state) : undefined, persistedPanelStates: getPersistedPanelStates(), children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true, minPanelSizePx: !isMobile ? 250 : 150 }) }) }), showSearchResults && _jsx(TMSearchResult, { isVisible: isVisible && currentSearchView === TMSearchViews.Result, context: SearchResultContext.METADATA_SEARCH, searchResults: searchResult, floatingActionConfig: floatingActionConfig, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, openInOffice: openInOffice, onRefreshSearchAsyncDatagrid: onRefreshSearchAsyncDatagrid, onClose: () => { if (onlyShowSearchQueryPanel)
+                    setShowSearchResults(false); setCurrentSearchView(TMSearchViews.Search); }, backCaption: onlyShowSearchQueryPanel ? SDKUI_Localizator.BackToSearch : undefined, onFileOpened: onFileOpened, onTaskCreateRequest: onTaskCreateRequest, openWGsCopyMoveForm: openWGsCopyMoveForm, editPdfForm: editPdfForm, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, openFileUploaderPdfEditor: openFileUploaderPdfEditor, passToArchiveCallback: passToArchiveCallback, onSelectedTIDChanged: onCurrentTIDChangedCallback, showTodoDcmtForm: showTodoDcmtForm, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, inputDID: inputDID, formAutoOpen: formAutoOpen, fetchRemoteCertificates: fetchRemoteCertificates, graphometricManager: graphometricManager })] }));
 };
 export default TMSearch;
 const TMTreeSelectorWrapper = ({ isMobile, onSelectedTIDChanged }) => {
@@ -298,11 +364,11 @@ const TMRecentsManagerWrapper = ({ mruTIDs, currentMruTID, deviceType, onSelecte
             onDeletedTID?.(tid);
         } }));
 };
-const TMSearchQueryPanelWrapper = ({ fromDTD, SQD, isExpertMode, showBackToResultButton, onSearchCompleted, onSqdSaved, onBackToResult, passToArchiveCallback, inputMids, maxDcmtsToBeReturned }) => {
+const TMSearchQueryPanelWrapper = ({ isSearchViewOnScreen, fromDTD, SQD, isExpertMode, showBackToResultButton, onSearchCompleted, onSqdSaved, onBackToResult, passToArchiveCallback, inputMids, maxDcmtsToBeReturned, onRefreshRequested, onDcmtTypeReloaded }) => {
     const { setPanelVisibilityById, toggleMaximize, countVisibleLeafPanels } = useTMPanelManagerContext();
     const deviceType = useDeviceType();
     const isMobile = deviceType === DeviceType.MOBILE;
-    return (_jsx(TMSearchQueryPanel, { onClosePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => setPanelVisibilityById('TMSearchQueryPanel', false) : undefined, allowMaximize: !isMobile && countVisibleLeafPanels() > 1, onMaximizePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => toggleMaximize("TMSearchQueryPanel") : undefined, isExpertMode: isExpertMode, fromDTD: fromDTD, SQD: SQD, inputMids: inputMids, onSearchCompleted: onSearchCompleted, onSqdSaved: onSqdSaved, showBackToResultButton: showBackToResultButton, onBackToResult: onBackToResult, passToArchiveCallback: passToArchiveCallback, maxDcmtsToBeReturned: maxDcmtsToBeReturned }));
+    return (_jsx(TMSearchQueryPanel, { isSearchViewOnScreen: isSearchViewOnScreen, onClosePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => setPanelVisibilityById('TMSearchQueryPanel', false) : undefined, allowMaximize: !isMobile && countVisibleLeafPanels() > 1, onMaximizePanel: (!isMobile && countVisibleLeafPanels() > 1) ? () => toggleMaximize("TMSearchQueryPanel") : undefined, isExpertMode: isExpertMode, fromDTD: fromDTD, SQD: SQD, inputMids: inputMids, onSearchCompleted: onSearchCompleted, onRefreshRequested: onRefreshRequested, onDcmtTypeReloaded: onDcmtTypeReloaded, onSqdSaved: onSqdSaved, showBackToResultButton: showBackToResultButton, onBackToResult: onBackToResult, passToArchiveCallback: passToArchiveCallback, maxDcmtsToBeReturned: maxDcmtsToBeReturned }));
 };
 const TMSavedQuerySelectorWrapper = ({ items, selectedId, allowShowSearch, manageDefault, onRefreshData, onItemClick, onDeleted, refreshFavoriteSavedQueries }) => {
     const { setPanelVisibilityById } = useTMPanelManagerContext();

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

@@ -58,10 +58,12 @@ const TMSearchQueryEditor = ({ qd, dcmtTypesList = [], isExpertMode = SDKUI_Glob
     const handleItemSelect = useCallback((tid, mid) => {
         if (currentEditingMID !== mid)
             setCurrentEditingMID(mid);
-        if (!focusedTidMid || mid !== focusedTidMid.mid) {
-            setFocusedTidMid({ tid: tid, mid: mid });
+        if (!focusedTidMid || mid !== focusedTidMid.mid || tid !== focusedTidMid.tid) {
+            const newFocusedTidMid = { tid: tid, mid: mid };
+            setFocusedTidMid(newFocusedTidMid);
+            onFocusedMetadataChanged?.(newFocusedTidMid);
         }
-    }, [currentEditingMID, focusedTidMid]);
+    }, [currentEditingMID, focusedTidMid, onFocusedMetadataChanged]);
     const handleAdvancedMenuClick = useCallback((e) => {
         if (e.button === AdvancedMenuButtons.MakeEditable && e.mid) {
             addOrRemoveEditableList(e.mid);

package/lib/components/features/search/TMSearchQueryPanel.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { DcmtTypeDescriptor, QueryDescriptor, SavedQueryDescriptor, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
 interface ITMSearchQueryPanelProps {
+    isSearchViewOnScreen?: boolean;
     fromDTD?: DcmtTypeDescriptor;
     SQD?: SavedQueryDescriptor;
     isExpertMode?: boolean;
@@ -21,10 +22,19 @@ interface ITMSearchQueryPanelProps {
         value: string;
     }>, tid?: number) => void;
     maxDcmtsToBeReturned?: number;
+    onRefreshRequested?: () => Promise<void>;
+    /** Notifica il tipo documento riletto dal server prima di ogni ricerca, così il chiamante allinea il proprio descrittore */
+    onDcmtTypeReloaded?: (dtd: DcmtTypeDescriptor) => void;
 }
 declare const TMSearchQueryPanel: React.FunctionComponent<ITMSearchQueryPanelProps>;
 export default TMSearchQueryPanel;
 export declare const refreshLastSearch: (qd: QueryDescriptor | undefined) => Promise<SearchResultDescriptor[] | undefined>;
-export declare const StyledToppyTextContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never> & Partial<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>>> & string;
-export declare const StyledToppyText: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, never> & Partial<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, never>>> & string;
-export declare const StyledToppyImage: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, never> & Partial<Pick<React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, never>>> & string;
+export declare const StyledToppyTextContainer: import("styled-components/dist/types").IStyledComponentBase<"web", Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "style"> & {
+    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
+}> & string;
+export declare const StyledToppyText: import("styled-components/dist/types").IStyledComponentBase<"web", Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "style"> & {
+    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
+}> & string;
+export declare const StyledToppyImage: import("styled-components/dist/types").IStyledComponentBase<"web", Omit<React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, "style"> & {
+    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
+}> & string;