@topconsultnpm/sdkui-react 6.20.0-dev1.14 → 6.20.0-dev1.16

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";
@@ -191,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,
@@ -210,57 +210,137 @@ 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 }
         };
     }
+    // ========================================================================
+    // 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
+    };
+    // 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
+        };
+    }
+    // ========================================================================
+    // 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.js

@@ -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) => {

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;

package/lib/hooks/useCheckInOutOperations.d.ts

@@ -0,0 +1,28 @@
+import { DcmtInfo, DownloadModes, DownloadTypes } from '../ts';
+import { FileDescriptor, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
+interface UseCheckInOutOperationsReturn {
+    showHistory: boolean;
+    showHistoryCallback: () => void;
+    hideHistoryCallback: () => void;
+    showCheckoutInformationForm: boolean;
+    showCheckoutInformationFormCallback: () => void;
+    hideCheckoutInformationFormCallback: () => void;
+    commentFormState: {
+        removeAndEditAttachment: boolean;
+        show: boolean;
+        isRequired: boolean;
+    };
+    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>, refreshCurrentDcmt?: () => Promise<void>, refreshFocusedDataRowAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
+    handleCheckInCallback: (dcmt: DcmtInfo, refreshCurrentDcmt?: () => Promise<void>, refreshFocusedDataRowAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
+    refreshPreviewTrigger: number;
+    showCicoWaitPanel: boolean;
+    cicoWaitPanelTitle: string;
+    showCicoPrimaryProgress: boolean;
+    cicoPrimaryProgressText: string;
+    cicoPrimaryProgressValue: number;
+    cicoPrimaryProgressMax: number;
+}
+export declare const useCheckInOutOperations: () => UseCheckInOutOperationsReturn;
+export {};

package/lib/hooks/useCheckInOutOperations.js

@@ -0,0 +1,223 @@
+import { useCallback, 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 { ResultTypes, SDK_Globals } from '@topconsultnpm/sdk-ts';
+let abortController = new AbortController();
+export const useCheckInOutOperations = () => {
+    const [showHistory, setShowHistory] = useState(false);
+    // State to manage show history selected file
+    const [showCheckoutInformationForm, setShowCheckoutInformationForm] = useState(false);
+    // Stato per triggerare il refresh della preview dall'esterno
+    const [refreshPreviewTrigger, setRefreshPreviewTrigger] = useState(0);
+    // State to manage comment form
+    const [commentFormState, setCommentFormState] = useState({
+        removeAndEditAttachment: true,
+        show: false,
+        isRequired: false
+    });
+    // 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
+    const [cicoWaitPanelTitle, setCicoWaitPanelTitle] = useState('');
+    // State variable to control the visibility of the primary section of the wait panel
+    const [showCicoPrimaryProgress, setShowCicoPrimaryProgress] = useState(false);
+    // State variable to store the primary text of the wait panel
+    const [cicoPrimaryProgressText, setCicoPrimaryProgressText] = useState('');
+    // State variable to track the current value of the primary progress indicator in the wait panel
+    const [cicoPrimaryProgressValue, setCicoPrimaryProgressValue] = useState(0);
+    // State variable to define the maximum value for the primary progress indicator in the wait panel
+    const [cicoPrimaryProgressMax, setCicoPrimaryProgressMax] = useState(0);
+    const showHistoryCallback = useCallback(() => {
+        setShowHistory(true);
+    }, []);
+    const hideHistoryCallback = useCallback(() => {
+        setShowHistory(false);
+    }, []);
+    const showCheckoutInformationFormCallback = useCallback(() => {
+        setShowCheckoutInformationForm(true);
+    }, []);
+    const hideCheckoutInformationFormCallback = useCallback(() => {
+        setShowCheckoutInformationForm(false);
+    }, []);
+    const triggerPreviewRefresh = useCallback(() => {
+        setRefreshPreviewTrigger(prev => prev + 1);
+    }, []);
+    const hideCommentFormCallback = useCallback(() => {
+        setCommentFormState(prev => ({ ...prev, show: false }));
+    }, []);
+    const copyCheckoutPathToClipboardCallback = (dcmt, filename) => {
+        const defaultCheckInOutFolder = SDKUI_Globals.userSettings.defaultCheckInOutFolder ?? "Download";
+        const wGSDraftCheckoutItemCurrentItems = [...SDKUI_Globals.userSettings.dcmtCheckoutInfo];
+        const existingItem = wGSDraftCheckoutItemCurrentItems.find((item) => item.TID === dcmt.TID.toString() && item.DID === dcmt.DID.toString());
+        const folder = existingItem && existingItem.checkoutFolder && existingItem.checkoutFolder !== "" ? existingItem.checkoutFolder : defaultCheckInOutFolder;
+        const name = existingItem?.checkoutName ?? getCicoDownloadFileName({ type: 'dcmtInfo', dcmtInfo: dcmt, originalFileName: filename }, true, false);
+        const textToCopy = folder ? `${folder}\\${name}` : name;
+        navigator.clipboard.writeText(textToCopy)
+            .then(() => {
+            ShowAlert({ message: SDKUI_Localizator.OperationSuccess, mode: 'success', duration: 5000, title: SDKUI_Localizator.CopyToClipboard });
+        })
+            .catch(err => {
+            ShowAlert({ message: err, mode: 'error', duration: 5000, title: SDKUI_Localizator.OperationResult });
+        });
+    };
+    const handleCheckOutCallback = async (dcmt, checkout, filename, downloadDcmtsAsync, refreshMetadataAsync, refreshFocusedDataRowAsync) => {
+        if (!dcmt)
+            throw new Error("Document info is required");
+        const title = checkout ? 'Check out' : SDKUI_Localizator.CancelCheckOut;
+        const msg = checkout ? SDKUI_Localizator.ExecuteCheckOutQuestion : SDKUI_Localizator.ExecuteCancelCheckOutQuestion;
+        TMMessageBoxManager.show({
+            title: title,
+            message: msg,
+            buttons: [ButtonNames.YES, ButtonNames.NO],
+            onButtonClick: async (e) => {
+                if (e !== ButtonNames.YES)
+                    return;
+                let result = [];
+                try {
+                    setCicoWaitPanelTitle(title);
+                    setShowCicoWaitPanel(true);
+                    setShowCicoPrimaryProgress(true);
+                    abortController = new AbortController();
+                    const ue = SDK_Globals.tmSession?.NewUpdateEngineByID();
+                    if (!ue)
+                        throw new Error("Update Engine not available");
+                    ue.TID = dcmt.TID;
+                    ue.DID = dcmt.DID;
+                    if (checkout) {
+                        await ue.CheckOutAsync()
+                            .then(async () => {
+                            await cicoDownloadFilesCallback([{ type: 'dcmtInfo', dcmtInfo: dcmt, originalFileName: filename }], true, downloadDcmtsAsync);
+                            result.push({ rowIndex: 1, id1: dcmt.TID, id2: dcmt.DID, description: SDKUI_Localizator.UpdateCompletedSuccessfully, resultType: ResultTypes.SUCCESS });
+                            await refreshMetadataAsync?.();
+                            await refreshFocusedDataRowAsync?.(dcmt.TID, dcmt.DID, true);
+                        })
+                            .catch((error) => {
+                            result.push({ rowIndex: 1, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(error) });
+                            throw error;
+                        });
+                    }
+                    else {
+                        await ue.UndoCheckOutAsync()
+                            .then(async () => {
+                            result.push({ rowIndex: 1, id1: dcmt.TID, id2: dcmt.DID, description: SDKUI_Localizator.UpdateCompletedSuccessfully, resultType: ResultTypes.SUCCESS });
+                            // Remove the corresponding draft checkout item
+                            updateCicoCheckoutStorageItem({ TID: dcmt.TID.toString(), DID: dcmt.DID.toString(), checkoutFolder: "", checkoutName: "" }, "dcmtInfo", "remove");
+                            await refreshMetadataAsync?.();
+                            await refreshFocusedDataRowAsync?.(dcmt.TID, dcmt.DID, true);
+                        })
+                            .catch((error) => {
+                            result.push({ rowIndex: 0, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(error) });
+                            throw error;
+                        });
+                    }
+                }
+                catch (error) {
+                    result.push({ rowIndex: 1, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(error) });
+                }
+                finally {
+                    setCicoPrimaryProgressText('');
+                    setCicoPrimaryProgressMax(0);
+                    setCicoPrimaryProgressValue(0);
+                    setShowCicoWaitPanel(false);
+                    TMResultManager.show(result, title, "ID", undefined);
+                }
+            }
+        });
+    };
+    const triggerCommentOnFileAdd = (addedFiles) => {
+        if (addedFiles.length > 0) {
+            setCommentFormState({
+                show: true,
+                isRequired: true,
+                removeAndEditAttachment: false
+            });
+        }
+    };
+    const handleCheckInCallback = async (dcmt, refreshMetadataAsync, refreshFocusedDataRowAsync) => {
+        if (!dcmt)
+            throw new Error("Document info is required");
+        // Create a new file input element
+        const input = document.createElement("input");
+        // Set the input type to "file" to allow file selection
+        input.type = "file";
+        // Set the accepted file types (e.g., images, PDFs, etc.)
+        input.accept = "*/*";
+        // Enable the input to accept one file at once
+        input.multiple = false;
+        // Add an event listener for when the file selection changes
+        input.addEventListener('change', async (event) => {
+            const fileInput = event.target;
+            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);
+            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",
+                onButtonClick: async (e) => {
+                    if (e !== ButtonNames.YES)
+                        return;
+                    setCicoWaitPanelTitle('Check in');
+                    setShowCicoWaitPanel(true);
+                    setShowCicoPrimaryProgress(true);
+                    abortController = new AbortController();
+                    let result = [];
+                    let i = 0;
+                    if (dcmt.TID && dcmt.DID) {
+                        try {
+                            const ue = SDK_Globals.tmSession?.NewUpdateEngineByID();
+                            if (ue) {
+                                ue.TID = dcmt.TID;
+                                ue.DID = dcmt.DID;
+                                await ue.CheckInAsync(file, "", abortController.signal);
+                                // Remove the corresponding draft checkout item
+                                updateCicoCheckoutStorageItem({ TID: dcmt.TID.toString(), DID: dcmt.DID.toString(), checkoutFolder: "", checkoutName: "" }, "dcmtInfo", "remove");
+                                result.push({ rowIndex: i, id1: dcmt.DID, id2: dcmt.DID, description: SDKUI_Localizator.UpdateCompletedSuccessfully, resultType: ResultTypes.SUCCESS });
+                                await refreshMetadataAsync?.();
+                                await refreshFocusedDataRowAsync?.(dcmt.TID, dcmt.DID, true);
+                                const cacheKey = `${dcmt.TID}-${dcmt.DID}`;
+                                if (dcmtsFileCachePreview.has(cacheKey))
+                                    removeDcmtsFileCache(cacheKey);
+                                triggerPreviewRefresh();
+                                triggerCommentOnFileAdd([dcmt.DID]);
+                            }
+                        }
+                        catch (err) {
+                            result.push({ rowIndex: i, id1: i, id2: i, resultType: ResultTypes.ERROR, description: getExceptionMessage(err) });
+                        }
+                        finally {
+                            setCicoPrimaryProgressText('');
+                            setCicoPrimaryProgressMax(0);
+                            setCicoPrimaryProgressValue(0);
+                            setShowCicoWaitPanel(false);
+                            TMResultManager.show(result, 'Check in', "ID", undefined, SDKUI_Localizator.CheckInSuccessMessage, 6000);
+                        }
+                    }
+                },
+            });
+        });
+        input.click();
+    };
+    return {
+        showHistory,
+        showHistoryCallback,
+        hideHistoryCallback,
+        showCheckoutInformationForm,
+        showCheckoutInformationFormCallback,
+        hideCheckoutInformationFormCallback,
+        commentFormState,
+        hideCommentFormCallback,
+        copyCheckoutPathToClipboardCallback,
+        handleCheckOutCallback,
+        handleCheckInCallback,
+        refreshPreviewTrigger,
+        showCicoWaitPanel,
+        cicoWaitPanelTitle,
+        showCicoPrimaryProgress,
+        cicoPrimaryProgressText,
+        cicoPrimaryProgressValue,
+        cicoPrimaryProgressMax,
+    };
+};

package/package.json

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

package/lib/components/NewComponents/ContextMenu/TMContextMenu.d.ts

@@ -1,4 +0,0 @@
-import React from 'react';
-import type { TMContextMenuProps } from './types';
-declare const TMContextMenu: React.FC<TMContextMenuProps>;
-export default TMContextMenu;