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

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

@@ -164,6 +164,34 @@ export declare class CaseFlowService {
      * cftid quando non passato (come per la bacheca).
      */
     private static participantsAddOrRemove;
+    /** Istanze marcate come preferite dall'utente corrente. */
+    static getFavorites(): Promise<CaseFlowInstanceDescriptor[]>;
+    /**
+     * Aggiunge o rimuove l'istanza dai preferiti dell'utente corrente tramite
+     * FavoritesAddOrRemoveAsync(cftid, id, remove).
+     */
+    static setFavorite(caseFlowId: number, favorite: boolean, cftid?: number): Promise<void>;
+    /**
+     * Inizia o smette di seguire l'istanza tramite
+     * FollowAddOrRemoveAsync(cftid, id, remove).
+     */
+    static setFollow(caseFlowId: number, follow: boolean, cftid?: number): Promise<void>;
+    /**
+     * 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.
+     *
+     * Da NON dedurre dalla bacheca Home come fanno pratiche-dossier e gruppi di
+     * lavoro (filtro su `HomeBlogPost.classID`): quella query prende `TOP 30`
+     * righe e il solo ultimo post non di sistema per oggetto, quindi chi segue
+     * un oggetto senza post risulta "non seguace"; per le istanze di CaseFlow,
+     * poi, non esiste nemmeno un ramo nella UNION.
+     */
+    static readFollowFlag(cf: CaseFlowInstanceDescriptor): boolean | undefined;
     /** Completa (approva) un workitem. La nota facoltativa viene pubblicata in bacheca dal backend. */
     static completeWorkItem(caseFlowId: number, workItemId: number, response?: string, cftid?: number): Promise<void>;
     /**

package/lib/services/caseflow/CaseFlowService.js

@@ -415,6 +415,76 @@ export class CaseFlowService {
             throw new Error(`Impossibile risolvere il template (cftid) per l'istanza id=${caseFlowId}.`);
         await engine.ParticipantsAddOrRemoveAsync(resolvedCftid, caseFlowId, participant, remove);
     }
+    // ----- Azioni personali dell'utente (Preferiti / Segui) -------------------
+    //
+    // Riguardano la relazione fra UTENTE e istanza, non il ciclo di vita della
+    // pratica. Come per documenti e partecipanti, l'engine espone un'unica API
+    // add-or-remove per ciascuna delle due.
+    //
+    // ATTENZIONE all'asimmetria: dei Preferiti si può leggere l'elenco
+    // (FavoritesRetrieveAllAsync), del Segui NO. Nessuna API dice se l'utente
+    // corrente segue una pratica: le `FollowAddOrRemove` sono di sola scrittura,
+    // qui come per pratiche-dossier e gruppi di lavoro. Finché il backend non
+    // esporrà `IsFollow` sul descrittore d'istanza, lo stato del comando Segui
+    // resta a carico del chiamante.
+    /** Istanze marcate come preferite dall'utente corrente. */
+    static async getFavorites() {
+        const engine = SDK_Globals.tmSession?.NewCaseFlowInstanceEngine();
+        if (!engine)
+            throw new Error('Motore delle istanze CaseFlow non disponibile.');
+        return await engine.FavoritesRetrieveAllAsync() ?? [];
+    }
+    /**
+     * Aggiunge o rimuove l'istanza dai preferiti dell'utente corrente tramite
+     * FavoritesAddOrRemoveAsync(cftid, id, remove).
+     */
+    static async setFavorite(caseFlowId, favorite, 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.FavoritesAddOrRemoveAsync(resolvedCftid, caseFlowId, !favorite);
+    }
+    /**
+     * Inizia o smette di seguire l'istanza tramite
+     * FollowAddOrRemoveAsync(cftid, id, remove).
+     */
+    static async setFollow(caseFlowId, follow, 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.FollowAddOrRemoveAsync(resolvedCftid, caseFlowId, !follow);
+    }
+    /**
+     * 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.
+     *
+     * Da NON dedurre dalla bacheca Home come fanno pratiche-dossier e gruppi di
+     * lavoro (filtro su `HomeBlogPost.classID`): quella query prende `TOP 30`
+     * righe e il solo ultimo post non di sistema per oggetto, quindi chi segue
+     * un oggetto senza post risulta "non seguace"; per le istanze di CaseFlow,
+     * 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;
+    }
     // ----- Workitem: movimentazione del flusso -------------------------------
     //
     // L'engine espone UNA sola API per la movimentazione dei workitem,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@topconsultnpm/sdkui-react",
-    "version": "6.22.0-dev2.18",
+    "version": "6.22.0-dev2.19",
     "description": "",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1",