@topconsultnpm/sdkui-react 6.21.0-dev4.11 → 6.21.0-dev4.13

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import { DcmtTypeDescriptor, SearchResultDescriptor, DataColumnDescriptor } from "@topconsultnpm/sdk-ts";
+import { DcmtMetadataMap } from '../../../helper';
 import { DcmtInfo, MetadataValueDescriptorEx } from '../../../ts';
 import { ITMTreeItem } from '../../base/TMTreeView';
 /**
@@ -19,7 +20,7 @@ export interface RelationTreeItem extends ITMTreeItem {
     isSeparator?: boolean;
     isInfoMessage?: boolean;
     isLogDel?: number;
-    values?: any;
+    values?: DcmtMetadataMap;
     searchResult?: SearchResultDescriptor[];
     itemsCount?: number;
     fileExt?: string;
@@ -131,14 +132,6 @@ export declare const hasDetailRelations: (mTID: number | undefined) => Promise<b
  * Check if document type has master relations
  */
 export declare const hasMasterRelations: (dTID: number | undefined) => Promise<boolean>;
-/**
- * Get metadata keys excluding system metadata
- */
-export declare const getMetadataKeys: (obj: any) => string[];
-/**
- * Get display value keys for a document (max 5, prioritize SYS_Abstract)
- */
-export declare const getDcmtDisplayValue: (obj: any) => string[];
 /**
  * Get display value formatted by column type
  */

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

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React, { useCallback, useEffect, useMemo, useState } from 'react';
-import { DcmtTypeListCacheService, SDK_Globals, DataColumnTypes, MetadataFormats, SystemMIDs, MetadataDataDomains, RelationCacheService, RelationTypes, UserListCacheService } from "@topconsultnpm/sdk-ts";
-import { genUniqueId, IconFolder, IconBackhandIndexPointingRight, IconCircleInfo, getDcmtCicoStatus, IconChevronDown, IconChevronRight, SDKUI_Localizator } from '../../../helper';
+import { DcmtTypeListCacheService, SDK_Globals, DataColumnTypes, MetadataFormats, MetadataDataDomains, RelationCacheService, RelationTypes, UserListCacheService } from "@topconsultnpm/sdk-ts";
+import { genUniqueId, IconFolder, IconBackhandIndexPointingRight, IconCircleInfo, getDcmtCicoStatus, IconChevronDown, IconChevronRight, SDKUI_Localizator, buildDcmtDisplayName } from '../../../helper';
 import ShowAlert from '../../base/TMAlert';
 import TMToppyMessage from '../../../helper/TMToppyMessage';
 import { TMColors } from '../../../utils/theme';
@@ -43,31 +43,6 @@ const isManyToManyRelation = async (relationID) => {
     const rdlManyToMany = allRelations.filter(o => o.relationType == RelationTypes.ManyToMany && o.id === relationID) ?? [];
     return rdlManyToMany.length > 0;
 };
-/**
- * Get metadata keys excluding system metadata
- */
-export const getMetadataKeys = (obj) => {
-    if (!obj)
-        return [];
-    const keys = Object.keys(obj);
-    // Escludi metadati di sistema (MID < 100 che sono uppercase) e altri campi tecnici
-    const sysMIDs = Object.values(SystemMIDs).map(o => o.toUpperCase());
-    return keys.filter(k => obj?.[k].value && !sysMIDs.includes(k)).filter(o => o !== "rowIndex" && o !== "ISLEXPROT");
-};
-/**
- * Get display value keys for a document (max 5, prioritize SYS_Abstract)
- */
-export const getDcmtDisplayValue = (obj) => {
-    if (!obj)
-        return [];
-    // Prima cerca SYS_Abstract
-    if (obj['SYS_Abstract']?.value) {
-        return ['SYS_Abstract'];
-    }
-    // Altrimenti prendi i primi 5 metadati non di sistema
-    const mdKeys = getMetadataKeys(obj);
-    return mdKeys.slice(0, 5);
-};
 /**
  * Get display value formatted by column type
  */
@@ -115,23 +90,34 @@ export const getDisplayValueByColumn = (col, value) => {
 export const searchResultToDataSource = async (searchResult, hideSysMetadata) => {
     const rows = searchResult?.dtdResult?.rows ?? [];
     const tid = searchResult?.fromTID;
-    const dtd = await DcmtTypeListCacheService.GetAsync(tid);
+    // IMPORTANT: Pass true to get full metadata with all properties (isSpecialSearchOutput, etc.)
+    const dtd = await DcmtTypeListCacheService.GetAsync(tid, true);
     const output = [];
     for (let index = 0; index < rows.length; index++) {
         const item = { rowIndex: index };
         const row = rows[index];
         for (let i = 0; i < row.length; i++) {
-            const mid = Number(searchResult?.dtdResult?.columns?.[i]?.extendedProperties?.["MID"] ?? "0");
+            const column = searchResult?.dtdResult?.columns?.[i];
+            const mid = Number(column?.extendedProperties?.["MID"] ?? "0");
             if (hideSysMetadata && mid < 100)
                 continue;
-            let key = searchResult?.dtdResult?.columns?.[i].caption ?? '';
-            if (mid <= 100)
+            // For system metadata (MID <= 100), use UPPERCASE caption as key
+            // For custom metadata (MID > 100), use caption as key but handle duplicates
+            let key = column?.caption ?? '';
+            if (mid <= 100) {
                 key = key.toUpperCase();
+            }
+            else {
+                // If key already exists with a different MID, append MID to make it unique
+                if (item[key] !== undefined && item[key]?.md?.id !== mid) {
+                    key = `${key}_${mid}`;
+                }
+            }
             const value = row[i];
             const md = dtd?.metadata?.find(o => o.id == mid);
             item[key] = {
                 md: md,
-                value: getDisplayValueByColumn(searchResult?.dtdResult?.columns?.[i], value)
+                value: getDisplayValueByColumn(column, value)
             };
         }
         output.push(item);
@@ -1126,34 +1112,36 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             : defaultDocumentStyle;
         const textDecoration = isLogicallyDeleted ? 'line-through' : 'none';
         const textColor = isLogicallyDeleted ? 'gray' : undefined;
-        const defaultMetadataContent = item.values && (_jsx(StyledDivHorizontal, { style: {
-                fontSize: '1rem',
-                overflow: 'hidden',
-                flex: 1,
-                minWidth: 0,
-                whiteSpace: 'nowrap',
-                textDecoration: textDecoration,
-                color: textColor
-            }, children: getDcmtDisplayValue(item.values).map((key, index) => {
-                const md = item.values?.[key]?.md;
-                const value = item.values?.[key]?.value;
-                const displayValues = getDcmtDisplayValue(item.values);
-                const isLast = index === displayValues.length - 1;
-                return (_jsxs(StyledDivHorizontal, { style: {
-                        flexShrink: isLast ? 1 : 0,
-                        minWidth: isLast ? 0 : 'auto',
-                        overflow: isLast ? 'hidden' : 'visible',
-                        textDecoration: textDecoration,
-                        color: textColor
-                    }, children: [index > 0 && _jsx("span", { style: { margin: '0 5px', color: textColor || '#999', textDecoration: textDecoration }, children: "\u2022" }), showMetadataNames && (_jsxs("span", { style: { color: textColor || '#666', marginRight: '5px', textDecoration: textDecoration }, children: [md?.name || key, ":"] })), md?.dataDomain === MetadataDataDomains.DataList ? (_jsx("span", { style: { textDecoration: textDecoration, color: textColor }, children: _jsx(TMDataListItemViewer, { dataListId: md.dataListID, viewMode: md.dataListViewMode, value: value }) })) : md?.dataDomain === MetadataDataDomains.UserID ? (_jsx("span", { style: { textDecoration: textDecoration, color: textColor }, children: _jsx(TMDataUserIdItemViewer, { userId: value, showIcon: true }) })) : (_jsx("span", { style: {
-                                fontWeight: 500,
-                                overflow: isLast ? 'hidden' : 'visible',
-                                textOverflow: isLast ? 'ellipsis' : 'clip',
-                                whiteSpace: 'nowrap',
-                                textDecoration: textDecoration,
-                                color: textColor
-                            }, children: value }))] }, `${key}_${index}`));
-            }) }));
+        const defaultMetadataContent = item.values && (() => {
+            const displayKeys = buildDcmtDisplayName(item.values);
+            return (_jsx(StyledDivHorizontal, { style: {
+                    fontSize: '1rem',
+                    overflow: 'hidden',
+                    flex: 1,
+                    minWidth: 0,
+                    whiteSpace: 'nowrap',
+                    textDecoration: textDecoration,
+                    color: textColor
+                }, children: displayKeys.map((key, index) => {
+                    const md = item.values?.[key]?.md;
+                    const value = item.values?.[key]?.value;
+                    const isLast = index === displayKeys.length - 1;
+                    return (_jsxs(StyledDivHorizontal, { style: {
+                            flexShrink: isLast ? 1 : 0,
+                            minWidth: isLast ? 0 : 'auto',
+                            overflow: isLast ? 'hidden' : 'visible',
+                            textDecoration: textDecoration,
+                            color: textColor
+                        }, children: [index > 0 && _jsx("span", { style: { margin: '0 5px', color: textColor || '#999', textDecoration: textDecoration }, children: "\u2022" }), showMetadataNames && (_jsxs("span", { style: { color: textColor || '#666', marginRight: '5px', textDecoration: textDecoration }, children: [md?.name || key, ":"] })), md?.dataDomain === MetadataDataDomains.DataList ? (_jsx("span", { style: { textDecoration: textDecoration, color: textColor }, children: _jsx(TMDataListItemViewer, { dataListId: md.dataListID, viewMode: md.dataListViewMode, value: value }) })) : md?.dataDomain === MetadataDataDomains.UserID ? (_jsx("span", { style: { textDecoration: textDecoration, color: textColor }, children: _jsx(TMDataUserIdItemViewer, { userId: value, showIcon: true }) })) : (_jsx("span", { style: {
+                                    fontWeight: 500,
+                                    overflow: isLast ? 'hidden' : 'visible',
+                                    textOverflow: isLast ? 'ellipsis' : 'clip',
+                                    whiteSpace: 'nowrap',
+                                    textDecoration: textDecoration,
+                                    color: textColor
+                                }, children: value }))] }, `${key}_${index}`));
+                }) }));
+        })();
         const metadataContent = customDocumentContent
             ? customDocumentContent(item, defaultMetadataContent || _jsx(_Fragment, {}))
             : defaultMetadataContent;

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

@@ -1,4 +1,5 @@
 import React from 'react';
+import { MetadataDescriptor } from '@topconsultnpm/sdk-ts';
 import { DcmtInfo } from '../../../ts';
 import { DocumentDownloadSettings, FileNamingMode } from '../../../helper';
 import { IRelatedDcmt } from './TMMasterDetailDcmts';
@@ -32,9 +33,9 @@ export declare const fileExists: (dirHandle: FileSystemDirectoryHandle, fileName
 export declare const generateUniqueFileName: (dirHandle: FileSystemDirectoryHandle, originalName: string) => Promise<string>;
 /** Recupera il nome leggibile del tipo documento (cache) */
 export declare const getTypeName: (tid: number | undefined) => Promise<string>;
-/** Formatta un valore convertendo le date in formato dd-MM-yyyy [HH-mm-ss] */
-export declare const formatMetadataValue: (value: string) => string;
-/** Recupera i metadati filtrati (primi 5 con mid > 100 e valore presente), concatenati con separatorChar */
+/** Formatta un valore convertendo le date secondo il formato specificato in MetadataDescriptor.format */
+export declare const formatMetadataValue: (value: string, md?: MetadataDescriptor) => string;
+/** Recupera i metadati filtrati usando buildDcmtDisplayName, concatenati con separatorChar */
 export declare const getFilteredMetadata: (tid: number, did: number, separatorChar: string) => Promise<string | null>;
 /** Opzioni di naming necessarie per generare il nome del file di destinazione */
 export interface IFileNamingOptions {

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

@@ -1,5 +1,5 @@
-import { DcmtTypeListCacheService, LayoutModes, SDK_Globals } from '@topconsultnpm/sdk-ts';
-import { searchResultToMetadataValues, DocumentDownloadSettings, getFullFileExtension } from '../../../helper';
+import { DcmtTypeListCacheService, LayoutModes, MetadataDataTypes, MetadataFormats, SDK_Globals } from '@topconsultnpm/sdk-ts';
+import { searchResultToMetadataValues, DocumentDownloadSettings, getFullFileExtension, buildDcmtDisplayName } from '../../../helper';
 import { TMColors } from '../../../utils/theme';
 /** Numero minimo di file PDF necessari per poterli unire in un unico documento. */
 export const MIN_PDF_FOR_MERGE = 2;
@@ -82,7 +82,7 @@ export const sanitizeFileName = (fileName, fallbackName, maxLength = 255) => {
         const illegalCharsRegex = /[<>:"/\\|?*]/g;
         const controlCharsRegex = /[\x00-\x1F\x7F]/g;
         let sanitized = fileName
-            .replace(illegalCharsRegex, '_')
+            .replace(illegalCharsRegex, '-')
             .replace(controlCharsRegex, '')
             .trim();
         sanitized = sanitized.replace(/[. ]+$/, '');
@@ -146,27 +146,40 @@ export const getTypeName = async (tid) => {
     const foundDtd = typeList.find(dtd => dtd.id?.toString() === tid?.toString());
     return foundDtd?.name ?? String(tid);
 };
-/** Formatta un valore convertendo le date in formato dd-MM-yyyy [HH-mm-ss] */
-export const formatMetadataValue = (value) => {
+/** Formatta un valore convertendo le date secondo il formato specificato in MetadataDescriptor.format */
+export const formatMetadataValue = (value, md) => {
+    // Formatta come data solo se il MetadataDescriptor indica tipo DateTime
+    if (md?.dataType !== MetadataDataTypes.DateTime) {
+        return value;
+    }
     const date = new Date(value);
-    if (!isNaN(date.getTime())) {
-        const day = date.getDate().toString().padStart(2, '0');
-        const month = (date.getMonth() + 1).toString().padStart(2, '0');
-        const year = date.getFullYear();
-        const hours = date.getHours();
-        const minutes = date.getMinutes();
-        const seconds = date.getSeconds();
-        if (hours !== 0 || minutes !== 0 || seconds !== 0) {
-            const hh = hours.toString().padStart(2, '0');
-            const mm = minutes.toString().padStart(2, '0');
-            const ss = seconds.toString().padStart(2, '0');
-            return `${day}-${month}-${year} ${hh}-${mm}-${ss}`;
-        }
-        return `${day}-${month}-${year}`;
+    if (isNaN(date.getTime())) {
+        return value;
+    }
+    const format = md.format?.format;
+    const formatCulture = md.format?.formatCulture ?? window.navigator.language;
+    switch (format) {
+        case MetadataFormats.ShortDate:
+            return date.toLocaleString(formatCulture, formatCulture === "it-IT" ? { year: "numeric", month: "2-digit", day: "2-digit" } : { dateStyle: 'short' });
+        case MetadataFormats.ShortTime:
+            return date.toLocaleString(formatCulture, { timeStyle: 'short' });
+        case MetadataFormats.ShortDateLongTime:
+            return date.toLocaleString(formatCulture, formatCulture === "it-IT" ? { year: "numeric", month: "2-digit", day: "2-digit", hour: '2-digit', minute: '2-digit', second: '2-digit' } : { dateStyle: 'short', timeStyle: 'medium' }).replace(',', '');
+        case MetadataFormats.ShortDateShortTime:
+            return date.toLocaleString(formatCulture, formatCulture === "it-IT" ? { year: "numeric", month: "2-digit", day: "2-digit", hour: '2-digit', minute: '2-digit' } : { dateStyle: 'short', timeStyle: 'short' }).replace(',', '');
+        case MetadataFormats.LongDate:
+            return date.toLocaleString(formatCulture, { weekday: "long", year: "numeric", month: "long", day: "numeric" });
+        case MetadataFormats.LongTime:
+            return date.toLocaleString(formatCulture, { timeStyle: 'medium' });
+        case MetadataFormats.LongDateLongTime:
+            return date.toLocaleString(formatCulture, { weekday: "long", year: "numeric", month: "long", day: "numeric", hour: '2-digit', minute: '2-digit', second: '2-digit' });
+        case MetadataFormats.LongDateShortTime:
+            return date.toLocaleString(formatCulture, { weekday: "long", year: "numeric", month: "long", day: "numeric", hour: '2-digit', minute: '2-digit' });
+        default:
+            return date.toLocaleString(formatCulture, formatCulture === "it-IT" ? { year: "numeric", month: "2-digit", day: "2-digit" } : { dateStyle: 'short' });
     }
-    return value;
 };
-/** Recupera i metadati filtrati (primi 5 con mid > 100 e valore presente), concatenati con separatorChar */
+/** Recupera i metadati filtrati usando buildDcmtDisplayName, concatenati con separatorChar */
 export const getFilteredMetadata = async (tid, did, separatorChar) => {
     const metadata = await SDK_Globals.tmSession?.NewSearchEngine().GetMetadataAsync(tid, did, true);
     if (!metadata)
@@ -177,8 +190,18 @@ export const getFilteredMetadata = async (tid, did, separatorChar) => {
     const dtdWithMetadata = await DcmtTypeListCacheService.GetWithNotGrantedAsync(tid, did, metadata);
     const mdList = dtdWithMetadata?.metadata ?? [];
     const metadataList = searchResultToMetadataValues(tid, dtdResult, rows, mids, mdList, LayoutModes.Update);
-    return metadataList
-        .reduce((acc, md) => acc.length < 5 && md.mid && md.mid > 100 && md.value ? [...acc, formatMetadataValue(md.value)] : acc, [])
+    // Converte l'array di MetadataValueDescriptorEx in DcmtMetadataMap per buildDcmtDisplayName
+    const metadataMap = Object.fromEntries(metadataList.filter(mvd => mvd.md?.name).map(mvd => [mvd.md.name, { md: mvd.md, value: mvd.value }]));
+    // Usa buildDcmtDisplayName per ricavare i nomi dei metadati da visualizzare
+    const displayKeys = buildDcmtDisplayName(metadataMap);
+    if (displayKeys.length === 0)
+        return null;
+    return displayKeys
+        .map(key => {
+        const entry = metadataMap[key];
+        return entry?.value ? formatMetadataValue(String(entry.value), entry.md) : null;
+    })
+        .filter(Boolean)
         .join(separatorChar);
 };
 /** Genera il nome file di destinazione in base alle impostazioni di naming */
@@ -201,6 +224,7 @@ export const generateTargetFileName = async (file, dcmtInfo, options) => {
         case 'onlyCustomMetadata': {
             try {
                 const filteredMetadata = await getFilteredMetadata(dcmtInfo.TID, dcmtInfo.DID, separatorChar);
+                console.log("filteredMetadata for TID:", dcmtInfo.TID, "DID:", dcmtInfo.DID, "is", filteredMetadata);
                 if (filteredMetadata) {
                     if (fileNamingMode === 'documentTypeAndCustomMetadata') {
                         const typeName = await getTypeName(dcmtInfo.TID);

package/lib/components/viewers/TMTidViewer.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useState } from 'react';
-import { IconDcmtType, IconDcmtTypeOnlyMetadata, IconLocked, IconView, isCreateCertificateEnabled, isPdfEditorEnabled, isSign4TopEnabled, LocalizeArchiveConstraints, LocalizeParametricFilterTypes, SDKUI_Localizator, TMImageLibrary } from '../../helper';
+import { getDTDDisplayNameInfo, IconDcmtType, IconDcmtTypeOnlyMetadata, IconLocked, IconView, isCreateCertificateEnabled, isPdfEditorEnabled, isSign4TopEnabled, LocalizeArchiveConstraints, LocalizeParametricFilterTypes, SDKUI_Localizator, TMImageLibrary } from '../../helper';
 import { AccessLevels, AccessLevelsEx, ArchiveConstraints, DcmtTypeListCacheService, OwnershipLevels, ParametricFilterTypes, SDK_Globals, SDK_Localizator, TemplateTIDs } from '@topconsultnpm/sdk-ts';
 import TMSpinner from '../base/TMSpinner';
 import { StyledDivHorizontal, StyledTooltipContainer, StyledTooltipItem, StyledTooltipSeparatorItem } from '../base/Styled';
@@ -309,6 +309,18 @@ export default TMTidViewer;
 export const cellRenderTID = (data, noneSelectionText) => {
     return (_jsx(TMTidViewer, { tid: data.value, noneSelectionText: noneSelectionText }));
 };
+/** Componente per mostrare il metodo di visualizzazione del nome documento (carica i metadati dalla cache se necessario) */
+const TMDisplayNameMethodItem = ({ dtd }) => {
+    const [displayNameMethod, setDisplayNameMethod] = useState('...');
+    useEffect(() => {
+        const fetchDisplayNameMethod = async () => {
+            const method = await getDTDDisplayNameInfo(dtd);
+            setDisplayNameMethod(method);
+        };
+        fetchDisplayNameMethod();
+    }, [dtd]);
+    return _jsx(StyledTooltipItem, { children: `${SDKUI_Localizator.DisplayNameMethod}: ${displayNameMethod}` });
+};
 export const renderDTDTooltipContent = (dtd) => {
     const mapAccessLevelToLocalizedString = (level) => {
         if (level === undefined || level === null)
@@ -343,5 +355,5 @@ export const renderDTDTooltipContent = (dtd) => {
                                         isPdfEditorEnabled(dtd.widgets) ? 'PDFEditor' : null,
                                     ].filter(Boolean);
                                     return (_jsxs(_Fragment, { children: [_jsx(StyledTooltipSeparatorItem, {}), enabledWidgets.length > 0 && (_jsxs(StyledTooltipItem, { children: ["Widgets: ", enabledWidgets.join(', ')] })), enabledWidgets.length === 0 && (_jsxs(StyledTooltipItem, { children: ["Widgets: ", SDKUI_Localizator.No] }))] }));
-                                })() : (_jsxs(_Fragment, { children: [_jsx(StyledTooltipSeparatorItem, {}), _jsxs(StyledTooltipItem, { children: ["Widgets: ", SDKUI_Localizator.No] })] }))] })] }));
+                                })() : (_jsxs(_Fragment, { children: [_jsx(StyledTooltipSeparatorItem, {}), _jsxs(StyledTooltipItem, { children: ["Widgets: ", SDKUI_Localizator.No] })] })), _jsx(StyledTooltipSeparatorItem, {}), _jsx(TMDisplayNameMethodItem, { dtd: dtd })] })] }));
 };

package/lib/helper/SDKUI_Localizator.d.ts

@@ -203,6 +203,9 @@ export declare class SDKUI_Localizator {
     static get DiagramItemTypes_End(): "Ende" | "End" | "Fin" | "Fim" | "Fine";
     static get Disabled(): "Deaktiviert" | "Disabled" | "Deshabilitado" | "Désactivé" | "Desabilitado" | "Disabilitato";
     static get DisplayFormat(): string;
+    static get DisplayNameMethod(): string;
+    static get DisplayNameMethod_Abstract(): string;
+    static get DisplayNameMethod_Top5(): string;
     static get DistinctValues(): "Unterschiedliche Werte" | "Distinct values" | "Valores distintos" | "Valeurs distinctes" | "Valori distinti";
     static get DocumentArchivedSuccessfully(): "Dokument erfolgreich archiviert" | "Document archived successfully" | "Documento archivado con éxito" | "Document archivé avec succès" | "Documento arquivado com sucesso" | "Documento archiviato con successo";
     static get DocumentAttachedSuccessfullyToEmail(): "Dokument erfolgreich zur E-Mail hinzugefügt." | "Document attached successfully to the email." | "Documento adjuntado exitosamente al correo electrónico." | "Document joint avec succès à l'e-mail." | "Documento anexado com sucesso ao e-mail." | "Documento allegato con successo all'email.";

package/lib/helper/SDKUI_Localizator.js

@@ -1979,6 +1979,36 @@ export class SDKUI_Localizator {
             default: return "Formato di visualizzazione";
         }
     }
+    static get DisplayNameMethod() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Anzeigemethode";
+            case CultureIDs.En_US: return "Display Method";
+            case CultureIDs.Es_ES: return "Método de visualización";
+            case CultureIDs.Fr_FR: return "Méthode d'affichage";
+            case CultureIDs.Pt_PT: return "Método de exibição";
+            default: return "Metodo di visualizzazione";
+        }
+    }
+    static get DisplayNameMethod_Abstract() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Dokumentbeschreibung (SYS_Abstract)";
+            case CultureIDs.En_US: return "Document description (SYS_Abstract)";
+            case CultureIDs.Es_ES: return "Descripción del documento (SYS_Abstract)";
+            case CultureIDs.Fr_FR: return "Description du document (SYS_Abstract)";
+            case CultureIDs.Pt_PT: return "Descrição do documento (SYS_Abstract)";
+            default: return "Descrizione documento (SYS_Abstract)";
+        }
+    }
+    static get DisplayNameMethod_Top5() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Erste 5 Metadaten";
+            case CultureIDs.En_US: return "First 5 metadata";
+            case CultureIDs.Es_ES: return "Primeros 5 metadatos";
+            case CultureIDs.Fr_FR: return "5 premières métadonnées";
+            case CultureIDs.Pt_PT: return "Primeiros 5 metadados";
+            default: return "Primi 5 metadati";
+        }
+    }
     static get DistinctValues() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Unterschiedliche Werte";

package/lib/helper/TMUtils.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { FileItem } from '../components';
-import { AppModules, DataColumnDescriptor, DcmtTypeDescriptor, PdGs, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
+import { AppModules, DataColumnDescriptor, DcmtTypeDescriptor, MetadataDescriptor, PdGs, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
 /**
  * Estensioni di firma/marca temporale note che possono avvolgere altre estensioni.
  * Es: file.pdf.p7m, file.xml.p7m, file.docx.p7m, file.xml.p7m.ts
@@ -77,4 +77,36 @@ type DcmtFormToolbarVisibility = {
 };
 export declare const getDcmtFormToolbarVisibility: (appModuleID: AppModules) => DcmtFormToolbarVisibility;
 export declare const isConvertibleToPdfExt: (ext: string | undefined | null) => boolean;
+/** Valore metadato con descrittore (da searchResultToDataSource) */
+export interface DcmtMetadataValue {
+    md?: MetadataDescriptor;
+    value: any;
+}
+/** Documento con metadati indicizzati per nome */
+export interface DcmtMetadataMap {
+    [key: string]: DcmtMetadataValue;
+    rowIndex?: any;
+}
+/**
+ * Restituisce le chiavi dei metadati da visualizzare come descrizione documento.
+ * Priorità: 1) SYS_Abstract  2) isSpecialSearchOutput=true  3) primi 5 metadati non di sistema
+ */
+export declare const buildDcmtDisplayName: (obj: DcmtMetadataMap | null | undefined) => Array<string>;
+/** Metodo utilizzato per determinare i metadati da visualizzare come descrizione documento */
+export declare enum DcmtDisplayNameMethod {
+    /** Nessun metadato disponibile */
+    None = "None",
+    /** Campo SYS_Abstract presente */
+    SysAbstract = "SysAbstract",
+    /** Metadati con isSpecialSearchOutput = true */
+    SpecialSearchOutput = "SpecialSearchOutput",
+    /** Primi 5 metadati non di sistema con permesso canView */
+    FirstViewableMetadata = "FirstViewableMetadata"
+}
+/**
+ * Analizza un DcmtTypeDescriptor e restituisce la stringa descrittiva del metodo di visualizzazione.
+ * Priorità: 1) SYS_Abstract  2) isSpecialSearchOutput=true  3) primi 5 metadati non di sistema (default)
+ * Se i metadati non sono presenti nel dtd, li recupera dalla cache.
+ */
+export declare const getDTDDisplayNameInfo: (dtd: DcmtTypeDescriptor | undefined) => Promise<string>;
 export {};

package/lib/helper/TMUtils.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import styled from "styled-components";
 import { TMTooltip } from '../components';
 import { IconCADossier, IconKey, IconMenuCAWorkingGroups } from './TMIcons';
-import { AppModules, DataListCacheService, LicenseModuleStatus, MetadataDataDomains, PdGs, SDK_Globals } from '@topconsultnpm/sdk-ts';
+import { AccessLevels, AppModules, DataListCacheService, DcmtTypeListCacheService, LicenseModuleStatus, MetadataDataDomains, PdGs, SDK_Globals, SystemMIDs } from '@topconsultnpm/sdk-ts';
 import { SDKUI_Localizator } from './SDKUI_Localizator';
 /**
  * Estensioni di firma/marca temporale note che possono avvolgere altre estensioni.
@@ -430,3 +430,106 @@ export const isConvertibleToPdfExt = (ext) => {
         'eml', 'msg'
     ].includes(normalized);
 };
+/**
+ * Restituisce le chiavi dei metadati da visualizzare come descrizione documento.
+ * Priorità: 1) SYS_Abstract  2) isSpecialSearchOutput=true  3) primi 5 metadati non di sistema
+ */
+export const buildDcmtDisplayName = (obj) => {
+    try {
+        if (!obj)
+            return [];
+        const sysAbstractKey = Object.keys(obj).find(k => k.toUpperCase() === 'SYS_ABSTRACT');
+        if (sysAbstractKey) {
+            if (obj[sysAbstractKey]?.value) {
+                return [sysAbstractKey];
+            }
+            // SYS_Abstract esiste ma è vuoto: usa DID se presente, altrimenti continua con la logica standard
+            const didKey = Object.keys(obj).find(k => k.toUpperCase() === 'DID');
+            if (didKey && obj[didKey]?.value) {
+                return [didKey];
+            }
+        }
+        const keys = Object.keys(obj);
+        const sysMIDs = Object.values(SystemMIDs).map(o => o.toUpperCase());
+        const viewableMetadataKeys = keys.filter(k => obj?.[k]?.value &&
+            obj?.[k]?.md?.perm?.canView === AccessLevels.Yes &&
+            !sysMIDs.includes(k.toUpperCase()) &&
+            k !== "rowIndex" &&
+            k !== "ISLEXPROT");
+        // Metadati con isSpecialSearchOutput = true
+        const specialOutputKeys = viewableMetadataKeys.filter(k => obj?.[k]?.md?.isSpecialSearchOutput === true);
+        if (specialOutputKeys.length > 0) {
+            return specialOutputKeys.slice(0, 5);
+        }
+        if (viewableMetadataKeys.length > 0) {
+            return viewableMetadataKeys.slice(0, 5);
+        }
+        // Fallback: se tutti i metadati personalizzati sono vuoti, usa DID
+        const didKey = Object.keys(obj).find(k => k.toUpperCase() === 'DID');
+        if (didKey && obj[didKey]?.value) {
+            return [didKey];
+        }
+        return [];
+    }
+    catch (error) {
+        console.error('buildDcmtDisplayName error:', error);
+        return [];
+    }
+};
+/** Metodo utilizzato per determinare i metadati da visualizzare come descrizione documento */
+export var DcmtDisplayNameMethod;
+(function (DcmtDisplayNameMethod) {
+    /** Nessun metadato disponibile */
+    DcmtDisplayNameMethod["None"] = "None";
+    /** Campo SYS_Abstract presente */
+    DcmtDisplayNameMethod["SysAbstract"] = "SysAbstract";
+    /** Metadati con isSpecialSearchOutput = true */
+    DcmtDisplayNameMethod["SpecialSearchOutput"] = "SpecialSearchOutput";
+    /** Primi 5 metadati non di sistema con permesso canView */
+    DcmtDisplayNameMethod["FirstViewableMetadata"] = "FirstViewableMetadata";
+})(DcmtDisplayNameMethod || (DcmtDisplayNameMethod = {}));
+/**
+ * Analizza un DcmtTypeDescriptor e restituisce la stringa descrittiva del metodo di visualizzazione.
+ * Priorità: 1) SYS_Abstract  2) isSpecialSearchOutput=true  3) primi 5 metadati non di sistema (default)
+ * Se i metadati non sono presenti nel dtd, li recupera dalla cache.
+ */
+export const getDTDDisplayNameInfo = async (dtd) => {
+    try {
+        if (!dtd) {
+            return SDKUI_Localizator.DisplayNameMethod_Top5;
+        }
+        // Recupera i metadati dalla cache se non presenti nel dtd
+        let metadata = dtd.metadata;
+        if (!metadata || metadata.length === 0) {
+            const cachedDtd = await DcmtTypeListCacheService.GetAsync(dtd.id);
+            metadata = cachedDtd?.metadata;
+        }
+        if (!metadata || metadata.length === 0) {
+            return SDKUI_Localizator.DisplayNameMethod_Top5;
+        }
+        const sysMIDs = Object.values(SystemMIDs).map(o => o.toUpperCase());
+        // 1) Cerca SYS_Abstract
+        const sysAbstract = metadata.find(md => md.name?.toUpperCase() === 'SYS_ABSTRACT');
+        if (sysAbstract) {
+            return SDKUI_Localizator.DisplayNameMethod_Abstract;
+        }
+        // Filtra metadati non di sistema con permesso canView
+        const viewableMetadata = metadata.filter(md => md.perm?.canView === AccessLevels.Yes &&
+            md.name &&
+            !sysMIDs.includes(md.name.toUpperCase()));
+        // 2) Cerca metadati con isSpecialSearchOutput = true
+        const specialOutputMetadata = viewableMetadata.filter(md => md.isSpecialSearchOutput === true);
+        if (specialOutputMetadata.length > 0) {
+            const metadataNames = specialOutputMetadata.map(md => md.nameLoc || md.name).filter(Boolean).join(', ');
+            const maxLength = 50;
+            const truncatedNames = metadataNames.length > maxLength ? metadataNames.substring(0, maxLength) + '...' : metadataNames;
+            return `${SDKUI_Localizator.Search_Special} (${truncatedNames})`;
+        }
+        // 3) Default: primi 5 metadati non di sistema
+        return SDKUI_Localizator.DisplayNameMethod_Top5;
+    }
+    catch (error) {
+        console.error('getDTDDisplayNameInfo error:', error);
+        return SDKUI_Localizator.DisplayNameMethod_Top5;
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@topconsultnpm/sdkui-react",
-    "version": "6.21.0-dev4.11",
+    "version": "6.21.0-dev4.13",
     "description": "",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1",
@@ -40,7 +40,7 @@
         "lib"
     ],
     "dependencies": {
-        "@topconsultnpm/sdk-ts": "6.21.0-dev4.2",
+        "@topconsultnpm/sdk-ts": "6.21.0-dev4.3",
         "@zip.js/zip.js": "2.8.26",
         "buffer": "^6.0.3",
         "devextreme": "^25.2.6",