SDK fieldAction: Diff Date

Questa funziona SDK permette di eseguire la differenza tra due date passate come parametri in input.

Come primi due parametri, separati dalla virgola, andranno passati i valori dei due campi di tipo data da coinvolgere nella differenza, tenendo però in considerazione che la funzione esegue il seguente calcolo: 

parametro2 - parametro1

Il secondo parametro data non è obbligatorio, quindi nel caso in cui si passasse solamente un valore data (parametro1), il calcolo verrà eseguito prendendo in automatico come secondo parametro (parametro2) la data-ora odierna.

Di default (quindi senza passare un terzo parametro), la funzione restituirà sempre il risultato del calcolo in secondi.
Invece, per ottenere il risultato in giorni, si dovrà passare la stringa fissa "days".

ATTENZIONE! di default la funzione restituirà sempre e solo risultati positivi, per abilitare la restituzione di risultati negativi di dovrà applicare una modifica al codice php.

ESEMPIO

Per comprenderne al meglio il funzionamento, qui di seguito viene riportato un esempio di utilizzo della funzione SDK diffDate() per eseguire il calcolo della differenza tra i valori di due campi denominati "Data Inizio" e "Data Fine" e salvarne il risultato (in giorni) nel campo "Intervallo Temporale" (Figura 1)

Figura 1

All'interno di una Action Task procediamo con la configurazione un'azione di Aggiorna entità coinvolgendo il campo "Intervallo Temporale".
Nello specifico, andiamo a richiamare la funzione SDK interessata attraverso la picklist "Selezione Opzione" ed accedendo alla sezione "Funzioni data" (Figura 2)

Figura 2

N.B: nella label della funzione selezionabile nella picklist "Seleziona opzione.." viene indicata la possibilità di passare un ulteriore parametro denominato "sla" che di default viene impostato a false, di fatto si tratta solamente di un refuso, pertanto risulta essere un parametro non gestibile.

Come primo e secondo parametro (separati dalla virgola) passiamo i valori dei campi "Data Inizio" e "Data Fine" nell'ordine appena citato (Figura 3)

Figura 3

Infine come terzo parametro passiamo la stringa fissa "days" (Figura 4)

Figura 4

Il risultato sarà come quello mostrato in figura 5

Figura 5