@topconsultnpm/sdkui-react 6.22.0-t1 → 6.22.0-t3

package/lib/helper/checkinCheckoutManager.d.ts

@@ -44,7 +44,7 @@ export type DownloadSource = {
 };
 export declare const getCicoDownloadFileName: (source: DownloadSource, checkout: boolean, withTimestampAndExt: boolean) => string;
 export declare const cicoDownloadFilesCallback: (sources: Array<DownloadSource>, checkout: boolean, downloadDcmtsAsync: (params: DownloadDcmtsAsyncParams) => Promise<void>) => Promise<void>;
-export declare const updateCicoCheckoutStorageItem: (item: CheckoutInfo, type: "fileItem" | "dcmtInfo", action?: "addOrUpdate" | "remove") => void;
+export declare const updateCicoCheckoutStorageItem: (item: CheckoutInfo, type: 'fileItem' | 'dcmtInfo', action?: "addOrUpdate" | "remove") => void;
 export declare const validateCicoFileName: (source: DownloadSource, fileName: string, checkoutDate?: string | null) => FileNameValidation;
 type ValidationResult = {
     expected: string | number | undefined;

package/lib/helper/checkinCheckoutManager.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { AccessLevels, CICO_MetadataNames, SDK_Globals, SystemMIDsAsNumber } from "@topconsultnpm/sdk-ts";
 import TMTooltip from "../components/base/TMTooltip";
 import { dcmtsFileCachePreview, Globalization, removeDcmtsFileCache, SDKUI_Globals, SDKUI_Localizator } from "./index";

package/lib/helper/dataGridSearchHelper.d.ts

@@ -0,0 +1,28 @@
+import { MetadataFormats } from '@topconsultnpm/sdk-ts';
+/** Testo mostrato in una colonna per una riga: è quello su cui va cercato ciò che l'utente digita */
+export type SearchTextGetter = (rowData: any) => string;
+/** Testo con cui una data viene mostrata nella griglia: è quello che l'utente vede e quindi quello che cerca */
+export declare const getDateDisplayText: (value: any, format: MetadataFormats | undefined, formatCulture: string | undefined | null) => string;
+/** Testo con cui un numero viene mostrato nella griglia (separatore delle migliaia, valuta, decimali) */
+export declare const getNumberDisplayText: (value: any, format: MetadataFormats | undefined, formatCulture: string) => string;
+/**
+ * Dirotta la ricerca della griglia sul testo mostrato, per le colonne indicate (chiave: il `dataField`).
+ *
+ * La ricerca di DevExtreme lavora sul valore archiviato, quindi non trova nulla dove il testo mostrato è
+ * diverso:
+ * - **date**, che nei dati sono stringhe ISO: DevExtreme prova a interpretare il testo digitato con il
+ *   formato della colonna, non riesce (il formato è un formatter personalizzato, non un pattern) e scarta
+ *   la colonna dalla ricerca — cercando `29/01/2023` non trova nulla;
+ * - **numeri formattati**, per lo stesso motivo (separatore delle migliaia, simbolo di valuta);
+ * - **liste dati e utenti**, dove viene confrontata la chiave archiviata invece della descrizione
+ *   visualizzata — cercando `FATTURA` non trova nulla, cercando `TD01` sì.
+ *
+ * Da passare a `customizeColumns` della griglia. Va fatto lì perché solo lì è disponibile la
+ * `calculateFilterExpression` predefinita di DevExtreme, che resta in uso per il filtro di intestazione e
+ * per il generatore di filtri: quelli funzionano già correttamente e vanno lasciati intatti.
+ *
+ * @example
+ * const searchTextGetters = useMemo(() => new Map([['TM_1_2', (row) => getDateDisplayText(row?.TM_1_2, format, culture)]]), [...]);
+ * const customizeColumns = useMemo(() => customizeSearchByDisplayText(searchTextGetters), [searchTextGetters]);
+ */
+export declare const customizeSearchByDisplayText: (searchTextGetters: Map<string, SearchTextGetter>) => (columns: Array<any>) => void;

package/lib/helper/dataGridSearchHelper.js

@@ -0,0 +1,51 @@
+import { formatDateTimeByMetadataFormat, formatNumberByMetadataFormat } from './TMUtils';
+/** Testo con cui una data viene mostrata nella griglia: è quello che l'utente vede e quindi quello che cerca */
+export const getDateDisplayText = (value, format, formatCulture) => {
+    if (value === undefined || value === null || value === '')
+        return '';
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(date.getTime()) ? '' : formatDateTimeByMetadataFormat(date, format, formatCulture);
+};
+/** Testo con cui un numero viene mostrato nella griglia (separatore delle migliaia, valuta, decimali) */
+export const getNumberDisplayText = (value, format, formatCulture) => {
+    if (value === undefined || value === null || value === '')
+        return '';
+    return formatNumberByMetadataFormat(value, format, formatCulture);
+};
+/**
+ * Dirotta la ricerca della griglia sul testo mostrato, per le colonne indicate (chiave: il `dataField`).
+ *
+ * La ricerca di DevExtreme lavora sul valore archiviato, quindi non trova nulla dove il testo mostrato è
+ * diverso:
+ * - **date**, che nei dati sono stringhe ISO: DevExtreme prova a interpretare il testo digitato con il
+ *   formato della colonna, non riesce (il formato è un formatter personalizzato, non un pattern) e scarta
+ *   la colonna dalla ricerca — cercando `29/01/2023` non trova nulla;
+ * - **numeri formattati**, per lo stesso motivo (separatore delle migliaia, simbolo di valuta);
+ * - **liste dati e utenti**, dove viene confrontata la chiave archiviata invece della descrizione
+ *   visualizzata — cercando `FATTURA` non trova nulla, cercando `TD01` sì.
+ *
+ * Da passare a `customizeColumns` della griglia. Va fatto lì perché solo lì è disponibile la
+ * `calculateFilterExpression` predefinita di DevExtreme, che resta in uso per il filtro di intestazione e
+ * per il generatore di filtri: quelli funzionano già correttamente e vanno lasciati intatti.
+ *
+ * @example
+ * const searchTextGetters = useMemo(() => new Map([['TM_1_2', (row) => getDateDisplayText(row?.TM_1_2, format, culture)]]), [...]);
+ * const customizeColumns = useMemo(() => customizeSearchByDisplayText(searchTextGetters), [searchTextGetters]);
+ */
+export const customizeSearchByDisplayText = (searchTextGetters) => (columns) => {
+    columns.forEach((column) => {
+        const getSearchText = column?.dataField ? searchTextGetters.get(column.dataField) : undefined;
+        // customizeColumns viene richiamata a ogni aggiornamento delle colonne: senza il marcatore i wrapper si anniderebbero
+        if (!getSearchText || column.tmSearchByDisplayText)
+            return;
+        const defaultCalculateFilterExpression = column.calculateFilterExpression;
+        // Senza questo DevExtreme prova a convertire il testo digitato nel tipo della colonna e, non riuscendo, la scarta
+        column.parseValue = (text) => text;
+        column.calculateFilterExpression = function (filterValue, selectedFilterOperation, target) {
+            if (target === 'search')
+                return [getSearchText, 'contains', filterValue];
+            return defaultCalculateFilterExpression?.apply(this, arguments);
+        };
+        column.tmSearchByDisplayText = true;
+    });
+};

package/lib/helper/dcmtsHelper.d.ts

@@ -1,8 +1,30 @@
+import { DcmtTypeDescriptor, MetadataDataTypes, MetadataDescriptor, MetadataFormats, RelationDescriptor } from "@topconsultnpm/sdk-ts";
 import { MetadataValueDescriptorEx } from "../ts";
+/** Metadati utente (esclusi quelli di sistema) del tipo documento, in ordine di visualizzazione */
+export declare const getUserMetadataSorted: (dtd: DcmtTypeDescriptor | undefined) => Array<MetadataDescriptor>;
+/** Metadato visibile all'utente: stessa regola del risultato di ricerca (vedi getQD), serve almeno la visualizzazione o la modifica */
+export declare const canViewMetadata: (md: MetadataDescriptor) => boolean;
+/** Formatta un valore scalare (non lista dati): date e numeri rispettano Format e FormatCulture del metadato */
+export declare const formatScalarValue: (value: any, dataType: MetadataDataTypes | undefined, format: MetadataFormats | undefined, formatCulture: string | undefined) => string;
 /** 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 getDcmtMetadataByMid: (dcmt: {
+    TID?: number;
+    DID?: number;
+} | undefined) => Promise<Map<number, any>>;
+export declare const mapAssociationsFromMetadata: (relation: RelationDescriptor, type: 'detail' | 'master', metadataByMid: Map<number, any>) => Array<{
+    mid: number;
+    value: string;
+}>;
+export declare const mapRelationAssociationsToMids: (relation: RelationDescriptor, type: 'detail' | 'master', dcmt: {
+    TID?: number;
+    DID?: number;
+} | undefined) => Promise<Array<{
+    mid: number;
+    value: string;
+}>>;
 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

@@ -1,4 +1,23 @@
-import { RelationCacheService, RelationTypes, SDK_Globals } from "@topconsultnpm/sdk-ts";
+import { AccessLevels, MetadataDataTypes, RelationCacheService, RelationTypes, SDK_Globals } from "@topconsultnpm/sdk-ts";
+import { formatDateTimeByMetadataFormat, formatNumberByMetadataFormat } from "./TMUtils";
+/** Metadati utente (esclusi quelli di sistema) del tipo documento, in ordine di visualizzazione */
+export const getUserMetadataSorted = (dtd) => {
+    return (dtd?.metadata ?? [])
+        .filter(md => md.id !== undefined && md.id > 100 && md.isSystem !== 1)
+        .sort((a, b) => (a.ordinalPosition ?? 0) - (b.ordinalPosition ?? 0));
+};
+/** Metadato visibile all'utente: stessa regola del risultato di ricerca (vedi getQD), serve almeno la visualizzazione o la modifica */
+export const canViewMetadata = (md) => !(md.perm?.canView == AccessLevels.No && md.perm?.canUpdate == AccessLevels.No);
+/** Formatta un valore scalare (non lista dati): date e numeri rispettano Format e FormatCulture del metadato */
+export const formatScalarValue = (value, dataType, format, formatCulture) => {
+    if (value === undefined || value === null || value === '')
+        return '';
+    switch (dataType) {
+        case MetadataDataTypes.DateTime: return formatDateTimeByMetadataFormat(value instanceof Date ? value : new Date(value), format, formatCulture);
+        case MetadataDataTypes.Number: return formatNumberByMetadataFormat(value, format, formatCulture ?? window.navigator.language);
+        default: return String(value);
+    }
+};
 /** Check if dcmtType (mTID) has configured Detail or Many-to-Many relations */
 export const hasDetailRelations = async (mTID) => {
     let allRelations = await RelationCacheService.GetAllAsync();
@@ -13,6 +32,46 @@ export const hasMasterRelations = async (mTID) => {
     let rdlManyToMany = allRelations?.filter(o => o.relationType == RelationTypes.ManyToMany && (o.masterTID == mTID || o.detailTID == mTID)) ?? [];
     return rdlManyToMany.length > 0 || rdlOneToMany.length > 0;
 };
+// Legge i metadati di un documento
+export const getDcmtMetadataByMid = async (dcmt) => {
+    const metadataMap = new Map();
+    if (!dcmt?.TID || !dcmt?.DID)
+        return metadataMap; // Documento non identificabile: mappa vuota
+    const searchEngine = SDK_Globals.tmSession?.NewSearchEngine();
+    if (!searchEngine)
+        return metadataMap; // Nessuna sessione attiva: mappa vuota
+    const allMetadata = await searchEngine.GetMetadataAsync(dcmt.TID, dcmt.DID, false);
+    const row = allMetadata?.dtdResult?.rows?.[0]; // Prima (e unica) riga = il documento richiesto
+    const mids = allMetadata?.selectMIDs; // MID nello stesso ordine dei valori di riga
+    if (row && mids)
+        mids.forEach((mid, index) => metadataMap.set(mid, row[index])); // Accoppia mid -> valore per posizione
+    return metadataMap;
+};
+// Mappa le associazioni della relazione nei MID di destinazione, usando i metadati sorgente già letti.
+// 'detail' = archivio dettagli dal master (sorgente item1 -> destinazione item2); 'master' = archivio master dal dettaglio (item2 -> item1).
+// Emette una voce per ogni associazione, anche vuota, per coprire tutti i collegamenti.
+export const mapAssociationsFromMetadata = (relation, type, metadataByMid) => {
+    if (!relation.associations || relation.associations.length === 0)
+        return []; // Relazione senza collegamenti
+    return relation.associations.map(assoc => {
+        const sourceMid = type === 'detail' ? (assoc.item1 ?? 0) : (assoc.item2 ?? 0); // MID da cui leggere il valore
+        const targetMid = type === 'detail' ? (assoc.item2 ?? 0) : (assoc.item1 ?? 0); // MID da valorizzare
+        const value = metadataByMid.get(sourceMid); // Valore sorgente (può mancare)
+        return { mid: targetMid, value: value !== undefined && value !== null ? value.toString() : '' }; // Assente/null -> stringa vuota
+    });
+};
+// Legge il documento sorgente (master per 'detail', dettaglio per 'master') e mappa le associazioni nei MID di destinazione.
+// Per letture ripetute dello stesso documento, riusare la mappa e chiamare direttamente `mapAssociationsFromMetadata`.
+export const mapRelationAssociationsToMids = async (relation, type, dcmt) => {
+    if (!relation.associations || relation.associations.length === 0)
+        return []; // Relazione senza collegamenti
+    if (!dcmt?.TID || !dcmt?.DID)
+        return []; // Documento sorgente non identificabile
+    const metadataByMid = await getDcmtMetadataByMid(dcmt);
+    if (metadataByMid.size === 0)
+        return []; // Nessun metadato leggibile: [] come nel flusso originale (niente collegamenti a vuoto)
+    return mapAssociationsFromMetadata(relation, type, metadataByMid);
+};
 export const isXMLFileExt = (fileExt) => {
     const fileExtension = fileExt?.toLowerCase() ?? '';
     switch (fileExtension) {

package/lib/helper/helpers.d.ts

@@ -2,6 +2,15 @@ import { Colors as ColorsType } from "../components/base/TMEditorBase";
 import { DeviceType } from "../components";
 import { AppModules, DataColumnDescriptor, DcmtTypeDescriptor, ITopMediaSession, MetadataDescriptor, QueryDescriptor, SearchResultDescriptor, TaskDescriptor } from "@topconsultnpm/sdk-ts";
 import { FileExtensionHandler, FormModes, moduleTypes } from "../ts";
+import React from "react";
+/**
+ * Handler di hover per elementi con stili inline: applica `over` all'ingresso del mouse e `out` all'uscita.
+ * Da spandere sull'elemento: `{...hoverStyle({ background: 'red' }, { background: 'transparent' })}`
+ */
+export declare const hoverStyle: (over: React.CSSProperties, out: React.CSSProperties) => {
+    onMouseEnter: (e: React.MouseEvent<HTMLElement>) => CSSStyleDeclaration & React.CSSProperties;
+    onMouseLeave: (e: React.MouseEvent<HTMLElement>) => CSSStyleDeclaration & React.CSSProperties;
+};
 declare const calcResponsiveSizes: (deviceType: DeviceType | undefined, desktopSize: string, tabletSize: string, mobileSize: string) => string;
 declare const taskModalSizes: (deviceType: DeviceType | undefined, formMode: FormModes) => {
     width: string;
@@ -9,7 +18,7 @@ declare const taskModalSizes: (deviceType: DeviceType | undefined, formMode: For
 };
 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 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 getColor: (color: ColorsType) => string;
@@ -35,6 +44,17 @@ export declare const getDataColumnName: (fromTID: number | undefined, dtColumn:
  */
 export declare const generateUniqueColumnKeys: (columns: DataColumnDescriptor[] | undefined, fromTID: number | undefined) => string[];
 export declare const searchResultDescriptorToSimpleArray: (searchResult: SearchResultDescriptor | undefined) => any[] | undefined;
+/**
+ * Unisce ("accoda") il risultato di una nuova ricerca a quello precedente, sullo stesso tipo documento.
+ * - Le righe della nuova ricerca vengono messe in cima (più recenti in alto)
+ * - Le righe duplicate sono accettate: lo stesso documento può comparire più volte
+ * - Aggiorna i contatori globali (dcmtsFound / dcmtsReturned) sul totale unito
+ *
+ * @param previous Risultato attualmente in memoria (può essere undefined al primo giro)
+ * @param next Nuovo risultato appena ottenuto
+ * @returns Un nuovo SearchResultDescriptor con le righe unite, oppure il singolo risultato disponibile
+ */
+export declare const mergeSearchResultsAppend: (previous: SearchResultDescriptor | undefined, next: SearchResultDescriptor | undefined) => SearchResultDescriptor | 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;
@@ -42,6 +62,8 @@ export declare const getSystemMetadata: (withPerm?: boolean) => MetadataDescript
 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 WHATS_NEWS_FILE_NAME = "what's new";
+export declare const WHATS_NEWS_LINK_URL = "https://www.topconsult.it/it/documentazionetopmedia";
 export declare const TASK_MORE_INFO_PREFIX_NAME: string;
 export declare const isTaskMoreInfo: (taskName: string | undefined) => boolean | undefined;
 export declare const getMoreInfoTasksForDocument: (allTasks: TaskDescriptor[], TID: number | null | undefined, DID: number | null | undefined) => TaskDescriptor[];
@@ -55,7 +77,7 @@ export { openApps, calcResponsiveDirection, calcResponsiveSizes, taskModalSizes,
 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.Element)[];
+export declare const renderHighlightedText: (text: string, searchText: string, isSelected: boolean) => string | (string | React.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;

package/lib/helper/helpers.js

@@ -1,4 +1,4 @@
-import { Fragment as _Fragment, jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Colors } from "../utils/theme";
 import { ButtonNames, DeviceType, TMExceptionBoxManager, TMMessageBoxManager, TMSpinner } from "../components";
 import { AccessLevels, MetadataDataDomains, MetadataDataTypes, MetadataDescriptor, MetadataFormatDescriptor, MetadataFormats, MetadataPermission, SDK_Globals, SetGlobalsInfoAsync, SystemMIDs, SystemMIDsAsNumber, Task_States, TopMediaServer, WorkItemMetadataNames } from "@topconsultnpm/sdk-ts";
@@ -7,6 +7,15 @@ import { buildTypes, FileExtensionHandler, FormModes, moduleTypes } from "../ts"
 import { SDKUI_Localizator } from "./SDKUI_Localizator";
 import ReactDOMServer from "react-dom/server";
 import { DeepCompareHelper } from "./DeepCompareHelper";
+import { UserSettings } from "./SDKUI_Globals";
+/**
+ * Handler di hover per elementi con stili inline: applica `over` all'ingresso del mouse e `out` all'uscita.
+ * Da spandere sull'elemento: `{...hoverStyle({ background: 'red' }, { background: 'transparent' })}`
+ */
+export const hoverStyle = (over, out) => ({
+    onMouseEnter: (e) => Object.assign(e.currentTarget.style, over),
+    onMouseLeave: (e) => Object.assign(e.currentTarget.style, out),
+});
 const calcResponsiveSizes = (deviceType, desktopSize, tabletSize, mobileSize) => {
     if (deviceType === DeviceType.DESKTOP)
         return desktopSize;
@@ -62,7 +71,6 @@ export const setSDK_GlobalsInfoAsync = async (tms) => {
     try {
         const result = await SetGlobalsInfoAsync(tms);
         if (result?.SessionDescr?.userID && result?.SessionDescr?.archiveID) {
-            const { UserSettings } = await import('./SDKUI_Globals');
             UserSettings.LoadSettings(result.SessionDescr.userID, result.SessionDescr.archiveID);
         }
         return result;
@@ -239,6 +247,38 @@ export const searchResultDescriptorToSimpleArray = (searchResult) => {
     });
     return result;
 };
+/**
+ * Unisce ("accoda") il risultato di una nuova ricerca a quello precedente, sullo stesso tipo documento.
+ * - Le righe della nuova ricerca vengono messe in cima (più recenti in alto)
+ * - Le righe duplicate sono accettate: lo stesso documento può comparire più volte
+ * - Aggiorna i contatori globali (dcmtsFound / dcmtsReturned) sul totale unito
+ *
+ * @param previous Risultato attualmente in memoria (può essere undefined al primo giro)
+ * @param next Nuovo risultato appena ottenuto
+ * @returns Un nuovo SearchResultDescriptor con le righe unite, oppure il singolo risultato disponibile
+ */
+export const mergeSearchResultsAppend = (previous, next) => {
+    // Se manca uno dei due, non c'è nulla da unire
+    if (!next?.dtdResult?.rows?.length)
+        return previous;
+    if (!previous?.dtdResult?.rows?.length)
+        return next;
+    // L'accodamento ha senso solo sullo stesso tipo documento (colonne compatibili)
+    if (previous.fromTID !== next.fromTID)
+        return next;
+    const prevRows = previous.dtdResult.rows ?? [];
+    const nextRows = next.dtdResult.rows ?? [];
+    // Nessuna deduplica: le nuove righe in cima, poi le precedenti (i duplicati sono ammessi)
+    const mergedRows = [...nextRows, ...prevRows];
+    // Costruisce il nuovo descrittore basandosi sull'ultimo risultato (colonne/qd più recenti), con le righe unite
+    const merged = structuredClone(next);
+    const mergedDtd = structuredClone(next.dtdResult);
+    mergedDtd.rows = mergedRows;
+    merged.dtdResult = mergedDtd;
+    merged.dcmtsReturned = mergedRows.length;
+    merged.dcmtsFound = mergedRows.length;
+    return merged;
+};
 export const getCompleteMetadataName = (dcmtTypeName, metadataName) => `${dcmtTypeName}...${metadataName}`;
 export const getQueryCountAsync = async (qd, showSpinner) => {
     try {
@@ -573,6 +613,8 @@ export const downloadBase64File = (base64Data, fileName) => {
     // Libera l'URL del Blob
     URL.revokeObjectURL(blobUrl);
 };
+export const WHATS_NEWS_FILE_NAME = "what's new";
+export const WHATS_NEWS_LINK_URL = 'https://www.topconsult.it/it/documentazionetopmedia';
 export const TASK_MORE_INFO_PREFIX_NAME = `${SDKUI_Localizator.MoreInformation} - `;
 export const isTaskMoreInfo = (taskName) => taskName?.startsWith(TASK_MORE_INFO_PREFIX_NAME);
 // Filtra i task di tipo "More Info" non completati associati a un documento specifico.
@@ -781,7 +823,21 @@ export var LandingPages;
 // #region Exception
 export function getExceptionMessage(ex) {
     let msg = ex.isApiException ? ex.response.title : ex.message;
-    return msg ?? ex.toString();
+    if (msg !== undefined && msg !== null)
+        return msg;
+    let asString = ex.toString();
+    if (asString !== '[object Object]')
+        return asString;
+    if (ex.errorMessage)
+        return ex.errorMessage;
+    if (ex.title)
+        return ex.title;
+    try {
+        return JSON.stringify(ex) ?? asString;
+    }
+    catch {
+        return asString;
+    }
 }
 export function getContrastColor(inputColor) {
     let hex = inputColor;

package/lib/helper/index.d.ts

@@ -5,6 +5,7 @@ export * from './Globalization';
 export * from './TMIcons';
 export * from './TMImageLibrary';
 export * from './helpers';
+export * from './dataGridSearchHelper';
 export * from './queryHelper';
 export * from './TMUtils';
 export * from './TMCommandsContextMenu';
@@ -18,3 +19,4 @@ export * from './devextremeCustomMessages';
 export * from './ZipManager';
 export * from './certificateImportHelper';
 export * from './grafometricSignaturesCache';
+export * from './TMAppUpdatedModal';

package/lib/helper/index.js

@@ -5,6 +5,7 @@ export * from './Globalization';
 export * from './TMIcons';
 export * from './TMImageLibrary';
 export * from './helpers';
+export * from './dataGridSearchHelper';
 export * from './queryHelper';
 export * from './TMUtils';
 export * from './TMCommandsContextMenu';
@@ -18,3 +19,4 @@ export * from './devextremeCustomMessages';
 export * from './ZipManager';
 export * from './certificateImportHelper';
 export * from './grafometricSignaturesCache';
+export * from './TMAppUpdatedModal';

package/lib/helper/queryHelper.d.ts

@@ -5,7 +5,10 @@ export type TID_Alias = {
     alias: string | undefined;
 };
 export declare const getTIDsByQd: (qd: QueryDescriptor | undefined) => TID_Alias[];
-export declare const getDcmtTypesByQdAsync: (qd: QueryDescriptor) => Promise<import("@topconsultnpm/sdk-ts").DcmtTypeDescriptor[]>;
+/** Restituisce i tipi documento (con metadati) referenziati da qd.
+ *  Con refreshCache = true i descrittori vengono riletti dal server, così la lista dei metadati
+ *  recepisce quelli aggiunti o rimossi dopo il popolamento della cache. */
+export declare const getDcmtTypesByQdAsync: (qd: QueryDescriptor, refreshCache?: boolean) => Promise<import("@topconsultnpm/sdk-ts").DcmtTypeDescriptor[]>;
 export declare const displayMetadataValue: (md: MetadataDescriptor | undefined, value: string | undefined, valueEmptyDescription?: string) => string;
 export declare const IsParametricQuery: (qd: QueryDescriptor | undefined) => boolean;
 export declare const addHiddenSelectItem: (select: SelectItem[], tid: number | undefined, mid: SystemMIDsAsNumber) => void;
@@ -14,6 +17,8 @@ export declare function addWhereClausesForConnect(qd: QueryDescriptor): void;
 export declare function getDefaultOperator(dataDomain: MetadataDataDomains | undefined, dataType: MetadataDataTypes | undefined): QueryOperators.Equal | QueryOperators.Contain | QueryOperators.In;
 export declare const getQD: (tid: number | undefined, easyOr: boolean, newMaxDcmtsToBeReturned: number) => Promise<QueryDescriptor | undefined>;
 export declare const getWorkItemSetIDAsync: (vid: number, did: number) => Promise<string | undefined>;
+/** Id assegnato alla ricerca di sistema con tutti i documenti: non è in cache, va ricostruita a runtime con getSysAllDcmtsSQD */
+export declare const SYS_ALL_DCMTS_SQD_ID = 1;
 export declare const getSysAllDcmtsSQD: (tid: number | undefined, easyOr: boolean) => Promise<SavedQueryDescriptor>;
 export declare const searchResultToMetadataValues: (tid: number | undefined, dtd: DataTableDescriptor | undefined, rows: string[], mids: number[], metadata: MetadataDescriptor[], layoutMode: LayoutModes, isReadOnlyOrigin?: boolean) => MetadataValueDescriptorEx[];
 export declare const handleArchiveVisibility: (md: MetadataDescriptor) => boolean;

package/lib/helper/queryHelper.js

@@ -15,8 +15,11 @@ export const getTIDsByQd = (qd) => {
     }
     return tids;
 };
-export const getDcmtTypesByQdAsync = async (qd) => {
-    return await DcmtTypeListCacheService.GetFromQdAsync(qd);
+/** Restituisce i tipi documento (con metadati) referenziati da qd.
+ *  Con refreshCache = true i descrittori vengono riletti dal server, così la lista dei metadati
+ *  recepisce quelli aggiunti o rimossi dopo il popolamento della cache. */
+export const getDcmtTypesByQdAsync = async (qd, refreshCache = false) => {
+    return await DcmtTypeListCacheService.GetFromQdAsync(qd, undefined, false, refreshCache);
 };
 export const displayMetadataValue = (md, value, valueEmptyDescription = "") => {
     if (!value)
@@ -251,9 +254,11 @@ export const getWorkItemSetIDAsync = async (vid, did) => {
     let result = await SDK_Globals.tmSession?.NewSearchEngine().SearchByIDAsync(qd);
     return result?.dtdResult?.rows?.[0]?.[0];
 };
+/** Id assegnato alla ricerca di sistema con tutti i documenti: non è in cache, va ricostruita a runtime con getSysAllDcmtsSQD */
+export const SYS_ALL_DCMTS_SQD_ID = 1;
 export const getSysAllDcmtsSQD = async (tid, easyOr) => {
     let sqd = new SavedQueryDescriptor();
-    sqd.id = 1;
+    sqd.id = SYS_ALL_DCMTS_SQD_ID;
     sqd.masterTID = tid;
     sqd.isEasyWhere = 1;
     sqd.name = SDKUI_Localizator.AllDcmts;

package/lib/hooks/tmDistinctValuesGridHelper.d.ts

@@ -0,0 +1,16 @@
+import { DataColumnDescriptor, DataColumnTypes, MetadataDescriptor, MetadataFormats } from '@topconsultnpm/sdk-ts';
+/**
+ * Funzioni condivise dalle due sorgenti di TMDistinctValues (valori distinti e ricerca rapida):
+ * stanno fuori dagli hook perché non dipendono da alcuno stato.
+ */
+export declare const withRowIndex: <T>(rows: Array<T>) => T[];
+export declare const toGridDataType: (dataType: DataColumnTypes | undefined) => "boolean" | "datetime" | "number" | "string";
+export declare const getMetadataName: (columnMd: MetadataDescriptor | undefined) => string | undefined;
+export declare const getDateDisplayFormat: (format: MetadataFormats | undefined, formatCulture: string | undefined | null) => {
+    formatter: (value: string | number | Date) => string;
+};
+/**
+ * Risolve il MID della colonna di un risultato di ricerca: la proprietà estesa è la fonte principale,
+ * in mancanza resta l'allineamento posizionale tra selectMIDs e colonne del risultato.
+ */
+export declare const getColumnMid: (column: DataColumnDescriptor | undefined, selectMIDs: number[] | undefined, columnIndex: number) => number;

package/lib/hooks/tmDistinctValuesGridHelper.js

@@ -0,0 +1,31 @@
+import { DataColumnTypes, SDK_Globals } from '@topconsultnpm/sdk-ts';
+import { formatDateTimeByMetadataFormat } from '../helper';
+/**
+ * Funzioni condivise dalle due sorgenti di TMDistinctValues (valori distinti e ricerca rapida):
+ * stanno fuori dagli hook perché non dipendono da alcuno stato.
+ */
+// rowIndex è la chiave delle griglie di TMDistinctValues: va riallineato all'ordine finale delle righe
+export const withRowIndex = (rows) => {
+    rows.forEach((row, index) => { row.rowIndex = index; });
+    return rows;
+};
+export const toGridDataType = (dataType) => {
+    switch (dataType) {
+        case DataColumnTypes.DateTime: return 'datetime';
+        case DataColumnTypes.Bool: return 'boolean';
+        case DataColumnTypes.Number: return 'number';
+        default: return 'string';
+    }
+};
+// Nome del metadato con cui viene intestata la colonna, nella lingua scelta dall'utente
+export const getMetadataName = (columnMd) => (SDK_Globals.useLocalizedName ? columnMd?.nameLoc : columnMd?.name) ?? columnMd?.name ?? columnMd?.nameLoc ?? undefined;
+// Le date vanno mostrate con il formato definito sul metadato, come nel risultato di ricerca
+export const getDateDisplayFormat = (format, formatCulture) => ({
+    // La griglia passa al formatter un oggetto Date già istanziato, ma il valore può arrivare anche come stringa
+    formatter: (value) => formatDateTimeByMetadataFormat(value instanceof Date ? value : new Date(value), format, formatCulture)
+});
+/**
+ * Risolve il MID della colonna di un risultato di ricerca: la proprietà estesa è la fonte principale,
+ * in mancanza resta l'allineamento posizionale tra selectMIDs e colonne del risultato.
+ */
+export const getColumnMid = (column, selectMIDs, columnIndex) => Number(column?.extendedProperties?.['MID'] ?? 0) || (selectMIDs?.[columnIndex] ?? 0);

package/lib/hooks/useArchiveListForm.d.ts

@@ -0,0 +1,39 @@
+import { MutableRefObject } from 'react';
+import { MetadataValueDescriptorEx } from '../ts';
+/** Modalità "aggiungi a elenco": il form non archivia a sistema, restituisce i metadati al chiamante (TMMultiMasterDetailDcmts). */
+export interface ArchiveListMode {
+    /** true quando si modifica una riga già presente nell'elenco ("Modifica" al posto di "Aggiungi"). */
+    isEditingRow: boolean;
+    /** Restituisce metadati e file al chiamante, che aggiunge o aggiorna la riga nell'elenco (senza archiviare). */
+    onUpsertRow: (metadataValues: Array<MetadataValueDescriptorEx>, file: File | undefined, tid?: number) => void;
+}
+interface UseArchiveListFormParams {
+    /** Assente = modalità "aggiungi a elenco" spenta. */
+    mode?: ArchiveListMode;
+    /** Valori della riga in modifica, con cui pre-compilare il form. */
+    editingRowValues?: Array<{
+        mid: number;
+        value: string;
+    }>;
+    /** Template vuoto del form. */
+    formDataOrig: Array<MetadataValueDescriptorEx>;
+    /** Ref ai valori correnti del form (per leggerli al submit senza stale closure). */
+    formDataRef: MutableRefObject<Array<MetadataValueDescriptorEx>>;
+    /** Ref al file caricato. */
+    dcmtFileRef: MutableRefObject<File | null>;
+    tid?: number;
+    isModal?: boolean;
+    /** Id del form, usato come parentId del message box quando è in modale. */
+    id?: string;
+    /** Svuota il form dopo aver restituito i valori. */
+    clearForm: () => void;
+}
+/** Isola la logica della modalità "aggiungi a elenco": valori di riferimento, submit e chiusura del form. */
+export declare const useArchiveListForm: ({ mode, editingRowValues, formDataOrig, formDataRef, dcmtFileRef, tid, isModal, id, clearForm, }: UseArchiveListFormParams) => {
+    enabled: boolean;
+    isEditingRow: boolean;
+    referenceValues: MetadataValueDescriptorEx[];
+    submit: () => void;
+    requestClose: (isModified: boolean, onClose?: () => void) => boolean;
+};
+export {};

package/lib/hooks/useArchiveListForm.js

@@ -0,0 +1,46 @@
+import { useCallback, useMemo } from 'react';
+import { ButtonNames, TMMessageBoxManager } from '../components';
+/** Isola la logica della modalità "aggiungi a elenco": valori di riferimento, submit e chiusura del form. */
+export const useArchiveListForm = ({ mode, editingRowValues, formDataOrig, formDataRef, dcmtFileRef, tid, isModal, id, clearForm, }) => {
+    const enabled = !!mode;
+    const isEditingRow = !!mode?.isEditingRow;
+    // Valori con cui si confronta il form per capire cosa è cambiato (flag "modificato" ed evidenza gialla).
+    // Modificando una riga si parte dai suoi valori, così i campi pre-compilati non risultano subito modificati.
+    const referenceValues = useMemo(() => {
+        if (!isEditingRow || !editingRowValues || editingRowValues.length === 0)
+            return formDataOrig;
+        return formDataOrig.map(md => {
+            const rowValue = editingRowValues.find(rv => rv.mid === md.mid);
+            return rowValue ? { ...md, value: rowValue.value } : md;
+        });
+    }, [isEditingRow, editingRowValues, formDataOrig]);
+    // Restituisce metadati e file al chiamante, poi svuota il form.
+    const submit = useCallback(() => {
+        if (!mode)
+            return;
+        const values = formDataRef.current.filter(md => md.mid !== undefined && md.mid > 99);
+        mode.onUpsertRow(values, dcmtFileRef.current ?? undefined, tid);
+        clearForm();
+    }, [mode, formDataRef, dcmtFileRef, tid, clearForm]);
+    // Gestisce la chiusura del form
+    const requestClose = useCallback((isModified, onClose) => {
+        if (!mode)
+            return false;
+        if (!isModified) {
+            onClose?.();
+            return true;
+        }
+        TMMessageBoxManager.show({
+            parentId: isModal ? "TMDcmtFormShowConfirmForClose-" + id : undefined,
+            message: "Chiudendo, le modifiche andranno perse. Proseguire?",
+            buttons: [ButtonNames.YES, ButtonNames.NO],
+            onButtonClick: (e) => {
+                // Sì: scarta le modifiche e chiude senza aggiungere all'elenco. No: resta sul form.
+                if (e == ButtonNames.YES)
+                    onClose?.();
+            }
+        });
+        return true;
+    }, [mode, isModal, id]);
+    return { enabled, isEditingRow, referenceValues, submit, requestClose };
+};

package/lib/hooks/useCaseFlowApprove.d.ts

@@ -0,0 +1,56 @@
+import { CaseFlowInstanceDescriptor, CaseFlowWorkItem } from '@topconsultnpm/sdk-ts';
+/**
+ * Attività (workitem) delle PRATICHE assegnate all'utente, con il documento su
+ * cui lavorano già risolto.
+ *
+ * Gemello di `useWorkflowApprove` per il modulo CaseFlow: i dati stanno in una
+ * cache di modulo e le istanze del hook si sincronizzano con un evento, così il
+ * form del documento — da qualunque punto venga aperto — sa che su quel TID/DID
+ * c'è una firma da fare o un'approvazione da dare, senza che il chiamante debba
+ * passargli nulla.
+ */
+/** Workitem di pratica già risolto sul documento cui si riferisce. */
+export interface CaseFlowDcmtWorkItem {
+    caseflow: CaseFlowInstanceDescriptor;
+    workItem: CaseFlowWorkItem;
+    tid: number;
+    did: number;
+}
+/**
+ * Ricarica i workitem di pratica dell'utente. Con `force` ignora la finestra
+ * anti-raffica (da usare dopo un'operazione che li ha modificati).
+ */
+export declare const refreshCaseFlowApproveData: (force?: boolean) => Promise<void>;
+/**
+ * Workitem di pratica pendenti su quel documento (lettura sincrona dalla cache).
+ *
+ * TID/DID vanno NORMALIZZATI: pur essendo tipati `number`, arrivano come stringhe
+ * quando il documento è aperto da una griglia (righe di datagrid) — per lo stesso
+ * motivo il resto della libreria fa `Number(TID)`/`Number(DID)` in ogni confronto.
+ * Senza normalizzazione il confronto stretto falliva, e l'attività risultava
+ * assente aprendo il documento dalla ricerca mentre compariva dal widget "Per te".
+ */
+export declare const getCaseFlowWorkItemsByDcmt: (tid?: number | string, did?: number | string) => CaseFlowDcmtWorkItem[];
+/** Svuota la cache (logout / cambio archivio). */
+export declare const clearCaseFlowApproveData: () => void;
+/** Completa il workitem di pratica e ricarica la cache. */
+export declare const completeCaseFlowWorkItem: (item: CaseFlowDcmtWorkItem, comment?: string) => Promise<void>;
+/** Rifiuta il workitem di pratica (motivo obbligatorio) e ricarica la cache. */
+export declare const rejectCaseFlowWorkItem: (item: CaseFlowDcmtWorkItem, reason: string) => Promise<void>;
+/**
+ * Completa l'attività di FIRMA di una pratica sul documento indicato, se esiste.
+ * La chiama il viewer di firma quando la firma è riuscita: è il gemello di quanto
+ * già avviene per i workitem del workflow legacy.
+ * @returns true se un'attività è stata completata.
+ */
+export declare const completeCaseFlowSignatureForDcmt: (tid: number | string, did: number | string, comment?: string) => Promise<boolean>;
+/**
+ * Attività di pratica sul documento indicato. Senza sessione o senza attività
+ * l'elenco è vuoto e nulla cambia nella UI.
+ */
+export declare const useCaseFlowApprove: (tid?: number | string, did?: number | string) => {
+    caseFlowWorkItems: CaseFlowDcmtWorkItem[];
+    refreshCaseFlowApprove: typeof refreshCaseFlowApproveData;
+    completeCaseFlowWorkItem: typeof completeCaseFlowWorkItem;
+    rejectCaseFlowWorkItem: typeof rejectCaseFlowWorkItem;
+};