@topconsultnpm/sdkui-react 6.20.0-dev1.5 → 6.20.0-dev1.50

package/lib/helper/TMPdfViewer.js

@@ -0,0 +1,187 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useRef, useCallback } from "react";
+import styled from "styled-components";
+import { LoadIndicator } from 'devextreme-react/load-indicator';
+import { IconCloseOutline } from "./TMIcons";
+import { SDKUI_Localizator } from "./SDKUI_Localizator";
+import { TMColors } from "../utils/theme";
+// Dynamic imports for optional dependencies
+let pdfjs;
+let Document;
+let Page;
+let isReactPdfAvailable = false;
+try {
+    const reactPdf = require('react-pdf');
+    pdfjs = reactPdf.pdfjs;
+    Document = reactPdf.Document;
+    Page = reactPdf.Page;
+    // Configura il worker PDF.js PRIMA del rendering
+    pdfjs.GlobalWorkerOptions.workerSrc = `https://unpkg.com/pdfjs-dist@${pdfjs.version}/build/pdf.worker.min.mjs`;
+    isReactPdfAvailable = true;
+}
+catch (error) {
+    // react-pdf not available - will use iframe fallback
+    // console.warn('react-pdf is not installed. TMPdfViewer will use iframe fallback.');
+}
+const PDFViewerContainer = styled.div `
+  width: 100%;
+  height: 100%;
+  overflow-y: auto;
+  overflow-x: hidden;
+  background-color: #f5f5f5;
+  position: relative;
+  
+  .react-pdf__Document {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 10px;
+    padding: 10px 0;
+  }
+  
+  .react-pdf__Page {
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+    margin: 0 auto;
+  }
+  
+  .react-pdf__Page__canvas {
+    max-width: 100%;
+    height: auto !important;
+  }
+`;
+const LoadingOverlay = styled.div `
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background-color: rgba(245, 245, 245, 0.95);
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  z-index: 1000;
+`;
+const TMPdfViewer = (props) => {
+    const { pdfBlob, title = "Anteprima PDF", isResizingActive, enableFitToWidth = false } = props;
+    const [isMobile, setIsMobile] = useState(false);
+    const [totalPagesNumber, setTotalPagesNumber] = useState(0);
+    const [loadedPagesNumber, setLoadedPagesNumber] = useState(0);
+    const [visiblePages, setVisiblePages] = useState(new Set([1]));
+    const [pdfUrl, setPdfUrl] = useState("");
+    const observerRef = useRef(null);
+    useEffect(() => {
+        const checkIsMobile = () => {
+            const userAgent = navigator.userAgent || navigator.vendor || window.opera;
+            // Detect actual mobile/tablet devices
+            const isMobileDevice = 
+            // User agent detection (phones and tablets)
+            /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(userAgent) ||
+                // Media query for touch devices with coarse pointer (more reliable than screen width)
+                (window.matchMedia?.('(hover: none) and (pointer: coarse)').matches ?? false) ||
+                // Touch-capable devices excluding desktop OS
+                (navigator.maxTouchPoints > 1 && !/Win|Mac|Linux x86_64/i.test(userAgent));
+            setIsMobile(isMobileDevice);
+        };
+        checkIsMobile();
+        // Create URL for iframe
+        const url = URL.createObjectURL(pdfBlob);
+        setPdfUrl(url);
+        return () => {
+            if (url) {
+                URL.revokeObjectURL(url);
+            }
+        };
+    }, [pdfBlob]);
+    /**
+     * Callback per l'Intersection Observer che gestisce il lazy loading delle pagine PDF.
+     * Viene chiamato ogni volta che una pagina entra o esce dal viewport (area visibile).
+     *
+     * - Monitora quando gli elementi (pagine) diventano visibili
+     * - Aggiunge il numero di pagina al Set delle pagine visibili quando entra nel viewport
+     * - Il rootMargin di 500px carica le pagine prima che siano effettivamente visibili (preloading)
+     */
+    const pageObserverCallback = useCallback((entries) => {
+        entries.forEach(entry => {
+            const pageNum = parseInt(entry.target.getAttribute('data-page-number') || '0');
+            if (entry.isIntersecting) {
+                // Aggiunge la pagina al Set di quelle da renderizzare
+                setVisiblePages(prev => new Set([...prev, pageNum]));
+            }
+        });
+    }, []);
+    /**
+     * Crea e configura l'Intersection Observer per il lazy loading.
+     *
+     * Configurazione:
+     * - root: null → osserva rispetto al viewport del browser
+     * - rootMargin: '500px' → inizia il caricamento 500px prima che la pagina sia visibile (buffer)
+     * - threshold: 0.01 → trigger quando anche solo l'1% dell'elemento è visibile
+     *
+     * Benefici:
+     * - Non blocca l'UI durante il rendering
+     * - Carica solo le pagine necessarie
+     * - Migliora le performance su PDF con molte pagine
+     */
+    useEffect(() => {
+        observerRef.current = new IntersectionObserver(pageObserverCallback, {
+            root: null,
+            rootMargin: '500px',
+            threshold: 0.01
+        });
+        return () => {
+            // Cleanup: disconnette l'observer quando il componente viene smontato
+            observerRef.current?.disconnect();
+        };
+    }, [pageObserverCallback]);
+    // Use iframe se react-pdf non è disponibile O se è desktop
+    if (!isReactPdfAvailable || (!isMobile && pdfUrl)) {
+        return (_jsx(PDFViewerContainer, { children: _jsx("iframe", { src: `${pdfUrl}#${enableFitToWidth ? 'view=FitH&' : ''}scrollbar=1`, title: title, style: {
+                    width: '100%',
+                    height: '100%',
+                    border: 'none',
+                    zIndex: 0,
+                    pointerEvents: isResizingActive === true ? "none" : "auto"
+                } }, pdfUrl) }));
+    }
+    // Usa react-pdf solo per mobile e solo se disponibile
+    return _jsxs(PDFViewerContainer, { children: [loadedPagesNumber === 0 && totalPagesNumber > 0 && _jsx(LoadingOverlay, { children: _jsxs("div", { style: {
+                        display: 'flex',
+                        justifyContent: 'center',
+                        alignItems: 'center',
+                        flexDirection: 'column',
+                        gap: '10px'
+                    }, children: [_jsx(LoadIndicator, { height: 60, width: 60 }), _jsxs("div", { children: [SDKUI_Localizator.Loading, "..."] })] }) }), _jsx("div", { style: { display: loadedPagesNumber > 0 && totalPagesNumber > 0 ? 'block' : 'none' }, children: _jsx(Document, { file: pdfBlob, onLoadSuccess: ({ numPages }) => {
+                        setTotalPagesNumber(numPages);
+                        setLoadedPagesNumber(0);
+                    }, loading: _jsxs("div", { style: {
+                            display: 'flex',
+                            justifyContent: 'center',
+                            alignItems: 'center',
+                            height: '100%',
+                            flexDirection: 'column',
+                            gap: '10px'
+                        }, children: [_jsx(LoadIndicator, { height: 60, width: 60 }), _jsxs("div", { children: [SDKUI_Localizator.Loading, "..."] })] }), error: _jsxs("div", { style: {
+                            display: 'flex',
+                            justifyContent: 'center',
+                            alignItems: 'center',
+                            height: '100%',
+                            flexDirection: 'column',
+                            gap: '10px'
+                        }, children: [_jsx(IconCloseOutline, { fontSize: 64, color: TMColors.error }), _jsx("div", { children: "Errore nel caricamento del PDF" })] }), children: Array.from(new Array(totalPagesNumber), (el, index) => {
+                        const pageNumber = index + 1;
+                        const shouldRender = visiblePages.has(pageNumber);
+                        return (_jsx("div", { "data-page-number": pageNumber, ref: (el) => {
+                                if (el && observerRef.current) {
+                                    observerRef.current.observe(el);
+                                }
+                            }, style: {
+                                minHeight: shouldRender ? 'auto' : '1000px',
+                                display: 'flex',
+                                justifyContent: 'center',
+                                alignItems: 'center'
+                            }, children: shouldRender && (_jsx(Page, { pageNumber: pageNumber, renderTextLayer: false, renderAnnotationLayer: false, width: Math.min(window.innerWidth - 40, 1200), loading: _jsx("div", { style: { padding: '20px' }, children: _jsx(LoadIndicator, { height: 40, width: 40 }) }), onLoadSuccess: () => {
+                                    setLoadedPagesNumber(prev => prev + 1);
+                                } })) }, `page_${pageNumber}`));
+                    }) }) })] });
+};
+export default TMPdfViewer;

package/lib/helper/checkinCheckoutManager.d.ts

@@ -1,11 +1,20 @@
 import React from "react";
-import { DcmtTypeDescriptor, FileDescriptor, UserDescriptor } from "@topconsultnpm/sdk-ts";
+import { AccessLevels, DcmtTypeDescriptor, FileDescriptor, UserDescriptor } from "@topconsultnpm/sdk-ts";
 import { DcmtInfo, DownloadModes, DownloadTypes } from "../ts/types";
 import { FileItem } from "../components";
 /**
  * Check-in/Check-out Manager
  * Questo modulo gestisce tutte le operazioni di check-in e check-out
  * dei documenti e delle bozze dei gruppi di lavoro.
+ *
+ * Operazioni gestite:
+ * - Generazione nomi file per download e checkout con timestamp e identificatori univoci
+ * - Download di documenti in modalità checkout
+ * - Gestione dello storage locale delle informazioni di checkout (aggiunta, aggiornamento, rimozione)
+ * - Validazione dei nomi file secondo le convenzioni di naming CICO
+ * - Rendering dell'interfaccia utente per conferma check-in con visualizzazione anomalie
+ * - Determinazione dello stato di check-out dei documenti (editMode/lockMode)
+ * - Verifica permessi e abilitazione funzionalità CICO per tipo documento
  */
 export interface CheckoutInfo {
     DID: string;
@@ -18,6 +27,7 @@ interface CheckoutStatusResult {
     mode: 'editMode' | 'lockMode' | '';
     version: number;
     icon: React.ReactNode | null;
+    editLockTooltipText: React.ReactNode | null;
 }
 export type DownloadSource = {
     type: 'fileItem';
@@ -29,7 +39,7 @@ export type DownloadSource = {
 };
 export declare const getCicoDownloadFileName: (source: DownloadSource, checkout: boolean, withTimestampAndExt: boolean) => string;
 export declare const cicoDownloadFilesCallback: (sources: Array<DownloadSource>, checkout: boolean, downloadDcmtsAsync: (inputDcmts: Array<DcmtInfo> | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File) => void, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean) => Promise<void>) => Promise<void>;
-export declare const updateCheckoutItem: (item: CheckoutInfo, type: "fileItem" | "dcmtInfo", action?: "addOrUpdate" | "remove") => void;
+export declare const updateCicoCheckoutStorageItem: (item: CheckoutInfo, type: "fileItem" | "dcmtInfo", action?: "addOrUpdate" | "remove") => void;
 export declare const validateCicoFileName: (source: DownloadSource, fileName: string) => FileNameValidation;
 type ValidationResult = {
     expected: string | number | undefined;
@@ -48,6 +58,26 @@ type FileNameValidation = {
     validationResults?: FileNameValidationItems;
 };
 export declare const renderCicoCheckInContent: (source: DownloadSource, selectedFilename: File, isValid: boolean, validationItems: FileNameValidationItems | undefined, color?: string) => React.ReactNode;
+interface CheckInCheckOutDcmtInfo {
+    CICO: number;
+    CanCICO: AccessLevels;
+    CanDelChronology: AccessLevels;
+    UserID_MID: number;
+    Date_MID: number;
+    Ver_MID: number;
+    UserID_CanViewOrUpdate: AccessLevels;
+    Date_CanViewOrUpdate: AccessLevels;
+    Ver_CanViewOrUpdate: AccessLevels;
+}
+export declare const getDcmtCicoInfo: (dtd: DcmtTypeDescriptor | undefined) => CheckInCheckOutDcmtInfo;
+/**
+ * Determina lo stato di check-in/check-out di un documento
+ *
+ * @param dcmt - Il documento in formato array (MetadataValueDescriptorEx[]) o oggetto piatto
+ * @param allUsers - Lista di tutti gli utenti per risolvere i nomi
+ * @param dtd - Descrittore del tipo documento contenente le definizioni dei metadati CICO
+ * @returns Oggetto con cicoEnabled (se CICO è abilitato) e checkoutStatus (dettagli dello stato)
+ */
 export declare const getDcmtCicoStatus: (dcmt: any, allUsers: Array<UserDescriptor>, dtd: DcmtTypeDescriptor | undefined) => {
     cicoEnabled: boolean;
     checkoutStatus: CheckoutStatusResult;

package/lib/helper/checkinCheckoutManager.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { AccessLevels, CICO_MetadataNames, SDK_Globals } from "@topconsultnpm/sdk-ts";
+import { AccessLevels, CICO_MetadataNames, SDK_Globals, SystemMIDsAsNumber } from "@topconsultnpm/sdk-ts";
 import TMTooltip from "../components/base/TMTooltip";
 import { Globalization, SDKUI_Globals, SDKUI_Localizator } from "./index";
 import { DownloadTypes } from "../ts/types";
@@ -64,13 +64,8 @@ export const cicoDownloadFilesCallback = async (sources, checkout, downloadDcmts
         if (tid && did && ext) {
             let fileName = getCicoDownloadFileName(source, checkout, true);
             if (checkout) {
-                const newItem = {
-                    TID: tid.toString(),
-                    DID: did.toString(),
-                    checkoutFolder: "",
-                    checkoutName: fileName
-                };
-                updateCheckoutItem(newItem, source.type, "addOrUpdate");
+                const newItem = { TID: tid.toString(), DID: did.toString(), checkoutFolder: "", checkoutName: fileName };
+                updateCicoCheckoutStorageItem(newItem, source.type, "addOrUpdate");
             }
             files.push({ TID: tid, DID: did, FILEEXT: ext, fileName });
         }
@@ -78,7 +73,7 @@ export const cicoDownloadFilesCallback = async (sources, checkout, downloadDcmts
     if (files.length > 0)
         await downloadDcmtsAsync(files, DownloadTypes.Dcmt, "download");
 };
-export const updateCheckoutItem = (item, type, action = "addOrUpdate") => {
+export const updateCicoCheckoutStorageItem = (item, type, action = "addOrUpdate") => {
     // Select the appropriate array based on type
     const currentItems = type === 'dcmtInfo' ? [...SDKUI_Globals.userSettings.dcmtCheckoutInfo] : [...SDKUI_Globals.userSettings.wgDraftCheckoutInfo];
     // Find the index of an existing item that has the same TID and DID as the new item
@@ -196,7 +191,7 @@ export const renderCicoCheckInContent = (source, selectedFilename, isValid, vali
     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 getDcmtCicoInfo = (dtd) => {
+export const getDcmtCicoInfo = (dtd) => {
     const cico = {
         CICO: 0,
         CanCICO: AccessLevels.No,
@@ -215,57 +210,139 @@ const getDcmtCicoInfo = (dtd) => {
     cico.CanDelChronology = dtd.perm?.canDelChron ?? AccessLevels.No;
     const mdCheckout = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_CheckoutUserID);
     if (mdCheckout) {
-        cico.UserID_MID = mdCheckout.fromMID;
+        cico.UserID_MID = mdCheckout.id;
         cico.UserID_CanViewOrUpdate = (mdCheckout.perm?.canView == AccessLevels.Yes || mdCheckout.perm?.canUpdate == AccessLevels.Yes) ? AccessLevels.Yes : AccessLevels.No;
     }
     const mdDate = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_CheckoutDate);
     if (mdDate) {
-        cico.Date_MID = mdDate.fromMID;
+        cico.Date_MID = mdDate.id;
         cico.Date_CanViewOrUpdate = (mdDate.perm?.canView == AccessLevels.Yes || mdDate.perm?.canUpdate == AccessLevels.Yes) ? AccessLevels.Yes : AccessLevels.No;
     }
     const mdVer = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_Version);
     if (mdVer) {
-        cico.Ver_MID = mdVer.fromMID;
+        cico.Ver_MID = mdVer.id;
         cico.Ver_CanViewOrUpdate = (mdVer.perm?.canView == AccessLevels.Yes || mdVer.perm?.canUpdate == AccessLevels.Yes) ? AccessLevels.Yes : AccessLevels.No;
     }
     return cico;
 };
+/**
+ * Determina lo stato di check-in/check-out di un documento
+ *
+ * @param dcmt - Il documento in formato array (MetadataValueDescriptorEx[]) o oggetto piatto
+ * @param allUsers - Lista di tutti gli utenti per risolvere i nomi
+ * @param dtd - Descrittore del tipo documento contenente le definizioni dei metadati CICO
+ * @returns Oggetto con cicoEnabled (se CICO è abilitato) e checkoutStatus (dettagli dello stato)
+ */
 export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
+    // ========================================================================
+    // VALIDAZIONE PARAMETRI
+    // ========================================================================
+    // Se i parametri essenziali non sono forniti, ritorna stato di default
     if (dcmt === undefined || dtd === undefined) {
         return {
             cicoEnabled: false,
-            checkoutStatus: { isCheckedOut: false, mode: '', version: 1, icon: null }
+            checkoutStatus: { isCheckedOut: false, mode: '', version: 1, icon: null, editLockTooltipText: null }
         };
     }
+    // ========================================================================
+    // ESTRAZIONE INFORMAZIONI CICO DAL DTD
+    // ========================================================================
+    // Recupera le configurazioni e permessi CICO dal tipo documento
     const cicoInfo = getDcmtCicoInfo(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 keyVersion = dcmt.TID + "_" + (CICO_Version_Meta?.id ?? 0);
-    const versionRaw = CICO_Version_Meta?.id ? dcmt[keyVersion] : undefined;
-    const version = (versionRaw != null && !isNaN(Number(versionRaw))) ? Number(versionRaw) : 1;
-    let checkoutStatus = { isCheckedOut: false, mode: '', version: version, icon: null, };
     const userID = SDK_Globals.tmSession?.SessionDescr?.userID;
-    if (dcmt && CICO_CheckoutUserID_Meta?.id) {
-        const keyUserID = dcmt.TID + "_" + CICO_CheckoutUserID_Meta.id;
-        const checkoutUserIdValue = dcmt[keyUserID];
-        const checkoutUserId = Number(checkoutUserIdValue);
-        if (userID && checkoutUserIdValue && !isNaN(checkoutUserId) && checkoutUserId > 0) {
-            // editMode: l'utente corrente è quello che ha fatto il checkout
-            // lockMode: un altro utente ha fatto il checkout
-            const mode = (userID && userID === checkoutUserId) ? 'editMode' : 'lockMode';
-            // Recupera i dati aggiuntivi per il tooltip
-            const keyDate = dcmt.TID + "_" + (CICO_CheckoutDate_Meta?.id ?? 0);
-            const checkoutDate = CICO_CheckoutDate_Meta?.id ? dcmt[keyDate] : undefined;
-            const editLockTooltipText = _jsxs(_Fragment, { children: [_jsxs("div", { style: { textAlign: "center" }, children: [mode === 'editMode' && (_jsxs(_Fragment, { children: [_jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-edit" }), SDKUI_Localizator.CurrentUserExtract] })), mode === 'lockMode' && (_jsxs(_Fragment, { children: [_jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-lock" }), SDKUI_Localizator.ExtractedFromOtherUser] }))] }), _jsx("hr", {}), _jsxs("div", { style: { textAlign: "left" }, children: [_jsxs("ul", { children: [_jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.ExtractedBy }), ": ", findCheckOutUserName(allUsers, checkoutUserId), " (ID: ", checkoutUserId, ")"] }), _jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.ExtractedOn }), ": ", Globalization.getDateTimeDisplayValue(checkoutDate?.toString())] })] }), _jsx("hr", {}), _jsx("ul", { children: _jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.Version }), ": ", version ?? 1] }) })] })] });
-            const icon = mode === 'editMode'
-                ? _jsx(TMTooltip, { content: editLockTooltipText, children: _jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-edit" }) })
-                : _jsx(TMTooltip, { content: editLockTooltipText, children: _jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-lock" }) });
-            checkoutStatus = { isCheckedOut: true, mode: mode, icon: icon, version: version };
+    // Variabili comuni per entrambi i formati di documento
+    let checkoutUserId;
+    let checkoutDate;
+    let version = 1;
+    let fileExt;
+    // ========================================================================
+    // CASO 1: Documento come Array di MetadataValueDescriptorEx
+    // ========================================================================
+    // 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;
+        // 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;
+        checkoutUserId = checkoutUserIdValue ? Number(checkoutUserIdValue) : undefined;
+        // Estrai la data di checkout
+        const checkoutDateProperty = dcmtsArray.find((item) => item.md?.name === CICO_MetadataNames.CICO_CheckoutDate);
+        checkoutDate = checkoutDateProperty?.value;
+        // Estrai la versione del documento
+        const versionProperty = dcmtsArray.find((item) => item.md?.name === CICO_MetadataNames.CICO_Version);
+        const versionRaw = versionProperty?.value;
+        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;
+    }
+    // ========================================================================
+    // CASO 2: Documento come Oggetto Piatto (formato standard)
+    // ========================================================================
+    // Questo formato viene utilizzato quando il documento ha proprietà dirette
+    // nel formato chiave-valore: TID, DID, e "TID_MetadataID" per i metadati
+    else {
+        // Trova i metadati CICO nel descrittore del tipo documento
+        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);
+        fileExt = dcmt.FILEEXT ? dcmt.FILEEXT.toString() : null;
+        // Estrai l'ID dell'utente che ha effettuato il checkout
+        if (CICO_CheckoutUserID_Meta?.id) {
+            const keyUserID = dcmt.TID + "_" + CICO_CheckoutUserID_Meta.id;
+            const checkoutUserIdValue = dcmt[keyUserID];
+            checkoutUserId = checkoutUserIdValue ? Number(checkoutUserIdValue) : undefined;
+        }
+        // Estrai la data di checkout
+        if (CICO_CheckoutDate_Meta?.id) {
+            const keyDate = dcmt.TID + "_" + CICO_CheckoutDate_Meta.id;
+            checkoutDate = dcmt[keyDate];
+        }
+        // Estrai la versione del documento
+        if (CICO_Version_Meta?.id) {
+            const keyVersion = dcmt.TID + "_" + CICO_Version_Meta.id;
+            const versionRaw = dcmt[keyVersion];
+            version = (versionRaw != null && !isNaN(Number(versionRaw))) ? Number(versionRaw) : 1;
         }
     }
+    // ========================================================================
+    // COSTRUZIONE DELLO STATO DI CHECKOUT
+    // ========================================================================
+    let checkoutStatus = {
+        isCheckedOut: false,
+        mode: '',
+        version: version,
+        icon: null,
+        editLockTooltipText: null
+    };
+    // Verifica se il documento è effettivamente in stato di checkout
+    if (userID && checkoutUserId && !isNaN(checkoutUserId) && checkoutUserId > 0) {
+        // Determina la modalità in base all'utente:
+        // - editMode: l'utente corrente può modificare (è lui che ha fatto il checkout)
+        // - lockMode: il documento è bloccato da un altro utente
+        const mode = (userID === checkoutUserId) ? 'editMode' : 'lockMode';
+        // ====================================================================
+        // COSTRUZIONE DEL TOOLTIP INFORMATIVO
+        // ====================================================================
+        const editLockTooltipText = (_jsxs(_Fragment, { children: [_jsxs("div", { style: { textAlign: "center" }, children: [mode === 'editMode' && (_jsxs(_Fragment, { children: [_jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-edit" }), SDKUI_Localizator.CurrentUserExtract] })), mode === 'lockMode' && (_jsxs(_Fragment, { children: [_jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-lock" }), SDKUI_Localizator.ExtractedFromOtherUser] }))] }), _jsx("hr", {}), _jsxs("div", { style: { textAlign: "left" }, children: [_jsxs("ul", { children: [_jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.ExtractedBy }), ": ", findCheckOutUserName(allUsers, checkoutUserId), " (ID: ", checkoutUserId, ")"] }), _jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.ExtractedOn }), ": ", Globalization.getDateTimeDisplayValue(checkoutDate?.toString())] })] }), _jsx("hr", {}), _jsx("ul", { children: _jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.Version }), ": ", version] }) })] })] }));
+        // Crea l'icona con tooltip appropriata alla modalità
+        const icon = mode === 'editMode'
+            ? _jsx(TMTooltip, { content: editLockTooltipText, children: _jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-edit" }) })
+            : _jsx(TMTooltip, { content: editLockTooltipText, children: _jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-lock" }) });
+        checkoutStatus = {
+            isCheckedOut: true,
+            mode: mode,
+            icon: icon,
+            version: version,
+            editLockTooltipText: editLockTooltipText
+        };
+    }
+    // ========================================================================
+    // RESTITUZIONE RISULTATO FINALE
+    // ========================================================================
     return {
-        cicoEnabled: cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes,
+        // CICO è abilitato se configurato nel DTD e l'utente ha i permessi
+        cicoEnabled: cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes && fileExt !== null && fileExt !== '',
         checkoutStatus: checkoutStatus
     };
 };

package/lib/helper/devextremeCustomMessages.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Custom DevExtreme localization messages
+ * Contains missing translations for DevExtreme components
+ */
+export declare const devextremeCustomMessages: {
+    de: {
+        "dxDataGrid-moveColumnToTheRight": string;
+        "dxDataGrid-moveColumnToTheLeft": string;
+    };
+    en: {
+        "dxDataGrid-moveColumnToTheRight": string;
+        "dxDataGrid-moveColumnToTheLeft": string;
+    };
+    es: {
+        "dxDataGrid-moveColumnToTheRight": string;
+        "dxDataGrid-moveColumnToTheLeft": string;
+    };
+    fr: {
+        "dxDataGrid-moveColumnToTheRight": string;
+        "dxDataGrid-moveColumnToTheLeft": string;
+    };
+    it: {
+        "dxDataGrid-moveColumnToTheRight": string;
+        "dxDataGrid-moveColumnToTheLeft": string;
+    };
+    pt: {
+        "dxDataGrid-moveColumnToTheRight": string;
+        "dxDataGrid-moveColumnToTheLeft": string;
+    };
+};

package/lib/helper/devextremeCustomMessages.js

@@ -0,0 +1,30 @@
+/**
+ * Custom DevExtreme localization messages
+ * Contains missing translations for DevExtreme components
+ */
+export const devextremeCustomMessages = {
+    "de": {
+        "dxDataGrid-moveColumnToTheRight": "Nach rechts verschieben",
+        "dxDataGrid-moveColumnToTheLeft": "Nach links verschieben"
+    },
+    "en": {
+        "dxDataGrid-moveColumnToTheRight": "Move to the right",
+        "dxDataGrid-moveColumnToTheLeft": "Move to the left"
+    },
+    "es": {
+        "dxDataGrid-moveColumnToTheRight": "Mover a la derecha",
+        "dxDataGrid-moveColumnToTheLeft": "Mover a la izquierda"
+    },
+    "fr": {
+        "dxDataGrid-moveColumnToTheRight": "Déplacer vers la droite",
+        "dxDataGrid-moveColumnToTheLeft": "Déplacer vers la gauche"
+    },
+    "it": {
+        "dxDataGrid-moveColumnToTheRight": "Sposta a destra",
+        "dxDataGrid-moveColumnToTheLeft": "Sposta a sinistra"
+    },
+    "pt": {
+        "dxDataGrid-moveColumnToTheRight": "Mover para a direita",
+        "dxDataGrid-moveColumnToTheLeft": "Mover para a esquerda"
+    }
+};

package/lib/helper/helpers.d.ts

@@ -1,6 +1,6 @@
 import { Colors as ColorsType } from "../components/base/TMEditorBase";
 import { DeviceType } from "../components";
-import { AppModules, DataColumnDescriptor, ITopMediaSession, MetadataDescriptor, QueryDescriptor, SearchResultDescriptor } from "@topconsultnpm/sdk-ts";
+import { AppModules, DataColumnDescriptor, DcmtTypeDescriptor, ITopMediaSession, MetadataDescriptor, QueryDescriptor, SearchResultDescriptor } from "@topconsultnpm/sdk-ts";
 import { FileExtensionHandler, FormModes, moduleTypes } from "../ts";
 declare const TABLET_WIDTH = 1024;
 declare const MOBILE_WIDTH = 640;
@@ -89,3 +89,4 @@ export declare class AreaHelper {
     static ExtractAreaInfo_1(areaPath: string): AreaValues;
     static ExtractAreaInfo_2(areaPath: string, extractFileName: boolean): AreaValues;
 }
+export declare const isApprovalWorkflowView: (dtd: DcmtTypeDescriptor) => boolean;

package/lib/helper/helpers.js

@@ -1,7 +1,7 @@
 import { Fragment as _Fragment, jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Colors } from "../utils/theme";
 import { ButtonNames, DeviceType, TMExceptionBoxManager, TMMessageBoxManager, TMSpinner } from "../components";
-import { AccessLevels, MetadataDataDomains, MetadataDataTypes, MetadataDescriptor, MetadataFormatDescriptor, MetadataFormats, MetadataPermission, SDK_Globals, SetGlobalsInfoAsync, SystemMIDs, SystemMIDsAsNumber, TopMediaServer } from "@topconsultnpm/sdk-ts";
+import { AccessLevels, MetadataDataDomains, MetadataDataTypes, MetadataDescriptor, MetadataFormatDescriptor, MetadataFormats, MetadataPermission, SDK_Globals, SetGlobalsInfoAsync, SystemMIDs, SystemMIDsAsNumber, TopMediaServer, WorkItemMetadataNames } from "@topconsultnpm/sdk-ts";
 import { Buffer } from 'buffer';
 import { buildTypes, FileExtensionHandler, FormModes, moduleTypes } from "../ts";
 import { SDKUI_Localizator } from "./SDKUI_Localizator";
@@ -664,7 +664,13 @@ export const renderHighlightedText = (text, searchText, isSelected) => {
     return text.split(regex).map((part, index) => regex.test(part) ? (_jsx("span", { style: { backgroundColor: isSelected ? '#6c9023' : 'yellow' }, children: part }, index)) : (part));
 };
 export function versionAndBuildtypeInfo(module) {
-    return moduleVersion(module);
+    switch (module) {
+        case moduleTypes.SDK:
+        case moduleTypes.SDKUI:
+            return moduleVersion(module).replace("-hotfix", "+hotfix");
+        default:
+            return moduleVersion(module);
+    }
 }
 export const getListMaxItems = (deviceType) => { return deviceType === DeviceType.MOBILE ? 8 : 12; };
 export const svgToString = (icon) => {
@@ -850,3 +856,7 @@ export class AreaHelper {
 }
 AreaHelper.AreaPathPrefix = "tmarea:\\\\";
 AreaHelper.AreaFolderNamePrefix = "AID_";
+export const isApprovalWorkflowView = (dtd) => {
+    return Boolean(dtd?.isView &&
+        dtd.metadata?.some(data => data.name === WorkItemMetadataNames.WI_DID));
+};

package/lib/helper/index.d.ts

@@ -9,6 +9,7 @@ export * from './queryHelper';
 export * from './TMUtils';
 export * from './TMCommandsContextMenu';
 export * from './TMConditionalWrapper';
+export * from './TMPdfViewer';
 export * from './TMToppyMessage';
 export * from './GlobalStyles';
 export * from './checkinCheckoutManager';

package/lib/helper/index.js

@@ -9,6 +9,7 @@ export * from './queryHelper';
 export * from './TMUtils';
 export * from './TMCommandsContextMenu';
 export * from './TMConditionalWrapper';
+export * from './TMPdfViewer';
 export * from './TMToppyMessage';
 export * from './GlobalStyles';
 export * from './checkinCheckoutManager';

package/lib/helper/queryHelper.js

@@ -2,6 +2,7 @@ import { AccessLevels, MetadataDataDomains, DcmtTypeListCacheService, SystemMIDs
 import { DateDisplayTypes, Globalization } from './Globalization';
 import { ChronologyMIDs, DraftsMIDs, MetadataValueDescriptorEx } from '../ts';
 import { SDKUI_Localizator } from './SDKUI_Localizator';
+import { getDcmtCicoInfo } from './checkinCheckoutManager';
 export const getTIDsByQd = (qd) => {
     let tids = [];
     qd?.from?.tid && tids.push({ tid: qd.from?.tid, alias: undefined });
@@ -82,6 +83,22 @@ export const prepareQdForSearchAsync = async (qdInput, removeWhereItemNoValue) =
         addHiddenSelectItem(qd.select, fromTID, SystemMIDsAsNumber.IsMail);
         addHiddenSelectItem(qd.select, fromTID, SystemMIDsAsNumber.IsSigned);
         addHiddenSelectItem(qd.select, fromTID, SystemMIDsAsNumber.IsShared);
+        const dtd = await DcmtTypeListCacheService.GetAsync(fromTID);
+        if (dtd) {
+            const cicoInfo = getDcmtCicoInfo(dtd);
+            const canCICO = cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes;
+            if (canCICO) {
+                if (!qd.select.find(o => o.mid == cicoInfo.UserID_MID) && cicoInfo.UserID_CanViewOrUpdate == AccessLevels.Yes) {
+                    addHiddenSelectItem(qd.select, fromTID, cicoInfo.UserID_MID);
+                }
+                if (!qd.select.find(o => o.mid == cicoInfo.Date_MID) && cicoInfo.Date_CanViewOrUpdate == AccessLevels.Yes) {
+                    addHiddenSelectItem(qd.select, fromTID, cicoInfo.Date_MID);
+                }
+                if (!qd.select.find(o => o.mid == cicoInfo.Ver_MID) && cicoInfo.Ver_CanViewOrUpdate == AccessLevels.Yes) {
+                    addHiddenSelectItem(qd.select, fromTID, cicoInfo.Ver_MID);
+                }
+            }
+        }
         if (qd.orderBy && qd.orderBy.length <= 0) {
             let obi = new OrderByItem();
             obi.tid = fromTID;
@@ -311,6 +328,18 @@ export const searchResultToMetadataValues = (tid, dtd, rows, mids, metadata, lay
                     mvd.customName = SDKUI_Localizator.Author;
                     mvd.isReadOnly = true;
                     break;
+                case ChronologyMIDs.CheckInTime:
+                    mvd.customName = SDKUI_Localizator.LastUpdateTime;
+                    mvd.isReadOnly = true;
+                    break;
+                case SystemMIDsAsNumber.FileExt:
+                    mvd.customName = SDKUI_Localizator.Extension;
+                    mvd.isReadOnly = true;
+                    break;
+                case SystemMIDsAsNumber.FileSize:
+                    mvd.customName = SDKUI_Localizator.File_Size;
+                    mvd.isReadOnly = true;
+                    break;
             }
         }
         return mvd;