|
Oggetti e funzioni |
Scroll |
Calcolo
I seguenti operatori sono supportati nel calcolo della formula:
Operatore |
Funzione |
+ |
Addizione |
- |
Sottrazione |
* |
Moltiplicazione |
/ |
Divisione |
^ |
Elevazione a potenza |
() |
Parentesi |
-a |
Meno unario |
Funzioni globali |
Vedere Funzioni globali di seguito |
Proprietà tabella |
Vedere Proprietà tabella di seguito |
Proprietà colonna di tabella |
Vedere Proprietà colonna di tabella di seguito |
L'uso degli operatori non è limitato ai campi numerici e decimali. Inoltre, è possibile eseguire i calcoli indicati di seguito.
Tipo di campo |
Descrizione |
Esempio d'uso |
Campo Data, campo Data e ora |
La sottrazione (-) può essere utilizzata per sottrarre tra loro due campi di data o due campi di data e ora. •I campi non possono essere di tipo diverso. •Il calcolo restituisce la differenza tra i due campi in giorni interi (arrotondati per difetto). •I risultati negativi sono accettati |
DateField1 = 2023.04.12 DateField2 = 2023.06.09
Calcolo:
DateField2 - DateField1 = 58 |
Campo di testo |
L'addizione (+) può essere utilizzata tra stringhe •Ãˆ possibile utilizzare l'addizione sia per i campi di testo che per testi letterali •La funzione toString permette di convertire altri tipi di campi in stringhe |
"PATIENT-"+PatientFirstName+"-"+PatientLastName= PATIENT-John-Doe
"INV-"+ToString(BuyerID)+"-"+ToString(OrderNumber) = INV-112-11773360 |
Nella formattazione condizionale è anche possibile utilizzare questi ulteriori operatori:
Operatore |
Funzione |
Operatori relazionali |
|
< |
Minore di |
<= |
Minore di o uguale a |
> |
Maggiore di |
>= |
Maggiore di o uguale a |
Operatori di comparazione |
|
= |
Uguale a |
!= |
Non uguale a |
Operatori logici |
|
AND |
And (senza distinzione maiuscole/minuscole) |
OR |
Or (senza distinzione maiuscole/minuscole) |
NOT |
Not (senza distinzione maiuscole/minuscole) |
Campi categoria
I seguenti tipi di campi dati possono essere utilizzati in una condizione.
Funzione |
Può essere utilizzata in una condizione |
Esempio d'uso |
Etichetta |
no |
- |
Immagine |
no |
- |
Testo |
sì |
Le stringhe devono essere racchiuse tra virgolette: "stringa". I numeri possono essere immessi senza virgolette. Se i campi di testo della categoria hanno il campo ID 'company_name' e company_zipcode: company_name = "Moyaware" company_zipcode = 1160 |
Intero |
sì |
field_id = 1234 |
Decimale |
sì |
field_id = 14,36 |
Data |
sì |
field_id = d'YYYY-MM-DD' |
Datetime |
sì |
Timestamp1 < d'YYYY-MM-DD HH:MM:SS' Timestamp1 < d'YYYY-MM-DD HH:MM' |
Casella di controllo |
sì |
Selezionato: checkbox = 1 Deselezionato: (NOT IsEmpty(checkbox)) AND checkbox = 0 Indeterminato: IsEmpty(checkbox) |
Contatore numerico |
no |
- |
Contatore formattato |
no |
- |
Parola chiave singola |
sì |
Le stringhe devono essere racchiuse tra virgolette: "stringa". I numeri possono essere immessi senza virgolette. Se l'ID campo è 'single_keyword': single_keyword = 2 oppure single_keyword_Text = "keyword" 'Text' deve essere aggiunto manualmente all'ID campo. |
Parola chiave multipla |
no |
- |
Principale/dipendente |
sì |
Il formato di input dipende dal tipo di campo. Fare riferimento agli esempi d'uso riportati sopra. |
Controllo scheda |
no |
- |
Scheda |
no |
- |
Tabella |
no |
- |
Testo di tabella |
sì* |
Vedere Testo |
Intero di tabella |
sì* |
Vedere Intero |
Decimale di tabella |
sì* |
Vedere Decimale |
Data di tabella |
sì* |
Vedere Data/ora |
Data/ora di tabella |
sì* |
Vedere Casella di controllo |
Casella di controllo tabella |
sì* |
Vedere Parola chiave singola |
Parola chiave singola di tabella |
sì* |
Vedere Parola chiave multipla |
Campo principale/dipendente di tabella |
sì* |
Vedere Principale/dipendente |
* I valori di tabella possono essere utilizzati solo quando è specificata una condizione per un campo all'interno della stessa tabella. Non è possibile definire condizioni per tabelle differenti.
Funzioni globali
Una funzione globale è una funzione normale che non è scritta in sintassi. Le funzioni disponibili sono:
Funzione |
Descrizione |
Esempio d'uso |
Abs() |
Restituisce il valore assoluto. |
Abs(Campo) |
AddDays(dateValue, days) |
Aggiunta di giorni (come numeri interi) ai campi data e data e ora. •L'argomento 'dateValue' si riferisce a un campo data o data e ora. •L'argomento 'days' si riferisce a un campo numerico o a un numero intero •Il risultato è un campo data o data e ora, a seconda del primo numero intero •I numeri negativi sono supportati |
AddDays(DateField1, NumberField)= DateField2 |
IsEmpty() |
Restituisce true/false se il campo è vuoto. |
IsEmpty(Campo) |
Round(x,y) |
Arrotonda un numero decimale a un numero di cifre da x a y. |
Round(3.4567,2) = 3.46 |
Search(x,y) |
Cerca una sotto-stringa specifica in una stringa e restituisce true/false se viene o non viene trovata. Sono disponibili i caratteri jolly seguenti:  * corrisponde a qualsiasi carattere  ? corrisponde esattamente a un carattere |
Search("Hello", "*o") = true |
Converte i valori dei campi di dati indice in stringhe. •Il primo parametro è obbligatorio •Sono accettati i seguenti tipi di campo: Numero, Decimale, Data, Data e ora, Casella di controllo (0, 1, vuoto), Campi parola chiave (lingua server) •Il secondo parametro è opzionale e può essere utilizzato per definire un formato per un campo decimale, data o data e ora |
ToString(DecimalField1, "0.##") ToString(DateField1, "YYYY/MM/DD")
|
Macro
Macro |
Descrizione |
Esempio d'uso |
WFTaskId |
Imposta una formattazione condizionale o rende i campi obbligatori o disabilitati in base a un lavoro di workflow. |
Se l'ID del lavoro di workflow era stato impostato su 'task_ID': WFTaskId = "task_ID" L'ID lavoro è considerato come una stringa, quindi deve essere racchiuso tra virgolette. |
Proprietà tabella
Le proprietà tabella sono proprietà che possono essere usate solo su una tabella. Per utilizzarle, includere la sintassi membro e non usare le parentesi.
Funzione |
Descrizione |
Esempio d'uso |
RowCount |
Restituisce il numero di righe corrente della tabella. |
'MyTable' deve essere il campo di tabella effettivo. MyTable.RowCount > 0 |
Proprietà colonna di tabella
Le proprietà colonna di tabella sono proprietà che possono essere usate solo su una colonna di tabella. Per utilizzarle, includere la sintassi membro e non usare le parentesi.
Funzione |
Descrizione |
Esempio d'uso |
Somma |
Restituisce la somma di tutte le righe di questa colonna di tabella. |
'TableIntCol' deve essere un campo di colonna di tabella. TableIntCol.Sum > 0 |
Precedenza operatore (ordine delle operazioni)
La precedenza operatore è definita nel modo seguente. Il valore più basso viene eseguito per primo, quello più alto per ultimo.
1.Potenza (^)
2.Moltiplicazione/Divisione (*, /)
3.Più/Meno (+, -)
4.Operatori relazionali (<, <= , > , >=)
5.Operatori di comparazione (=, !=)
6.And logico
7.Or logico
Ad esempio, un "OR" viene sempre eseguito alla fine e una moltiplicazione verrebbe calcolata prima di un'addizione.
2 + 3 * 2 darebbe il risultato 8.
Se l'ordine di precedenza richiesto è differente, è possibile usare le parentesi per modificarlo:
Ad es. (2 + 3) * 2 darebbe il risultato 10.
Quando un operatore o una funzione di una formula genera un'eccezione durante la valutazione (ad es. una divisione per zero), il risultato è vuoto. L'errore viene registrato nel registro errori e non viene mostrato all'utente.
Analogamente, la condizione viene considerata FALSE ogni volta che un operatore o una funzione di una formula genera un'eccezione durante un'eccezione. L'errore viene registrato nel registro errori e non viene mostrato all'utente.
Origini campo
A seconda del tipo di campo, le formule possono usare origini campo differenti. Un campo dati indice normale può utilizzare le seguenti origini campo:
• Qualsiasi origine di campo dati indice normale supportata (Numero, Decimale, Campi dipendenti del tipo Numero o Decimale)
• Proprietà tabella (ad es. funzione RowCount)
• Proprietà colonna di tabella (ad es. funzione Sum)
I campi normali non possono avere un campo di colonna tabella come origine (solo indirettamente tramite una funzione RowCount/Sum). Un campo dati indice del tipo colonna di tabella può utilizzare le seguenti origini campo:
• Qualsiasi origine di campo normale supportata (Numero, Decimale, Campi dipendenti del tipo Numero o Decimale)
• Un altro campo dati indice di tipo colonna di tabella della stessa tabella (non è possibile fare riferimento a una colonna di un'altra tabella).
• Proprietà colonna di tabella (ad es. funzione Sum), eccetto per la colonna in uso. In altre parole, se è attualmente in uso la colonna "X", non è possibile usare la formula "X.Sum".
Parola chiave "This"
Solo nella formattazione condizionale, è possibile usare la parola chiave "this" (senza virgolette). La parola chiave farà riferimento al campo corrente nel quale l'utente si trova.
Ad esempio, se un utente è nel campo "Calc", una formattazione condizionale avrebbe l'aspetto seguente:
Calc > 10
Oppure si può usare la parola chiave "this" per fare riferimento al campo:
this > 10
La parola chiave "this" funziona solo nella formattazione condizionale perché un calcolo non può fare riferimento a se stesso. Vi sono casi speciali in cui la categoria include già un campo con un FieldID "this". In tali casi, "this" fa riferimento all'altro campo, non a se stesso.
