Dopo aver selezionato il campo in cui Field Calculator scriverà il risultato dell'operazione accedi alla pagina della sua configurazione.
Nella parte superiore della pagina trovi alcune informazioni relative al Campo da valorizzare.
- Campo da valorizzare :
nome e tipo di campo nel quale Field Calculator scriverà i suoi risultati; - Database:
database di appartenenza del campo da valorizzare. Se il campo è condiviso, sarà indicato il Master Database.
Restringi target
In questa sezione definisci quali sono i contatti interessati dal calcolo del Field Calculator.
Cliccando sul pulsante Modifica filtro avrai la possibilità di circoscrivere il target dell'operazione applicando delle condizioni specifiche.
Di default vengono selezionati tutti i contatti indipendentemente dal loro stato (e dal database di appartenenza) nel caso in cui il campo sia condiviso. Per limitare l'aggiornamento ai soli contatti attivi e/o ad un solo database se il campo è condiviso, aggiungi dei filtri specifici per queste condizioni.
Il pulsante "Conta contatti del filtro" ti permette di sapere quali sono i contatti che saranno interessati dal calcolo del Field Calculator.
Espressione
In questa sezione imposti le operazioni che saranno eseguite dal Field Calculator.
Ogni operazione è composta di due parti: le condizioni e le azioni.
Se si verifica quanto descritto nelle condizioni, allora Field Calculator esegue delle azioni. È possibile fare in modo che, qualora nessuna delle condizioni specificate si verificasse, Field Calculator esegua un'azione alternativa.
Per creare una nuova operazione, clicca sul pulsante "Aggiungi Condizione" .
Nella tabella saranno aggiunti due campi:
- il campo Se in cui impostare la condizione;
- il campo Allora assegna il valore in cui scrivere il calcolo da compiere.
È possibile aggiungere nuove condizioni e calcoli cliccando sul pulsante "Aggiungi condizione".
Se hai aggiunto più condizioni, il Field Calculator procederà a cascata analizzando il primo contatto e verificando la prima condizione. Se la prima condizione è soddisfatta, Field Calculator scriverà il risultato e passerà al contatto successivo.
Se la condizione non è verificata, Field Calculator passerà alla successiva secondo l'ordine di configurazione delle condizioni.
Se alla fine dell'analisi nessuna delle condizioni sarà verificata, verrà applicato il valore di default del campo Altrimenti.
se lasci vuoto il campo Altrimenti, nel caso in cui nessuna condizione fosse verificata, il campo calcolato sarà svuotato.
Se vuoi che il valore del campo calcolato resti inalterato, inserisci una delle seguenti keyword (rigorosamente in maiuscolo e senza apici):
- BREAK
- RETURN
- END
Per cancellare una condizione, clicca sull'icona del cestino.
Testare l'operazione
Puoi verificare la corretta configurazione di un'operazione prima di eseguirla in maniera definitiva.
Prima di eseguire la verifica, salva l'operazione cliccando sul pulsante Salva in alto a destra quindi clicca sul pulsante "Anteprima per contatto".
Sarà visualizzata la finestra del test.
Nel campo ID contatto: inserisci l'id del contatto sul quale effettuare il test.
Per conoscere l'ID di un contatto, entra nella sua scheda all'interno del database cui appartiene.
Nella barra degli indirizzi del browser, individua la stringa
idlettore=
.Il numero riportato dopo l'= (Uguale) sarà l'id del contatto:
Dopo aver inserito l'ID, clicca sul pulsante Anteprima per un contatto.
se tutto è stato configurato correttamente, nella finestra comparirà una nuova riga contente il risultato dell'operazione sul contatto selezionato.
Valori ed operatori
Le condizioni inserite nel campo Se sono espressioni che restituiscono un valore true
o false
.
Per scrivere una condizione puoi usare gli operatori EQ, NEQ, GT, GTE, LT, LTE,CONTAINS
e gli operatori logici AND, OR, NOT
.
I valori invece sono espressioni che devono restituire un risultato dello stesso tipo del campo in cui andranno scritti.
Esempi di valori:
'Mario'
stringa di testo10
numerocontact.values.NAME & '-' & contact.values.SURNAME
stringa di concatenazione(contact.values.A + contact.values.B)/2
stringa per calcolo dei valori
Schedulazione
Le operazioni del Field Calculator possono essere eseguite a richiesta o secondo una schedulazione configurabile nell'apposita sezione.
L'esecuzione può essere:
Schedulazione a richiesta
Non segue una pianificazione. L'operazione viene lanciata ogni volta che si clicca sulm pulsante "Lancia il calcolo" .
l'esecuzione a richiesta non interferisce con le pianificazioni configurate.
L'inizio reale dell'operazione potrebbe non essere immediato. Il calcolo sarà eseguito dal Field Calculator nel minor tempo possibile tenendo comunque conto del numero di operazioni già programmate sulla piattaforma.
Schedulazione giornaliera
Il calcolo viene lanciato ogni giorno all'orario specificato nel campo Alle ore:
L'orario va inserito nel formato hh:mm.
Schedulazione settimanale
Il calcolo viene lanciato nel giorno e all'ora indicate nei campi Giorno della settimana: e Alle ore:
L'orario va inserito nel formato hh:mm.
Schedulazione mensile
Il calcolo viene lanciato una volta al mese.
Nel campo Giorno del mese indichi in quale giorno sarà eseguita l'operazione. Se inserisci il numero 31, questo corrisponderà all'ultimo giorno del mese, indipendentemente dalla durata del mese stesso.
Nel campo Alle ore: va inserito l'orario di esecuzione del calcolo, in formato hh:mm
Una volta terminata la configurazione dell'operazione, clicca sul pulsante Salva in alto a destra per registrare la configurazione.
Nella sezione di Avvio manuale, visualizzerai i risultati dell'ultima esecuzione dell'operazione.
Elenco delle operazioni
Una volta salvato, il calcolo da te creato sarà aggiunto, nella pagina principale, all'elenco delle operazioni già create.
Cliccando sulle icone a sinistra dell'ID del campo oggetto dell'operazione puoi:
- Accedere al menu di configurazione del calcolo
- Lanciare l'operazione di calcolo con esecuzione immediata
- Cancellare l'operazione
- La colonna Tipo schedulazione riporta informazioni sul tipo di schedulazione impostata per le diverse operazioni.
- La colonna Database indica il/i database sui quali sarà effettuato il calcolo.
- La colonna Prossima esecuzione indica, se l'operazione è schedulata, data ed ora della prossima esecuzione.
Nel menu contestuale di destra, è presente la voce Vai all'elenco delle operazioni.
Questa voce ti porta alla pagina contenente l'elenco di tutte le operazioni configurate sulla piattaforma (quindi non solo quelle create dal Field Calculator che rappresenta solo una tra le numerose tipologie di azioni presenti).