@topconsultnpm/sdkui-react 6.20.0-dev1.75 → 6.20.0-dev1.76

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

@@ -806,8 +806,8 @@ const TMSearchResultGrid = ({ openInOffice, fromDTD, allUsers, inputFocusedItem,
     const [focusedItem, setFocusedItem] = useState();
     const [visibleItems, setVisibleItems] = useState([]);
     const [pageSize, setPageSize] = useState(SDKUI_Globals.userSettings.searchSettings?.pageSize ?? TMDataGridPageSize.Large);
-    const { loadDataListsAsync, renderDataListCell } = useDataListItem();
-    const { loadUsersAsync, renderUserIdViewer } = useDataUserIdItem();
+    const { loadDataListsAsync, renderDataListCell, dataListsCache } = useDataListItem();
+    const { loadUsersAsync, renderUserIdViewer, usersCache } = useDataUserIdItem();
     useEffect(() => {
         if (deepCompare(inputFocusedItem, focusedItem))
             return;
@@ -959,28 +959,104 @@ const TMSearchResultGrid = ({ openInOffice, fromDTD, allUsers, inputFocusedItem,
             return { type: 'currency', currency: "JPY" };
         return undefined;
     }, []);
+    /**
+     * Genera la configurazione delle colonne della griglia con i relativi headerFilter.
+     * Per le colonne di tipo DataList e UserID, crea headerFilter con valori leggibili (nomi/descrizioni)
+     * invece delle chiavi numeriche, migliorando l'esperienza utente durante il filtraggio.
+     */
+    const generateColumns = useCallback(() => {
+        // Verifica che esistano colonne da processare
+        if (!searchResult?.dtdResult?.columns)
+            return [];
+        // Genera chiavi univoche per ogni colonna basate sul TID del risultato
+        const uniqueKeys = generateUniqueColumnKeys(searchResult?.dtdResult?.columns, searchResult?.fromTID);
+        const cols = [];
+        // Itera su ogni colonna del risultato di ricerca
+        searchResult.dtdResult.columns.map((col, index) => {
+            // Determina se la colonna è visibile (non nascosta)
+            const isVisible = col.extendedProperties?.["Visibility"] != "Hidden";
+            // Estrae il dominio dati della colonna (es. DataList, UserID, None)
+            const dataDomain = MetadataDataDomains[(col.extendedProperties?.["DataDomain"] ?? "None")];
+            // Estrae l'ID della DataList associata (se presente)
+            const dataListID = Number(col.extendedProperties?.["DataListID"]);
+            // Estrae la modalità di visualizzazione della DataList
+            const dataListViewMode = DataListViewModes[(col.extendedProperties?.["DataListViewMode"] ?? "None")];
+            // Inizializza la configurazione del filtro header
+            let headerFilterConfig = undefined;
+            // Configurazione headerFilter per colonne DataList
+            if (dataDomain === MetadataDataDomains.DataList && dataListID) {
+                // Recupera gli elementi della DataList dalla cache
+                const dataListItems = dataListsCache.current.get(dataListID);
+                if (dataListItems && dataListItems.length > 0) {
+                    // Crea il datasource per l'headerFilter mostrando il nome (text) ma filtrando per valore (value)
+                    headerFilterConfig = {
+                        dataSource: dataListItems
+                            .filter(item => item.name != null && item.value != null)
+                            .map(item => ({
+                            text: item.name,
+                            value: item.value
+                        }))
+                    };
+                }
+            }
+            // Configurazione headerFilter per colonne UserID
+            if (dataDomain === MetadataDataDomains.UserID) {
+                // Recupera tutti gli utenti dalla cache
+                const users = Array.from(usersCache.current.values());
+                if (users.length > 0) {
+                    // Crea il datasource per l'headerFilter mostrando nome utente completo (dominio\nome)
+                    headerFilterConfig = {
+                        dataSource: users
+                            .filter(user => user.name != null && user.id != null)
+                            .map(user => ({
+                            text: user.domain ? `${user.domain}\\${user.name}` : user.name,
+                            value: user.id
+                        }))
+                    };
+                }
+            }
+            // Aggiunge la configurazione della colonna all'array
+            cols.push({
+                dataField: uniqueKeys[index],
+                dataType: dataType(col),
+                visible: isVisible,
+                cellRender: (cellData) => cellRender(cellData, dataDomain, dataListID, dataListViewMode),
+                headerFilter: headerFilterConfig,
+                caption: col.caption,
+                format: getDisplayFormat(col),
+            });
+        });
+        return cols;
+    }, [searchResult, dataType, cellRender, getDisplayFormat, dataListsCache, usersCache]);
+    /**
+     * Effect che carica i dati necessari e genera le colonne della griglia.
+     * Esegue il caricamento delle cache (DataList e UserID) in parallelo prima di generare le colonne,
+     * garantendo che gli headerFilter abbiano tutti i dati disponibili.
+     */
     useEffect(() => {
+        // Verifica che siano disponibili il tipo documento e i risultati di ricerca
         if (fromDTD === undefined || searchResult === undefined)
             return;
         const loadColumnsAndData = async () => {
-            setFocusedItem(undefined); // resetta sempre prima
-            let cols = [];
-            // Generate unique keys for all columns
-            const uniqueKeys = generateUniqueColumnKeys(searchResult?.dtdResult?.columns, searchResult?.fromTID);
+            // Resetta l'elemento focalizzato quando si caricano nuovi dati
+            setFocusedItem(undefined);
+            // Set per raccogliere gli ID univoci da precaricare
             const dataListIDs = new Set();
             const userIDs = new Set();
+            // Itera sulle colonne per identificare quali DataList devono essere caricate
             searchResult?.dtdResult?.columns?.forEach((col) => {
                 const dataDomain = MetadataDataDomains[(col.extendedProperties?.["DataDomain"] ?? "None")];
                 const dataListID = Number(col.extendedProperties?.["DataListID"]);
+                // Se la colonna è di tipo DataList, aggiunge l'ID al set per il caricamento
                 if (dataDomain === MetadataDataDomains.DataList && dataListID) {
                     dataListIDs.add(dataListID);
                 }
             });
-            await loadDataListsAsync(dataListIDs);
-            // Carica gli UserID dalle righe
+            // Itera sulle righe per identificare quali UserID devono essere caricati
             searchResult?.dtdResult?.rows?.forEach((row) => {
                 searchResult?.dtdResult?.columns?.forEach((col, colIndex) => {
                     const dataDomain = MetadataDataDomains[(col.extendedProperties?.["DataDomain"] ?? "None")];
+                    // Se la colonna è di tipo UserID, estrae l'ID dalla riga e lo aggiunge al set
                     if (dataDomain === MetadataDataDomains.UserID) {
                         const userId = Number(row[colIndex]);
                         if (userId && userId > 0) {
@@ -989,28 +1065,20 @@ const TMSearchResultGrid = ({ openInOffice, fromDTD, allUsers, inputFocusedItem,
                     }
                 });
             });
-            await loadUsersAsync(userIDs);
-            searchResult?.dtdResult?.columns?.map((col, index) => {
-                const isVisible = col.extendedProperties?.["Visibility"] != "Hidden";
-                const dataDomain = MetadataDataDomains[(col.extendedProperties?.["DataDomain"] ?? "None")];
-                const dataListID = Number(col.extendedProperties?.["DataListID"]);
-                const dataListViewMode = DataListViewModes[(col.extendedProperties?.["DataListViewMode"] ?? "None")];
-                cols.push({
-                    dataField: uniqueKeys[index],
-                    dataType: dataType(col),
-                    visible: isVisible,
-                    cellRender: (cellData) => cellRender(cellData, dataDomain, dataListID, dataListViewMode),
-                    caption: col.caption,
-                    format: getDisplayFormat(col),
-                });
-            });
+            // Carica in parallelo le cache di DataList e UserID per ottimizzare le prestazioni
+            await Promise.all([
+                loadDataListsAsync(dataListIDs),
+                loadUsersAsync(userIDs)
+            ]);
+            // Genera colonne con cache popolate per garantire headerFilter completi
+            const cols = generateColumns();
             setColumns(cols);
+            // Converte i risultati di ricerca in un array semplice per la griglia
             let newDataSource = searchResultDescriptorToSimpleArray(searchResult);
             setDataSource(newDataSource);
-            // setFocusedItem(newDataSource && newDataSource.length > 0 ? newDataSource[0] : undefined);
         };
         loadColumnsAndData();
-    }, [searchResult, fromDTD, allUsers, loadDataListsAsync]);
+    }, [searchResult, fromDTD, allUsers, loadDataListsAsync, loadUsersAsync, generateColumns]);
     useEffect(() => {
         let newDataSource = searchResultDescriptorToSimpleArray(searchResult);
         setDataSource(newDataSource);
@@ -1058,6 +1126,10 @@ const TMSearchResultGrid = ({ openInOffice, fromDTD, allUsers, inputFocusedItem,
         onDblClick();
     }, [onDblClick]);
     const dataColumns = useMemo(() => {
+        // Aspetta che le colonne siano completamente caricate
+        if (!columns || columns.length === 0) {
+            return [];
+        }
         return [
             {
                 dataType: "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topconsultnpm/sdkui-react",
-  "version": "6.20.0-dev1.75",
+  "version": "6.20.0-dev1.76",
   "description": "",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",