SDK fieldAction: vte_json_column_fields
Questa funziona SDK permette di generare un codice JSON contenente le label e i valori dei 2 o più campi passati come parametri.
Come primo parametro va passato il crmid del record dal quale si vogliono estrarre le informazioni, invece come parametri successivi andranno passati i "fieldname" dei campi da includere, ovvero i nomi in cui quei campi sono registrati a Data Base.
NOTA BENE: anche se nella descrizione della funzione viene indicato di passare i parametri successivi all'id inserendo delle parentesi quadre, quest'ultime non devono essere inserite.
Viene utilizzata principalmente per formattare un subset di dati al fine di eseguire delle chiamate Web Service di tipo REST (configurabili sempre da processo tramite l'azione standard dedicata "Chiama Web Service Esterno").
Per approfondimenti sulla configurazione di chiamate API da processo si prega di consultare il capitolo 3.15 del manuale dei processi.
ESEMPIO DI UTILIZZO
Per comprenderne al meglio il funzionamento, qui di seguito viene riportato un esempio di utilizzo della funzione SDK vte_json_column_fields() per la generazione di un codice JSON contenente i seguenti campi e valori di un'istanza del modulo Assistenza Clienti coinvolta nel processo:
Titolo
Stato
All'interno della form dinamica di un process helper procediamo con la creazione di un campo area di testo denominato "Body JSON Format" nel quale verrà salvato il risultato della funzione.
Successivamente andiamo a richiamare la funzione SDK interessata attraverso la picklist "Selezione Opzione" e ad accedere alla sezione "Funzioni SDK" (Figura 1)
Figura 1
Infine passiamo i parametri richiesti dalla funzione, tutti separati dalla virgola.
Nello specifico, come primo parametro inseriamo il crmid del record dal quale si vogliono estrarre le informazioni, quindi nel nostro caso l'id del ticket. (Figura 2)
Figura 2
Invece, come parametri successivi, inseriamo i "fieldname" dei campi da coinvolgere, ovvero i nomi con cui quei campi sono registrati a Data Base.
Nel nostro caso specifico saranno "ticket_title", "ticketstatus" e "ticketpriorities". (Figura 3)
Figura 3
Per ricavarli facilmente, sarà sufficiente selezionare il campo relativo dalla picklist "Selezione Opzione" ed eliminare il riferimento all'istanza coinvolta nel processo, ovvero il metaid (Figura 4).
Figura 4
Il codice JSON generato sarà come quello mostrato in Figura 5