@topconsultnpm/sdkui-react 6.21.0-dev1.6 → 6.21.0-dev1.8

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

@@ -1018,8 +1018,8 @@ const TMDcmtForm = ({ TID, DID, groupId, layoutMode = LayoutModes.Update, formMo
         }
     }, [TID, DID, triggerBlogRefresh, onRefreshBlogDatagrid]);
     const checkoutBadge = useMemo(() => {
-        const { cicoEnabled, checkoutStatus } = getDcmtCicoStatus(formData, allUsers, fromDTD);
-        if (!cicoEnabled || !checkoutStatus.isCheckedOut)
+        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' }) }) }));
     }, [formData, fromDTD, isMobile]);

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

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { DcmtTypeListCacheService, LayoutModes, SDK_Localizator } from '@topconsultnpm/sdk-ts';
+import { DcmtTypeListCacheService, LayoutModes, SDK_Globals, SDK_Localizator } from '@topconsultnpm/sdk-ts';
 import TMRelationViewer from './TMRelationViewer';
 import TMContextMenu from '../../NewComponents/ContextMenu/TMContextMenu';
-import { IconMultipleSelection, IconCheckFile, IconDetailDcmts, SDKUI_Localizator, IconMenuVertical, IconDataList, IconPreview, IconSearchCheck, IconBoard, IconDcmtTypeSys, IconShow, getMoreInfoTasksForDocument, isApprovalWorkflowView } from '../../../helper';
+import { IconMultipleSelection, IconCheckFile, IconDetailDcmts, SDKUI_Localizator, IconMenuVertical, IconDataList, IconPreview, IconSearchCheck, IconBoard, IconDcmtTypeSys, IconShow, getMoreInfoTasksForDocument, isApprovalWorkflowView, searchResultToMetadataValues } from '../../../helper';
 import { FormModes, SearchResultContext } from '../../../ts';
 import { TMColors } from '../../../utils/theme';
 import ShowAlert from '../../base/TMAlert';
@@ -29,11 +29,60 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
     const [contextMenuPosition, setContextMenuPosition] = useState({ x: 0, y: 0 });
     const [dtdFocused, setDtdFocused] = useState();
     const [refreshKey, setRefreshKey] = useState(0);
+    // Stato per gestire la transizione fluida durante il refresh
+    const [isRefreshing, setIsRefreshing] = useState(false);
+    /** State for transformed focusedItem metadata values (similar to formData in TMDcmtForm) */
+    const [focusedItemFormData, setFocusedItemFormData] = useState([]);
+    // Trigger operationItems refresh (after file substitution, etc.)
+    const [refreshOperationsTrigger, setRefreshOperationsTrigger] = useState(0);
+    // Increments trigger counter to force operationItems to re-calculate
+    const onRefreshOperationsDatagrid = useCallback(async () => {
+        setRefreshOperationsTrigger(prev => prev + 1);
+    }, []);
+    // Refresh con transizione fluida: fade-out -> update -> fade-in
     const onRefreshSearch = async () => {
         await dcmtUtility?.onRefreshPreviewForm?.();
-        // forza il refresh del form di dettaglio al salvataggio
-        setRefreshKey(prev => prev + 1);
+        // Avvia fade-out
+        setIsRefreshing(true);
+        // Attendi che il fade-out sia completato, poi aggiorna
+        setTimeout(() => {
+            setRefreshKey(prev => prev + 1);
+            onRefreshOperationsDatagrid();
+            // Attendi un po' per dare tempo al re-render, poi fade-in
+            setTimeout(() => {
+                setIsRefreshing(false);
+            }, 300); // Durata extra dell'overlay dopo l'update
+        }, 200); // Durata del fade-out
     };
+    useEffect(() => {
+        const fetchFocusedItemMetadata = async () => {
+            if (!focusedItem?.tid || !focusedItem?.did) {
+                setFocusedItemFormData([]);
+                return;
+            }
+            try {
+                const tid = focusedItem?.tid;
+                const did = focusedItem?.did;
+                const metadata = await SDK_Globals.tmSession?.NewSearchEngine().GetMetadataAsync(tid, did, true);
+                // Transform metadata to MetadataValueDescriptorEx[] (similar to setMetadataList in TMDcmtForm)
+                if (metadata) {
+                    const dtdResult = metadata.dtdResult;
+                    const rows = dtdResult?.rows ? dtdResult.rows[0] : [];
+                    const mids = metadata.selectMIDs;
+                    // Get DTD with metadata descriptors
+                    const dtdWithMetadata = await DcmtTypeListCacheService.GetWithNotGrantedAsync(tid, did, metadata);
+                    const mdList = dtdWithMetadata?.metadata ?? [];
+                    const metadataList = searchResultToMetadataValues(tid, dtdResult, rows, mids, mdList, LayoutModes.Update);
+                    setFocusedItemFormData(structuredClone(metadataList));
+                }
+            }
+            catch (error) {
+                console.error('Error fetching focusedItem metadata:', error);
+                setFocusedItemFormData([]);
+            }
+        };
+        fetchFocusedItemMetadata();
+    }, [focusedItem?.tid, focusedItem?.did, refreshOperationsTrigger]);
     // Load dtdFocused when focusedItem changes
     useEffect(() => {
         const loadDtdFocused = async () => {
@@ -83,14 +132,23 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
             currentMetadataValues: [],
             allUsers: [],
             // searchResult: selectedSearchResult,
-            datagridUtility,
+            datagridUtility: {
+                visibleItems: [],
+                onRefreshSearchAsyncDatagrid: datagridUtility?.onRefreshSearchAsyncDatagrid,
+                onRefreshDataRowsAsync: datagridUtility?.onRefreshDataRowsAsync,
+                refreshFocusedDataRowAsync: datagridUtility?.refreshFocusedDataRowAsync,
+                onRefreshBlogDatagrid: datagridUtility?.onRefreshBlogDatagrid,
+                onRefreshPreviewDatagrid: datagridUtility?.onRefreshPreviewDatagrid,
+                refreshOperationsTrigger,
+                onRefreshOperationsDatagrid,
+            },
             dcmtUtility: {
                 approvalVID: dcmtUtility?.approvalVID,
-                dcmtDataRowForCicoStatus: dcmtUtility?.dcmtDataRowForCicoStatus,
+                dcmtDataRowForCicoStatus: focusedItemFormData, // Passa i metadata trasformati del focusedItem per le operazioni di CICO
                 selectedDcmtSearchResultRelations: dcmtUtility?.selectedDcmtSearchResultRelations,
                 dcmtTIDHasDetailRelations: dcmtUtility?.dcmtTIDHasDetailRelations,
                 dcmtTIDHasMasterRelations: dcmtUtility?.dcmtTIDHasMasterRelations,
-                updateCurrentDcmt: dcmtUtility?.updateCurrentDcmt,
+                updateCurrentDcmt: onRefreshSearch,
                 onCloseDcmtForm: dcmtUtility?.onCloseDcmtForm,
                 onRefreshBlogForm: dcmtUtility?.onRefreshBlogForm,
                 onRefreshPreviewForm: onRefreshSearch,
@@ -227,11 +285,11 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
                         setContextMenuVisible(true);
                     }, children: [_jsx(TMRelationViewerWrapper, { inputDcmts: inputDcmts, isForMaster: isForMaster, showCurrentDcmtIndicator: showCurrentDcmtIndicator, showZeroDcmts: showZeroDcmts, 
                             // customItemRender={customItemRender}
-                            allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: handleSelectedItemsChanged, onNoRelationsFound: handleNoRelationsFound, onItemContextMenu: onItemContextMenu }, refreshKey), _jsx(TMContextMenu, { items: operationItems, externalControl: {
+                            allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: handleSelectedItemsChanged, onNoRelationsFound: handleNoRelationsFound, onItemContextMenu: onItemContextMenu, focusedItemFormData: focusedItemFormData }, refreshKey), _jsx(TMContextMenu, { items: operationItems, externalControl: {
                                 visible: contextMenuVisible,
                                 position: contextMenuPosition,
                                 onClose: () => setContextMenuVisible(false)
-                            } })] }) }), [inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, allowMultipleSelection, focusedItem, selectedItems, handleFocusedItemChanged, handleSelectedItemsChanged, handleNoRelationsFound, onItemContextMenu, contextMenuVisible, contextMenuPosition, refreshKey]);
+                            } })] }) }), [inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, allowMultipleSelection, focusedItem, selectedItems, handleFocusedItemChanged, handleSelectedItemsChanged, handleNoRelationsFound, onItemContextMenu, contextMenuVisible, contextMenuPosition, refreshKey, focusedItemFormData]);
     const tmFormOrResult = useMemo(() => _jsx(TMFormOrResultWrapper, { deviceType: deviceType, focusedItem: focusedItem, onTaskCreateRequest: onTaskCreateRequest, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest }, refreshKey), [focusedItem, deviceType, allTasks, handleNavigateToWGs, handleNavigateToDossiers, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshAfterAddDcmtToFavs, refreshKey]);
     const initialPanelDimensions = {
         'tmTreeView': { width: '50%', height: '100%' },
@@ -309,7 +367,28 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
             toolbarOptions: { icon: _jsx(IconSearchCheck, { fontSize: 24 }), visible: false, orderNumber: 2, isActive: allInitialPanelVisibility['tmFormOrResult'] }
         }
     ], [tmTreeView, tmFormOrResult, focusedItem?.isDcmt, dtdMaster]);
-    return (_jsxs("div", { style: { width: '100%', height: '100%', position: 'relative' }, children: [isCheckingFirstLoad && (_jsx(Spinner, { description: SDKUI_Localizator.Loading, flat: true })), _jsxs("div", { style: isCheckingFirstLoad ? { position: 'absolute', width: 0, height: 0, overflow: 'hidden', opacity: 0, pointerEvents: 'none' } : { width: '100%', height: '100%' }, children: [_jsx(TMPanelManagerProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'tmTreeView', children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true }) }), renderDcmtOperations, renderFloatingBar] })] }));
+    return (_jsxs("div", { style: { width: '100%', height: '100%', position: 'relative' }, children: [isCheckingFirstLoad && (_jsx(Spinner, { description: SDKUI_Localizator.Loading, flat: true })), _jsxs("div", { style: isCheckingFirstLoad ? { position: 'absolute', width: 0, height: 0, overflow: 'hidden', opacity: 0, pointerEvents: 'none' } : { width: '100%', height: '100%' }, children: [_jsx(TMPanelManagerProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'tmTreeView', children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true }) }), _jsxs("div", { style: {
+                            position: 'absolute',
+                            top: 0,
+                            left: 0,
+                            right: 0,
+                            bottom: 0,
+                            backgroundColor: 'rgba(255, 255, 255, 0.7)',
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                            opacity: isRefreshing ? 1 : 0,
+                            pointerEvents: isRefreshing ? 'auto' : 'none',
+                            transition: 'opacity 200ms ease-in-out',
+                            zIndex: 10,
+                        }, children: [_jsx("div", { style: {
+                                    width: 40,
+                                    height: 40,
+                                    border: '3px solid #e0e0e0',
+                                    borderTopColor: TMColors.primaryColor,
+                                    borderRadius: '50%',
+                                    animation: 'spin 0.8s linear infinite',
+                                } }), _jsx("style", { children: `@keyframes spin { to { transform: rotate(360deg); } }` })] }), renderDcmtOperations, renderFloatingBar] })] }));
 };
 export default TMMasterDetailDcmts;
 /**
@@ -318,7 +397,7 @@ export default TMMasterDetailDcmts;
  * - Panel visibility toggling
  * - Focus delay handling
  */
-const TMRelationViewerWrapper = ({ inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, customItemRender, allowMultipleSelection, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onNoRelationsFound, onItemContextMenu }) => {
+const TMRelationViewerWrapper = ({ inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, customItemRender, allowMultipleSelection, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onNoRelationsFound, onItemContextMenu, focusedItemFormData }) => {
     const { setPanelVisibilityById, setToolbarButtonVisibility } = useTMPanelManagerContext();
     // Handle focused item changes with panel visibility management
     const handleFocusedItemChanged = useCallback((item) => {
@@ -349,7 +428,7 @@ const TMRelationViewerWrapper = ({ inputDcmts, isForMaster, showCurrentDcmtIndic
             onItemContextMenu?.(item, e);
         }, 100);
     }, [onItemContextMenu, handleFocusedItemChanged]);
-    return (_jsx(TMRelationViewer, { inputDcmts: inputDcmts, isForMaster: isForMaster, showCurrentDcmtIndicator: showCurrentDcmtIndicator, initialShowZeroDcmts: showZeroDcmts, customItemRender: customItemRender, allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: onSelectedItemsChanged, maxDepthLevel: 1, invertMasterNavigation: false, onNoRelationsFound: onNoRelationsFound, onItemContextMenu: onContextMenu }));
+    return (_jsx(TMRelationViewer, { inputDcmts: inputDcmts, isForMaster: isForMaster, showCurrentDcmtIndicator: showCurrentDcmtIndicator, initialShowZeroDcmts: showZeroDcmts, customItemRender: customItemRender, allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: onSelectedItemsChanged, maxDepthLevel: 1, invertMasterNavigation: false, onNoRelationsFound: onNoRelationsFound, onItemContextMenu: onContextMenu, focusedItemFormData: focusedItemFormData }));
 };
 const TMFormOrResultWrapper = ({ deviceType, focusedItem, onTaskCreateRequest, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, onRefreshAfterAddDcmtToFavs, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshSearchAsyncDatagrid }) => {
     const { setPanelVisibilityById } = useTMPanelManagerContext();

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

@@ -1,6 +1,6 @@
 import React from 'react';
 import { DcmtTypeDescriptor, SearchResultDescriptor, DataColumnDescriptor } from "@topconsultnpm/sdk-ts";
-import { DcmtInfo } from '../../../ts';
+import { DcmtInfo, MetadataValueDescriptorEx } from '../../../ts';
 import { ITMTreeItem } from '../../base/TMTreeView';
 /**
  * Tree item structure for relations
@@ -104,6 +104,11 @@ export interface TMRelationViewerProps {
      * Use to show a context menu.
      */
     onItemContextMenu?: (item: RelationTreeItem, e: React.MouseEvent) => void;
+    /**
+     * Metadata values for the focused item
+     * (used in master-detail context)
+     */
+    focusedItemFormData?: MetadataValueDescriptorEx[];
 }
 /**
  * Check if document type has detail relations

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

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React, { useCallback, useEffect, useMemo, useState } from 'react';
-import { DcmtTypeListCacheService, SDK_Globals, DataColumnTypes, MetadataFormats, SystemMIDs, MetadataDataDomains, RelationCacheService, RelationTypes } from "@topconsultnpm/sdk-ts";
-import { genUniqueId, IconFolder, IconBackhandIndexPointingRight, IconCircleInfo } from '../../../helper';
+import { DcmtTypeListCacheService, SDK_Globals, DataColumnTypes, MetadataFormats, SystemMIDs, MetadataDataDomains, RelationCacheService, RelationTypes, UserListCacheService } from "@topconsultnpm/sdk-ts";
+import { genUniqueId, IconFolder, IconBackhandIndexPointingRight, IconCircleInfo, getDcmtCicoStatus } from '../../../helper';
 import { TMColors } from '../../../utils/theme';
 import { StyledDivHorizontal, StyledBadge } from '../../base/Styled';
 import TMTreeView from '../../base/TMTreeView';
@@ -136,7 +136,7 @@ export const searchResultToDataSource = async (searchResult, hideSysMetadata) =>
     }
     return output;
 };
-const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndicator = true, allowShowZeroDcmts = true, initialShowZeroDcmts = false, allowedTIDs, allowMultipleSelection = false, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onDocumentDoubleClick, customItemRender, customDocumentStyle, customMainContainerContent, customDocumentContent, showMetadataNames = false, maxDepthLevel = 2, invertMasterNavigation = true, additionalStaticItems, showMainDocument = true, labelMainContainer, onNoRelationsFound, onItemContextMenu, }) => {
+const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndicator = true, allowShowZeroDcmts = true, initialShowZeroDcmts = false, allowedTIDs, allowMultipleSelection = false, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onDocumentDoubleClick, customItemRender, customDocumentStyle, customMainContainerContent, customDocumentContent, showMetadataNames = false, maxDepthLevel = 2, invertMasterNavigation = true, additionalStaticItems, showMainDocument = true, labelMainContainer, onNoRelationsFound, onItemContextMenu, focusedItemFormData = [] }) => {
     // State
     const [dcmtTypes, setDcmtTypes] = useState([]);
     const [treeData, setTreeData] = useState([]);
@@ -160,6 +160,16 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
     const userInteractedWithStaticItemsRef = React.useRef(false);
     // Ref to track the last inputKey for which we set the focused item
     const lastFocusedInputRef = React.useRef('');
+    // State for all users (used for checkout status display)
+    const [allUsers, setAllUsers] = useState([]);
+    // Load all users for checkout status resolution
+    useEffect(() => {
+        const fetchAllUsers = async () => {
+            const users = await UserListCacheService.GetAllAsync();
+            setAllUsers(users ?? []);
+        };
+        fetchAllUsers();
+    }, []);
     /**
      * Generate a stable key from inputDcmts to detect real changes
      */
@@ -234,6 +244,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                         dcmtDetails.push({
                             tid: tid,
                             did: did,
+                            dtd: dtd,
                             isLogDel: isLogDel,
                             key: `${tid}_${did}_${searchResult.relationID}_${mTID}_${mDID}_${rowGUID}`,
                             isDcmt: true,
@@ -247,7 +258,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                             expanded: false,
                             hidden: false,
                             name: row?.SYS_Abstract?.value || row?.SYS_SUBJECT?.value || `Documento ${did}`,
-                            fileExt: row?.FILEEXT?.value
+                            fileExt: row?.FILEEXT?.value,
                             // Note: Recursive loading on expansion is handled by calculateItemsForNode
                         });
                     }
@@ -260,7 +271,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             console.error('❌ Error loading detail documents:', error);
         }
         return items;
-    }, [allowedTIDs]);
+    }, [allowedTIDs, focusedItemFormData, focusedItem?.dtd?.id]);
     /**
      * Recursively retrieve master documents
      */
@@ -319,6 +330,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                         dcmtMasters.push({
                             tid: tid,
                             did: did,
+                            dtd: dtd,
                             isLogDel: isLogDel,
                             key: `${tid}_${did}_${searchResult.relationID}_${dTID}_${dDID}_${rowGUID}`,
                             isDcmt: true,
@@ -609,6 +621,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
                         name: docRow?.SYS_Abstract?.value || docRow?.SYS_SUBJECT?.value || `Documento ${isForMaster ? 'Dettaglio' : 'Master'}`,
                         tid: dcmt.TID,
                         did: dcmt.DID,
+                        dtd: dtd,
                         isDcmt: true,
                         isContainer: false,
                         expanded: false,
@@ -1080,8 +1093,31 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
         const metadataContent = customDocumentContent
             ? customDocumentContent(item, defaultMetadataContent || _jsx(_Fragment, {}))
             : defaultMetadataContent;
-        return (_jsxs("div", { onDoubleClick: handleDoubleClick, style: documentStyle, children: [item.did && item.tid && showCurrentDcmtIndicator && inputDcmts?.some(d => d.DID === item.did && d.TID === item.tid) ? _jsx(IconBackhandIndexPointingRight, { fontSize: 22, overflow: 'visible' }) : _jsx(_Fragment, {}), item.values && (_jsx(TMDcmtIcon, { tid: item.values?.TID?.value, did: item.values?.DID?.value, fileExtension: item.values?.FILEEXT?.value, fileCount: item.values?.FILECOUNT?.value, isLexProt: item.values?.IsLexProt?.value, isMail: item.values?.ISMAIL?.value, isShared: item.values?.ISSHARED?.value, isSigned: item.values?.ISSIGNED?.value, downloadMode: 'openInNewWindow' })), metadataContent] }));
-    }, [onDocumentDoubleClick, showCurrentDcmtIndicator, inputDcmts, customMainContainerContent, customDocumentStyle, customDocumentContent, showMetadataNames, showMainDocument]);
+        // Calculate checkout status for non-root documents
+        let checkoutStatusIcon = null;
+        if (item.values && item.dtd) {
+            // Convert item.values to flat format expected by getDcmtCicoStatus
+            const flatValues = {};
+            if (item.values) {
+                for (const key of Object.keys(item.values)) {
+                    const entry = item.values[key];
+                    if (entry?.md?.id && item.tid) {
+                        // Create TID_MID key format for metadata
+                        flatValues[`${item.tid}_${entry.md.id}`] = entry.value;
+                    }
+                    // Also add direct key for system properties
+                    flatValues[key] = entry?.value;
+                }
+                flatValues.TID = item.tid;
+                flatValues.DID = item.did;
+            }
+            const { checkoutStatus } = getDcmtCicoStatus(flatValues, allUsers, item.dtd);
+            if (checkoutStatus.isCheckedOut && checkoutStatus.icon) {
+                checkoutStatusIcon = checkoutStatus.icon;
+            }
+        }
+        return (_jsxs("div", { onDoubleClick: handleDoubleClick, style: documentStyle, children: [item.did && item.tid && showCurrentDcmtIndicator && inputDcmts?.some(d => d.DID === item.did && d.TID === item.tid) ? _jsx(IconBackhandIndexPointingRight, { fontSize: 22, overflow: 'visible' }) : _jsx(_Fragment, {}), item.values && (_jsx(TMDcmtIcon, { tid: item.values?.TID?.value, did: item.values?.DID?.value, fileExtension: item.values?.FILEEXT?.value, fileCount: item.values?.FILECOUNT?.value, isLexProt: item.values?.IsLexProt?.value, isMail: item.values?.ISMAIL?.value, isShared: item.values?.ISSHARED?.value, isSigned: item.values?.ISSIGNED?.value, downloadMode: 'openInNewWindow' })), checkoutStatusIcon, metadataContent] }));
+    }, [onDocumentDoubleClick, showCurrentDcmtIndicator, inputDcmts, customMainContainerContent, customDocumentStyle, customDocumentContent, showMetadataNames, showMainDocument, focusedItemFormData, focusedItem?.dtd, allUsers]);
     /**
      * Wrapper renderer that handles custom rendering if provided
      */

package/lib/helper/checkinCheckoutManager.d.ts

@@ -22,7 +22,7 @@ export interface CheckoutInfo {
     checkoutFolder: string;
     checkoutName: string;
 }
-interface CheckoutStatusResult {
+export interface CheckoutStatusResult {
     isCheckedOut: boolean;
     mode: 'editMode' | 'lockMode' | '';
     version: number;

package/lib/helper/checkinCheckoutManager.js

@@ -259,13 +259,15 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
     let checkoutDate;
     let version = 1;
     let fileExt;
+    let isMetadata = false;
     // ========================================================================
-    // CASO 1: Documento come Array di MetadataValueDescriptorEx
+    // CASO 1: Documento come Array di MetadataValueDescriptorEx: Form del documento
     // ========================================================================
     // Questo formato viene utilizzato quando il documento proviene da query
     // o liste dove ogni metadato è un oggetto separato con proprietà 'md' e 'value'
     if (Array.isArray(dcmt) && dcmt.length > 0 && dcmt[0]?.md !== undefined) {
         const dcmtsArray = dcmt;
+        console.log("dcmtsArray:", dcmtsArray);
         // Estrai l'ID dell'utente che ha effettuato il checkout
         const checkoutUserIdProperty = dcmtsArray.find((item) => item.md?.name === CICO_MetadataNames.CICO_CheckoutUserID);
         const checkoutUserIdValue = checkoutUserIdProperty?.value;
@@ -279,9 +281,11 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
         version = (versionRaw != null && !isNaN(Number(versionRaw))) ? Number(versionRaw) : 1;
         const fileExtProperty = dcmtsArray.find((item) => item.mid === SystemMIDsAsNumber.FileExt);
         fileExt = fileExtProperty?.value ? fileExtProperty.value.toString() : null;
+        const fileCountProperty = dcmtsArray.find((item) => item.mid === SystemMIDsAsNumber.FileCount);
+        isMetadata = !(fileCountProperty?.value && Number(fileCountProperty.value) > 0);
     }
     // ========================================================================
-    // CASO 2: Documento come Oggetto Piatto (formato standard)
+    // CASO 2: Documento come Oggetto Piatto (formato standard): Risultato della ricerca
     // ========================================================================
     // Questo formato viene utilizzato quando il documento ha proprietà dirette
     // nel formato chiave-valore: TID, DID, e "TID_MetadataID" per i metadati
@@ -290,6 +294,8 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
         const CICO_CheckoutUserID_Meta = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_CheckoutUserID);
         const CICO_CheckoutDate_Meta = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_CheckoutDate);
         const CICO_Version_Meta = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_Version);
+        const fileCountValue = dcmt.FILECOUNT != null ? Number(dcmt.FILECOUNT) : NaN;
+        isMetadata = isNaN(fileCountValue) || fileCountValue <= 0;
         fileExt = dcmt.FILEEXT ? dcmt.FILEEXT.toString() : null;
         // Estrai l'ID dell'utente che ha effettuato il checkout
         if (CICO_CheckoutUserID_Meta?.id) {
@@ -310,6 +316,15 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
         }
     }
     // ========================================================================
+    // EARLY RETURN: Documento di soli metadati (senza file)
+    // ========================================================================
+    if (isMetadata) {
+        return {
+            cicoEnabled: false,
+            checkoutStatus: { isCheckedOut: false, mode: '', version: 1, icon: null, editLockTooltipText: null }
+        };
+    }
+    // ========================================================================
     // COSTRUZIONE DELLO STATO DI CHECKOUT
     // ========================================================================
     let checkoutStatus = {
@@ -345,8 +360,8 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
     // RESTITUZIONE RISULTATO FINALE
     // ========================================================================
     return {
-        // CICO è abilitato se configurato nel DTD e l'utente ha i permessi
-        cicoEnabled: cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes && fileExt !== null && fileExt !== '',
+        // CICO è abilitato se configurato nel DTD, l'utente ha i permessi e il documento non è di soli metadati
+        cicoEnabled: cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes && fileExt !== null && fileExt !== '' && !isMetadata,
         checkoutStatus: checkoutStatus
     };
 };

package/lib/hooks/useDocumentOperations.js

@@ -105,6 +105,7 @@ export const useDocumentOperations = (props) => {
     }, [refreshOperationsTrigger]);
     // Context helpers
     const isDcmtFormContext = context === SearchResultContext.DCMT_FORM;
+    const isMasterDetailContext = context === SearchResultContext.MASTER_DETAIL;
     const { showHistory, showHistoryCallback, hideHistoryCallback, showCheckoutInformationForm, commentFormState, hideCommentFormCallback, showCheckoutInformationFormCallback, hideCheckoutInformationFormCallback, copyCheckoutPathToClipboardCallback, handleCheckOutCallback, handleCheckInCallback, showCicoWaitPanel, cicoWaitPanelTitle, showCicoPrimaryProgress, cicoPrimaryProgressText, cicoPrimaryProgressValue, cicoPrimaryProgressMax, } = useCheckInOutOperations({
         onRefreshPreview: onRefreshPreviewCallback
     });
@@ -632,7 +633,7 @@ export const useDocumentOperations = (props) => {
     const checkinMenuItem = () => {
         // Take the first document (used for validation checks)
         let dcmt = focusedItem;
-        if (isDcmtFormContext) {
+        if (isDcmtFormContext || isMasterDetailContext) {
             dcmt = dcmtDataRowForCicoStatus;
         }
         const { cicoEnabled, checkoutStatus } = getDcmtCicoStatus(dcmt, allUsers, dtd);
@@ -1059,7 +1060,6 @@ export const useDocumentOperations = (props) => {
                 disabled: isDisabledForSingleRow() && isDisabledForMultiRow(),
                 submenu: [
                     addToFavoriteOperation(),
-                    openFormOperation(),
                     downloadFileMenuItem(),
                     downloadXMLAttachmentsMenuItem(),
                 ]
@@ -1090,6 +1090,7 @@ export const useDocumentOperations = (props) => {
                 ]
             },
             signatureMenuItem(),
+            checkinMenuItem(),
             ...((inputDcmtFormLayoutMode === LayoutModes.Update) ? [fullTextSearchMenuItem()] : []),
         ];
     };

package/package.json

@@ -1,57 +1,57 @@
 {
-    "name":  "@topconsultnpm/sdkui-react",
-    "version":  "6.21.0-dev1.6",
-    "description":  "",
-    "scripts":  {
-                    "test":  "echo \"Error: no test specified\" \u0026\u0026 exit 1",
-                    "clean":  "powershell Remove-Item lib/ -recurse",
-                    "copy-files":  "copyfiles -u 1 src/assets/*.* src/assets/ImageLibrary/*.* src/assets/thumbnails/*.* src/assets/IconsS4t/*.* src/assets/Metadata/*.* src/css/tm-sdkui.css lib/",
-                    "tm-build":  "npm run clean \u0026\u0026 tsc \u0026\u0026 npm run copy-files",
-                    "tm-watch":  "tsc -w",
-                    "tm-publish":  "npm publish --tag latest",
-                    "tm-publish_wl":  "npm publish",
-                    "storybook":  "storybook dev -p 6006",
-                    "build-storybook":  "storybook build"
-                },
-    "author":  "TopConsult",
-    "license":  "ISC",
-    "devDependencies":  {
-                            "@chromatic-com/storybook":  "^4.1.3",
-                            "@storybook/addon-docs":  "^10.1.0",
-                            "@storybook/addon-onboarding":  "^10.1.0",
-                            "@storybook/react-vite":  "^10.1.0",
-                            "@types/htmlparser2":  "^3.10.7",
-                            "@types/node":  "^20.2.5",
-                            "@types/react":  "^18.3.3",
-                            "@types/react-dom":  "^18.3.3",
-                            "copyfiles":  "^2.4.1",
-                            "esbuild":  "^0.25.0",
-                            "react":  "^18.3.1",
-                            "react-dom":  "^18.3.1",
-                            "storybook":  "^10.1.0",
-                            "typescript":  "^5.9.3",
-                            "vite":  "^6.1.1"
-                        },
-    "main":  "dist/cjs/index.js",
-    "types":  "./index.d.ts",
-    "module":  "lib/esm/index.js",
-    "files":  [
-                  "dist",
-                  "lib"
-              ],
-    "dependencies":  {
-                         "react-router-dom":  "^6.15.0",
-                         "react-pdf":  "^10.3.0",
-                         "htmlparser2":  "^10.0.0",
-                         "buffer":  "^6.0.3",
-                         "@topconsultnpm/sdk-ts":  "6.20.0",
-                         "exceljs":  "^4.4.0",
-                         "devextreme":  "25.2.4",
-                         "styled-components":  "^6.1.1",
-                         "pdfjs-dist":  "5.4.296",
-                         "devextreme-react":  "25.2.4"
-                     },
-    "overrides":  {
-                      "esbuild":  "^0.25.0"
-                  }
+    "name": "@topconsultnpm/sdkui-react",
+    "version": "6.21.0-dev1.8",
+    "description": "",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1",
+        "clean": "powershell Remove-Item lib/ -recurse",
+        "copy-files": "copyfiles -u 1 src/assets/*.* src/assets/ImageLibrary/*.* src/assets/thumbnails/*.* src/assets/IconsS4t/*.* src/assets/Metadata/*.* src/css/tm-sdkui.css lib/",
+        "tm-build": "npm run clean && tsc && npm run copy-files",
+        "tm-watch": "tsc -w",
+        "tm-publish": "npm publish --tag latest",
+        "tm-publish_wl": "npm publish",
+        "storybook": "storybook dev -p 6006",
+        "build-storybook": "storybook build"
+    },
+    "author": "TopConsult",
+    "license": "ISC",
+    "devDependencies": {
+        "@chromatic-com/storybook": "^4.1.3",
+        "@storybook/addon-docs": "^10.1.0",
+        "@storybook/addon-onboarding": "^10.1.0",
+        "@storybook/react-vite": "^10.1.0",
+        "@types/htmlparser2": "^3.10.7",
+        "@types/node": "^20.2.5",
+        "@types/react": "^18.3.3",
+        "@types/react-dom": "^18.3.3",
+        "copyfiles": "^2.4.1",
+        "esbuild": "^0.25.0",
+        "react": "^18.3.1",
+        "react-dom": "^18.3.1",
+        "storybook": "^10.1.0",
+        "typescript": "^5.9.3",
+        "vite": "^6.1.1"
+    },
+    "main": "dist/cjs/index.js",
+    "types": "./index.d.ts",
+    "module": "lib/esm/index.js",
+    "files": [
+        "dist",
+        "lib"
+    ],
+    "dependencies": {
+        "@topconsultnpm/sdk-ts": "6.21.0-dev1.2",
+        "buffer": "^6.0.3",
+        "devextreme": "25.2.4",
+        "devextreme-react": "25.2.4",
+        "exceljs": "^4.4.0",
+        "htmlparser2": "^10.0.0",
+        "pdfjs-dist": "5.4.296",
+        "react-pdf": "^10.3.0",
+        "react-router-dom": "^6.15.0",
+        "styled-components": "^6.1.1"
+    },
+    "overrides": {
+        "esbuild": "^0.25.0"
+    }
 }