Riferimento a una formula: app canvas
Questo articolo spiega tutte le funzioni disponibili nelle app canvas.
Le formule nelle app canvas combinano molti elementi. Di seguito sono elencati tutti gli elementi:
- Le funzioni usano i parametri, eseguono un'operazione e restituiscono un valore. Ad esempio, Sqrt(25) restituisce 5. Le funzioni si basano sulle funzioni di Microsoft Excel. Alcune funzioni hanno effetti collaterali, ad esempio la funzione SubmitForm, e sono utili solo in una formula di comportamento, come Button.OnSelect.
- I segnali restituiscono informazioni sull'ambiente. Ad esempio, Location restituisce le coordinate GPS correnti del dispositivo. I segnali non usano parametri e non hanno effetti collaterali.
- Le enumerazioni restituiscono un valore costante prestabilito. Ad esempio, Color è un'enumerazione con valori predefiniti per Color.Red, Color.Blue, e così via. Qui sono incluse le enumerazioni comuni. Le enumerazioni specifiche per funzione sono descritte insieme alla funzione.
- Gli operatori denominati, ad esempio ThisItem e Self, consentono di accedere alle informazioni da un contenitore.
Di seguito altri elementi:
A
Abs: valore assoluto di un numero.
Acceleration: legge il sensore di accelerazione del dispositivo.
Acos: restituisce l'arcocoseno di un numero, espresso in radianti.
Acot: restituisce l'arcotangente di un numero, espresso in radianti.
AddColumns: restituisce una tabella con colonne aggiunte.
And: AND della logica booleana. Restituisce true se tutti gli argomenti sono veri. Puoi anche usare l'operatore &&.
AIClassify: classifica il testo in una delle categorie fornite.
AIExtract: estrai entità specificate come numeri di registrazione, numeri di telefono o nomi di persone.
AIReply: redige una risposta al messaggio fornito.
AISentiment: rileva la valutazione del testo che fornisci.
AISummarize: riassume il testo che fornisci.
AITranslate: traduce il testo da un'altra lingua.
App: fornisce informazioni sull'app attualmente in esecuzione e il controllo sul comportamento dell'app.
Asin: restituisce l'arcoseno di un numero, espresso in radianti.
Assert : restituisce true o false in un test.
As: assegna un nome al record corrente nelle funzioni raccolta, modulo e ambito del record come ForAll, With e Sum.
AsType: considera un riferimento a un record come un tipo di tabella specifico.
Atan: restituisce l'arcotangente di un numero, espresso in radianti.
Atan2: restituisce l'arcotangente in base a una coordinata (x,y), espresso in radianti.
Average: calcola la media di un'espressione di tabella o di un insieme di argomenti.
B
Back: visualizza la schermata precedente.
Blank: restituisce un valore blank che può essere usato per inserire un valore NULL in un'origine dati.
Boolean: converte una stringa di testo, un numero o un valore non tipizzato in un valore booleano.
C
Calendar: recupera informazioni sul calendario per le impostazioni locali correnti.
Char: converte un codice carattere in una stringa.
Choices: restituisce una tabella dei valori possibili per una colonna di ricerca.
Clear: elimina tutti i dati da una raccolta.
ClearCollect: elimina tutti i dati da una raccolta e aggiunge un insieme di record.
ClearData: cancella una raccolta o tutte le raccolte da un host di app come un dispositivo locale.
Clock: recupera informazioni sull'orologio per le impostazioni locali correnti.
Coalesce: sostituisce i valori blank senza modificare i valori non blank.
Collect: crea una raccolta o aggiunge dati a un'origine dati.
Color: imposta una proprietà su un valore di colore predefinito.
ColorFade: dissolve un valore colore.
ColorValue: converte un nome colore CSS o un codice esadecimale in un valore colore.
Column: recupera nomi e valori della colonna da un Tipo di dati di un oggetto non tipizzato.
ColumnNames: recupera nomi e valori della colonna da un Tipo di dati di un oggetto non tipizzato.
Compass: restituisce l'intestazione della bussola.
Concat: concatena le stringhe in un'origine dati.
Concatenate: concatena le stringhe.
Concurrent: valuta più formule contemporaneamente.
Connection: restituisce informazioni sulla connessione di rete.
Copia: copia il testo negli appunti sul dispositivo su cui è in esecuzione l'app.
Count: conta i record di tabella che contengono numeri.
Cos: restituisce il coseno di un angolo, espresso in radianti.
Cot: restituisce la cotangente di un angolo, espresso in radianti.
CountA: conta i record di tabella che non sono vuoti.
CountIf: conta i record di tabella che soddisfano una condizione.
CountRows: conta i record di tabella.
D
DataSourceInfo: offre informazioni su un'origine dati.
Date: restituisce un valore di data e ora, in base ai valori Anno, Mese e Giorno.
DateAdd: aggiunge giorni, mesi, trimestri o anni a un valore di data e ora.
DateDiff: sottrae due valori data e illustra il risultato espresso in giorni, mesi, trimestri o anni.
DateTime: restituisce un valore di data e ora, in base ai valori data e ora.
DateTimeValue: converte una stringa di data e ora in un valore di data e ora.
DateValue: converte una stringa di sola data in un valore di data e ora.
Day: recupera la parte relativa al giorno di un valore di data e ora.
Dec2Hex: converte un numero in una stringa di testo esadecimale.
Defaults: restituisce i valori predefiniti per un'origine dati.
Degrees: converte i radianti in gradi.
Disable: disabilita un segnale, ad esempio Location per leggere il GPS.
Distinct: riepiloga i record di una tabella, rimuovendo i duplicati.
Download: scarica un file dal Web nel dispositivo locale.
DropColumns: restituisce una tabella con una o più colonne rimosse.
E
EDate: aggiunge o sottrae mesi a una data, senza cambiare il giorno del mese.
EditForm : reimposta un controllo form per modificare un elemento.
Enable: abilita un segnale, ad esempio Location, per leggere il GPS.
EncodeHTML – Codifica i caratteri che devono essere sottoposti a escape per essere utilizzati in un contesto HTML.
EncodeUrl: codifica i caratteri speciali con la codifica URL.
EndsWith: verifica se una stringa di testo termina con un'altra stringa di testo.
EOMonth: aggiunge o sottrae mesi a una data, restituendo l'ultimo giorno di quel mese.
Errore: crea un errore personalizzato o il pass-through di un errore.
Errors: offre informazioni su errori relativi alle precedenti modifiche apportate a un'origine dati.
exactin: controlla se una stringa di testo è contenuta all'interno di un'altra stringa di testo o tabella, con rispetto delle maiuscole e minuscole. Utilizzata anche per verificare se un record è in una tabella.
Exit: chiude l'app attualmente in esecuzione ed eventualmente disconnette l'utente corrente.
Exp: restituisce e elevato a potenza.
F
Filter: restituisce una tabella filtrata in base a uno o più criteri.
Find: controlla se una stringa viene visualizzata in un'altra e ne restituisce il percorso.
First: restituisce il primo record di una tabella.
FirstN : restituisce il primo insieme di record (record N) di una tabella.
ForAll: calcola i valori ed esegue azioni per tutti i record di una tabella.
G
GroupBy: restituisce una tabella con i record raggruppati.
GUID: converte una stringa GUID in un valore GUID o crea un nuovo valore GUID.
H
HashTags: estrae gli hashtag (#stringhe) da una stringa.
Hex2Dec: converte una stringa di testo esadecimale in un numero.
Host: fornisce informazioni sull'host corrente che esegue l'app.
Hour: restituisce la parte relativa all'ora di un valore di data e ora.
I
If: restituisce un valore se una condizione è vera; altrimenti restituisce un altro valore.
IfError: rileva errori e fornisce un valore alternativo o esegue un'azione.
in: controlla se una stringa di testo è contenuta all'interno di un'altra stringa di testo o tabella, senza rispetto delle maiuscole e minuscole. Utilizzata anche per verificare se un record è in una tabella.
Index: restituisce un record da una tabella in base alla posizione ordinata.
Int: arrotonda per difetto al numero intero più vicino.
IsBlank: controlla se un valore è vuoto.
IsBlankOrError: controlla se un errore o un valore è vuoto.
IsEmpty: controlla se una tabella è vuota.
IsError: verifica la presenza di un errore.
IsMatch: controlla una stringa rispetto a un modello. È possibile usare espressioni regolari.
IsNumeric: controlla se un valore è numerico.
ISOWeekNum: restituisce il numero della settimana ISO di un valore di data/ora.
IsToday: verifica se un valore di data/ora si verifica oggi nel fuso orario dell'utente.
IsType: verifica se un riferimento a un record fa riferimento a un tipo di tabella specifico.
IsUTCToday: verifica se un valore di data/ora si verifica oggi in Coordinated Universal Time (UTC).
J
JSON: genera una stringa di testo JSON per una tabella, un record o un valore.
L
Language: restituisce il tag di lingua relativo all'utente corrente.
Last: restituisce l'ultimo record di una tabella.
LastN: restituisce l'ultimo insieme di record (record N) di una tabella.
Launch: avvia una pagina Web o un'app canvas.
Left: restituisce la parte più a sinistra di una stringa.
Len: restituisce la lunghezza di una stringa.
Ln: restituisce il logaritmo naturale.
LoadData: carica una raccolta da un host di app come un dispositivo locale.
Location: restituisce il percorso come coordinata della mappa usando Global Posizioneing System (GPS) e altre informazioni.
Log: restituisce il logaritmo in base a un numero.
LookUp: cerca un singolo record in una tabella in base a uno o più criteri.
Lower: converte le lettere di una stringa di testo in minuscolo.
M
Match: estrae una substring in base a un modello. È possibile usare espressioni regolari.
MatchAll: estrae più sottostringhe in base a un modello. È possibile usare espressioni regolari.
Max: valore massimo di un'espressione di tabella o di un insieme di argomenti.
Mid: restituisce la parte centrale di una stringa.
Min: valore minimo di un'espressione di tabella o di un insieme di argomenti.
Minute: recupera la parte relativa al minuto di un valore di data e ora.
Mod: restituisce il resto dopo aver diviso il dividendo per un divisore.
Month: recupera la parte relativa al mese di un valore di data e ora.
N
Navigate: modifica la schermata visualizzata.
NewForm: reimposta un controllo form per creare un elemento.
Not: NOT della logica booleana. Restituisce true se l'argomento è falsoe restituisce false se l'argomento è vero. È anche possibile usare l'operatore !.
Notify: visualizza un banner all'utente.
Now: restituisce il valore di data/ora corrente nel fuso orario dell'utente.
O
Or: OR della logica booleana. Restituisce vero se uno degli argomenti è vero. Puoi anche usare || come operatore.
P
Param: i parametri di accesso passati a un'app canvas quando questa viene avviata.
Parent: consente di accedere alle proprietà di un controllo del contenitore.
ParseJSON: converte il documento JSON rappresentato come testo in un valore Oggetto non tipizzato.
Patch: modifica o crea un record in un'origine dati oppure unisce i record esterni a un'origine dati.
PDF: consente di esportare i contenuti dalla schermata corrente in un oggetto per l'uso in più scenari.
Pi: restituisce il numero π.
PlainText: rimuove i tag HTML e XML da una stringa.
Power: restituisce un numero elevato a potenza. Puoi anche usare ^ come operatore.
Proper: converte la prima lettera di ogni parola in una stringa in maiuscolo e converte il resto in minuscolo.
R
Radians: converte i gradi in radianti.
Rand: restituisce un numero pseudo casuale compreso tra 0 e 1.
RandBetween: restituisce un numero pseudo casuale tra due numeri.
ReadNFC: legge un tag Near Field Communication (NFC).
RecordInfo: fornisce informazioni su un record di un'origine dati.
Refresh : aggiorna i record di un'origine dati.
Relate: correla i record di due tabelle tramite una relazione uno-a-molti o molti-a-molti.
Remove: rimuove uno o più record specifici da un'origine dati.
RemoveIf: rimuove i record da un'origine dati in base a una condizione.
RenameColumns: rinomina le colonne di una tabella.
Replace: sostituisce parte di una stringa con un'altra stringa, dalla posizione iniziale della stringa.
RequestHide: nasconde un modulo SharePoint.
Reset: reimposta il valore predefinito di un controllo di input, ignorando le modifiche dell'utente.
ResetForm: reimposta un controllo form per modificare un elemento esistente.
Revert: ricarica e cancella gli errori relativi ai record di un'origine dati.
RGBA: restituisce un valore colore per un insieme di componenti rosso, verde, blu e alfa.
Right: restituisce la parte più a destra di una stringa.
Round: arrotonda al numero più vicino.
RoundDown: arrotonda per difetto al numero più grande precedente.
RoundUp: arrotonda per eccesso al numero più piccolo precedente.
S
SaveData: salva una raccolta su un host di app come un dispositivo locale.
Search: trova i record in una tabella che contiene una stringa in una delle relative colonne.
Second: recupera la parte relativa al secondo di un valore di data e ora.
Select: simula un'azione di selezione su un controllo, causando la valutazione della formula OnSelect.
Self: fornisce accesso alle proprietà del controllo corrente.
Sequence: genera una tabella di numeri sequenziali, utile durante l'iterazione con ForAll.
SendAppNotification (anteprima): invia una notifica in-app con azioni facoltative a un destinatario.
Set: imposta il valore di una variabile globale.
SetFocus: sposta lo stato attivo per l'input su un controllo specifico.
SetProperty: simula le interazioni con i controlli di input.
ShowColumns: restituisce una tabella con solo le colonne selezionate.
ShowHostInfo: mostra le informazioni all'utente nell'app.
Shuffle: riordina in modo casuale i record di una tabella.
Sin: restituisce il seno di un angolo espresso in radianti.
Sort: restituisce una tabella ordinata in base a una formula.
SortByColumns: restituisce una tabella ordinata in base a una o più colonne.
Split: suddivide una stringa di testo in una tabella di sottostringhe.
Sqrt : restituisce la radice quadrata di un numero.
StartsWith: controlla se una stringa di testo inizia con un'altra stringa di testo.
StdevP: restituisce la deviazione standard dei relativi argomenti.
Substitute: sostituisce parte di una stringa con un'altra stringa, creando una corrispondenza tra stringhe.
SubmitForm: salva l'elemento in un controllo form nell'origine dati.
Sum: calcola la somma di un'espressione di tabella o di un insieme di argomenti.
Switch: esegue la corrispondenza con un set di valori e quindi valuta una formula corrispondente.
T
Table: crea una tabella temporanea.
Tan: restituisce la tangente di un angolo, in radianti.
Text: converte qualsiasi valore e formatta un numero o un valore di data/ora in una stringa di testo.
ThisItem: restituisce il record per l'elemento corrente in un controllo form o raccolta.
ThisRecord: restituisce il record per l'elemento corrente in una funzione di ambito del record, ad esempio ForAll, With e Sum.
Time: restituisce un valore di data e ora, in base ai valori Ora, Minuto e Secondo.
TimeValue: converte una stringa di sola ora in un valore di data e ora.
TimeZoneOffset: restituisce la differenza tra l'ora UTC e l'ora locale dell'utente in minuti.
Today: restituisce solo il valore di data corrente.
Trace: fornisce informazioni aggiuntive nei risultati del test.
Trim: rimuove gli spazi aggiuntivi alle estremità e all'interno di una stringa di testo.
TrimEnds: rimuove solo gli spazi aggiuntivi alle estremità di una stringa di testo.
Trunc: tronca il numero solo alla parte intera rimuovendo qualsiasi parte decimale.
U
Ungroup: rimuove un raggruppamento.
UniChar: converte un codice Unicode in una stringa.
Unrelate: annulla la correlazione tra i record di due tabelle in una relazione uno-a-molti o molti-a-molti.
Update: sostituisce un record in un'origine dati.
UpdateContext: imposta il valore di una o più variabili di contesto dello schermata corrente.
UpdateIf: modifica un insieme di record in un'origine dati in base a una condizione.
Upper: converte tutte le lettere di una stringa di testo in maiuscolo.
User: restituisce informazioni sull'utente corrente.
UTCNow: restituisce il valore di data/ora corrente in Coordinated Universal Time (UTC).
UTCToday: restituisce solo il valore di data corrente in Coordinated Universal Time (UTC).
V
Validate: controlla se il valore di una singola colonna o di un record completo è valido per un'origine dati.
Value: converte una stringa in un numero.
VarP: restituisce lo scostamento dei relativi argomenti.
ViewForm: reimposta un controllo form per visualizzare un elemento esistente.
W
Weekday: recupera la parte relativa al giorno feriale di un valore di data e ora.
WeekNum: restituisce il numero della settimana di un valore di data/ora.
With: calcola i valori ed esegue azioni per un singolo record, inclusi i record inline dei valori denominati.
Y
Year: recupera la parte relativa all'anno di un valore di data e ora.