@topconsultnpm/sdkui-react 6.22.0-dev2.19 → 6.22.0-dev2.20

package/lib/helper/SDKUI_Localizator.js

@@ -444,6 +444,16 @@ export class SDKUI_Localizator {
             default: return "Consenti solo archiviazioni di metadati";
         }
     }
+    static get ArchivedDetails() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Bereits archivierte Details";
+            case CultureIDs.En_US: return "Already archived details";
+            case CultureIDs.Es_ES: return "Detalles ya archivados";
+            case CultureIDs.Fr_FR: return "Détails déjà archivés";
+            case CultureIDs.Pt_PT: return "Detalhes já arquivados";
+            default: return "Dettagli già archiviati";
+        }
+    }
     static get ArchivedDocuments() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Archivierte Dokumente";
@@ -484,6 +494,46 @@ export class SDKUI_Localizator {
             default: return "Archivia documento master";
         }
     }
+    static get ArchiveMultipleDetailDocuments() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Mehrere Details archivieren";
+            case CultureIDs.En_US: return "Archive multiple details";
+            case CultureIDs.Es_ES: return "Archivar múltiples detalles";
+            case CultureIDs.Fr_FR: return "Archiver plusieurs détails";
+            case CultureIDs.Pt_PT: return "Arquivar múltiplos detalhes";
+            default: return "Archivia dettagli multipli";
+        }
+    }
+    static get ArchiveMasterAndMultipleDetailDocuments() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Master mit mehreren Details archivieren";
+            case CultureIDs.En_US: return "Archive master with multiple details";
+            case CultureIDs.Es_ES: return "Archivar maestro con múltiples detalles";
+            case CultureIDs.Fr_FR: return "Archiver le maître avec plusieurs détails";
+            case CultureIDs.Pt_PT: return "Arquivar mestre com múltiplos detalhes";
+            default: return "Archivia master con dettagli multipli";
+        }
+    }
+    static get ArchiveMasterAndDetails_Confirm() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Master archivieren und mit den Details fortfahren?";
+            case CultureIDs.En_US: return "Archive the master and proceed with the details?";
+            case CultureIDs.Es_ES: return "¿Archivar el maestro y continuar con los detalles?";
+            case CultureIDs.Fr_FR: return "Archiver le maître et poursuivre avec les détails ?";
+            case CultureIDs.Pt_PT: return "Arquivar o mestre e prosseguir com os detalhes?";
+            default: return "Archiviare il master e proseguire con i dettagli?";
+        }
+    }
+    static get ExitWithoutArchiving_Confirm() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Möchten Sie wirklich beenden? Die eingegebenen Dokumente werden nicht archiviert. Fortfahren?";
+            case CultureIDs.En_US: return "Are you sure you want to exit? The entered documents will not be archived. Continue?";
+            case CultureIDs.Es_ES: return "¿Está seguro de que desea salir? Los documentos introducidos no se archivarán. ¿Continuar?";
+            case CultureIDs.Fr_FR: return "Êtes-vous sûr de vouloir quitter ? Les documents saisis ne seront pas archivés. Continuer ?";
+            case CultureIDs.Pt_PT: return "Tem a certeza de que pretende sair? Os documentos introduzidos não serão arquivados. Continuar?";
+            default: return "Sei sicuro di voler uscire? I documenti inseriti non verranno archiviati. Continuare?";
+        }
+    }
     static get Archiving() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Archivierung";
@@ -1672,6 +1722,16 @@ export class SDKUI_Localizator {
             default: return "Dettagli";
         }
     }
+    static get DetailsToArchive() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Zu archivierende Details";
+            case CultureIDs.En_US: return "Details to archive";
+            case CultureIDs.Es_ES: return "Detalles a archivar";
+            case CultureIDs.Fr_FR: return "Détails à archiver";
+            case CultureIDs.Pt_PT: return "Detalhes a arquivar";
+            default: return "Dettagli da archiviare";
+        }
+    }
     static get Delete() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Löschen";
@@ -1712,6 +1772,16 @@ export class SDKUI_Localizator {
             default: return "Eliminare il commento?";
         }
     }
+    static get DeleteAllRowsToChangeDcmtType() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Löschen Sie alle Zeilen, um den Dokumenttyp zu ändern";
+            case CultureIDs.En_US: return "Delete all rows to change the document type";
+            case CultureIDs.Es_ES: return "Elimine todas las filas para poder cambiar el tipo de documento";
+            case CultureIDs.Fr_FR: return "Supprimez toutes les lignes pour pouvoir changer le type de document";
+            case CultureIDs.Pt_PT: return "Elimine todas as linhas para poder alterar o tipo de documento";
+            default: return "Elimina tutte le righe per poter cambiare tipo documento";
+        }
+    }
     static get DeleteDeletedMessages() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Gelöschte Nachrichten löschen";
@@ -4018,6 +4088,16 @@ export class SDKUI_Localizator {
             default: return "Nascondi tutti";
         }
     }
+    static get HideArchivedDetails() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Bereits archivierte Details ausblenden";
+            case CultureIDs.En_US: return "Hide already archived details";
+            case CultureIDs.Es_ES: return "Ocultar los detalles ya archivados";
+            case CultureIDs.Fr_FR: return "Masquer les détails déjà archivés";
+            case CultureIDs.Pt_PT: return "Ocultar os detalhes já arquivados";
+            default: return "Nascondi i dettagli già archiviati";
+        }
+    }
     static get HideDcmtTypes() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Dokumenttypen ausblenden";
@@ -4028,6 +4108,16 @@ export class SDKUI_Localizator {
             default: return "Nascondi tipi documento";
         }
     }
+    static get HideDetailsToArchive() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Zu archivierende Details ausblenden";
+            case CultureIDs.En_US: return "Hide details to archive";
+            case CultureIDs.Es_ES: return "Ocultar los detalles a archivar";
+            case CultureIDs.Fr_FR: return "Masquer les détails à archiver";
+            case CultureIDs.Pt_PT: return "Ocultar os detalhes a arquivar";
+            default: return "Nascondi i dettagli da archiviare";
+        }
+    }
     static get HideDetailsWithZeroDocs() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Details mit 0 Dokumenten ausblenden";
@@ -4078,6 +4168,16 @@ export class SDKUI_Localizator {
             default: return "Nascondi opzioni di formattazione";
         }
     }
+    static get HideMasterInfo() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Master-Informationen ausblenden";
+            case CultureIDs.En_US: return "Hide master information";
+            case CultureIDs.Es_ES: return "Ocultar la información del maestro";
+            case CultureIDs.Fr_FR: return "Masquer les informations du maître";
+            case CultureIDs.Pt_PT: return "Ocultar as informações do mestre";
+            default: return "Nascondi le informazioni del master";
+        }
+    }
     static get HideMetadata() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Metadaten ausblenden";
@@ -6653,6 +6753,26 @@ export class SDKUI_Localizator {
             default: return "Nessuna correlazione trovata";
         }
     }
+    static get StopRelationsCalculation() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Berechnung unterbrechen und die bereits berechneten Korrelationen anzeigen";
+            case CultureIDs.En_US: return "Stop the calculation and show the already calculated correlations";
+            case CultureIDs.Es_ES: return "Interrumpir el cálculo y mostrar las correlaciones ya calculadas";
+            case CultureIDs.Fr_FR: return "Interrompre le calcul et afficher les corrélations déjà calculées";
+            case CultureIDs.Pt_PT: return "Interromper o cálculo e mostrar as correlações já calculadas";
+            default: return "Interrompi il calcolo e mostra le correlazioni già calcolate";
+        }
+    }
+    static get RelationsCalculationStopped() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Berechnung der Korrelationen unterbrochen: Es werden nur die bereits berechneten Korrelationen angezeigt.";
+            case CultureIDs.En_US: return "Correlations calculation stopped: only the already calculated correlations are shown.";
+            case CultureIDs.Es_ES: return "Cálculo de correlaciones interrumpido: solo se muestran las correlaciones ya calculadas.";
+            case CultureIDs.Fr_FR: return "Calcul des corrélations interrompu : seules les corrélations déjà calculées sont affichées.";
+            case CultureIDs.Pt_PT: return "Cálculo das correlações interrompido: são mostradas apenas as correlações já calculadas.";
+            default: return "Calcolo delle correlazioni interrotto: vengono mostrate solo le correlazioni già calcolate.";
+        }
+    }
     static get RelatedDcmtsNotFound() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Für das ausgewählte Dokument wurden keine zugehörigen Dokumente gefunden.";
@@ -6693,6 +6813,16 @@ export class SDKUI_Localizator {
             default: return "Rimuovi filtro contestuale";
         }
     }
+    static get RemoveDetailFromSummary_Confirm() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Detail entfernen? Es wird nicht archiviert.";
+            case CultureIDs.En_US: return "Remove this detail? It won't be archived.";
+            case CultureIDs.Es_ES: return "¿Eliminar este detalle? No se archivará.";
+            case CultureIDs.Fr_FR: return "Supprimer ce détail ? Il ne sera pas archivé.";
+            case CultureIDs.Pt_PT: return "Remover este detalhe? Não será arquivado.";
+            default: return "Rimuovere questo dettaglio? Non verrà archiviato.";
+        }
+    }
     static get RemoveFromCache() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Element aus Cache entfernen";
@@ -7299,6 +7429,16 @@ export class SDKUI_Localizator {
             default: return "Seleziona un documento per visualizzare i dettagli";
         }
     }
+    static get SelectDcmtTypeForDetailArchiving() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Dokumenttyp auswählen, für den die Details archiviert werden sollen";
+            case CultureIDs.En_US: return "Select the document type for which to archive the details";
+            case CultureIDs.Es_ES: return "Seleccionar el tipo de documento sobre el cual archivar los detalles";
+            case CultureIDs.Fr_FR: return "Sélectionner le type de document sur lequel archiver les détails";
+            case CultureIDs.Pt_PT: return "Selecionar o tipo de documento no qual arquivar os detalhes";
+            default: return "Selezionare il tipo documento sul quale effettuare l'archiviazione dei dettagli";
+        }
+    }
     static get SelectArchiveToStart() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Klicken Sie auf Archivieren, um zu beginnen.";
@@ -7630,6 +7770,16 @@ export class SDKUI_Localizator {
             default: return "Mostra tutti";
         }
     }
+    static get ShowArchivedDetails() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Bereits archivierte Details anzeigen";
+            case CultureIDs.En_US: return "Show already archived details";
+            case CultureIDs.Es_ES: return "Mostrar los detalles ya archivados";
+            case CultureIDs.Fr_FR: return "Afficher les détails déjà archivés";
+            case CultureIDs.Pt_PT: return "Mostrar os detalhes já arquivados";
+            default: return "Mostra i dettagli già archiviati";
+        }
+    }
     static get ShowColumnSelection() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Spaltenauswahl anzeigen";
@@ -7690,6 +7840,16 @@ export class SDKUI_Localizator {
             default: return "Mostra dettagli";
         }
     }
+    static get ShowDetailsToArchive() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Zu archivierende Details anzeigen";
+            case CultureIDs.En_US: return "Show details to archive";
+            case CultureIDs.Es_ES: return "Mostrar los detalles a archivar";
+            case CultureIDs.Fr_FR: return "Afficher les détails à archiver";
+            case CultureIDs.Pt_PT: return "Mostrar os detalhes a arquivar";
+            default: return "Mostra i dettagli da archiviare";
+        }
+    }
     static get ShowDetailsWithZeroDocs() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Details mit 0 Dokumenten anzeigen";
@@ -7740,6 +7900,26 @@ export class SDKUI_Localizator {
             default: return "Mostra il pannello sinistro";
         }
     }
+    static get ShowMasterInfo() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Master-Informationen anzeigen";
+            case CultureIDs.En_US: return "Show master information";
+            case CultureIDs.Es_ES: return "Mostrar la información del maestro";
+            case CultureIDs.Fr_FR: return "Afficher les informations du maître";
+            case CultureIDs.Pt_PT: return "Mostrar as informações do mestre";
+            default: return "Mostra le informazioni del master";
+        }
+    }
+    static get ShowPartialResults() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Teilergebnisse anzeigen";
+            case CultureIDs.En_US: return "Show partial results";
+            case CultureIDs.Es_ES: return "Mostrar resultados parciales";
+            case CultureIDs.Fr_FR: return "Afficher les résultats partiels";
+            case CultureIDs.Pt_PT: return "Mostrar resultados parciais";
+            default: return "Mostra risultati parziali";
+        }
+    }
     static get ShowSearch() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Suche anzeigen";

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/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;

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;

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/useDocumentOperations.d.ts

@@ -105,6 +105,7 @@ interface UseDocumentOperationsProps {
 }
 export interface UseDocumentOperationsResult {
     operationItems: Array<TMContextMenuItemProps>;
+    selectedDcmtInfos: Array<DcmtInfo>;
     renderFloatingBar: React.ReactNode;
     renderDcmtOperations: React.ReactNode;
     features: {

package/lib/hooks/useDocumentOperations.js

@@ -21,10 +21,11 @@ import { useDcmtOperations } from "./useDcmtOperations";
 import useFloatingBarPinnedItems from "./useFloatingBarPinnedItems";
 import { useInputAttachmentsDialog, useInputCvtFormatDialog } from "./useInputDialog";
 import { useRelatedDocuments } from "./useRelatedDocuments";
-import { convertSearchResultDescriptorToFileItems, dcmtsFileCachePreview, getDcmtCicoStatus, getMoreInfoTasksForDocument, IconActivity, IconArchiveDetail, IconArchiveDoc, IconArchiveMaster, IconBatchUpdate, IconCheck, IconCheckFile, IconCheckIn, IconCircleInfo, IconCloseCircle, IconConvertFilePdf, IconCopy, IconCustom, IconDelete, IconDetailDcmts, IconDotsVerticalCircleOutline, IconDownload, IconEdit, IconExportTo, IconFileDots, IconHide, IconInfo, IconMenuCAArchive, IconMoveToFolder, IconPair, IconPin, IconPlatform, IconPreview, IconRelation, IconSearch, IconShare, IconSharedDcmt, IconShow, IconSignaturePencil, IconStar, IconSubstFile, IconUndo, IconUnpair, IconUserGroupOutline, isConvertibleToPdfExt, isPdfEditorAvailable, S4T_USER_REGISTRY_MASTER, SDKUI_Globals, SDKUI_Localizator, searchResultToMetadataValues, TMImageLibrary, IconCertificateBadge } from '../helper';
+import { convertSearchResultDescriptorToFileItems, dcmtsFileCachePreview, getDcmtCicoStatus, getMoreInfoTasksForDocument, IconActivity, IconArchiveDetail, IconArchiveDoc, IconArchiveMaster, IconBatchUpdate, IconCheck, IconCheckFile, IconCheckIn, IconCircleInfo, IconCloseCircle, IconConvertFilePdf, IconCopy, IconCustom, IconDelete, IconDetailDcmts, IconDotsVerticalCircleOutline, IconDownload, IconEdit, IconExportTo, IconFileDots, IconHide, IconInfo, IconMenuCAArchive, IconMoveToFolder, IconPair, IconPin, IconPlatform, IconPreview, IconRelation, IconSearch, IconShare, IconSharedDcmt, IconShow, IconSignaturePencil, IconStar, IconSubstFile, IconUndo, IconUnpair, IconUserGroupOutline, isConvertibleToPdfExt, isPdfEditorAvailable, S4T_USER_REGISTRY_MASTER, SDKUI_Globals, SDKUI_Localizator, searchResultToMetadataValues, TMImageLibrary, IconCertificateBadge, IconArchiveMultipleDetailDocuments } from '../helper';
 import { isXMLFileExt } from "../helper/dcmtsHelper";
 import TMCopyToFolderForm from "../components/features/documents/TMCopyToFolderForm";
 import TMMergeToPdfForm from "../components/features/documents/TMMergeToPdfForm";
+import TMMultiMasterDetailDcmtsForm from "../components/features/documents/TMMultiMasterDetailDcmtsForm";
 export const getSelectedDcmtsOrFocused = (selectedItems, focusedItem, fileFormat) => {
     if (selectedItems.length <= 0 && !focusedItem)
         return [];
@@ -170,6 +171,7 @@ export const useDocumentOperations = (props) => {
     // State to control modal opening for master/detail documents
     const [isOpenDetailsModal, setIsOpenDetailsModal] = useState(false);
     const [isOpenMasterModal, setIsOpenMasterModal] = useState(false);
+    const [isOpenMultiDetailModal, setIsOpenMultiDetailModal] = useState(false);
     const openDetailDcmtsFormHandler = (value) => { setIsOpenDetails(value); };
     const openMasterDcmtsFormHandler = (value) => { setIsOpenMaster(value); };
     const openDetailDcmtsModalHandler = (value) => { setIsOpenDetailsModal(value); };
@@ -908,10 +910,18 @@ export const useDocumentOperations = (props) => {
                     id: 'rel-ark-det',
                     icon: _jsx(IconArchiveDetail, {}),
                     name: SDKUI_Localizator.ArchiveDetailDocument,
-                    operationType: 'multiRow',
-                    disabled: canArchiveDetailRelation !== true,
+                    operationType: 'singleRow',
+                    disabled: canArchiveDetailRelation !== true || isDisabledForMultiRow(),
                     onClick: async () => await archiveDetailDocuments(selectedDcmtInfos?.[0]?.TID)
                 },
+                {
+                    id: 'multi-detail',
+                    icon: _jsx(IconArchiveMultipleDetailDocuments, {}),
+                    name: SDKUI_Localizator.ArchiveMultipleDetailDocuments,
+                    operationType: 'singleRow',
+                    disabled: canArchiveDetailRelation !== true || isDisabledForMultiRow(),
+                    onClick: () => setIsOpenMultiDetailModal(true),
+                },
                 {
                     id: 'rel-mst',
                     icon: _jsx(IconDetailDcmts, { transform: 'scale(-1, 1)' }),
@@ -1391,7 +1401,8 @@ export const useDocumentOperations = (props) => {
                             onRefreshBlogDatagrid,
                             onRefreshPreviewDatagrid
                         }, fetchRemoteCertificates: fetchRemoteCertificates, graphometricManager: graphometricManager })) }), (showHistory && dtd && selectedDcmtInfos.length > 0) && _jsx(TMViewHistoryDcmt, { fromDTD: dtd, deviceType: deviceType, inputDcmt: selectedDcmtInfos[0], onClose: hideHistoryCallback, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), (commentFormState.show && selectedDcmtInfos.length > 0) && _jsx(TMBlogCommentForm, { context: { engine: 'SearchEngine', object: { tid: selectedDcmtInfos[0].TID, did: selectedDcmtInfos[0].DID } }, onClose: hideCommentFormCallback, refreshCallback: onRefreshBlog, participants: [], showAttachmentsSection: true, allArchivedDocumentsFileItems: convertSearchResultDescriptorToFileItems(currentSearchResults ?? []), isCommentRequired: commentFormState.isRequired, removeAndEditAttachment: commentFormState.removeAndEditAttachment, selectedAttachmentDid: [Number(selectedDcmtInfos[0].DID)] }), (showCheckoutInformationForm && dtd && selectedDcmtInfos.length > 0) &&
-                _jsx(TMDcmtCheckoutInfoForm, { dtdName: dtd.name ?? SDKUI_Localizator.SearchResult, selectedDcmtOrFocused: selectedDcmtInfos[0], onClose: hideCheckoutInformationFormCallback }), isOpenDetailsModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenDetailsModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetailsModal(false) }) }), _jsx(StyledMultiViewPanel, { "$isVisible": isOpenDetails, children: isOpenDetails && _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetails(false) }) }), isOpenMasterModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenMasterModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMasterModal(false) }) }), _jsxs(StyledMultiViewPanel, { "$isVisible": isOpenMaster, children: [isOpenMaster && _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMaster(false) }), secondaryMasterDcmts.length > 0 && secondaryMasterDcmts.map((dcmt, index) => {
+                _jsx(TMDcmtCheckoutInfoForm, { dtdName: dtd.name ?? SDKUI_Localizator.SearchResult, selectedDcmtOrFocused: selectedDcmtInfos[0], onClose: hideCheckoutInformationFormCallback }), isOpenDetailsModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenDetailsModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetailsModal(false) }) }), _jsx(StyledMultiViewPanel, { "$isVisible": isOpenDetails, children: isOpenDetails && _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetails(false) }) }), (isOpenMultiDetailModal && dtd) &&
+                _jsx(TMMultiMasterDetailDcmtsForm, { dtd: dtd, masterDcmt: selectedDcmtInfos[0], onClose: () => setIsOpenMultiDetailModal(false), allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, showDcmtFormSidebar: showDcmtFormSidebar, showTodoDcmtForm: showTodoDcmtForm, openFileUploaderPdfEditor: openFileUploaderPdfEditor, graphometricManager: graphometricManager, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, fetchRemoteCertificates: fetchRemoteCertificates, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick, onTaskCreateRequest: onTaskCreateRequest, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, onFileOpened: onFileOpened, passToArchiveCallback: passToArchiveCallback, openWGsCopyMoveForm: openWGsCopyMoveForm }), isOpenMasterModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenMasterModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMasterModal(false) }) }), _jsxs(StyledMultiViewPanel, { "$isVisible": isOpenMaster, children: [isOpenMaster && _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMaster(false) }), secondaryMasterDcmts.length > 0 && secondaryMasterDcmts.map((dcmt, index) => {
                         return (_jsx(StyledModalContainer, { style: { backgroundColor: 'white' }, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, inputDcmts: [dcmt], allowNavigation: false, onBack: () => handleRemoveItem(dcmt.TID, dcmt.DID) }) }, `${index}-${dcmt.DID}`));
                     })] }), isOpenArchiveRelationForm && _jsx(TMDcmtForm, { isModal: true, titleModal: SDKUI_Localizator.Archive + ' - ' + (archiveType === 'detail' ? SDKUI_Localizator.DcmtsDetail : SDKUI_Localizator.DcmtsMaster), TID: archiveRelatedDcmtFormTID, layoutMode: LayoutModes.Ark, inputMids: archiveRelatedDcmtFormMids, showBackButton: false, allowButtonsRefs: false, onClose: () => {
                     setIsOpenArchiveRelationForm(false);
@@ -1456,6 +1467,7 @@ export const useDocumentOperations = (props) => {
                 } }))] }));
     return {
         operationItems: operationItems(),
+        selectedDcmtInfos,
         renderFloatingBar,
         renderDcmtOperations,
         features: {