@topconsultnpm/sdkui-react 6.22.0-dev2.5 → 6.22.0-dev2.50

package/lib/helper/TMAppUpdatedModal.js

@@ -0,0 +1,134 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from 'react';
+import styled from 'styled-components';
+import { AppModules, SDK_Globals } from '@topconsultnpm/sdk-ts';
+import { useDeviceType, TMModal } from '../components';
+import { calcResponsiveSizes, WHATS_NEWS_LINK_URL } from './helpers';
+import { SDKUI_Globals } from './SDKUI_Globals';
+import { SDKUI_Localizator } from './SDKUI_Localizator';
+import { IconUpdate, IconOpenInNew } from './TMIcons';
+import { getAppModuleButtonColors } from './TMUtils';
+const Content = styled.div `
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    background-color: #ffffff;
+`;
+const Header = styled.div `
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 14px;
+    padding: 32px 30px 26px 30px;
+    background-color: ${({ $backgroundColor }) => $backgroundColor};
+    color: #ffffff;
+    text-align: center;
+`;
+const HeaderIcon = styled.div `
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 68px;
+    height: 68px;
+    border-radius: 50%;
+    background-color: rgba(255, 255, 255, 0.18);
+    border: 1px solid rgba(255, 255, 255, 0.35);
+    box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18);
+`;
+const HeaderTitle = styled.h2 `
+    margin: 0;
+    font-size: 22px;
+    font-weight: 600;
+    letter-spacing: 0.2px;
+`;
+const VersionBadge = styled.span `
+    display: inline-block;
+    padding: 4px 12px;
+    border-radius: 999px;
+    background-color: rgba(255, 255, 255, 0.22);
+    border: 1px solid rgba(255, 255, 255, 0.4);
+    font-size: 13px;
+    font-weight: 600;
+    letter-spacing: 0.3px;
+`;
+const Body = styled.div `
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+    padding: 26px 30px 22px 30px;
+    text-align: center;
+`;
+const Message = styled.p `
+    margin: 0;
+    font-size: 15px;
+    line-height: 1.6;
+    color: #242424;
+`;
+const SubMessage = styled.p `
+    margin: 0;
+    font-size: 13px;
+    line-height: 1.6;
+    color: #6b6b6b;
+`;
+const Footer = styled.div `
+    display: flex;
+    flex-direction: row;
+    justify-content: center;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: 12px;
+    padding: 0 30px 28px 30px;
+`;
+const BaseButton = styled.button `
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: 8px;
+    min-width: 150px;
+    padding: 10px 18px;
+    border-radius: 8px;
+    font-size: 14px;
+    font-weight: 600;
+    cursor: pointer;
+    transition: background-color 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease;
+`;
+const PrimaryButton = styled(BaseButton) `
+    border: 1px solid ${({ $base }) => $base};
+    background-color: ${({ $base }) => $base};
+    color: #ffffff;
+
+    &:hover {
+        background-color: ${({ $hover }) => $hover};
+        border-color: ${({ $hover }) => $hover};
+        box-shadow: 0 2px 8px ${({ $shadow }) => $shadow};
+    }
+`;
+const SecondaryButton = styled(BaseButton) `
+    border: 1px solid #d5d5d5;
+    background-color: #ffffff;
+    color: #444444;
+
+    &:hover {
+        background-color: #f3f3f3;
+        border-color: #bdbdbd;
+    }
+`;
+export const TMAppUpdatedModal = () => {
+    const deviceType = useDeviceType();
+    const currentVersion = SDK_Globals.appVersion ?? '';
+    const appModuleID = SDK_Globals.tmSession?.SessionDescr?.appModuleID ?? AppModules.SURFER;
+    const appModuleColors = useMemo(() => getAppModuleButtonColors(appModuleID), [appModuleID]);
+    const [previousVersion] = useState(() => SDKUI_Globals.userSettings.lastSeenAppVersion ?? '');
+    const [isOpen, setIsOpen] = useState(() => currentVersion !== '' && previousVersion !== currentVersion);
+    useEffect(() => {
+        if (!isOpen)
+            return;
+        SDKUI_Globals.userSettings.lastSeenAppVersion = currentVersion;
+    }, [isOpen, currentVersion]);
+    const onClose = () => { setIsOpen(false); };
+    if (!isOpen)
+        return null;
+    return (_jsx(TMModal, { width: calcResponsiveSizes(deviceType, '520px', '520px', '95%'), height: 'auto', showHeader: false, resizable: false, onClose: onClose, children: _jsxs(Content, { children: [_jsxs(Header, { "$backgroundColor": appModuleColors.base, children: [_jsx(HeaderIcon, { children: _jsx(IconUpdate, { fontSize: 34 }) }), _jsx(HeaderTitle, { children: SDKUI_Localizator.AppUpdatedTitle }), _jsx(VersionBadge, { children: `${SDK_Globals.appModule} ${currentVersion}` })] }), _jsxs(Body, { children: [_jsx(Message, { children: previousVersion
+                                ? SDKUI_Localizator.AppUpdatedMessageFromTo.replaceParams(previousVersion, currentVersion)
+                                : SDKUI_Localizator.AppUpdatedMessage.replaceParams(currentVersion) }), _jsx(SubMessage, { children: SDKUI_Localizator.AppUpdatedSubMessage })] }), _jsxs(Footer, { children: [_jsxs(PrimaryButton, { "$base": appModuleColors.base, "$hover": appModuleColors.hover, "$shadow": appModuleColors.shadow, onClick: () => window.open(WHATS_NEWS_LINK_URL, '_blank', 'noopener,noreferrer'), children: [_jsx(IconOpenInNew, { fontSize: 18 }), SDKUI_Localizator.DiscoverWhatsNew] }), _jsx(SecondaryButton, { onClick: onClose, children: SDKUI_Localizator.Close })] })] }) }));
+};

package/lib/helper/TMIcons.d.ts

@@ -271,6 +271,7 @@ export declare function IconWizard4(props: React.SVGProps<SVGSVGElement>): impor
 export declare function IconNew(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
 export declare function IconFileOpenOutline(props: Readonly<React.SVGProps<SVGSVGElement>>): import("react/jsx-runtime").JSX.Element;
 export declare function IconArchiveDetail(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+export declare function IconArchiveMultipleDetailDocuments(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
 export declare function IconArchiveMaster(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
 export declare function IconPair(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
 export declare function IconUnpair(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;

package/lib/helper/TMIcons.js

@@ -673,6 +673,9 @@ export function IconFileOpenOutline(props) {
 export function IconArchiveDetail(props) {
     return (_jsxs("svg", { fontSize: props.fontSize ?? FONTSIZE, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "1em", height: "1em", ...props, children: [" ", _jsx("path", { fill: "currentColor", d: "m20.54 5.23l-1.39-1.68C18.88 3.21 18.47 3 18 3H6c-.47 0-.88.21-1.16.55L3.46 5.23C3.17 5.57 3 6.02 3 6.5V19c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V6.5c0-.48-.17-.93-.46-1.27M12 17.5L6.5 12H10v-2h4v2h3.5zM5.12 5l.81-1h12l.94 1z" }), " "] }));
 }
+export function IconArchiveMultipleDetailDocuments(props) {
+    return (_jsxs("svg", { fontSize: props.fontSize ?? FONTSIZE, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 48 48", width: "1em", height: "1em", ...props, children: [_jsx("path", { fill: "currentColor", d: "M40,35v5H8v-5H4v5c0,2.2,1.8,4,4,4h32c2.2,0,4-1.8,4-4v-5H40z" }), _jsxs("g", { fill: "currentColor", children: [_jsx("polygon", { points: "24,23.4 17,15 31,15" }), _jsx("rect", { x: "22", y: "4", width: "4", height: "14" }), _jsx("path", { d: "M31.5,26.9L30.8,28l3.5,1.9l0.6-1.2c1.6-3,2.6-4.7,3.5-5.2C39.3,23,41,23,44,23v-4C36.3,19,35.6,19.4,31.5,26.9z" }), _jsx("polygon", { points: "38.4,31 29.4,35 28,25" }), _jsx("path", { d: "M16.5,26.9l0.6,1.2L13.6,30L13,28.8c-1.6-3-2.6-4.7-3.5-5.2C8.7,23,7,23,4,23v-4C11.7,19,12.4,19.4,16.5,26.9z" }), _jsx("polygon", { points: "20,25 18.6,35 9.6,31" })] })] }));
+}
 export function IconArchiveMaster(props) {
     return (_jsxs("svg", { fontSize: props.fontSize ?? FONTSIZE, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "1em", height: "1em", ...props, children: [" ", _jsx("path", { fill: "currentColor", d: "m20.55 5.22l-1.39-1.68A1.51 1.51 0 0 0 18 3H6c-.47 0-.88.21-1.15.55L3.46 5.22C3.17 5.57 3 6.01 3 6.5V19a2 2 0 0 0 2 2h14c1.1 0 2-.9 2-2V6.5c0-.49-.17-.93-.45-1.28M12 9.5l5.5 5.5H14v2h-4v-2H6.5zM5.12 5l.82-1h12l.93 1z" }), " "] }));
 }

package/lib/helper/TMUtils.d.ts

@@ -53,11 +53,18 @@ export declare const PDGS_COLORS: {
     DOSSIER: string;
     DOCUMENT: string;
     WORKING_GROUP: string;
+    /** Istanza di CaseFlow: viola, per non confonderla ne' con la pratica (arancio) ne' con il gruppo di lavoro (verde). */
+    CASEFLOW: string;
 };
 export declare const getPdgsIconMap: (fontSize?: number) => Map<PdGs, JSX.Element>;
 export declare const convertSearchResultDescriptorToFileItems: (documents: Array<SearchResultDescriptor>) => Array<FileItem>;
 export declare const getAppModuleGradient: (appModuleID: AppModules) => string;
 export declare const getPanelManagerToolbarColor: (appModuleID: AppModules) => string;
+export declare const getAppModuleButtonColors: (appModuleID: AppModules) => {
+    base: string;
+    hover: string;
+    shadow: string;
+};
 export declare const getFileManagerFolderColor: (appModuleID: AppModules) => string;
 type SearchToolbarVisibility = {
     tmSearchResult: boolean;

package/lib/helper/TMUtils.js

@@ -270,6 +270,8 @@ export const PDGS_COLORS = {
     DOSSIER: '#e65b00',
     DOCUMENT: '#b38600',
     WORKING_GROUP: '#009700',
+    /** Istanza di CaseFlow: viola, per non confonderla ne' con la pratica (arancio) ne' con il gruppo di lavoro (verde). */
+    CASEFLOW: '#6a3fb5',
 };
 export const getPdgsIconMap = (fontSize = 20) => {
     return new Map([
@@ -336,7 +338,7 @@ export const getAppModuleGradient = (appModuleID) => {
         case AppModules.SURFER:
             return 'linear-gradient(270deg, #46B5A2 16%, #3BAABC 34%, #3BAABC 34%, #3681AD 54%, #3368A5 72%, #2F549D 88%, #304F99 100%)';
         case AppModules.DESIGNER:
-            return 'linear-gradient(270deg, #A06A8E 16%, #885C77 34%, #6F4C5F 54%, #5A3446 72%, #482234 100%);';
+            return 'linear-gradient(270deg, #A06A8E 16%, #885C77 34%, #6F4C5F 54%, #5A3446 72%, #482234 100%)';
         case AppModules.ORCHESTRATOR:
             return 'linear-gradient(270deg, #46B5A2 16%, #3BAA8A 34%, #2F8F6F 54%, #277A5A 72%, #216948 88%, #1d6f42 100%)';
         default:
@@ -355,6 +357,18 @@ export const getPanelManagerToolbarColor = (appModuleID) => {
             return 'transparent linear-gradient(90deg, #CCE0F4 0%, #7EC1E7 14%, #39A6DB 28%, #1E9CD7 35%, #0075BE 78%, #005B97 99%) 0% 0% no-repeat padding-box';
     }
 };
+export const getAppModuleButtonColors = (appModuleID) => {
+    switch (appModuleID) {
+        case AppModules.SURFER:
+            return { base: '#2559a5', hover: '#1c4783', shadow: 'rgba(37, 89, 165, 0.35)' };
+        case AppModules.DESIGNER:
+            return { base: '#482234', hover: '#351826', shadow: 'rgba(72, 34, 52, 0.35)' };
+        case AppModules.ORCHESTRATOR:
+            return { base: '#1d6f42', hover: '#15532f', shadow: 'rgba(29, 111, 66, 0.35)' };
+        default:
+            return { base: '#2559a5', hover: '#1c4783', shadow: 'rgba(37, 89, 165, 0.35)' };
+    }
+};
 export const getFileManagerFolderColor = (appModuleID) => {
     switch (appModuleID) {
         case AppModules.SURFER:

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,28 @@
+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>;
+/** 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,21 @@
-import { RelationCacheService, RelationTypes, SDK_Globals } from "@topconsultnpm/sdk-ts";
+import { 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));
+};
+/** 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 +30,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;
@@ -53,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[];

package/lib/helper/helpers.js

@@ -7,6 +7,14 @@ import { buildTypes, FileExtensionHandler, FormModes, moduleTypes } from "../ts"
 import { SDKUI_Localizator } from "./SDKUI_Localizator";
 import ReactDOMServer from "react-dom/server";
 import { DeepCompareHelper } from "./DeepCompareHelper";
+/**
+ * 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;
@@ -605,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.
@@ -813,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) => "string" | "number" | "datetime" | "boolean";
+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 {};