@topconsultnpm/sdkui-react 6.22.0-dev3.8 → 6.22.0-dev4.10

package/lib/services/caseflow/CaseFlowService.js

@@ -1,6 +1,24 @@
-import { SDK_Globals, BlogPost, CaseFlowDcmt, CaseFlowInstanceDescriptor, CaseFlowParticipant, CaseFlowWIOperationDescriptor, MetadataValueDescriptor, CF_ParticipantRoles, CF_States, CF_WIOperations, CF_WorkItemCategories, CF_WorkItemStates, UserListCacheService, DcmtTypeListCacheService, } from '@topconsultnpm/sdk-ts';
+import { SDK_Globals, BlogPost, CaseFlowDcmt, CaseFlowInstanceDescriptor, CaseFlowInstanceSearchDescriptor, CaseFlowParticipant, CaseFlowWIOperationDescriptor, MetadataValueDescriptor, CF_ParticipantRoles, CF_States, CF_WIOperations, CF_WorkItemCategories, CF_WorkItemStates, UserListCacheService, DcmtTypeListCacheService, } from '@topconsultnpm/sdk-ts';
 import { CaseFlowTemplateCacheService } from './CaseFlowTemplateCacheService';
-import { getTemplateNameSync, primeTemplateName, primeTemplateNames, primeActionNames } from './caseFlowNameCache';
+import { primeTemplateName, primeTemplateNames, primeActionNames } from './caseFlowNameCache';
+/** Numero massimo di pratiche restituite da una ricerca, se non indicato. */
+export const CASEFLOW_SEARCH_DEFAULT_MAX_RESULTS = 500;
+/**
+ * Tetto di `maxResults`. Il server non restituisce mai più di 5000 pratiche e
+ * se ne chiede una in più per sapere se il risultato è troncato: oltre 4999
+ * il troncamento non sarebbe più riconoscibile.
+ */
+export const CASEFLOW_SEARCH_MAX_RESULTS = 4999;
+/**
+ * Giorno `YYYY-MM-DD` come mezzanotte UTC. Il client lo invia con
+ * `toISOString()` e il server ne usa solo la data: una mezzanotte locale
+ * (`new Date(2026, 8, 30)` in Italia = `2026-09-29T22:00Z`) finirebbe sul
+ * giorno precedente.
+ */
+function toUtcDay(day) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(day ?? '');
+    return m ? new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3]))) : undefined;
+}
 export class CaseFlowService {
     // ----- Template / tipi documento (invariati: cache condivise) ------------
     /** Elenco dei template reali (via CaseFlowTemplateCacheService). */
@@ -105,50 +123,59 @@ export class CaseFlowService {
         const all = await this.loadAllInstances();
         return all.filter(cf => cf.ownerID === userId);
     }
-    /** Ricerca avanzata sulle istanze applicando i filtri indicati. */
+    /**
+     * Ricerca avanzata sulle istanze, eseguita dal server (`usp_Cfi_Search`):
+     * restituisce solo le pratiche visibili all'utente che soddisfano i
+     * criteri, già con la copertina. Tutti i confronti di testo sono
+     * "contiene", senza distinzione fra maiuscole e minuscole.
+     *
+     * Per riconoscere un risultato troncato si chiede al server una pratica
+     * in più di `maxResults`: se arriva, la si scarta e `truncated` vale true.
+     */
     static async searchCaseflows(criteria) {
-        const all = await this.loadAllInstances();
-        const lowerIncludes = (haystack, needle) => (haystack ?? '').toLowerCase().includes(needle.toLowerCase());
-        return all.filter(cf => {
-            if (criteria.templateId != null && cf.cftid !== criteria.templateId)
-                return false;
-            if (criteria.name && !lowerIncludes(cf.name, criteria.name))
-                return false;
-            if (criteria.description && !lowerIncludes(cf.description, criteria.description))
-                return false;
-            if (criteria.state && cf.state !== criteria.state)
-                return false;
-            if (criteria.dateFrom) {
-                const from = new Date(criteria.dateFrom);
-                if (cf.creationTime && cf.creationTime < from)
-                    return false;
-            }
-            if (criteria.dateTo) {
-                const to = new Date(criteria.dateTo);
-                if (cf.creationTime && cf.creationTime > to)
-                    return false;
-            }
-            if (criteria.metadataFilters && criteria.metadataFilters.length > 0) {
-                for (const mf of criteria.metadataFilters) {
-                    if (!mf.value.trim())
-                        continue;
-                    const cfMeta = (cf.cover ?? []).find(m => m.mid === mf.mid);
-                    if (!cfMeta || !lowerIncludes(cfMeta.value, mf.value))
-                        return false;
-                }
-            }
-            if (criteria.freeTextMetadata && criteria.freeTextMetadata.trim()) {
-                const needle = criteria.freeTextMetadata.trim();
-                const matchesCommon = lowerIncludes(cf.name, needle)
-                    || lowerIncludes(cf.description, needle)
-                    || lowerIncludes(cf.ownerName, needle)
-                    || lowerIncludes(getTemplateNameSync(cf.cftid), needle);
-                const matchesMeta = (cf.cover ?? []).some(m => lowerIncludes(m.value, needle) || lowerIncludes(m.metadataName, needle));
-                if (!matchesCommon && !matchesMeta)
-                    return false;
+        const engine = SDK_Globals.tmSession?.NewCaseFlowInstanceEngine();
+        if (!engine)
+            return { items: [], truncated: false };
+        const max = Math.min(Math.max(Math.trunc(criteria.maxResults ?? CASEFLOW_SEARCH_DEFAULT_MAX_RESULTS), 1), CASEFLOW_SEARCH_MAX_RESULTS);
+        const text = (s) => s?.trim() || undefined;
+        const filter = new CaseFlowInstanceSearchDescriptor();
+        filter.cftid = criteria.templateId ?? 0;
+        filter.name = text(criteria.name);
+        filter.description = text(criteria.description);
+        filter.state = criteria.state;
+        filter.dateFrom = toUtcDay(criteria.dateFrom);
+        filter.dateTo = toUtcDay(criteria.dateTo);
+        filter.freeText = text(criteria.freeTextMetadata);
+        const metadataFilters = (criteria.metadataFilters ?? [])
+            .filter(mf => mf.value.trim())
+            .map(mf => MetadataValueDescriptor.fromJS({ mid: mf.mid, value: mf.value.trim() }));
+        filter.metadataFilters = metadataFilters.length > 0 ? metadataFilters : undefined;
+        filter.top = max + 1;
+        const list = (await engine.SearchAsync(filter)) ?? [];
+        const truncated = list.length > max;
+        const items = truncated ? list.slice(0, max) : list;
+        // Il server restituisce la copertina con i soli MID e valori: i nomi
+        // dei metadati vengono dalla copertina del modello. Lo stesso giro
+        // popola le cache dei nomi di modello e azioni usate in rendering.
+        const cftids = [...new Set(items.map(i => i.cftid).filter((c) => c != null))];
+        const templates = new Map();
+        await Promise.all(cftids.map(async (cftid) => {
+            const tpl = await CaseFlowTemplateCacheService.GetAsync(cftid);
+            if (!tpl)
+                return;
+            templates.set(cftid, tpl);
+            primeTemplateName(tpl.id, tpl.name);
+            primeActionNames(tpl);
+        }));
+        for (const inst of items) {
+            const tplCover = inst.cftid != null ? templates.get(inst.cftid)?.cover : undefined;
+            for (const m of inst.cover ?? []) {
+                if (!m.metadataName)
+                    m.metadataName = tplCover?.find(md => md.id === m.mid)?.name;
             }
-            return true;
-        });
+        }
+        await this.resolveUserNames(items);
+        return { items, truncated };
     }
     /** WorkItem pendenti assegnati all'utente, raggruppati per istanza. */
     static async getMyPendingWorkItems(userId) {
@@ -221,6 +248,25 @@ export class CaseFlowService {
         const id = await engine.CreateAsync(d);
         return id ?? 0;
     }
+    /**
+     * Avvia un'istanza tramite StartAsync(cftid, id): il backend porta la pratica
+     * da `New` a `InProgress` e materializza i workitem della prima azione.
+     *
+     * NON va chiamata dopo `CreateCaseFlowInstance`: la Create dell'API REST
+     * esegue già lo start internamente, quindi un'istanza appena creata è
+     * ancora `New` solo nel descrittore inviato, non lato server. Questa resta
+     * per le istanze che si trovano davvero in `New` (avvio differito); sulle
+     * altre il backend rifiuta.
+     */
+    static async startCaseflow(caseFlowId, 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.StartAsync(resolvedCftid, caseFlowId);
+    }
     /**
      * Elimina un'istanza tramite DeleteAsync(cftid, id). Il cftid è preso dal
      * template fornito (se disponibile) oppure risolto dall'istanza.
@@ -490,11 +536,10 @@ export class CaseFlowService {
     /**
      * Stato "l'utente corrente segue questa pratica" letto dal descrittore.
      *
-     * Restituisce `undefined` quando il descrittore non porta l'informazione —
-     * cioè SEMPRE, finché il backend non aggiunge `IsFollow` in output a
-     * `usp_Cfi_RetrieveAll`/`usp_Cfi_Retrieve` e la relativa proprietà al
-     * contratto. Il tipo è tollerante perché la colonna è un BIT/NUMBER e può
-     * arrivare come booleano, come 0/1 o come stringa.
+     * `isFollow` fa ormai parte del contratto (`CaseFlowInstanceDescriptor`):
+     * arriva valorizzato da `usp_Cfi_RetrieveAll`/`usp_Cfi_Retrieve`. Resta
+     * `undefined` solo quando il descrittore proviene da una sorgente che non
+     * popola il campo.
      *
      * Da NON dedurre dalla bacheca Home come fanno pratiche-dossier e gruppi di
      * lavoro (filtro su `HomeBlogPost.classID`): quella query prende `TOP 30`
@@ -503,14 +548,7 @@ export class CaseFlowService {
      * poi, non esiste nemmeno un ramo nella UNION.
      */
     static readFollowFlag(cf) {
-        const raw = cf.isFollow;
-        if (typeof raw === 'boolean')
-            return raw;
-        if (typeof raw === 'number')
-            return raw !== 0;
-        if (raw === '0' || raw === '1')
-            return raw === '1';
-        return undefined;
+        return cf.isFollow;
     }
     // ----- Workitem: movimentazione del flusso -------------------------------
     //
@@ -551,7 +589,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,4 +1,3 @@
-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>;
@@ -14,6 +13,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) => React.JSX.Element;
-    static readonly getTooltip: (objClass: ObjectClasses, d: any) => React.JSX.Element | null;
+    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;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@topconsultnpm/sdkui-react",
-    "version": "6.22.0-dev3.8",
+    "version": "6.22.0-dev4.10",
     "description": "",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1",
@@ -42,7 +42,7 @@
         "lib"
     ],
     "dependencies": {
-        "@topconsultnpm/sdk-ts": "6.22.0-dev3.3",
+        "@topconsultnpm/sdk-ts": "6.22.0-dev4.3",
         "@zip.js/zip.js": "2.8.26",
         "buffer": "^6.0.3",
         "devextreme": "^26.1.4",