@topconsultnpm/sdkui-react 6.21.0-dev1.5 → 6.21.0-dev1.51

package/lib/helper/checkinCheckoutManager.js

@@ -105,7 +105,7 @@ export const updateCicoCheckoutStorageItem = (item, type, action = "addOrUpdate"
         SDKUI_Globals.userSettings.wgDraftCheckoutInfo = currentItems;
     }
 };
-export const validateCicoFileName = (source, fileName) => {
+export const validateCicoFileName = (source, fileName, checkoutDate) => {
     const archiveID = SDK_Globals.tmSession?.SessionDescr?.archiveID;
     let baseName;
     let tid;
@@ -152,6 +152,7 @@ export const validateCicoFileName = (source, fileName) => {
     const nameCheck = parts[1];
     const tidCheck = parts[2];
     const didCheck = parts[3];
+    const timestampCheck = parts[4]; // Timestamp from filename: YYYYMMDDHHmmss
     // Validation checks
     const expectedFullName = `${nameCheck}.${fileExtensionCheck}`.toLowerCase();
     const isValidName = expectedFullName === name.toLowerCase();
@@ -159,9 +160,53 @@ export const validateCicoFileName = (source, fileName) => {
     const isValidTid = tidCheck ? tid.toString() === parseInt(tidCheck, 10).toString() : false;
     const isValidArchive = archiveCheck ? archiveCheck === archiveID : false;
     const isValidExt = ext ? ext.toLowerCase() === fileExtensionCheck.toLowerCase() : false;
+    // First phase validation result
+    const isFirstPhaseValid = !!(isValidName && isValidArchive && isValidDid && isValidTid && isValidExt);
+    // Second phase: validate checkoutDate timestamp (only if first phase passed and checkoutDate is a valid string)
+    let checkoutDateValidation;
+    let isSecondPhaseValid = true;
+    if (isFirstPhaseValid && checkoutDate && typeof checkoutDate === "string") {
+        try {
+            // Convert checkoutDate to timestamp format YYYYMMDDHHmmss
+            const dt = new Date(checkoutDate);
+            // Check if date is valid
+            if (isNaN(dt.getTime())) {
+                // Skip second phase validation if date is invalid
+                console.warn("validateCicoFileName: invalid checkoutDate, skipping timestamp validation");
+            }
+            else {
+                const pad = (n) => n.toString().padStart(2, '0');
+                const expectedTimestamp = `${dt.getFullYear()}${pad(dt.getMonth() + 1)}${pad(dt.getDate())}${pad(dt.getHours())}${pad(dt.getMinutes())}${pad(dt.getSeconds())}`;
+                isSecondPhaseValid = timestampCheck === expectedTimestamp;
+                // Format dates for display: readable date + (raw timestamp)
+                const expectedDisplayDate = Globalization.getDateTimeDisplayValue(dt);
+                // Parse timestampCheck to readable format (YYYYMMDDHHmmss -> Date)
+                let currentDisplayDate = timestampCheck;
+                if (timestampCheck && timestampCheck.length === 14) {
+                    const year = parseInt(timestampCheck.substring(0, 4), 10);
+                    const month = parseInt(timestampCheck.substring(4, 6), 10) - 1;
+                    const day = parseInt(timestampCheck.substring(6, 8), 10);
+                    const hours = parseInt(timestampCheck.substring(8, 10), 10);
+                    const minutes = parseInt(timestampCheck.substring(10, 12), 10);
+                    const seconds = parseInt(timestampCheck.substring(12, 14), 10);
+                    const parsedDate = new Date(year, month, day, hours, minutes, seconds);
+                    currentDisplayDate = Globalization.getDateTimeDisplayValue(parsedDate);
+                }
+                checkoutDateValidation = {
+                    expected: `${expectedDisplayDate} (${expectedTimestamp})`,
+                    current: `${currentDisplayDate} (${timestampCheck})`,
+                    isValid: isSecondPhaseValid
+                };
+            }
+        }
+        catch (error) {
+            // If anything goes wrong, skip second phase validation
+            console.warn("validateCicoFileName: error processing checkoutDate, skipping timestamp validation", error);
+        }
+    }
     // Return validation results as an object
     return {
-        isValid: !!(isValidName && isValidArchive && isValidDid && isValidTid && isValidExt),
+        isValid: isFirstPhaseValid && isSecondPhaseValid,
         validationResults: {
             archiveID: {
                 expected: archiveID,
@@ -187,13 +232,155 @@ export const validateCicoFileName = (source, fileName) => {
                 expected: ext?.toLowerCase(),
                 current: fileExtensionCheck.toLowerCase(),
                 isValid: isValidExt
-            }
+            },
+            ...(checkoutDateValidation && { checkoutDate: checkoutDateValidation })
         }
     };
 };
+/**
+ * Rimuove il timestamp di checkout e l'estensione dal nome file se presenti.
+ * Es: checkout~Z1~(CP) CICO A~10683~9894334~20260420090234.TXT -> checkout~Z1~(CP) CICO A~10683~9894334
+ * Non lancia mai errori, ritorna il nome originale in caso di problemi.
+ */
+const stripCheckoutTimestamp = (filename) => {
+    try {
+        if (!filename || typeof filename !== 'string')
+            return filename;
+        // Check if it's a checkout filename (starts with 'checkout~')
+        if (!filename.startsWith('checkout~'))
+            return filename;
+        // Remove extension if present
+        const lastDotIndex = filename.lastIndexOf('.');
+        const nameWithoutExt = lastDotIndex !== -1 ? filename.substring(0, lastDotIndex) : filename;
+        // Check if the last part is a 14-digit timestamp
+        const lastTildeIndex = nameWithoutExt.lastIndexOf('~');
+        if (lastTildeIndex === -1)
+            return nameWithoutExt;
+        const potentialTimestamp = nameWithoutExt.substring(lastTildeIndex + 1);
+        // Validate it's a 14-digit number (YYYYMMDDHHmmss)
+        if (potentialTimestamp.length === 14 && /^\d{14}$/.test(potentialTimestamp)) {
+            // Remove the timestamp part
+            return nameWithoutExt.substring(0, lastTildeIndex);
+        }
+        return nameWithoutExt;
+    }
+    catch {
+        // Never throw, return original
+        return filename;
+    }
+};
 export const renderCicoCheckInContent = (source, selectedFilename, isValid, validationItems, color = "#996300") => {
     const fileName = source.type === 'fileItem' ? source.fileItem.name : (source.dcmtInfo.fileName ?? SDKUI_Localizator.SearchResult);
-    return _jsxs("div", { style: { width: "100%", height: "100%" }, children: [SDKUI_Localizator.CheckInElementConfirm.replaceParams(fileName), !isValid && _jsxs("div", { style: { width: "100%", height: "100%", marginTop: '15px' }, children: [_jsxs("div", { style: { display: 'flex', flexDirection: 'column' }, children: [_jsx("div", { style: { fontSize: '12px', color, marginBottom: '12px' }, children: SDKUI_Localizator.ElementNameConventionError }), _jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: '6px' }, children: [_jsxs("div", { style: { color }, children: [_jsx("strong", { style: { color }, children: SDKUI_Localizator.Expected }), ":", ' ', _jsx("span", { style: { fontStyle: 'italic' }, children: getCicoDownloadFileName(source, true, false) })] }), _jsxs("div", { style: { color }, children: [_jsx("strong", { style: { color }, children: SDKUI_Localizator.SelectedSingular }), ":", ' ', _jsx("span", { style: { fontStyle: 'italic' }, children: selectedFilename.name })] })] })] }), validationItems && Object.entries(validationItems).filter(([_, value]) => !value.isValid).length > 0 && (_jsxs("div", { style: { width: "100%", height: "100%", marginTop: '15px' }, children: [_jsx("hr", {}), _jsxs("table", { style: { width: "100%", borderCollapse: "collapse", color }, children: [_jsx("caption", { style: { textAlign: "center", fontWeight: "bold", marginBottom: "5px" }, children: SDKUI_Localizator.Anomalies }), _jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { style: { textAlign: "left", borderBottom: "1px solid #eee" }, children: SDKUI_Localizator.Value }), _jsx("th", { style: { textAlign: "left", borderBottom: "1px solid #eee" }, children: SDKUI_Localizator.Expected }), _jsx("th", { style: { textAlign: "left", borderBottom: "1px solid #eee" }, children: SDKUI_Localizator.Current })] }) }), _jsx("tbody", { children: Object.entries(validationItems).filter(([_, value]) => !value.isValid).map(([key, result]) => (_jsxs("tr", { children: [_jsx("td", { style: { borderBottom: "1px solid #eee" }, children: _jsx("strong", { style: { textTransform: "capitalize" }, children: key }) }), _jsxs("td", { style: { borderBottom: "1px solid #eee" }, children: [" ", result.expected || "-"] }), _jsxs("td", { style: { borderBottom: "1px solid #eee" }, children: [" ", result.current || "-"] })] }, key))) })] }), _jsx("hr", {})] })), _jsx("div", { style: { fontSize: '12px', marginTop: '15px', marginBottom: '15px' }, children: SDKUI_Localizator.ProceedAnyway })] })] });
+    const warningBgColor = "#fff8e6";
+    const warningBorderColor = "#f5c518";
+    return (_jsxs("div", { style: { width: "100%", padding: "8px 0", userSelect: 'text' }, children: [_jsx("div", { style: {
+                    fontSize: '1rem',
+                    marginBottom: isValid ? 0 : '16px',
+                    lineHeight: 1.5
+                }, children: SDKUI_Localizator.CheckInElementConfirm.replaceParams(fileName) }), !isValid && (_jsxs("div", { style: {
+                    background: warningBgColor,
+                    border: `1px solid ${warningBorderColor}`,
+                    borderRadius: '8px',
+                    padding: '16px',
+                    marginTop: '8px'
+                }, children: [_jsxs("div", { style: {
+                            display: 'flex',
+                            alignItems: 'center',
+                            gap: '8px',
+                            marginBottom: '16px'
+                        }, children: [_jsx("i", { className: "dx-icon-warning", style: { fontSize: '20px', color } }), _jsx("span", { style: { fontSize: '1rem', fontWeight: 600, color }, children: SDKUI_Localizator.ElementNameConventionError })] }), _jsxs("div", { style: {
+                            display: 'flex',
+                            flexDirection: 'column',
+                            gap: '12px',
+                            background: '#fff',
+                            borderRadius: '6px',
+                            padding: '12px',
+                            marginBottom: '16px'
+                        }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'flex-start', gap: '8px' }, children: [_jsxs("span", { style: {
+                                            minWidth: '80px',
+                                            fontWeight: 600,
+                                            color: '#555',
+                                            fontSize: '0.875rem'
+                                        }, children: [SDKUI_Localizator.Expected, ":"] }), _jsx("code", { style: {
+                                            fontFamily: 'monospace',
+                                            fontSize: '0.875rem',
+                                            background: '#e8f5e9',
+                                            padding: '2px 8px',
+                                            borderRadius: '4px',
+                                            color: '#2e7d32',
+                                            wordBreak: 'break-all'
+                                        }, children: getCicoDownloadFileName(source, true, false) })] }), _jsxs("div", { style: { display: 'flex', alignItems: 'flex-start', gap: '8px' }, children: [_jsxs("span", { style: {
+                                            minWidth: '80px',
+                                            fontWeight: 600,
+                                            color: '#555',
+                                            fontSize: '0.875rem'
+                                        }, children: [SDKUI_Localizator.SelectedSingular, ":"] }), _jsx("code", { style: {
+                                            fontFamily: 'monospace',
+                                            fontSize: '0.875rem',
+                                            background: '#ffebee',
+                                            padding: '2px 8px',
+                                            borderRadius: '4px',
+                                            color: '#c62828',
+                                            wordBreak: 'break-all'
+                                        }, children: stripCheckoutTimestamp(selectedFilename.name) })] })] }), validationItems && Object.entries(validationItems).filter(([_, value]) => !value.isValid).length > 0 && (_jsxs("div", { style: {
+                            background: '#fff',
+                            borderRadius: '6px',
+                            padding: '12px',
+                            marginBottom: '16px'
+                        }, children: [_jsx("div", { style: {
+                                    fontWeight: 600,
+                                    marginBottom: '12px',
+                                    color: '#555',
+                                    fontSize: '0.875rem',
+                                    textTransform: 'uppercase',
+                                    letterSpacing: '0.5px'
+                                }, children: SDKUI_Localizator.Anomalies }), _jsxs("table", { style: {
+                                    width: "100%",
+                                    borderCollapse: "separate",
+                                    borderSpacing: 0,
+                                    fontSize: '0.875rem'
+                                }, children: [_jsx("thead", { children: _jsxs("tr", { style: { background: '#f5f5f5' }, children: [_jsx("th", { style: {
+                                                        textAlign: "left",
+                                                        padding: '10px 12px',
+                                                        borderBottom: "2px solid #ddd",
+                                                        fontWeight: 600,
+                                                        color: '#333'
+                                                    }, children: SDKUI_Localizator.Value }), _jsx("th", { style: {
+                                                        textAlign: "left",
+                                                        padding: '10px 12px',
+                                                        borderBottom: "2px solid #ddd",
+                                                        fontWeight: 600,
+                                                        color: '#2e7d32'
+                                                    }, children: SDKUI_Localizator.Expected }), _jsx("th", { style: {
+                                                        textAlign: "left",
+                                                        padding: '10px 12px',
+                                                        borderBottom: "2px solid #ddd",
+                                                        fontWeight: 600,
+                                                        color: '#c62828'
+                                                    }, children: SDKUI_Localizator.Current })] }) }), _jsx("tbody", { children: Object.entries(validationItems)
+                                            .filter(([_, value]) => !value.isValid)
+                                            .map(([key, result], index, arr) => (_jsxs("tr", { style: {
+                                                background: index % 2 === 0 ? '#fafafa' : '#fff'
+                                            }, children: [_jsx("td", { style: {
+                                                        padding: '10px 12px',
+                                                        borderBottom: index === arr.length - 1 ? 'none' : "1px solid #eee",
+                                                        fontWeight: 500,
+                                                        textTransform: "capitalize"
+                                                    }, children: key.toUpperCase() }), _jsx("td", { style: {
+                                                        padding: '10px 12px',
+                                                        borderBottom: index === arr.length - 1 ? 'none' : "1px solid #eee",
+                                                        color: '#2e7d32',
+                                                        fontFamily: 'monospace'
+                                                    }, children: result.expected || "-" }), _jsx("td", { style: {
+                                                        padding: '10px 12px',
+                                                        borderBottom: index === arr.length - 1 ? 'none' : "1px solid #eee",
+                                                        color: '#c62828',
+                                                        fontFamily: 'monospace'
+                                                    }, children: result.current || "-" })] }, key))) })] })] }))] })), !isValid && (_jsx("div", { style: {
+                    fontSize: '1rem',
+                    lineHeight: 1.5,
+                    marginTop: '16px'
+                }, children: SDKUI_Localizator.ProceedAnyway }))] }));
 };
 export const getDcmtCicoInfo = (dtd) => {
     const cico = {
@@ -245,7 +432,7 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
     if (dcmt === undefined || dtd === undefined) {
         return {
             cicoEnabled: false,
-            checkoutStatus: { isCheckedOut: false, mode: '', version: 1, icon: null, editLockTooltipText: null }
+            checkoutStatus: { isCheckedOut: false, mode: '', version: 1, icon: null, editLockTooltipText: null, checkoutUserId: undefined, checkoutDate: undefined, fileExt: null, isMetadata: false }
         };
     }
     // ========================================================================
@@ -259,8 +446,9 @@ 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'
@@ -279,9 +467,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 +480,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 +502,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, checkoutUserId: undefined, checkoutDate: undefined, fileExt: fileExt, isMetadata: true }
+        };
+    }
+    // ========================================================================
     // COSTRUZIONE DELLO STATO DI CHECKOUT
     // ========================================================================
     let checkoutStatus = {
@@ -317,7 +518,11 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
         mode: '',
         version: version,
         icon: null,
-        editLockTooltipText: null
+        editLockTooltipText: null,
+        checkoutUserId: checkoutUserId,
+        checkoutDate: checkoutDate,
+        fileExt: fileExt,
+        isMetadata: isMetadata
     };
     // Verifica se il documento è effettivamente in stato di checkout
     if (userID && checkoutUserId && !isNaN(checkoutUserId) && checkoutUserId > 0) {
@@ -338,15 +543,19 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
             mode: mode,
             icon: icon,
             version: version,
-            editLockTooltipText: editLockTooltipText
+            editLockTooltipText: editLockTooltipText,
+            checkoutUserId: checkoutUserId,
+            checkoutDate: checkoutDate,
+            fileExt: fileExt,
+            isMetadata: isMetadata
         };
     }
     // ========================================================================
     // 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/useCheckInOutOperations.d.ts

@@ -18,7 +18,7 @@ export interface UseCheckInOutOperationsReturn {
     hideCommentFormCallback: () => void;
     copyCheckoutPathToClipboardCallback: (dcmt: DcmtInfo, filename: string) => void;
     handleCheckOutCallback: (dcmt: DcmtInfo, checkout: boolean, filename: string, downloadDcmtsAsync: (inputDcmts: Array<DcmtInfo> | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File) => void, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean) => Promise<void>, onRefreshAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
-    handleCheckInCallback: (dcmt: DcmtInfo, onRefreshAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
+    handleCheckInCallback: (dcmt: DcmtInfo, checkoutDate?: string | null, onRefreshAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
     showCicoWaitPanel: boolean;
     cicoWaitPanelTitle: string;
     showCicoPrimaryProgress: boolean;

package/lib/hooks/useCheckInOutOperations.js

@@ -1,6 +1,6 @@
-import { useCallback, useState } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 import { cicoDownloadFilesCallback, dcmtsFileCachePreview, getCicoDownloadFileName, getExceptionMessage, removeDcmtsFileCache, renderCicoCheckInContent, SDKUI_Globals, SDKUI_Localizator, updateCicoCheckoutStorageItem, validateCicoFileName } from '../helper';
-import { ButtonNames, ShowAlert, TMMessageBoxManager, TMResultManager } from '../components';
+import { ButtonNames, DeviceType, ShowAlert, TMMessageBoxManager, TMResultManager, useDeviceType } from '../components';
 import { ResultTypes, SDK_Globals } from '@topconsultnpm/sdk-ts';
 let abortController = new AbortController();
 export const useCheckInOutOperations = (props) => {
@@ -14,6 +14,10 @@ export const useCheckInOutOperations = (props) => {
         show: false,
         isRequired: false
     });
+    // Get the current device type (e.g., mobile, tablet, desktop) using a custom hook.
+    const deviceType = useDeviceType();
+    // This avoids unnecessary re-renders by only recalculating when deviceType changes.
+    let isMobile = useMemo(() => { return deviceType === DeviceType.MOBILE; }, [deviceType]);
     // State variable to control the visibility of the wait panel
     const [showCicoWaitPanel, setShowCicoWaitPanel] = useState(false);
     // State variable to store the title of the wait panel
@@ -127,7 +131,7 @@ export const useCheckInOutOperations = (props) => {
             });
         }
     };
-    const handleCheckInCallback = async (dcmt, onRefreshAsync) => {
+    const handleCheckInCallback = async (dcmt, checkoutDate, onRefreshAsync) => {
         if (!dcmt)
             throw new Error("Document info is required");
         // Create a new file input element
@@ -144,12 +148,13 @@ export const useCheckInOutOperations = (props) => {
             if (!fileInput.files || fileInput.files.length === 0)
                 return;
             const file = fileInput.files[0];
-            const validateFileName = validateCicoFileName({ type: 'dcmtInfo', dcmtInfo: dcmt, originalFileName: dcmt.fileName ?? SDKUI_Localizator.SearchResult }, file.name);
+            const validateFileName = validateCicoFileName({ type: 'dcmtInfo', dcmtInfo: dcmt, originalFileName: dcmt.fileName ?? SDKUI_Localizator.SearchResult }, file.name, checkoutDate);
             TMMessageBoxManager.show({
                 resizable: true,
                 buttons: [ButtonNames.YES, ButtonNames.NO],
                 message: renderCicoCheckInContent({ type: 'dcmtInfo', dcmtInfo: dcmt, originalFileName: dcmt.fileName ?? SDKUI_Localizator.SearchResult }, file, validateFileName.isValid, validateFileName.validationResults),
                 title: "Check in",
+                initialWidth: !validateFileName.isValid && !isMobile ? '800px' : undefined,
                 onButtonClick: async (e) => {
                     if (e !== ButtonNames.YES)
                         return;

package/lib/hooks/useDcmtOperations.d.ts

@@ -21,5 +21,6 @@ export interface UseDcmtOperationsReturn {
     removeDcmtsFileCache: (key: string) => void;
     isDcmtFileInCache: (key: string) => boolean;
     runOperationAsync: (inputDcmts: DcmtInfo[] | undefined, dcmtOperationType: DcmtOperationTypes, actionAfterOperationAsync?: () => Promise<void>) => Promise<void>;
+    FileSourceDialog: () => JSX.Element;
 }
 export declare const useDcmtOperations: () => UseDcmtOperationsReturn;

package/lib/hooks/useDcmtOperations.js

@@ -4,9 +4,18 @@ import { SDK_Globals, RetrieveFileOptions, DcmtOpers, ResultTypes, RecentCategor
 import { ShowAlert, TMResultManager, FormulaHelper, TMExceptionBoxManager, TMSpinner } from '../components';
 import { Globalization, getExceptionMessage, dialogConfirmOperation, extensionHandler, downloadBase64File, SDKUI_Globals, dcmtsFileCacheDownload, CACHE_SIZE_LIMIT, clearDcmtsFileCache, dcmtsFileCachePreview, isDcmtFileInCache, removeDcmtsFileCache, SDKUI_Localizator } from '../helper';
 import { DcmtOperationTypes, DownloadTypes, FileExtensionHandler } from '../ts';
-import { useFileDialog } from './useInputDialog';
+import { useFileDialog, useFileSourceDialog } from './useInputDialog';
 import { isXMLFileExt } from '../helper/dcmtsHelper';
 import { ShowConfirm } from '../components/base/TMConfirm';
+const isScannerLicenseConfigured = () => {
+    try {
+        const scannerLicense = SDKUI_Globals.userSettings.advancedSettings.scannerLicense;
+        return scannerLicense && scannerLicense.trim() !== '';
+    }
+    catch {
+        return false;
+    }
+};
 let abortController = new AbortController();
 const downloadCountMap = new Map();
 const getDownloadFileName = (fileName) => {
@@ -32,6 +41,7 @@ export const useDcmtOperations = () => {
     const [waitPanelValueSecondary, setWaitPanelValueSecondary] = useState(0);
     const [waitPanelMaxValueSecondary, setWaitPanelMaxValueSecondary] = useState(0);
     const { OpenFileDialog } = useFileDialog();
+    const [selectFileSource, FileSourceDialog] = useFileSourceDialog();
     const _downloadDcmtsAsync = async (inputDcmts, downloadMode = "download", onFileDownloaded, skipConfirmation = false) => {
         if (inputDcmts === undefined)
             return;
@@ -210,7 +220,61 @@ export const useDcmtOperations = () => {
             return;
         if (inputDcmts.length <= 0)
             return;
-        let file = inputDcmts[0].FILE ?? await OpenFileDialog();
+        let file = inputDcmts[0].FILE;
+        if (!file) {
+            if (isScannerLicenseConfigured()) {
+                const hasExistingFile = !!inputDcmts[0].FILEEXT;
+                const source = await selectFileSource(hasExistingFile);
+                if (!source)
+                    return;
+                switch (source) {
+                    case 'filesystem':
+                        file = await OpenFileDialog();
+                        break;
+                    case 'scanner-new':
+                        if (SDKUI_Globals.scanRequestHandler) {
+                            file = await new Promise((resolve) => {
+                                SDKUI_Globals.scanRequestHandler('new', (scannedFile) => resolve(scannedFile), () => resolve(undefined));
+                            });
+                        }
+                        else {
+                            ShowAlert({ message: SDKUI_Localizator.ScanFeatureUnavailableInThisContext, mode: 'info', duration: 3000, title: 'Scanner' });
+                            return;
+                        }
+                        break;
+                    case 'scanner-edit':
+                        if (SDKUI_Globals.scanRequestHandler) {
+                            // Download the existing file from the document
+                            let existingFile;
+                            try {
+                                const rfo = new RetrieveFileOptions();
+                                rfo.retrieveReason = DcmtOpers.None;
+                                const retrievedFile = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmts[0].TID, inputDcmts[0].DID, rfo);
+                                existingFile = retrievedFile;
+                            }
+                            catch (ex) {
+                                TMExceptionBoxManager.show({ exception: getExceptionMessage(ex) });
+                                return;
+                            }
+                            if (!existingFile) {
+                                ShowAlert({ message: 'Impossibile recuperare il file del documento.', mode: 'warning', duration: 3000, title: 'Scanner' });
+                                return;
+                            }
+                            file = await new Promise((resolve) => {
+                                SDKUI_Globals.scanRequestHandler('edit', (scannedFile) => resolve(scannedFile), () => resolve(undefined), existingFile);
+                            });
+                        }
+                        else {
+                            ShowAlert({ message: SDKUI_Localizator.ScanFeatureUnavailableInThisContext, mode: 'info', duration: 3000, title: 'Scanner' });
+                            return;
+                        }
+                        break;
+                }
+            }
+            else {
+                file = await OpenFileDialog();
+            }
+        }
         if (!file)
             return;
         setShowWaitPanel(true);
@@ -489,10 +553,16 @@ export const useDcmtOperations = () => {
             actionAfterOperationAsync?.();
             TMResultManager.show(result, operationTitle, "TID", "DID");
         };
-        dialogConfirmOperation(operationTitle, msg, doOperationAsync);
+        // Per SubstituteFile con beta features e scanner, non mostrare conferma
+        if (dcmtOperationType === DcmtOperationTypes.SubstituteFile && isScannerLicenseConfigured()) {
+            await doOperationAsync();
+        }
+        else {
+            dialogConfirmOperation(operationTitle, msg, doOperationAsync);
+        }
     };
     return {
         abortController, showWaitPanel, showPrimary, waitPanelTitle, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary,
-        downloadDcmtsAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache, runOperationAsync
+        downloadDcmtsAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache, runOperationAsync, FileSourceDialog
     };
 };

package/lib/hooks/useDocumentOperations.js

@@ -105,10 +105,11 @@ 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
     });
-    const { abortController, showWaitPanel, waitPanelTitle, showPrimary, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, downloadDcmtsAsync, runOperationAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache } = useDcmtOperations();
+    const { abortController, showWaitPanel, waitPanelTitle, showPrimary, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, downloadDcmtsAsync, runOperationAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache, FileSourceDialog } = useDcmtOperations();
     const { 
     // Data
     relatedDcmts, pairedSearchResults, manyToManyRelations, selectedManyToManyRelation, manyToManyChooserDataSource, relatedDcmtsChooserDataSource, 
@@ -616,12 +617,18 @@ export const useDocumentOperations = (props) => {
         const firstDoc = selectedDcmtInfos?.[0];
         if (!firstDoc)
             return;
+        // Take the first document (used for validation checks)
+        let dcmt = focusedItem;
+        if (isDcmtFormContext || isMasterDetailContext) {
+            dcmt = dcmtDataRowForCicoStatus;
+        }
+        const { checkoutStatus } = getDcmtCicoStatus(dcmt, allUsers, dtd);
         firstDoc.fileName = dtd?.name ?? SDKUI_Localizator.SearchResult;
         const onRefreshAsync = async () => {
             await updateCurrentDcmt?.();
             await refreshFocusedDataRowAsync?.(firstDoc.TID, firstDoc.DID, true);
         };
-        await handleCheckInCallback(firstDoc, onRefreshAsync);
+        await handleCheckInCallback(firstDoc, checkoutStatus.checkoutDate, onRefreshAsync);
     };
     const copyCheckoutPathToClipboardOperationCallback = () => {
         const firstDoc = selectedDcmtInfos?.[0];
@@ -632,7 +639,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,9 +1066,13 @@ export const useDocumentOperations = (props) => {
                 disabled: isDisabledForSingleRow() && isDisabledForMultiRow(),
                 submenu: [
                     addToFavoriteOperation(),
-                    openFormOperation(),
+                    addReplaceFileOperation(),
+                    fileCheckMenuItem(),
+                    fileConversionsMenuItem(),
+                    ...(SDK_Globals.tmSession?.SessionDescr?.appModuleID === AppModules.SURFER ? [createContextualTaskMenuItem()] : []),
                     downloadFileMenuItem(),
                     downloadXMLAttachmentsMenuItem(),
+                    ...(selectedDcmtInfos.length > 0 && isPdfEditorAvailable(dtd, selectedDcmtInfos[0]?.FILEEXT) && onOpenPdfEditorRequest ? [pdfEditorMenuItem(onOpenPdfEditorRequest)] : []),
                 ]
             },
             signatureMenuItem(),
@@ -1081,6 +1092,7 @@ export const useDocumentOperations = (props) => {
                     ...(inputDcmtFormLayoutMode === LayoutModes.Update ? [addToFavoriteOperation()] : []),
                     addReplaceFileOperation(),
                     openFormOperation(),
+                    deletetionMenuItem(),
                     fileCheckMenuItem(),
                     fileConversionsMenuItem(),
                     ...(SDK_Globals.tmSession?.SessionDescr?.appModuleID === AppModules.SURFER ? [createContextualTaskMenuItem()] : []),
@@ -1090,6 +1102,7 @@ export const useDocumentOperations = (props) => {
                 ]
             },
             signatureMenuItem(),
+            checkinMenuItem(),
             ...((inputDcmtFormLayoutMode === LayoutModes.Update) ? [fullTextSearchMenuItem()] : []),
         ];
     };
@@ -1115,7 +1128,7 @@ export const useDocumentOperations = (props) => {
     };
     const renderFloatingBar = (floatingBarContainerRef && floatingBarContainerRef.current && allowFloatingBar && showFloatingBar && deviceType !== DeviceType.MOBILE) ? (_jsx(TMFloatingMenuBar, { containerRef: floatingBarContainerRef, contextMenuItems: operationItems(), isConstrained: true, defaultPosition: { x: 1, y: 88 }, defaultPinnedItems: ['rel-det', 'rel-mst', 'dl'], defaultOrientation: 'horizontal', hasContextMenu: false, pinnedItemIds: pinnedItemIds, onPinChange: setPinnedItemIds })) : null;
     const renderDcmtOperations = (_jsxs(_Fragment, { children: [(showExportForm && searchResult && dataColumns && dataSource && selectedRowKeys) && (_jsx(TMDataGridExportForm, { dataColumns: dataColumns, dataSource: dataSource, selectedRowKeys: selectedRowKeys, onCloseExportForm: () => setShowExportForm(false), searchResult: searchResult })), _jsx(StyledMultiViewPanel, { "$isVisible": isOpenDcmtForm, children: ((isOpenDcmtForm && focusedItem?.TID !== undefined && focusedItem?.DID !== undefined) &&
-                    _jsx(TMDcmtForm, { isModal: openDcmtFormAsModal || (dcmtFormLayoutMode === LayoutModes.Ark && focusedItem?.DID !== undefined), titleModal: dtd?.name ?? '', TID: focusedItem.TID, DID: focusedItem.DID, allowButtonsRefs: true, layoutMode: dcmtFormLayoutMode, count: visibleItems?.length, itemIndex: visibleItems ? visibleItems.findIndex(o => o.rowIndex === focusedItem?.rowIndex) + 1 : undefined, canNext: canNavigateHandler ? canNavigateHandler('next') : false, canPrev: canNavigateHandler ? canNavigateHandler('prev') : false, onNext: () => onNavigateHandler && onNavigateHandler('next'), onPrev: () => onNavigateHandler && onNavigateHandler('prev'), onClose: () => { (false); onDcmtFormOpenChange(false, LayoutModes.Update); }, onWFOperationCompleted: onWFOperationCompleted, onTaskCreateRequest: onTaskCreateRequest, onSavedAsyncCallback: onSavedAsyncCallback, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, focusedItem?.TID, focusedItem?.DID), showDcmtFormSidebar: showDcmtFormSidebar, datagridUtility: {
+                    _jsx(TMDcmtForm, { isModal: openDcmtFormAsModal || (dcmtFormLayoutMode === LayoutModes.Ark && focusedItem?.DID !== undefined), titleModal: dtd?.name ?? '', TID: focusedItem.TID, DID: focusedItem.DID, allowButtonsRefs: true, layoutMode: dcmtFormLayoutMode, count: visibleItems?.length, itemIndex: visibleItems ? visibleItems.findIndex(o => o.rowIndex === focusedItem?.rowIndex) + 1 : undefined, canNext: canNavigateHandler ? canNavigateHandler('next') : false, canPrev: canNavigateHandler ? canNavigateHandler('prev') : false, onNext: () => onNavigateHandler && onNavigateHandler('next'), onPrev: () => onNavigateHandler && onNavigateHandler('prev'), onClose: () => { (false); onDcmtFormOpenChange(false, LayoutModes.Update); }, onWFOperationCompleted: onWFOperationCompleted, onTaskCreateRequest: onTaskCreateRequest, onSavedAsyncCallback: onSavedAsyncCallback, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openFileUploaderPdfEditor: openFileUploaderPdfEditor, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, focusedItem?.TID, focusedItem?.DID), showDcmtFormSidebar: showDcmtFormSidebar, datagridUtility: {
                             onRefreshSearchAsyncDatagrid,
                             onRefreshDataRowsAsync,
                             refreshFocusedDataRowAsync,
@@ -1181,7 +1194,7 @@ export const useDocumentOperations = (props) => {
                     updateBatchUpdateForm(false);
                     setIsModifiedBatchUpdate(false);
                     await onRefreshDataRowsAsync?.();
-                }, onStatusChanged: (isModified) => { setIsModifiedBatchUpdate(isModified); } }), showApprovePopup && _jsx(WorkFlowApproveRejectPopUp, { deviceType: deviceType, onCompleted: handleWFOperationCompleted, selectedItems: selectedDcmtInfos, isReject: 0, onClose: () => updateShowApprovePopup(false) }), showRejectPopup && _jsx(WorkFlowApproveRejectPopUp, { deviceType: deviceType, onCompleted: handleWFOperationCompleted, selectedItems: selectedDcmtInfos, isReject: 1, onClose: () => updateShowRejectPopup(false) }), showReAssignPopup && _jsx(WorkFlowReAssignPopUp, { deviceType: deviceType, onCompleted: handleWFOperationCompleted, selectedItems: selectedDcmtInfos, onClose: () => updateShowReAssignPopup(false) }), showMoreInfoPopup && _jsx(WorkFlowMoreInfoPopUp, { fromDTD: dtd, TID: contextConfig.approvalTID, DID: focusedItem?.DID, deviceType: deviceType, onCompleted: handleWFOperationCompleted, onClose: () => updateShowMoreInfoPopup(false), allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, triggerBlogRefresh: onRefreshBlogDatagrid }), _jsx(ConfirmFormatDialog, {}), _jsx(ConfirmAttachmentsDialog, {}), taskFormDialogComponent, s4TViewerDialogComponent, currentCustomButton && _jsx(TMCustomButton, { button: currentCustomButton, formData: currentMetadataValues, selectedItems: selectedItemsFull, onClose: () => setCurrentCustomButton(undefined) })] }));
+                }, onStatusChanged: (isModified) => { setIsModifiedBatchUpdate(isModified); } }), showApprovePopup && _jsx(WorkFlowApproveRejectPopUp, { deviceType: deviceType, onCompleted: handleWFOperationCompleted, selectedItems: selectedDcmtInfos, isReject: 0, onClose: () => updateShowApprovePopup(false) }), showRejectPopup && _jsx(WorkFlowApproveRejectPopUp, { deviceType: deviceType, onCompleted: handleWFOperationCompleted, selectedItems: selectedDcmtInfos, isReject: 1, onClose: () => updateShowRejectPopup(false) }), showReAssignPopup && _jsx(WorkFlowReAssignPopUp, { deviceType: deviceType, onCompleted: handleWFOperationCompleted, selectedItems: selectedDcmtInfos, onClose: () => updateShowReAssignPopup(false) }), showMoreInfoPopup && _jsx(WorkFlowMoreInfoPopUp, { fromDTD: dtd, TID: contextConfig.approvalTID, DID: focusedItem?.DID, deviceType: deviceType, onCompleted: handleWFOperationCompleted, onClose: () => updateShowMoreInfoPopup(false), allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, triggerBlogRefresh: onRefreshBlogDatagrid }), _jsx(ConfirmFormatDialog, {}), _jsx(ConfirmAttachmentsDialog, {}), _jsx(FileSourceDialog, {}), taskFormDialogComponent, s4TViewerDialogComponent, currentCustomButton && _jsx(TMCustomButton, { button: currentCustomButton, formData: currentMetadataValues, selectedItems: selectedItemsFull, onClose: () => setCurrentCustomButton(undefined) })] }));
     return {
         operationItems: operationItems(),
         renderFloatingBar,
@@ -1234,6 +1247,7 @@ export const useDocumentOperations = (props) => {
                 removeDcmtsFileCache,
                 isDcmtFileInCache,
                 runOperationAsync,
+                FileSourceDialog,
             },
             relatedDocumentsInfo: {
                 // Data