Formelreferenz – Canvas-Apps
In diesem Artikel erfahren Sie mehr über alle in Canvas-Apps verfügbaren Funktionen.
Formeln in Canvas-Apps kombinieren viele Elemente miteinander. Im Folgenden sind aufgeführt:
- Funktionen nehmen Parameter entgegen, führen eine Operation aus und geben einen Wert zurück. So gibt beispielsweise Sqrt(25) den Wert 5 zurück. Funktionen werden Microsoft Excel-Funktionen nachempfunden. Einige Funktionen haben Seiteneffekte, wie z.B. SubmitForm, die sich nur für Verhaltensformeln wie Button.OnSelect eignet.
- Signale geben Informationen über Umgebung zurück. Die Funktion Location gibt beispielsweise die aktuellen GPS-Koordinaten des Geräts zurück. Signale verwenden keine Parameter und haben keine Seiteneffekte.
- Aufzählungen geben einen vordefinierten konstanten Wert zurück. Color ist eine Enumeration, die über vordefinierte Werte für Color.Red, Color.Blue usw. verfügt. An dieser Stelle werden nur allgemeine Enumerationen beschrieben. Funktionsspezifische Enumerationen werden mit der jeweiligen Funktion erläutert.
- Benannte Operatoren wie ThisItem und Self ermöglichen den Zugriff auf Informationen innerhalb eines Containers.
Andere Elemente enthalten:
A
Abs – Absolutwert einer Zahl.
Beschleunigung – Liest den Beschleunigungssensor in Ihrem Gerät.
Acos – Gibt den Arkuskosinus einer Zahl im Bogenmaß zurück.
Acot – Gibt den Arkukotangens einer Zahl im Bogenmaß zurück.
AddColumns – Gibt eine Tabelle mit hinzugefügten Spalten zurück.
Und – boolesch logisches UND. Gibt TRUE zurück, wenn für alle Argumente TRUE gilt. Sie können auch den &&-Operator verwenden.
AIClassify – Klassifiziert Text in eine oder mehrere Kategorien.
AIExtract – Extrahiert bestimmte Entitäten wie Registrierungsnummern, Telefonnummern oder Personennamen.
AIReply – Erstellt eine Antwort auf die von Ihnen eingegebene Nachricht.
AISentiment – Erkennt die Stimmung des von Ihnen eingegebenen Textes.
AISummarize – Fasst den von Ihnen eingegebenen Text zusammen.
AITranslate – Übersetzt Text aus einer anderen Sprache.
App – Bietet Informationen über die aktuell ausgeführte App und Kontrolle über das Verhalten der App.
Asin – Gibt den Arkussinus einer Zahl im Bogenmaß zurück.
Assert – Wird in einem Test als „true“ oder „false“ ausgewertet.
Als – Benennt den aktuellen Datensatz in Galerie-, Formular- und Datensatzbereichsfunktionen wie FürAlle, Mit und Summe.
AsType – Behandelt einen Datensatzverweis als einen bestimmten Tabellentyp.
Atan – Gibt den Arkustangens einer Zahl im Bogenmaß zurück.
Atan2 – Gibt den Arkustangens basierend auf einer (x,y)-Koordinate im Bogenmaß zurück.
Durchschnitt – Berechnet den Durchschnitt eines Tabellenausdrucks oder einer Reihe von Argumenten.
B
Zurück – Zeigt den vorherigen Bildschirm an.
Leer – Gibt einen leeren Wert zurück, der zum Einfügen eines NULL-Werts in ein Datenquelle verwendet werden kann.
boolesch – Wandelt eine Textzeichenfolge, Zahl oder einen nicht typisierten Wert in einen boolesch-Wert um.
C
Kalender – Ruft Informationen zum Kalender für das aktuelle Gebietsschema ab.
Char – Übersetzt einen Zeichencode in eine Zeichenfolge.
Auswahlmöglichkeiten – Gibt eine Tabelle mit den möglichen Werten für eine Nachschlagespalte zurück.
Löschen – Löscht alle Daten aus einer Sammlung.
ClearCollect – Löscht alle Daten aus einer Sammlung und fügt dann einen Satz von Datensätzen hinzu.
ClearData – Löscht eine Sammlung oder alle Sammlungen von einem App-Host, beispielsweise einem lokalen Gerät.
Uhr – Ruft Informationen zur Uhr für das aktuelle Gebietsschema ab.
Zusammenführen – Ersetzt leere Werte, während nicht-leere Werte unverändert bleiben.
Sammeln – Erstellt eine Sammlung oder fügt Daten zu einem Datenquelle hinzu.
Farbe – Legt eine Eigenschaft auf einen integrierten Farbwert fest.
ColorFade – Blendet einen Farbwert aus.
ColorValue – Übersetzt einen CSS Farbnamen oder einen Hex-Code in einen Farbwert.
Spalte – Ruft Spaltennamen und -werte aus einem nicht typisiertes Objekt-Datentyp ab.
ColumnNames – Ruft Spaltennamen und -werte aus einem nicht typisiertes Objekt-Datentyp ab.
Kompass – Gibt Ihre Kompassrichtung zurück.
Concat – Verkettet Zeichenfolgen in einem Datenquelle.
Verketten – Verkettet Zeichenfolgen.
Gleichzeitig – Bewertet mehrere Formeln gleichzeitig miteinander.
Verbindung – Gibt Informationen zu Ihrer Netzwerkverbindung zurück.
Kopieren – Kopiert Text in die Zwischenablage auf dem Gerät, auf dem die App ausgeführt wird.
Count – Zählt Tabellendatensätze, die Zahlen enthalten.
Cos – Gibt den Cosinus eines im Bogenmaß angegebenen Winkels zurück.
Cot – Gibt den Kotangens eines im Bogenmaß angegebenen Winkels zurück.
CountA – Zählt Tabellendatensätze, die nicht leer sind.
CountIf – Zählt Tabellendatensätze, die eine Bedingung erfüllen.
CountRows – Zählt Tabellendatensätze.
D
DataSourceInfo – Bietet Informationen zu einem Datenquelle.
Datum – Gibt einen Datums-/Uhrzeitwert basierend auf den Werten Jahr, Monat und Tag zurück.
DateAdd – Fügt einem Datums-/Uhrzeitwert Tage, Monate, Quartale oder Jahre hinzu.
DateDiff – Subtrahiert zwei Datumswerte und zeigt das Ergebnis in Tagen, Monaten, Quartalen oder Jahren an.
DateTime – Gibt einen Datums-/Uhrzeitwert zurück, der sowohl auf Datums- als auch auf Uhrzeitkomponenten basiert.
DateTimeValue – Wandelt eine Datums- und Uhrzeitzeichenfolge in einen Datums-/Uhrzeitwert um.
DateValue – Wandelt eine reine Datumszeichenfolge in einen Datums-/Uhrzeitwert um.
Tag – Ruft den Tagesteil eines Datums-/Uhrzeitwerts ab.
Dec2Hex – Wandelt eine Zahl in eine hexadezimale Textzeichenfolge um.
Defaults – Gibt die Standardwerte für ein Datenquelle zurück.
Grad – Wandelt Bogenmaß in Grad um.
Deaktivieren – Deaktiviert ein Signal, beispielsweise den Standort , zum Auslesen des GPS.
Distinct – Fasst die Datensätze einer Tabelle zusammen und entfernt Duplikate.
Download – Lädt eine Datei aus dem Internet auf das lokale Gerät herunter.
DropColumns – Gibt eine Tabelle zurück, aus der eine oder mehrere Spalten entfernt wurden.
E
EDate – Addiert oder subtrahiert Monate zu einem Datum, ohne den Tag des Monats zu ändern.
EditForm – Setzt ein Formularsteuerelement zum Bearbeiten eines Elements zurück.
Aktivieren – Aktiviert ein Signal, z. B. Standort , zum Auslesen des GPS.
EncodeHTML – Codiert Zeichen, die maskiert werden müssen, um in einem HTML-Kontext verwendet zu werden.
EncodeUrl – Codiert Sonderzeichen mithilfe der URL-Kodierung.
EndsWith – Überprüft, ob eine Textzeichenfolge mit einer anderen Textzeichenfolge endet.
EOMonth – Addiert oder subtrahiert Monate zu einem Datum und gibt den letzten Tag des jeweiligen Monats zurück.
Fehler – Erstellen Sie einen benutzerdefinierten Fehler oder leiten Sie einen Fehler weiter.
Fehler – Bietet Fehlerinformationen zu vorherigen Änderungen an einem Datenquelle.
exactin – Überprüft, ob eine Textzeichenfolge in einer anderen Textzeichenfolge oder Tabelle enthalten ist (Groß-/Kleinschreibung beachten). Wird auch verwendet, um zu überprüfen, ob sich ein Datensatz in einer Tabelle befindet.
Beenden – Beendet die aktuell ausgeführte App und meldet optional den aktuellen Benutzer ab.
Exp – Gibt e potenziert zurück.
F
Filter – Gibt eine gefilterte Tabelle basierend auf einem oder mehreren Kriterien zurück.
Find – Überprüft, ob eine Zeichenfolge in einer anderen vorkommt, und gibt die Position zurück.
First – Gibt den ersten Datensatz einer Tabelle zurück.
FirstN – Gibt den ersten Datensatzsatz (N Datensätze) einer Tabelle zurück.
ForAll – Berechnet Werte und führt Aktionen für alle Datensätze einer Tabelle aus.
G
GroupBy – Gibt eine Tabelle mit gruppierten Datensätzen zurück.
GUID – Wandelt eine GUID-Zeichenfolge in einen GUID-Wert um oder erstellt einen neuen GUID-Wert.
H
HashTags – Extrahiert die Hashtags (#strings) aus einem String.
Hex2Dec – Wandelt eine hexadezimale Textzeichenfolge in eine Zahl um.
Host – Bietet Informationen über den aktuellen Host, auf dem die App ausgeführt wird.
Stunde – Gibt den Stundenanteil eines Datums-/Uhrzeitwerts zurück.
I
If – Gibt einen Wert zurück, wenn eine Bedingung erfüllt ist, und einen anderen Wert, wenn nicht.
IfError – Erkennt Fehler und bietet einen alternativen Wert oder ergreift Maßnahmen.
in – Überprüft, ob eine Textzeichenfolge in einer anderen Textzeichenfolge oder Tabelle enthalten ist, unabhängig von der Groß-/Kleinschreibung. Wird auch verwendet, um zu überprüfen, ob sich ein Datensatz in einer Tabelle befindet.
Index – Gibt einen Datensatz aus einer Tabelle basierend auf der geordneten Position zurück.
Int – Rundet auf die nächste Ganzzahl ab.
IsBlank – Prüft auf einen leeren Wert.
IsBlankOrError – Prüft, ob ein leerer Wert oder ein Fehler vorliegt.
IsEmpty – Prüft, ob die Tabelle leer ist.
IsError – Prüft, ob ein Fehler vorliegt.
IsMatch – Überprüft eine Zeichenfolge anhand eines Musters. Reguläre Ausdrücke können verwendet werden.
IsNumeric – Überprüft, ob ein numerischer Wert vorliegt.
ISOWeekNum – Gibt die ISO-Wochennummer eines Datums-/Uhrzeitwerts zurück.
IsToday – Überprüft, ob ein Datums-/Uhrzeitwert irgendwann heute in der Zeitzone des Benutzers liegt.
IsType – Überprüft, ob sich eine Datensatzreferenz auf einen bestimmten Tabellentyp bezieht.
IsUTCToday – Überprüft, ob ein Datums-/Uhrzeitwert irgendwann heute in der koordinierten Weltzeit (UTC) liegt.
J
JSON – Generiert eine JSON-Textzeichenfolge für eine Tabelle, einen Datensatz oder einen Wert.
L
Sprache – Gibt das Sprachtag des aktuellen Benutzers zurück.
Last – Gibt den letzten Datensatz einer Tabelle zurück.
LastN – Gibt den letzten Datensatzsatz (N Datensätze) einer Tabelle zurück.
Starten – Startet eine Webseite oder eine Canvas-App.
Left – Gibt den äußersten linken Teil einer Zeichenfolge zurück.
Len – Gibt die Länge einer Zeichenfolge zurück.
Ln – Gibt den natürlichen Logarithmus zurück.
LoadData – Lädt eine Sammlung von einem App-Host, beispielsweise einem lokalen Gerät.
Standort – Gibt Ihren Standort als Kartenkoordinaten zurück, indem das Global Positioning System (GPS) und andere Informationen verwendet werden.
Log – Gibt den Logarithmus einer Zahl in jeder Basis zurück.
LookUp – Sucht anhand eines oder mehrerer Kriterien nach einem einzelnen Datensatz in einer Tabelle.
Kleinbuchstaben – Wandelt die Buchstaben einer Textzeichenfolge vollständig in Kleinbuchstaben um.
M
Match – Extrahiert eine Teilzeichenfolge basierend auf einem Muster. Reguläre Ausdrücke können verwendet werden.
MatchAll – Extrahiert mehrere Teilzeichenfolgen basierend auf einem Muster. Reguläre Ausdrücke können verwendet werden.
Max – Maximalwert eines Tabellenausdrucks oder einer Reihe von Argumenten.
Mid – Gibt den mittleren Teil einer Zeichenfolge zurück.
Min – Mindestwert eines Tabellenausdrucks oder einer Reihe von Argumenten.
Minute – Ruft den Minutenanteil eines Datums-/Uhrzeitwerts ab.
Mod – Gibt den Rest zurück, nachdem ein Dividend durch einen Divisor geteilt wurde.
Monat – Ruft den Monatsteil eines Datums-/Uhrzeitwerts ab.
N
Navigieren – Ändert, welcher Bildschirm angezeigt wird.
NewForm – Setzt ein Formularsteuerelement zum Erstellen eines Elements zurück.
Nicht – boolesch logisches NICHT. Gibt TRUE zurück, wenn für das Argument FALSE gilt, und FALSE wenn für das Argument TRUE gilt. Sie können auch den !-Operator verwenden.
Benachrichtigen – Zeigt dem Benutzer eine Bannernachricht an.
Jetzt – Gibt den aktuellen Datums-/Uhrzeitwert in der Zeitzone des Benutzers zurück.
O
Oder – boolesch logisches ODER. Gibt TRUE zurück, wenn für eines der Argumente TRUE gilt. Sie können auch den ||-Operator verwenden.
P
Param – Zugriffsparameter, die beim Start an eine Canvas-App übergeben werden.
übergeordnetes Element – Bietet Zugriff auf die Eigenschaften eines Containersteuerelements.
ParseJSON – Konvertiert ein als Text dargestelltes JSON-Dokument in einen nicht typisiertes Objekt Wert.
Patch – Ändert oder erstellt einen Datensatz in einem Datenquelle oder führt Datensätze außerhalb eines Datenquelle zusammen.
PDF – Exportieren Sie Inhalte des aktuellen Bildschirms in ein Objekt zur Verwendung in mehreren Szenarien.
Pi – Gibt die Zahl π zurück.
PlainText – Entfernt HTML- und XML-Tags aus einer Zeichenfolge.
Potenz – Gibt eine potenzierte Zahl zurück. Sie können auch den ^-Operator verwenden.
Proper – Wandelt den ersten Buchstaben jedes Wortes in einer Zeichenfolge in einen Großbuchstaben und den Rest in Kleinbuchstaben um.
R
Radiant – Wandelt Grad in Radiant um.
Rand – Gibt eine pseudozufällige Zahl zwischen 0 und 1 zurück.
RandBetween – Gibt eine pseudozufällige Zahl zwischen zwei Zahlen zurück.
ReadNFC – Liest einen Near Field Communication (NFC)-Tag.
RecordInfo – Bietet Informationen zu einem Datensatz von Datenquelle.
Aktualisieren – Aktualisiert die Datensätze eines Datenquelle.
Relate – Verbindet Datensätze zweier Tabellen über eine Eins-zu-viele- oder Viele-zu-viele-Beziehung.
Entfernen – Entfernt einen oder mehrere bestimmte Datensätze aus einem Datenquelle.
RemoveIf – Entfernt Datensätze aus einem Datenquelle basierend auf einer Bedingung.
RenameColumns – Benennt Spalten einer Tabelle um.
Ersetzen – Ersetzt einen Teil einer Zeichenfolge durch eine andere Zeichenfolge, indem die Startposition der Zeichenfolge festgelegt wird.
RequestHide – Blendet ein SharePoint Formular aus.
Zurücksetzen – Setzt ein Eingabesteuerelement auf seinen Standardwert zurück und verwirft alle Benutzeränderungen.
ResetForm – Setzt ein Formularsteuerelement zum Bearbeiten eines vorhandenen Elements zurück.
wiederherstellen – Lädt die Datensätze eines Datenquelle neu und löscht Fehler.
RGBA – Gibt einen Farbwert für eine Reihe von Rot-, Grün-, Blau- und Alphakomponenten zurück.
Rechts – Gibt den äußersten rechten Teil einer Zeichenfolge zurück.
Runden – Rundet auf die nächste Zahl.
RoundDown – Rundet auf die größte vorherige Zahl ab.
RoundUp – Rundet auf die kleinste nächste Zahl auf.
S
SaveData – Speichert eine Sammlung auf einem App-Host, beispielsweise einem lokalen Gerät.
Suchen – Sucht Datensätze in einer Tabelle, die in einer ihrer Spalten eine Zeichenfolge enthalten.
Sekunde – Ruft den zweiten Teil eines Datums-/Uhrzeitwerts ab.
Auswählen – Simuliert eine Auswählen-Aktion für ein Steuerelement, wodurch die Formel OnSelect ausgewertet wird.
Self – Bietet Zugriff auf die Eigenschaften des aktuellen Steuerelements.
Sequenz – Generiert eine Tabelle mit fortlaufenden Nummern, nützlich bei der Iteration mit ForAll.
SendAppNotification (Vorschauversion) – Senden Sie eine In-App-Benachrichtigung mit optionalen Aktionen an einen Empfänger.
Set – Legt den Wert einer globalen Variablen fest.
SetFocus – Verschiebt den Eingabefokus auf ein bestimmtes Steuerelement.
SetProperty – Simuliert Interaktionen mit Eingabesteuerelementen.
ShowColumns – Gibt eine Tabelle mit nur ausgewählten Spalten zurück.
ShowHostInfo – Zeigt dem Benutzer Informationen in der App an.
Shuffle – Ordnet die Datensätze einer Tabelle nach dem Zufallsprinzip neu an.
Sin – Gibt den Sinus eines im Bogenmaß angegebenen Winkels zurück.
Sortieren – Gibt eine sortierte Tabelle basierend auf einer Formel zurück.
SortByColumns – Gibt eine sortierte Tabelle basierend auf einer oder mehreren Spalten zurück.
Teilen – Teilt eine Textzeichenfolge in eine Tabelle mit Teilzeichenfolgen auf.
Sqrt – Gibt die Quadratwurzel einer Zahl zurück.
StartsWith – Überprüft, ob eine Textzeichenfolge mit einer anderen Textzeichenfolge beginnt.
StdevP – Gibt die Standardabweichung seiner Argumente zurück.
Ersetzen – Ersetzt einen Teil einer Zeichenfolge durch eine andere Zeichenfolge, indem die Zeichenfolgen abgeglichen werden.
SubmitForm – Speichert das Element in einem Formularsteuerelement in Datenquelle.
Summe – Berechnet die Summe eines Tabellenausdrucks oder einer Reihe von Argumenten.
Switch – Gleicht einen Satz von Werten ab und wertet dann eine entsprechende Formel aus.
T
Tabelle – Erstellt eine temporäre Tabelle.
Tan – Gibt den Tangens eines im Bogenmaß angegebenen Winkels zurück.
Text – Wandelt jeden Wert um und formatiert einen Zahlen- oder Datums-/Uhrzeitwert in eine Textzeichenfolge.
ThisItem – Gibt den Datensatz für das aktuelle Element in einer Galerie oder einem Formularsteuerelement zurück.
ThisRecord : Gibt den Datensatz für das aktuelle Element in einer Datensatzbereichsfunktion zurück, z. B. ForAll, With und Sum.
Zeit – Gibt einen Datums-/Uhrzeitwert basierend auf den Werten Stunde, Minute und Sekunde zurück.
TimeValue – Wandelt eine reine Uhrzeitzeichenfolge in einen Datums-/Uhrzeitwert um.
TimeZoneOffset – Gibt die Differenz zwischen UTC und der Ortszeit des Benutzers in Minuten zurück.
Heute – Gibt den aktuellen Nur-Datum-Wert zurück.
Trace – Geben Sie in Ihren Testergebnissen zusätzliche Informationen an.
Trimmen – Entfernt zusätzliche Leerzeichen an den Enden und im Inneren einer Textzeichenfolge.
TrimEnds – Entfernt zusätzliche Leerzeichen nur am Ende einer Textzeichenfolge.
Trunc : Kürzt die Zahl auf den ganzzahligen Teil, indem alle Dezimalteile entfernt werden.
U
Gruppierung aufheben – Entfernt eine Gruppierung.
UniChar – Übersetzt einen Unicode-Code in eine Zeichenfolge.
Aufheben der Verknüpfung – Hebt die Verknüpfung von Datensätzen zweier Tabellen aus einer Eins-zu-viele- oder Viele-zu-viele-Beziehung auf.
Update – Ersetzt einen Datensatz in einem Datenquelle.
UpdateContext – Legt den Wert einer oder mehrerer Kontextvariablen des aktuellen Bildschirms fest.
UpdateIf – Ändert einen Datensatzsatz in einem Datenquelle basierend auf einer Bedingung.
Großbuchstaben – Wandelt die Buchstaben einer Textzeichenfolge in Großbuchstaben um.
Benutzer – Gibt Informationen zum aktuellen Benutzer zurück.
UTCNow – Gibt den aktuellen Datums-/Uhrzeitwert in koordinierter Weltzeit (UTC) zurück.
UTCToday – Gibt den aktuellen Datumswert in der koordinierten Weltzeit (UTC) zurück.
V
Validieren – Überprüft, ob der Wert einer einzelnen Spalte oder eines kompletten Datensatzes für ein Datenquelle gültig ist.
Wert – Wandelt eine Zeichenfolge in eine Zahl um.
VarP – Gibt die Varianz seiner Argumente zurück.
ViewForm – Setzt ein Formularsteuerelement zum Anzeigen eines vorhandenen Elements zurück.
W
Wochentag – Ruft den Wochentagsteil eines Datums-/Uhrzeitwerts ab.
WeekNum – Gibt die Wochennummer eines Datums-/Uhrzeitwerts zurück.
Mit – Berechnet Werte und führt Aktionen für einen einzelnen Datensatz aus, einschließlich Inline-Datensätzen benannter Werte.
Y
Jahr – Ruft den Jahresteil eines Datums-/Uhrzeitwerts ab.