10.3 Somma parziale dei record relazionati coinvolti in un ciclo
Per eseguire la somma parziale dei record di uno specifico modulo avente relazione 1-N o N-N con il modulo di partenza, non è possibile utilizzare la voce "Somma", in quanto, il sistema prenderà sempre in considerazione TUTTI i record relazionati.
Quindi, per ottenere il risultato desiderato, si dovrà configurare un'azione di cicla record relazionati e per ogni riga "Aggiorna entità", in questo modo andremo a salvare il totale all'interno di un campo del modulo di partenza 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 i record interessati, 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 del record 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 record relazionati sul modulo Installazioni (partendo dal modulo Azienda) con la quale vogliamo calcolare illa totalesomma del campo "Numero manutenzioni annuali" solamente delle installazioni aventi nella colonna "Stato" il valore "A Servizio" e salvarne il risultato nel campo "NumeroTot Installazionimanutenzioni su installazioni attive" dell'azienda (Figura 1)
Figura 1
All'interno del processo configuriamo un'azione di cicla record relazionati (Installazioni) e per ogni riga aggiorna entità del modulo "Aziende" (Figura 2 e 3)
Figura 3
Nella sezione "Condizioni sul campo" andiamo ad inserire "Stato" = "A Servizio" (Figura 4)
Figura 4
All'interno del campo "Tot manutenzioni su installazioni attive" andiamo a richiamare la funzione SDK interessata attraverso la picklist "Selezione Opzione" ed accedendo alla sezione "Funzioni SDK" (Figura 5)
Figura 5
Come primo parametro inseriamo la variabile che identifica il contenuto del campo "Tot manutenzioni su installazioni attive" (Figura 6)
Figura 6
Come secondo parametro inseriamo la variabile che identifica il valore corrente del campo "Numero manutenzioni annuali" delle installazioni coinvolte nel ciclo (Figura 7)