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

package/lib/helper/checkinCheckoutManager.js

@@ -0,0 +1,346 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+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";
+const findCheckOutUserName = (users, checkoutUserId) => {
+    let checkOutUser = users.find(user => user.id === checkoutUserId);
+    return checkOutUser ? checkOutUser.name : '-';
+};
+const colors = {
+    MEDIUM_GREEN: "#28a745",
+};
+export const getCicoDownloadFileName = (source, checkout, withTimestampAndExt) => {
+    const archiveID = SDK_Globals.tmSession?.SessionDescr?.archiveID;
+    if (!archiveID)
+        return '';
+    let baseName;
+    let tid;
+    let did;
+    let ext;
+    if (source.type === 'fileItem') {
+        // fileItem source
+        const { name, tid: tidValue, did: didValue, ext: extValue } = source.fileItem;
+        baseName = name.includes('.') ? name.substring(0, name.lastIndexOf('.')) : name;
+        tid = Number(tidValue);
+        did = Number(didValue);
+        ext = extValue;
+    }
+    else {
+        // dcmtInfo source
+        const { dcmtInfo, originalFileName } = source;
+        const { TID, DID, FILEEXT } = dcmtInfo;
+        baseName = originalFileName.includes('.') ? originalFileName.substring(0, originalFileName.lastIndexOf('.')) : originalFileName;
+        tid = TID;
+        did = DID;
+        ext = FILEEXT;
+    }
+    const fileIdentifier = `${archiveID}~${baseName}~${tid}~${did}`;
+    const extension = withTimestampAndExt && ext ? `.${ext}` : '';
+    let timestamp = '';
+    if (checkout && withTimestampAndExt) {
+        const now = new Date();
+        const pad = (n) => n.toString().padStart(2, '0');
+        timestamp = `~${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    }
+    return `${checkout ? 'checkout~' : ''}${fileIdentifier}${timestamp}${extension}`;
+};
+export const cicoDownloadFilesCallback = async (sources, checkout, downloadDcmtsAsync) => {
+    const files = [];
+    sources.forEach(source => {
+        let tid;
+        let did;
+        let ext;
+        if (source.type === 'fileItem') {
+            tid = Number(source.fileItem.tid);
+            did = Number(source.fileItem.did);
+            ext = source.fileItem.ext;
+        }
+        else {
+            tid = source.dcmtInfo.TID;
+            did = source.dcmtInfo.DID;
+            ext = source.dcmtInfo.FILEEXT;
+        }
+        if (tid && did && ext) {
+            let fileName = getCicoDownloadFileName(source, checkout, true);
+            if (checkout) {
+                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 });
+        }
+    });
+    if (files.length > 0)
+        await downloadDcmtsAsync(files, DownloadTypes.Dcmt, "download");
+};
+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
+    const index = currentItems.findIndex(i => i.TID === item.TID && i.DID === item.DID);
+    // If the action is to add a new item or update an existing one
+    if (action === "addOrUpdate") {
+        if (index >= 0) {
+            // If the item exists, overwrite it with the new values
+            currentItems[index] = item;
+        }
+        else {
+            // If the item does not exist, push it into the array
+            currentItems.push(item);
+        }
+    }
+    else if (action === "remove" && index >= 0) {
+        // If the action is to remove an item, remove it from the array
+        currentItems.splice(index, 1);
+    }
+    // Update the global array with the modified copy
+    if (type === 'dcmtInfo') {
+        SDKUI_Globals.userSettings.dcmtCheckoutInfo = currentItems;
+    }
+    else {
+        SDKUI_Globals.userSettings.wgDraftCheckoutInfo = currentItems;
+    }
+};
+export const validateCicoFileName = (source, fileName) => {
+    const archiveID = SDK_Globals.tmSession?.SessionDescr?.archiveID;
+    let baseName;
+    let tid;
+    let did;
+    let ext;
+    if (source.type === 'fileItem') {
+        // fileItem source
+        const { name: originalName, tid: tidValue, did: didValue, ext: extValue } = source.fileItem;
+        baseName = originalName.includes('.') ? originalName.substring(0, originalName.lastIndexOf('.')) : originalName;
+        tid = Number(tidValue);
+        did = Number(didValue);
+        ext = extValue;
+    }
+    else {
+        // dcmtInfo source
+        const { dcmtInfo, originalFileName } = source;
+        const { TID, DID, FILEEXT } = dcmtInfo;
+        baseName = originalFileName.includes('.') ? originalFileName.substring(0, originalFileName.lastIndexOf('.')) : originalFileName;
+        tid = TID;
+        did = DID;
+        ext = FILEEXT;
+    }
+    // Ensure originalName has the extension
+    const normalizedExt = ext?.toLowerCase() ?? '';
+    const name = baseName.toLowerCase().endsWith(`.${normalizedExt}`) ? baseName : `${baseName}.${normalizedExt}`;
+    let fileNameToValidate = fileName;
+    const fileExtensionCheck = fileNameToValidate.split('.').pop() ?? '';
+    // Remove extension part
+    fileNameToValidate = fileNameToValidate.slice(0, -fileExtensionCheck.length - 1);
+    // Check and remove 'checkout~' prefix if present
+    const hasCheckoutPrefix = fileNameToValidate.startsWith('checkout~');
+    if (hasCheckoutPrefix) {
+        fileNameToValidate = fileNameToValidate.replace(/^checkout~/, '');
+    }
+    // Split the remaining string by underscores (~)
+    const parts = fileNameToValidate.split('~');
+    if (parts.length !== 5) {
+        return {
+            isValid: false,
+        };
+    }
+    // Extract components starting from the end
+    const archiveCheck = parts[0];
+    const nameCheck = parts[1];
+    const tidCheck = parts[2];
+    const didCheck = parts[3];
+    // Validation checks
+    const expectedFullName = `${nameCheck}.${fileExtensionCheck}`.toLowerCase();
+    const isValidName = expectedFullName === name.toLowerCase();
+    const isValidDid = didCheck ? did.toString() === parseInt(didCheck, 10).toString() : false;
+    const isValidTid = tidCheck ? tid.toString() === parseInt(tidCheck, 10).toString() : false;
+    const isValidArchive = archiveCheck ? archiveCheck === archiveID : false;
+    const isValidExt = ext ? ext.toLowerCase() === fileExtensionCheck.toLowerCase() : false;
+    // Return validation results as an object
+    return {
+        isValid: !!(isValidName && isValidArchive && isValidDid && isValidTid && isValidExt),
+        validationResults: {
+            archiveID: {
+                expected: archiveID,
+                current: archiveCheck,
+                isValid: isValidArchive
+            },
+            name: {
+                expected: name.toLowerCase(),
+                current: expectedFullName,
+                isValid: isValidName
+            },
+            did: {
+                expected: did?.toString(),
+                current: didCheck,
+                isValid: isValidDid
+            },
+            tid: {
+                expected: tid.toString(),
+                current: tidCheck,
+                isValid: isValidTid
+            },
+            fileExtension: {
+                expected: ext?.toLowerCase(),
+                current: fileExtensionCheck.toLowerCase(),
+                isValid: isValidExt
+            }
+        }
+    };
+};
+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 })] })] });
+};
+export const getDcmtCicoInfo = (dtd) => {
+    const cico = {
+        CICO: 0,
+        CanCICO: AccessLevels.No,
+        CanDelChronology: AccessLevels.No,
+        UserID_MID: 0,
+        Date_MID: 0,
+        Ver_MID: 0,
+        UserID_CanViewOrUpdate: AccessLevels.No,
+        Date_CanViewOrUpdate: AccessLevels.No,
+        Ver_CanViewOrUpdate: AccessLevels.No,
+    };
+    if (dtd === undefined)
+        return cico;
+    cico.CICO = dtd.cico ?? 0;
+    cico.CanCICO = dtd.perm?.canCICO ?? AccessLevels.No;
+    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.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.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.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 userID = SDK_Globals.tmSession?.SessionDescr?.userID;
+    // 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 {
+        // 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/dcmtsHelper.d.ts

@@ -0,0 +1,8 @@
+import { MetadataValueDescriptorEx } from "../ts";
+/** Check if dcmtType (mTID) has configured Detail or Many-to-Many relations */
+export declare const hasDetailRelations: (mTID: number | undefined) => Promise<boolean>;
+/** Check if dcmtType (mTID) has configured Master or Many-to-Many relations */
+export declare const hasMasterRelations: (mTID: number | undefined) => Promise<boolean>;
+export declare const isXMLFileExt: (fileExt: string | undefined) => boolean;
+export declare const getButtonAttributes: (args: string | undefined, formData: MetadataValueDescriptorEx[] | undefined, selectedItems: Array<any> | undefined) => Record<string, any> | undefined;
+export declare const getSelectedItem: (args: string | undefined, formData: MetadataValueDescriptorEx[] | undefined, item: any) => Record<string, any> | undefined;

package/lib/helper/dcmtsHelper.js

@@ -0,0 +1,82 @@
+import { RelationCacheService, RelationTypes, SDK_Globals } from "@topconsultnpm/sdk-ts";
+/** Check if dcmtType (mTID) has configured Detail or Many-to-Many relations */
+export const hasDetailRelations = async (mTID) => {
+    let allRelations = await RelationCacheService.GetAllAsync();
+    let rdlOneToMany = allRelations?.filter(o => o.masterTID == mTID && o.relationType == RelationTypes.OneToMany) ?? [];
+    let rdlManyToMany = allRelations?.filter(o => o.relationType == RelationTypes.ManyToMany && (o.masterTID == mTID || o.detailTID == mTID)) ?? [];
+    return rdlManyToMany.length > 0 || rdlOneToMany.length > 0;
+};
+/** Check if dcmtType (mTID) has configured Master or Many-to-Many relations */
+export const hasMasterRelations = async (mTID) => {
+    let allRelations = await RelationCacheService.GetAllAsync();
+    let rdlOneToMany = allRelations?.filter(o => o.detailTID == mTID && o.relationType == RelationTypes.OneToMany) ?? [];
+    let rdlManyToMany = allRelations?.filter(o => o.relationType == RelationTypes.ManyToMany && (o.masterTID == mTID || o.detailTID == mTID)) ?? [];
+    return rdlManyToMany.length > 0 || rdlOneToMany.length > 0;
+};
+export const isXMLFileExt = (fileExt) => {
+    const fileExtension = fileExt?.toLowerCase() ?? '';
+    switch (fileExtension) {
+        case 'xml':
+        case 'xml.p7m':
+        case 'xml.p7m.ts':
+        case 'xml.p7m.tsd': return true;
+        default: return false;
+    }
+};
+/*utility functions for TMCustomButton*/
+export const getButtonAttributes = (args, formData, selectedItems) => args && formData ? formDataMap(formData, args, selectedItems) : undefined;
+const getSelectedItems = (selectedItems) => selectedItems && selectedItems.map(item => item["DID"]) || [];
+export const getSelectedItem = (args, formData, item) => {
+    //converto item in formData
+    const formDataConverted = [];
+    for (const key in item) {
+        const md = formData?.find(md => `${item["TID"]}_${md.mid}` === key);
+        if (md) { // aggiungo solo i metadati
+            const name = md.md?.name || "";
+            formDataConverted.push({ md: { name: name }, value: item[key] });
+        }
+    }
+    return args && formDataConverted ?
+        formDataMap(formDataConverted, args, []) : undefined;
+};
+const formDataMap = (data, args, selectedItems) => {
+    const session = SDK_Globals.tmSession;
+    const sessionDescr = session?.SessionDescr;
+    const result = {};
+    // Helper per estrarre il valore di un campo
+    const getParamValue = (fieldName) => {
+        const md = data.find(md => md.md?.name === fieldName);
+        switch (fieldName) {
+            case 'SelectedDIDs': return getSelectedItems(selectedItems);
+            case 'AuthenticationMode': return sessionDescr?.authenticationMode ?? null;
+            case 'ArchiveID': return sessionDescr?.archiveID ?? null;
+            case 'CultureID': return sessionDescr?.cultureID ?? null;
+            case 'Domain': return sessionDescr?.domain ?? null;
+            case 'UserID': return sessionDescr?.userID ?? null;
+            case 'UserName': return sessionDescr?.userName ?? null;
+            case 'Session': return session ?? null;
+            default: return md?.value;
+        }
+    };
+    // Regex per catturare: chiave=[...] o chiave={...} o {@campo}
+    const keyValueRegex = /(\w+)=\[([^\]]+)\]|(\w+)=\{@?([^}]+)\}|\{@([^}]+)\}/g;
+    for (const match of args.matchAll(keyValueRegex)) {
+        if (match[1]) {
+            // Formato: chiave=[{@campo} testo {@campo} ...]
+            const key = match[1];
+            const content = match[2].replace(/\{@([^}]+)\}/g, (_, fieldName) => data.find(md => md.md?.name === fieldName)?.value ?? '');
+            result[key] = content;
+        }
+        else if (match[3]) {
+            // Formato: chiave={@campo} o chiave={valore}
+            const key = match[3];
+            const value = match[4];
+            result[key] = value.startsWith('@') ? getParamValue(value.substring(1)) : value;
+        }
+        else if (match[5]) {
+            // Formato: {@campo}
+            result[match[5]] = getParamValue(match[5]);
+        }
+    }
+    return result;
+};

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

@@ -0,0 +1,91 @@
+import { Colors as ColorsType } from "../components/base/TMEditorBase";
+import { DeviceType } from "../components";
+import { AppModules, DataColumnDescriptor, ITopMediaSession, MetadataDescriptor, QueryDescriptor, SearchResultDescriptor } from "@topconsultnpm/sdk-ts";
+import { FileExtensionHandler, FormModes, moduleTypes } from "../ts";
+declare const TABLET_WIDTH = 1024;
+declare const MOBILE_WIDTH = 640;
+declare const calcResponsiveDirection: (deviceType: DeviceType, desktopDir: "horizontal" | "vertical", tabletDir: "horizontal" | "vertical", mobileDir: "horizontal" | "vertical") => "horizontal" | "vertical";
+declare const openApps: (appModule: AppModules, tmSession: ITopMediaSession, appRoutes?: any[]) => Promise<void>;
+export declare const setSDK_GlobalsInfoAsync: (tms: ITopMediaSession | undefined) => Promise<ITopMediaSession | undefined>;
+declare const calcResponsiveSizes: (deviceType: DeviceType | undefined, desktopSize: string, tabletSize: string, mobileSize: string) => string;
+declare const getColor: (color: ColorsType) => string;
+/**
+ * Genera un Universally Unique Identifier (UUID) versione 4.
+ * Simile a Guid.NewGuid() in C#.
+ * @returns {string} Un UUID in formato stringa.
+ */
+export declare const generateUUID: () => string;
+declare const makeID: (length: number) => string;
+export declare const truncateText: (text: string, maxLength: number) => string;
+declare function genUniqueId(): string;
+export declare const captionToDataField: (caption: string | undefined) => string;
+export declare const getDataColumnName: (fromTID: number | undefined, dtColumn: DataColumnDescriptor | undefined) => string;
+/**
+ * Generates unique column keys handling duplicates by adding incremental suffixes.
+ * @param columns Array of DataColumnDescriptor
+ * @param fromTID The TID to use for column name generation
+ * @returns Array of unique column keys
+ */
+export declare const generateUniqueColumnKeys: (columns: DataColumnDescriptor[] | undefined, fromTID: number | undefined) => string[];
+export declare const searchResultDescriptorToSimpleArray: (searchResult: SearchResultDescriptor | undefined) => any[] | undefined;
+export declare const getCompleteMetadataName: (dcmtTypeName: string | undefined, metadataName: string | undefined) => string;
+export declare const getQueryCountAsync: (qd: QueryDescriptor, showSpinner: boolean) => Promise<void>;
+export declare function getTIDByMID(mid: number | undefined, defaultTid?: number): number;
+export declare const getSystemMetadata: (withPerm?: boolean) => MetadataDescriptor[];
+export declare function deepCompare(obj1: any, obj2: any): boolean;
+export declare const extensionHandler: (fileExt: string | undefined) => FileExtensionHandler;
+export declare const downloadBase64File: (base64Data: string, fileName: string) => void;
+export declare const TASK_MORE_INFO_PREFIX_NAME: string;
+export declare const isTaskMoreInfo: (taskName: string | undefined) => boolean | undefined;
+export declare const canNext: (visibleItems: any[], selectedItems: any[]) => boolean;
+export declare const getNext: (visibleItems: any[], selectedItems: any[]) => any;
+export declare const canPrev: (visibleItems: any[], selectedItems: any[]) => boolean;
+export declare const getPrev: (visibleItems: any[], selectedItems: any[]) => any;
+export declare const calcSaveFormTitle: (rootTitle: string | undefined, formMode: FormModes, updateId: number | undefined, pathKeys: string[] | undefined) => string;
+export declare function calcIsModified(formData: any, formDataOrig: any): boolean;
+export { openApps, calcResponsiveDirection, calcResponsiveSizes, getColor, genUniqueId, makeID, MOBILE_WIDTH, TABLET_WIDTH };
+export declare function moduleVersion(module: moduleTypes): string;
+export declare function buildtype(module: moduleTypes): string;
+export declare const highlightText: (text: string, searchValue: string) => JSX.Element;
+export declare const renderHighlightedText: (text: string, searchText: string, isSelected: boolean) => string | (string | import("react/jsx-runtime").JSX.Element)[];
+export declare function versionAndBuildtypeInfo(module: moduleTypes): string;
+export declare const getListMaxItems: (deviceType: DeviceType | undefined) => number;
+export declare const svgToString: (icon: React.ReactElement) => string;
+export declare function stringIsNullOrEmpty(value: string | undefined): boolean;
+export declare function isPositiveNumber(val: unknown): val is number;
+export declare function sleep(ms: number): Promise<void>;
+export declare const dialogConfirmOperation: (title: string, msg: string, operationAsync: () => Promise<void>) => void;
+export declare enum LandingPages {
+    DASHBOARD = "dashboard",
+    SEARCH = "search",
+    ARCHIVE = "archive",
+    WORKING_GROUPS = "workingGroups",
+    WORKFLOW_APPR = "workflowAppr",
+    DOSSIERS = "dossiers",
+    FAVORITES = "favorites",
+    RECENT = "recent",
+    AREA_MANAGER = "areaManager",
+    NOTIFICATIONS = "notifications",
+    ACTIVITIES = "activities"
+}
+export declare function getExceptionMessage(ex: any): string;
+export declare function getContrastColor(inputColor: string): {
+    bgColor: string;
+    textColor: string;
+};
+/** Adds TID to a list of "most recently used" (MRU) TIDs, keeping a maximum of 10 elements  */
+export declare function updateMruTids(currentMruTIDs: number[] | undefined | null, newTid: unknown): number[];
+/** Remove TID to a list of "most recently used" (MRU) TIDs, keeping a maximum of 10 elements  */
+export declare function removeMruTid(currentMruTIDs: number[] | undefined | null, tidToRemove: unknown): number[];
+export declare class AreaValues {
+    aid: number;
+    subFolder: string;
+    fileName: string;
+}
+export declare class AreaHelper {
+    static readonly AreaPathPrefix: string;
+    static readonly AreaFolderNamePrefix: string;
+    static IsAreaPath(areaPath: string | undefined): boolean;
+    static ExtractAreaInfo_1(areaPath: string): AreaValues;
+    static ExtractAreaInfo_2(areaPath: string, extractFileName: boolean): AreaValues;
+}