10.2 Somma parziale delle righe di un campo tabella coinvolte in un ciclo
Come anticipato nel capitolo 10.1, per eseguire la somma parziale delle righe di un campo tabella coinvolte in un ciclo, non è possibile utilizzare la voce "Somma", in quanto, il sistema prenderà sempre in considerazione TUTTE le righe presenti all'interno del campo tabella.
Infatti, la voce "Somma" è una variabile disponibile anche nel caso in cui non si esegua un ciclo.
La sua esistenza è finalizzata ad ottenere facilmente la somma di tutte le righe di un campo tabella senza dover necessariamente configurare un'azione di cicla righe.
Quindi, per ottenere il risultato desiderato, si dovrà configurare un'azione di cicla righe e per ogni riga "Aggiorna entità", in questo modo andremo a salvare il totale all'interno di un campo di un modulo o di una form dinamica (dalla versione 24.08 in poi).
Una volta inserite la condizione nella sezione "Condizioni sul campo" per coinvolgere nel ciclo solamente le righe interessate, nell'azione di aggiorna entità si dovrà sfruttare la funzione SDK fieldAction Standard "vte_sum()" (per approfondimenti vedere capitolo 12.1) per aggiungere (ad ogni ciclo) il valore della riga corrente al contenuto che è già presente nel campo in cui si sta salvando il risultato.
ATTENZIONE! -> nel caso in cui si configurasse un processo che si scatena in maniera ricorrente, per ottenere il risultato corretto si deve impostare un'azione di aggiorna entità che svuoti il contenuto del campo nel quale si vuole salvare il risultato.
ESEMPIO DI UTILIZZO
Per comprenderne al meglio il funzionamento, qui di seguito viene riportato un esempio di un'azione di cicla righe sul campo tabella "Partecipanti" (Figura 1) del modulo Leads dal quale vogliamo calcolare la somma della colonna "Numero" solamente delle righe aventi nella colonna "Tipologia" il valore "Rivenditore" e salvarne il risultato nel campo "Totale Rivenditori" (Figura 2)
Figura 1
Figura 2
All'interno del processo configuriamo un'azione di cicla righe e per ogni riga aggiorna entità del modulo "Leads" (Figura 3 e 4)
Figura 3
Figura 4
Nella sezione "Condizioni sul campo" andiamo ad inserire "Tipologia" = "Rivenditore" (Figura 5)
Figura 5
All'interno del campo "Totale Rivenditori" andiamo a richiamare la funzione SDK interessata attraverso la picklist "Selezione Opzione" ed accedendo alla sezione "Funzioni SDK" (Figura 6)
Figura 6
Come primo parametro inseriamo la variabile che identifica il contenuto del campo "Totale Rivenditori" (Figura 7)
Figura 7
Come secondo parametro inseriamo la variabile che identifica il valore corrente della colonna "Numero" delle righe del campo tabella coinvolte nel ciclo (Figura 8)
Figura 8
Riprendendo le Figure 1 e 2, come risultato finale otterremo la somma della colonna "Numero" della prima e terza riga del campo tabella, che nel nostro caso corrisponde al valore 8 (Figura 9)
Figura 9