13.6 SDK Action: Freeze Entity

Questa funzione SDK permette di "congelare"/"scongelare" un determinato record coinvolto all'interno del processo.

Con il termine "congelare" si definisce la possibilità di bloccare la modifica del record coinvolto da parte di qualsiasi utente (compresi quelli con permessi di amministratore).

Risulta essere molto utile nei casi in cui si devono eseguire delle azioni in modalità background e nel frattempo si vuole evitare che gli utenti possano applicare ulteriori modifiche al record coinvolto.

Nella pratica, viene momentaneamente nascosto il pulsante "Modifica" principale (Figura 1) e tutti i vari pulsanti correlati, come ad esempio il pulsante dedicato presente in Lista. (Figura 2)



Figura 1



Figura 2

Come primo parametro va passato il crmid del record da congelare/scongelare.

Invece, come secondo parametro, va passato il valore statico "1" se si svolge congelarlo, "0" se si vuole scongelarlo.

ESEMPIO DI UTILIZZO

Per comprenderne al meglio il funzionamento, qui di seguito viene riportato l'esempio di utilizzo della funzione SDK Freeze Entity() per congelare l'azienda fino al completamento dell'aggiornamento dell'assegnatario dei contatti relazionati.

All'interno di un'Action Task posizionata prima dell'azione di cicla record relazionati, procediamo con la configurazione di un'azione di tipo "Funzioni SDK" nella quale richiamiamo l'Freeze Entity().

Come primo parametro passiamo il crmid dell'azienda da congelare, nel nostro caso $44-crmid. (Figura 3)

Come secondo parametro passiamo il valore statico "1". (Figura 3)

Figura 3

Successivamente all'Action Task in cui è stata configurata l'azione di cicla record relazionati, procediamo con la configurazione di un'altra azione di tipo "Funzioni SDK" nella quale richiamiamo l'Freeze Entity().

Come primo parametro passiamo il crmid dell'azienda da scongelare, nel nostro caso $44-crmid. (Figura 4)

Come secondo parametro passiamo il valore statico "0". (Figura 4)

Figura 4