@topconsultnpm/sdkui-react 6.22.0-dev3.2 → 6.22.0-dev3.20

package/lib/helper/TMPdfViewer.d.ts

@@ -1,8 +1,9 @@
+import React from "react";
 interface TMPdfViewerProps {
     pdfBlob: Blob;
     title?: string;
     isResizingActive?: boolean;
     enableFitToWidth?: boolean;
 }
-declare const TMPdfViewer: (props: TMPdfViewerProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMPdfViewer: (props: TMPdfViewerProps) => React.JSX.Element;
 export default TMPdfViewer;

package/lib/helper/TMToppyMessage.d.ts

@@ -1,8 +1,8 @@
-import { ReactNode } from 'react';
+import React, { ReactNode } from 'react';
 interface TMToppyMessageProps {
     message: ReactNode;
     titleTooltip?: string;
     maxWidth?: string;
 }
-declare const TMToppyMessage: (props: TMToppyMessageProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMToppyMessage: (props: TMToppyMessageProps) => React.JSX.Element;
 export default TMToppyMessage;

package/lib/helper/TMUtils.d.ts

@@ -24,7 +24,7 @@ export declare const getFullFileExtension: (fileName: string, depth?: number) =>
  * Es: pdf.p7m.tsd → pdf, pdf.p7m → pdf, pdf → pdf
  */
 export declare const getBaseExtension: (ext: string) => string;
-export declare const getFileIcon: (fileExtension: string | undefined, fileCount: number | undefined, tooltipContent?: JSX.Element | string) => import("react/jsx-runtime").JSX.Element;
+export declare const getFileIcon: (fileExtension: string | undefined, fileCount: number | undefined, tooltipContent?: JSX.Element | string) => React.JSX.Element;
 export declare function formatBytes(bytes: number | undefined, decimalPlaces?: number): string;
 export interface RowData {
     [key: string]: string | number | null;
@@ -52,9 +52,15 @@ interface TabItemProps {
     $isSelected: boolean;
     $activeGradient?: string;
 }
-export declare const StyledTabItem: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, TabItemProps>> & string;
-export declare const StyledTabIcon: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, TabItemProps>> & string;
-export declare const TMCountBadge: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const StyledTabItem: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Merged<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "style"> & {
+    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
+}, TabItemProps>> & string;
+export declare const StyledTabIcon: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Merged<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "style"> & {
+    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
+}, TabItemProps>> & string;
+export declare const TMCountBadge: import("styled-components/dist/types").IStyledComponentBase<"web", Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "style"> & {
+    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
+}> & string;
 export declare const PDGS_COLORS: {
     DOSSIER: string;
     DOCUMENT: string;

package/lib/helper/helpers.d.ts

@@ -77,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-runtime").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/hooks/useDcmtOperations.js

@@ -9,6 +9,8 @@ import { importCertificatesAsync } from '../helper/certificateImportHelper';
 import { isXMLFileExt } from '../helper/dcmtsHelper';
 import { ShowConfirm } from '../components/base/TMConfirm';
 import { generateTargetFileName } from '../components/features/documents/copyAndMergeDcmtsShared';
+/** Intervallo minimo (ms) fra due aggiornamenti della progress bar di download. */
+const DOWNLOAD_PROGRESS_THROTTLE_MS = 100;
 const isScannerLicenseConfigured = () => {
     try {
         const scannerLicense = SDKUI_Globals.userSettings.advancedSettings.scannerLicense;
@@ -286,6 +288,8 @@ export const useDcmtOperations = () => {
         setShowSecondary(true);
         setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
+        // Riferimento const: il narrowing su inputDcmts non sopravvive dentro le closure.
+        const dcmts = inputDcmts;
         const rfo = new RetrieveFileOptions();
         rfo.retrieveReason = retrieveOptions?.retrieveReason ?? DcmtOpers.ShowFile;
         if (retrieveOptions?.cvtFormat !== undefined)
@@ -294,77 +298,111 @@ export const useDcmtOperations = () => {
             rfo.generalRetrieveFormat = retrieveOptions.generalRetrieveFormat;
         rfo.invoiceRetrieveFormat = retrieveOptions?.invoiceRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
         rfo.orderRetrieveFormat = retrieveOptions?.orderRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
-        let result = [];
-        setWaitPanelMaxValuePrimary(inputDcmts.length);
-        let firstBlock = true;
-        let maxFileSize = 0;
-        for (let i = 0; i < inputDcmts.length; i++) {
-            if (abortController.signal.aborted) {
-                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${i + 1} documenti` });
-                break;
+        const results = [];
+        setWaitPanelMaxValuePrimary(dcmts.length);
+        // ---- Progress secondaria: throttlata ----
+        // Gli eventi di avanzamento di axios arrivano a ogni chunk: senza throttle ognuno
+        // provoca un re-render dell'intera form (relation viewer compreso).
+        let currentBytes;
+        let pendingSecondary;
+        let secondaryTimer;
+        const flushSecondaryProgress = () => {
+            secondaryTimer = undefined;
+            if (!pendingSecondary)
+                return;
+            setWaitPanelMaxValueSecondary(pendingSecondary.max);
+            setWaitPanelValueSecondary(pendingSecondary.value);
+            setWaitPanelTextSecondary(pendingSecondary.text);
+            pendingSecondary = undefined;
+        };
+        const publishSecondaryProgress = () => {
+            const loaded = currentBytes?.loaded ?? 0;
+            const total = currentBytes?.total ?? 0;
+            pendingSecondary = total > 0
+                ? { value: loaded, max: total, text: `Downloading... ${Globalization.getNumberDisplayValue(loaded, true)} / ${Globalization.getNumberDisplayValue(total, true)}` }
+                : { value: 0, max: 0, text: '' };
+            if (secondaryTimer === undefined)
+                secondaryTimer = setTimeout(flushSecondaryProgress, DOWNLOAD_PROGRESS_THROTTLE_MS);
+        };
+        // ---- Download sequenziale: un documento per volta ----
+        let completed = 0;
+        const downloadOne = async (i) => {
+            setWaitPanelTextPrimary(`Download file ${i + 1} di ${dcmts.length}`);
+            let file;
+            const cacheKey = `${dcmts[i].TID}-${dcmts[i].DID}`;
+            if (useCache && dcmtsFileCacheDownload.has(cacheKey)) {
+                file = dcmtsFileCacheDownload.get(cacheKey);
             }
-            try {
-                setWaitPanelTextPrimary(`Download file ${i + 1} di ${inputDcmts.length}`);
-                let file;
-                const cacheKey = `${inputDcmts[i].TID}-${inputDcmts[i].DID}`;
-                if (useCache && dcmtsFileCacheDownload.has(cacheKey)) {
-                    file = dcmtsFileCacheDownload.get(cacheKey);
+            else {
+                currentBytes = { loaded: 0, total: 0 };
+                try {
+                    file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(dcmts[i].TID, dcmts[i].DID, rfo, abortController.signal, (pd) => {
+                        currentBytes = { loaded: pd.ProgressBarValue, total: pd.ProgressBarMaximum ?? 0 };
+                        publishSecondaryProgress();
+                    });
+                }
+                finally {
+                    currentBytes = undefined;
+                    publishSecondaryProgress();
+                }
+            }
+            completed++;
+            setWaitPanelValuePrimary(completed);
+            if (downloadMode === "openInNewWindow") {
+                if (onFileDownloaded && file) {
+                    onFileDownloaded(file, dcmts[i]);
                 }
                 else {
-                    file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmts[i].TID, inputDcmts[i].DID, rfo, abortController.signal, (pd) => {
-                        if (firstBlock) {
-                            maxFileSize = pd.ProgressBarMaximum ?? 0;
-                            setWaitPanelMaxValueSecondary(maxFileSize);
-                            firstBlock = false;
-                        }
-                        setWaitPanelValueSecondary(pd.ProgressBarValue);
-                        setWaitPanelTextSecondary(`Downloading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                        if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                            setWaitPanelMaxValueSecondary(0);
-                            setWaitPanelValueSecondary(0);
-                            setWaitPanelTextSecondary('');
-                            firstBlock = true;
-                        }
-                    });
+                    window.open(window.URL.createObjectURL(file), '_blank', 'noopener');
                 }
-                setWaitPanelValuePrimary(i + 1);
-                const fileURL = window.URL.createObjectURL(file);
-                if (downloadMode === "openInNewWindow") {
-                    (onFileDownloaded && file)
-                        ? onFileDownloaded(file, inputDcmts[i])
-                        : window.open(fileURL, '_blank', 'noopener');
+            }
+            else {
+                if (onFileDownloaded && file) {
+                    await onFileDownloaded(file, dcmts[i]);
                 }
                 else {
-                    if (onFileDownloaded && file) {
-                        await onFileDownloaded(file, inputDcmts[i]);
-                    }
-                    else {
-                        const alink2 = document.createElement('a');
-                        alink2.href = fileURL;
-                        // Usa useInputFileName per determinare la priorità del nome file
-                        alink2.download = getDownloadFileName(file, inputDcmts[i], useInputFileName);
-                        alink2.target = "_blank";
-                        alink2.rel = "noreferrer";
-                        alink2.click();
-                    }
+                    // L'object URL serve solo in questo ramo: creato qui e revocato dopo il
+                    // click, così i blob non restano agganciati al documento per sempre.
+                    const fileURL = window.URL.createObjectURL(file);
+                    const alink2 = document.createElement('a');
+                    alink2.href = fileURL;
+                    // Usa useInputFileName per determinare la priorità del nome file
+                    alink2.download = getDownloadFileName(file, dcmts[i], useInputFileName);
+                    alink2.target = "_blank";
+                    alink2.rel = "noreferrer";
+                    alink2.click();
+                    // 60s come per l'iframe di stampa: revocare troppo presto può far fallire
+                    // il download se il browser non ha ancora risolto il blob URL.
+                    setTimeout(() => window.URL.revokeObjectURL(fileURL), 60000);
                 }
-                if (useCache) {
-                    if (dcmtsFileCacheDownload.size >= CACHE_SIZE_LIMIT) {
-                        const oldestKey = dcmtsFileCacheDownload.keys().next().value;
-                        dcmtsFileCacheDownload.delete(oldestKey);
-                    }
-                    dcmtsFileCacheDownload.set(cacheKey, file);
+            }
+            if (useCache) {
+                if (dcmtsFileCacheDownload.size >= CACHE_SIZE_LIMIT) {
+                    const oldestKey = dcmtsFileCacheDownload.keys().next().value;
+                    dcmtsFileCacheDownload.delete(oldestKey);
                 }
-                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.SUCCESS });
+                dcmtsFileCacheDownload.set(cacheKey, file);
+            }
+            results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.SUCCESS });
+        };
+        for (let i = 0; i < dcmts.length; i++) {
+            if (abortController.signal.aborted) {
+                results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${completed} documenti` });
+                break;
+            }
+            try {
+                await downloadOne(i);
             }
             catch (ex) {
-                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(ex) });
+                results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(ex) });
                 const err = ex;
                 if (err.name === 'CanceledError') {
                     ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
                 }
             }
         }
+        if (secondaryTimer !== undefined)
+            clearTimeout(secondaryTimer);
         setWaitPanelTextPrimary('');
         setWaitPanelMaxValuePrimary(0);
         setWaitPanelValuePrimary(0);
@@ -372,7 +410,7 @@ export const useDcmtOperations = () => {
         setWaitPanelMaxValueSecondary(0);
         setWaitPanelValueSecondary(0);
         setShowWaitPanel(false);
-        TMResultManager.show(result, operationTitle, "TID", "DID", undefined, undefined, showSuccessAlert);
+        TMResultManager.show(results, operationTitle, "TID", "DID", undefined, undefined, showSuccessAlert);
     };
     const _downloadAttachmentsAsync = async (inputDcmts, confirmAttachments, showSuccessAlert = true) => {
         if (inputDcmts === undefined)

package/lib/hooks/useDocumentOperations.d.ts

@@ -63,6 +63,7 @@ export interface UIConfigProps {
     toppyHelpCenterUsePortal?: boolean;
     inputDcmtFormLayoutMode?: LayoutModes;
     graphometricManager?: IGraphometricManagerProp;
+    showSelector?: boolean;
 }
 export interface TasksProps {
     allTasks?: Array<TaskDescriptor>;

package/lib/hooks/useDocumentOperations.js

@@ -86,7 +86,7 @@ export const useDocumentOperations = (props) => {
     const { dataColumns, dataSource, selectedRowKeys, } = exportData ?? {};
     const { visibleItems = [], onRefreshSearchAsyncDatagrid, onRefreshDataRowsAsync, refreshFocusedDataRowAsync, onRefreshBlogDatagrid, onRefreshPreviewDatagrid, refreshOperationsTrigger = 0, onRefreshOperationsDatagrid, } = datagridUtility ?? {};
     const { approvalVID, dcmtDataRowForCicoStatus, selectedDcmtSearchResultRelations, dcmtTIDHasDetailRelations = false, dcmtTIDHasMasterRelations = false, updateCurrentDcmt, onCloseDcmtForm, onRefreshBlogForm, onRefreshPreviewForm, taskFormDialogComponent, s4TViewerDialogComponent } = dcmtUtility ?? {};
-    const { floatingBarContainerRef, customButtonsLayout, workingGroupContext, openS4TViewer = false, openDcmtFormAsModal = false, showDcmtFormSidebar = true, allowFloatingBar = true, enablePinIcons = true, allowRelations = true, showTodoDcmtForm = false, showToppyDraggableHelpCenter = true, toppyHelpCenterUsePortal = false, editPdfForm = false, inputDcmtFormLayoutMode = LayoutModes.Update, graphometricManager, } = uiConfig;
+    const { floatingBarContainerRef, customButtonsLayout, workingGroupContext, openS4TViewer = false, openDcmtFormAsModal = false, showDcmtFormSidebar = true, allowFloatingBar = true, enablePinIcons = true, allowRelations = true, showTodoDcmtForm = false, showToppyDraggableHelpCenter = true, toppyHelpCenterUsePortal = false, editPdfForm = false, inputDcmtFormLayoutMode = LayoutModes.Update, graphometricManager, showSelector = false, } = uiConfig;
     const { allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback } = tasks;
     const { 
     // Refresh operations (data consistency)
@@ -1073,7 +1073,7 @@ export const useDocumentOperations = (props) => {
             ]
         };
     };
-    const canToggleDcmtTypesSelection = !isMobile && context === SearchResultContext.WORKFLOW_APPROVE;
+    const canToggleDcmtTypesSelection = !isMobile && showSelector && currentSearchResults?.length === 1;
     const otherOperationsMenuItem = () => {
         return {
             id: 'oth',

package/lib/hooks/useInputDialog.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 import { FileDescriptor, FileFormats } from '@topconsultnpm/sdk-ts';
 export declare const useInputCvtFormatDialog: () => [() => Promise<FileFormats>, () => JSX.Element];
 export declare const useFileDialog: () => {
@@ -5,7 +6,7 @@ export declare const useFileDialog: () => {
 };
 export declare const useInputAttachmentsDialog: () => {
     openConfirmAttachmentsDialog: (list: FileDescriptor[]) => Promise<string[] | undefined>;
-    ConfirmAttachmentsDialog: () => import("react/jsx-runtime").JSX.Element | null;
+    ConfirmAttachmentsDialog: () => React.JSX.Element | null;
 };
 export type FileSourceType = 'filesystem' | 'scanner-new' | 'scanner-edit' | undefined;
 export declare const useFileSourceDialog: () => [(hasExistingFile?: boolean) => Promise<FileSourceType>, () => JSX.Element];

package/lib/hooks/usePreventFileDrop.js

@@ -2,7 +2,12 @@ import { useEffect } from "react";
 const usePreventFileDrop = (allowedDropZones) => {
     useEffect(() => {
         const isOverAllowedZone = (event) => allowedDropZones.some((ref) => ref.current?.contains(event.target));
+        // Il blocco vale solo per i file trascinati da fuori: i drag interni all'applicazione
+        // (riordino di metadati, colonne, tab, ...) devono restare liberi di completarsi
+        const isFileDrag = (event) => event.dataTransfer?.types?.includes("Files") === true;
         const handleDragOver = (event) => {
+            if (!isFileDrag(event))
+                return;
             if (isOverAllowedZone(event)) {
                 // Riafferma "copy" ad ogni dragover: altrimenti un "none"
                 // impostato mentre si era fuori zona resta e mostra "not-allowed"
@@ -17,6 +22,8 @@ const usePreventFileDrop = (allowedDropZones) => {
             }
         };
         const handleDragEnter = (event) => {
+            if (!isFileDrag(event))
+                return;
             if (isOverAllowedZone(event)) {
                 document.body.style.cursor = "default";
             }
@@ -28,6 +35,8 @@ const usePreventFileDrop = (allowedDropZones) => {
             document.body.style.cursor = "default";
         };
         const handleDrop = (event) => {
+            if (!isFileDrag(event))
+                return;
             if (!isOverAllowedZone(event)) {
                 event.preventDefault();
                 document.body.style.cursor = "default";

package/lib/services/caseflow/CaseFlowService.d.ts

@@ -144,6 +144,17 @@ export declare class CaseFlowService {
      * cftid quando non passato (come per bacheca e partecipanti).
      */
     private static dcmtAddOrRemove;
+    /**
+     * Allega un file alla pratica tramite AttachAddAsync(cftid, id, ...).
+     * @returns il DID dell'allegato appena archiviato.
+     */
+    static addAttachment(caseFlowId: number, file: File, name?: string, description?: string, cftid?: number): Promise<number | undefined>;
+    /**
+     * Toglie l'allegato dalla pratica tramite AttachRemoveAsync(cftid, id, attachDID).
+     * A differenza dello sgancio di un documento d'archivio, qui il file viene
+     * anche cancellato: un allegato fuori dalla sua pratica non ha più senso.
+     */
+    static removeAttachment(caseFlowId: number, attachDID: number, cftid?: number): Promise<void>;
     /**
      * Aggiunge un partecipante all'istanza (o ne aggiorna ruolo/permessi se già
      * presente) tramite ParticipantsAddOrRemoveAsync(remove=false).
@@ -202,7 +213,27 @@ export declare class CaseFlowService {
     static completeDataCompletionWorkItem(caseFlowId: number, workItemId: number, metadataValues: Record<number, string>, response?: string, cftid?: number): Promise<void>;
     /** Rifiuta un workitem. Il motivo viene pubblicato in bacheca dal backend. */
     static rejectWorkItem(caseFlowId: number, workItemId: number, response?: string, cftid?: number): Promise<void>;
-    /** Assegna un'azione a un utente creando il relativo workitem (operazione Assign). */
+    /**
+     * Prende in carico un'azione per se stessi (operazione Claim): il backend
+     * crea il workitem intestato al chiamante e porta l'azione in lavorazione.
+     *
+     * Non e' un caso particolare di `createWorkItemForAction`: assegnare e'
+     * riservato a Owner e Supervisore, prendere in carico e' di chiunque lavori
+     * alla pratica. Passando dall'operazione Assign, un Partecipante si vedeva
+     * rifiutare la presa in carico (TMC-2789).
+     */
+    static claimAction(caseFlowId: number, actionID: number, cftid?: number): Promise<void>;
+    /**
+     * Rilascia un workitem preso in carico (operazione ReleaseClaim): il backend
+     * lo cancella e, se per quell'azione non restano altri destinatari, la riporta
+     * disponibile per la presa in carico.
+     *
+     * Stessa chiamata per due gesti diversi, e' la guardia della SP a distinguerli:
+     * il detentore rilascia il proprio workitem, un Owner/Supervisore annulla
+     * l'assegnazione di un altro. Chi chiama non deve dire quale dei due sta facendo.
+     */
+    static releaseClaim(caseFlowId: number, workItemId: number, cftid?: number): Promise<void>;
+    /** Assegna un'azione a un ALTRO utente creando il relativo workitem (operazione Assign). */
     static createWorkItemForAction(caseFlowId: number, actionID: number, toUserID: number, description?: string, cftid?: number): Promise<void>;
     /** Forza il completamento di un'azione (supervisor). */
     static forceCompleteAction(caseFlowId: number, actionID: number, reason?: string, cftid?: number): Promise<void>;

package/lib/services/caseflow/CaseFlowService.js

@@ -353,6 +353,33 @@ export class CaseFlowService {
             throw new Error(`Impossibile risolvere il template (cftid) per l'istanza id=${caseFlowId}.`);
         await engine.DcmtAddOrRemoveAsync(resolvedCftid, caseFlowId, tid, did, remove);
     }
+    /**
+     * Allega un file alla pratica tramite AttachAddAsync(cftid, id, ...).
+     * @returns il DID dell'allegato appena archiviato.
+     */
+    static async addAttachment(caseFlowId, file, name, description, cftid) {
+        const engine = SDK_Globals.tmSession?.NewCaseFlowInstanceEngine();
+        if (!engine)
+            throw new Error('Motore delle istanze CaseFlow non disponibile.');
+        const resolvedCftid = cftid ?? (await this.getCaseflow(caseFlowId))?.cftid;
+        if (resolvedCftid == null)
+            throw new Error(`Impossibile risolvere il template (cftid) per l'istanza id=${caseFlowId}.`);
+        return await engine.AttachAddAsync(resolvedCftid, caseFlowId, name, description, file);
+    }
+    /**
+     * Toglie l'allegato dalla pratica tramite AttachRemoveAsync(cftid, id, attachDID).
+     * A differenza dello sgancio di un documento d'archivio, qui il file viene
+     * anche cancellato: un allegato fuori dalla sua pratica non ha più senso.
+     */
+    static async removeAttachment(caseFlowId, attachDID, cftid) {
+        const engine = SDK_Globals.tmSession?.NewCaseFlowInstanceEngine();
+        if (!engine)
+            throw new Error('Motore delle istanze CaseFlow non disponibile.');
+        const resolvedCftid = cftid ?? (await this.getCaseflow(caseFlowId))?.cftid;
+        if (resolvedCftid == null)
+            throw new Error(`Impossibile risolvere il template (cftid) per l'istanza id=${caseFlowId}.`);
+        await engine.AttachRemoveAsync(resolvedCftid, caseFlowId, attachDID);
+    }
     // ----- Partecipanti ------------------------------------------------------
     //
     // Per scelta del backend l'engine espone UNA sola API,
@@ -524,7 +551,37 @@ export class CaseFlowService {
             comment: response,
         }), cftid);
     }
-    /** Assegna un'azione a un utente creando il relativo workitem (operazione Assign). */
+    /**
+     * Prende in carico un'azione per se stessi (operazione Claim): il backend
+     * crea il workitem intestato al chiamante e porta l'azione in lavorazione.
+     *
+     * Non e' un caso particolare di `createWorkItemForAction`: assegnare e'
+     * riservato a Owner e Supervisore, prendere in carico e' di chiunque lavori
+     * alla pratica. Passando dall'operazione Assign, un Partecipante si vedeva
+     * rifiutare la presa in carico (TMC-2789).
+     */
+    static async claimAction(caseFlowId, actionID, cftid) {
+        await this.executeWorkItemOperation(caseFlowId, CaseFlowWIOperationDescriptor.fromJS({
+            operation: CF_WIOperations.Claim,
+            actionID,
+        }), cftid);
+    }
+    /**
+     * Rilascia un workitem preso in carico (operazione ReleaseClaim): il backend
+     * lo cancella e, se per quell'azione non restano altri destinatari, la riporta
+     * disponibile per la presa in carico.
+     *
+     * Stessa chiamata per due gesti diversi, e' la guardia della SP a distinguerli:
+     * il detentore rilascia il proprio workitem, un Owner/Supervisore annulla
+     * l'assegnazione di un altro. Chi chiama non deve dire quale dei due sta facendo.
+     */
+    static async releaseClaim(caseFlowId, workItemId, cftid) {
+        await this.executeWorkItemOperation(caseFlowId, CaseFlowWIOperationDescriptor.fromJS({
+            operation: CF_WIOperations.ReleaseClaim,
+            wiid: workItemId,
+        }), cftid);
+    }
+    /** Assegna un'azione a un ALTRO utente creando il relativo workitem (operazione Assign). */
     static async createWorkItemForAction(caseFlowId, actionID, toUserID, description, cftid) {
         await this.executeWorkItemOperation(caseFlowId, CaseFlowWIOperationDescriptor.fromJS({
             operation: CF_WIOperations.Assign,

package/lib/services/platform_services.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 import { JobTypes, ObjectClasses, ProcessDescriptor, DcmtTypeDescriptor } from "@topconsultnpm/sdk-ts";
 export declare class PlatformObjectService {
     static readonly retrieveAllAsync: (objClass: ObjectClasses, refreshCache?: boolean) => Promise<import("@topconsultnpm/sdk-ts").AreaDescriptor[] | import("@topconsultnpm/sdk-ts").NotificationDescriptor[] | import("@topconsultnpm/sdk-ts").RelationDescriptor[] | import("@topconsultnpm/sdk-ts").TaskDescriptor[] | import("@topconsultnpm/sdk-ts").WorkingGroupDescriptor[] | undefined>;
@@ -13,6 +14,6 @@ export declare class PlatformObjectService {
     static readonly createAsync: (objClass: ObjectClasses, jobType: JobTypes, d: any) => Promise<number | undefined>;
     static readonly deleteAsync: (objClass: ObjectClasses, id: number) => Promise<number | undefined>;
     static readonly getName: (objClass: ObjectClasses, jobType?: JobTypes, isPlural?: boolean) => string;
-    static readonly getIcon: (objClass: ObjectClasses, d: any) => import("react/jsx-runtime").JSX.Element;
-    static readonly getTooltip: (objClass: ObjectClasses, d: any) => import("react/jsx-runtime").JSX.Element | null;
+    static readonly getIcon: (objClass: ObjectClasses, d: any) => React.JSX.Element;
+    static readonly getTooltip: (objClass: ObjectClasses, d: any) => React.JSX.Element | null;
 }

package/package.json

@@ -1,21 +1,21 @@
 {
     "name": "@topconsultnpm/sdkui-react",
-    "version": "6.22.0-dev3.2",
+    "version": "6.22.0-dev3.20",
     "description": "",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1",
         "clean": "node -e \"const fs=require('fs');fs.rmSync('lib',{recursive:true,force:true});fs.mkdirSync('lib')\"",
         "copy-files": "cpx \"src/{assets/*.*,assets/ImageLibrary/*.*,assets/thumbnails/*.*,assets/IconsS4t/*.*,assets/Metadata/*.*,css/tm-sdkui.css}\" lib",
-        "tm-license":  "devextreme-license --out src/devextreme-license.ts --force && node scripts/check-license.js",
-        "pretm-build":  "npm run tm-license",
-        "tm-build":  "npm run clean && tsc && npm run copy-files",
-        "tm-watch":  "tsc -w",
-        "tm-publish":  "npm publish --tag latest",
-        "tm-publish_wl":  "npm publish",
-        "prestorybook":  "npm run tm-license",
-        "storybook":  "storybook dev -p 6006",
-        "prebuild-storybook":  "npm run tm-license",
-        "build-storybook":  "storybook build"
+        "tm-license": "devextreme-license --out src/devextreme-license.ts --force && node scripts/check-license.js",
+        "pretm-build": "npm run tm-license",
+        "tm-build": "npm run clean && tsc && npm run copy-files",
+        "tm-watch": "tsc -w",
+        "tm-publish": "npm publish --tag latest",
+        "tm-publish_wl": "npm publish",
+        "prestorybook": "npm run tm-license",
+        "storybook": "storybook dev -p 6006",
+        "prebuild-storybook": "npm run tm-license",
+        "build-storybook": "storybook build"
     },
     "author": "TopConsult",
     "license": "ISC",
@@ -42,17 +42,17 @@
         "lib"
     ],
     "dependencies": {
-        "react-pdf":  "^10.4.1",
-        "@zip.js/zip.js":  "2.8.26",
-        "pdf-lib":  "^1.17.1",
-        "devextreme-exceljs-fork":  "^4.4.13",
-        "buffer":  "^6.0.3",
-        "@topconsultnpm/sdk-ts":  "6.22.0-t2",
-        "react-window":  "^2.2.7",
-        "devextreme":  "^26.1.4",
-        "htmlparser2":  "^10.0.0",
-        "styled-components":  "^6.1.1",
-        "devextreme-react":  "^26.1.4"
+        "@topconsultnpm/sdk-ts": "6.22.0-dev3.4",
+        "@zip.js/zip.js": "2.8.26",
+        "buffer": "^6.0.3",
+        "devextreme": "^26.1.4",
+        "devextreme-exceljs-fork": "^4.4.13",
+        "devextreme-react": "^26.1.4",
+        "htmlparser2": "^10.0.0",
+        "pdf-lib": "^1.17.1",
+        "react-pdf": "^10.4.1",
+        "react-window": "^2.2.7",
+        "styled-components": "^6.1.1"
     },
     "overrides": {
         "esbuild": "^0.25.0",