12.12 SDK Action: Set entity reference

Questa funzione SDK permette di istanziare uno specifico record all'interno di un'istanza dello stesso modulo coinvolta all'interno del processo.

Viene utilizzata principalmente nel caso in cui si debbano eseguire determinate azioni su un record che è stato inserito dall'esterno (utente) in un campo di una form dinamica (Testo o Relazionato a), a patto che nel processo sia già coinvolta un'atra istanza dello stesso modulo.

ESEMPIO DI UTILIZZO

Per comprenderne al meglio il funzionamento, qui di seguito viene riportato l'esempio di utilizzo della funzione SDK Set entity reference() che viene attualmente sfruttato nel processo BPMN standard di conversione del lead.

Nella form dinamica del process helper (configurata nell'Action Task "Request details") viene data la possibilità all'utente di creare una nuova azienda oppure di selezionarne una esistente.
PerNello


Tra il modulo Leads e il modulo Aziende non esiste di alcun tipo di relazione.
Nel momento in cui si configura un processo che si basa sul modulo Leads, gli unici modi per coinvolgere un'istanza del modulo Aziende all'interno del processo sono i seguenti:
a) azione di Crea entità -> andando a creare un nuovo record sarà possibile sfruttarlo al completo all'interno del processo
b) campo relazionato su form dinamica di un process helper -> andando ad inserirespecifico, l'id deldell'azienda recordesistente viene storicizzato in un campo di tipo "Relazionato a" presente all'interno della form dinamica.
Questa tipologia di campo non stabilisce una vera e propria relazione, di conseguenza non viene visto come istanza completa del modulo Aziende.
Infatti, non possiede alcun metaid, ossia l'id che identifica univocamente l'istanza di un modulo all'interno di un processo.
Per questo, le azioni eseguibili sul record contenuto nel campo di relazione sono limitate.
Al contrario, l'entità istanziata dall'azione di Crea entità possiede un proprio metaid, questo perché è stata coinvolta a tutti gli effetti all'interno del processo.

Nel caso del processo di conversione del lead, non è possibile coinvolgere all'interno dell'azione standard "Trasferisci relazioni" l'azienda contenuta all'interno del campo di relazione.

Per risolvere questo problema, è possibile ricorrere all'utilizzo della funzione Set entity reference() per forzare il record (presente nel campo di relazione) all'interno dell'istanza del modulo Azienda coinvolta tramite l'azione di Crea entità.

In questo modo,