Odwołanie do formuły — aplikacje kanwy
W tym artykule zapoznasz się ze wszystkimi dostępnymi funkcjami w aplikacjach kanwy.
Formuły w aplikacjach kanwy mogą łączyć wiele elementów. Poniżej wymieniono:
- Funkcje – przyjmują parametry, wykonują operację i zwracają wartość. Na przykład funkcja Sqrt(25) zwraca wartość 5. Funkcje są modelowane podobnie do funkcji w Microsoft Excel. Niektóre funkcje mają skutki uboczne, na przykład funkcje takie jak SubmitForm, które są odpowiednie tylko w przypadku formuł zachowania, takich jak Button.OnSelect.
- Sygnały – zwracają informacje o środowisku. Na przykład Location zwraca bieżące współrzędne GPS urządzenia. Sygnały nie przyjmują parametrów ani nie mają efektów ubocznych.
- Wyliczenia – zwracają wstępnie zdefiniowane wartości stałe. Na przykład Color jest wyliczeniem, które ma wstępnie zdefiniowane wartości dla Color.Red, Color.Blue itd. Obejmuje to typowe wyliczenia. Wyliczenia właściwe dla funkcji opisano w ramach funkcji.
- Operatory nazwane, takie jak ThisItem i Self — zapewniają dostęp do informacji z poziomu kontenera.
Inne elementy obejmują:
A
Abs – wartość bezwzględna liczby.
Acceleration – odczytuje czujnik przyspieszenia w urządzeniu.
Acos – zwraca arcus cosinus liczby, w radianach.
Acot – zwraca arcus cotangens liczby, w radianach.
AddColumns – zwraca tabelę z dodanymi kolumnami.
And – operator logiczny AND. Zwraca wartość true, jeśli wszystkie argumenty mają wartość true. Można również użyć operatora &&.
AIClassify – klasyfikuje tekst w jedną z podanych kategorii.
AIExtract – wyodrębnia określone encje, takie jak numery rejestracji, numery telefonów lub nazwy osób.
AIReply – przygotowuje odpowiedź na podaną wiadomość.
AISentiment – wykrywa tonację podanego tekstu.
AISummarize – podsumowuje podany tekst.
AITranslate – tłumaczy tekst z innego języka.
App – udostępnia informacje o obecnie uruchomionej aplikacji i zapewnia kontrolę nad zachowaniem aplikacji.
Asin – zwraca arcus sinus liczby, w radianach.
Assert – wynikiem testu jest wartość true lub false.
As – Nazywa bieżący rekord w funkcjach galerii, formularza i zakresu rekordów, takich jak ForAll, With i Sum.
AsType — traktuje odwołanie do rekordu jako określony typ tabeli.
Atan – zwraca arcus tangens liczby, w radianach.
Atan2 – zwraca arcus tangens na podstawie współrzędnych (x,y), w radianach.
Average – oblicza średnią wyrażenia tabeli lub zestawu argumentów.
B
Back – wyświetla poprzedni ekran.
Blank – zwraca wartość pustą, którą można użyć, aby wstawić wartość NULL do źródła danych.
Wartość logiczna – Konwertuje ciąg tekstowy, liczbę lub niewpisaną wartość na wartość logiczną.
C
Calendar – pobiera informacje o bieżących ustawieniach regionalnych kalendarza.
Char – przekształca kod znaku w ciąg.
Choices – zwraca tabelę zawierającą możliwe wartości kolumny odnośnika.
Clear – usuwa wszystkie dane z kolekcji.
ClearCollect – usuwa wszystkie dane z kolekcji, a następnie dodaje zestaw rekordów.
ClearData — czyści kolekcję lub wszystkie zbiory z aplikacji hosta, takiego jak urządzenie lokalne.
Clock – pobiera informacje o bieżących ustawieniach regionalnych zegara.
Coalesce – zastępuje puste wartości, pozostawiając wartości inne niż puste bez zmian.
Collect – tworzy kolekcję lub dodaje dane do źródła danych.
Color – ustawia właściwość na wbudowaną wartość koloru.
ColorFade – powoduje zanikanie wartości koloru.
ColorValue – przekształca kod szesnastkowy lub nazwę koloru CSS na wartość koloru.
Column – Pobiera nazwy i wartości kolumn z typu danych Obiekt bez typu.
ColumnNames – Pobiera nazwy i wartości kolumn z typu danych Obiekt bez typu.
Compass – zwraca kierunek wskazywany przez kompas.
Concat – łączy ciągi w źródle danych.
Concatenate – łączy ciągi.
Concurrent – oblicza wiele formuł jednocześnie.
Connection – zwraca informacje dotyczące połączenia sieciowego.
Kopiuj – kopiuje tekst do schowka na urządzeniu, w którym uruchomiona jest aplikacja.
Count – zlicza rekordy tabeli zawierające liczby.
Cos – zwraca cosinus kąta określonego w radianach.
Cot – zwraca cotangens kąta określonego w radianach.
CountA – zlicza rekordy tabeli, które nie są puste.
CountIf – zlicza rekordy tabeli, które spełniają warunek.
CountRows – zlicza rekordy tabeli.
D
DataSourceInfo – udostępnia informacje dotyczące źródła danych.
Date – zwraca wartość daty/godziny na podstawie wartości Year, Month i Day.
DateAdd – dodaje dni, miesiące, kwartały lub lata do wartości daty/godziny.
DateDiff – odejmuje dwie wartości daty i wyświetla wynik w dniach, miesiącach, kwartałach lub latach.
DateTime – zwraca wartość daty/godziny na podstawie składników daty i godzin.
DateTimeValue – konwertuje ciąg daty i godziny na wartość daty/godziny.
DateValue – konwertuje ciąg daty na wartość daty/godziny.
Day – pobiera część dotyczącą dnia z wartości daty/godziny.
Dec2Hex – konwertuje liczbę na szesnastkowy ciąg tekstowy.
Defaults – zwraca wartości domyślne źródła danych.
Degrees – konwertuje wartość w radianach na wartość w stopniach.
Disable – wyłącza sygnał, np. Location do odczytu GPS.
Distinct – sumuje rekordy tabeli, usuwając duplikaty.
Download – pobiera plik z Internetu na urządzenie lokalne.
DropColumns – zwraca tabelę z co najmniej jedną usuniętą kolumną.
E
EDate – dodaje lub odejmuje miesiące do daty bez zmiany dnia miesiąca.
EditForm – resetuje kontrolkę formularza do edycji elementu.
Enable – włącza sygnał, np. Location do odczytu GPS.
EncodeHTML — koduje znaki, które muszą być zakodowane i używane w kontekście HTML.
EncodeUrl – koduje znaki specjalne przy użyciu kodowania adresu URL.
EndsWith – sprawdza, czy ciąg tekstowy kończy się innym ciągiem tekstowym.
EOMonth – dodaje lub odejmuje miesiące do daty, zwraca ostatni dzień tego miesiąca.
Error — tworzenie błędu niestandardowego lub podanie błędu.
Errors – udostępnia informacje o błędach wcześniejszych zmian źródła danych.
exactin – Sprawdza, czy ciąg tekstowy znajduje się w innym ciągu tekstowym lub tabeli, w zależności od wielkości liter. Służy również do sprawdzania, czy rekord znajduje się w tabeli.
Exit – wyjście z obecnie uruchomionej aplikacji i może dodatkowo wyrejestrować bieżącego użytkownika.
Exp – Zwraca liczbę e podniesioną do potęgi
F
Filter – zwraca tabelę filtrowaną na podstawie jednego lub większej liczby kryteriów.
Find – sprawdza, czy jeden ciąg występuje w innym i zwraca lokalizację.
First – zwraca pierwszy rekord tabeli.
FirstN – zwraca pierwszy zestaw rekordów (N rekordów) tabeli.
ForAll – oblicza wartości i wykonuje akcje dla wszystkich rekordów tabeli.
G
GroupBy – zwraca tabelę z pogrupowanymi rekordami.
GUID – konwertuje ciąg identyfikatora GUID na wartość identyfikatora GUID lub tworzy nową wartość identyfikatora GUID.
H
HashTags – wyodrębnia hasztagi (ciągi#) z ciągu tekstowego.
Hex2Dec – konwertuje liczbę szesnastkową na liczbę dziesiętną.
Host — zawiera informacje o bieżącym hoście, na który działa aplikacja.
Hour – zwraca część dotyczącą godziny z wartości daty/godziny.
I
If – zwraca jedną wartość, jeśli warunek jest spełniony, a inną wartość, gdy nie.
IfError – wykrywa błędy i podaje wartość alternatywną lub wykonuje działanie.
in – Sprawdza, czy ciąg tekstowy znajduje się w innym ciągu tekstowym lub tabeli, niezależnie od wielkości liter. Służy również do sprawdzania, czy rekord znajduje się w tabeli.
Index — zwraca rekord z tabeli na podstawie uporządkowanej pozycji.
Int – Zaokrągla wartość w dół do najbliższej liczby całkowitej.
IsBlank – sprawdza pod kątem wartości blank.
IsBlankOrError — sprawdza, czy wartość lub błąd jest blank.
IsEmpty – sprawdza pod kątem pustej tabeli.
IsError – sprawdzenie, czy wystąpił błąd.
IsMatch – sprawdza ciąg względem wzorca. Możliwość używania wyrażeń regularnych.
IsNumeric – sprawdza pod kątem wartości liczbowej.
ISOWeekNum – zwraca numer tygodnia ISO wartości daty/godzin.
IsToday — sprawdza, czy wartość data/godzina jest dzisiejsza w strefie czasowej użytkownika.
IsType — sprawdza, czy odwołanie do rekordu odwołuje się do określonego typu tabeli.
IsUTCToday — sprawdza, czy wartość data/godzina jest dzisiejsza w uniwersalnym czasie koordynowanym (UTC).
J
JSON – generuje ciąg tekstowy JSON dla tabeli, rekordu lub wartości.
L
Language – zwraca tag języka bieżącego użytkownika.
Last – zwraca ostatni rekord tabeli.
LastN – zwraca ostatni zestaw rekordów (N rekordów) tabeli.
Launch – uruchamia stronę sieci Web lub aplikację kanwy.
Left – zwraca część najdalej z lewej strony ciągu.
Len – zwraca długość ciągu.
Ln – zwraca logarytm naturalny.
LoadData — Ładuje kolekcję z hosta aplikacji, takiego jak urządzenie lokalne.
Location – zwraca Twoją lokalizację w postaci współrzędnych geograficznych z użyciem globalnego systemu pozycjonowania GPS i innych informacji.
Log — zwraca logarytm w dowolnej bazie liczby.
LookUp – wyszukuje pojedynczy rekord w tabeli na podstawie jednego lub większej liczby kryteriów.
Lower – konwertuje litery w ciągu tekstowym na małe litery.
M
Match – wyodrębnia ciąg podrzędny na podstawie wzorca. Możliwość używania wyrażeń regularnych.
MatchAll – wyodrębnia wiele ciągów podrzędnych na podstawie wzorca. Możliwość używania wyrażeń regularnych.
Max – wartość maksymalna wyrażenia tabeli lub zestawu argumentów.
Mid – zwraca środkową część ciągu.
Min – wartość minimalna wyrażenia tabeli lub zestawu argumentów.
Minute – pobiera część dotyczącą minut z wartości daty/godziny.
Mod – zwraca resztę z dzielenia dzielnej przez dzielnik.
Month – pobiera część dotyczącą miesiąca z wartości daty/godziny.
N
Navigate – zmienia wyświetlany ekran.
NewForm – resetuje kontrolkę formularza do tworzenia elementu.
Not – operator logiczny NOT. Zwraca wartość true, jeśli jej argument ma wartość false, albo zwraca wartość false, jeśli jej argument ma wartość true. Można również użyć operatora !.
Notify – wyświetla komunikat bannera dla użytkownika.
Now — zwraca bieżącą wartość daty/godzin w strefie czasowej użytkownika.
O
Or – operator logiczny OR. Zwraca wartość prawda, jeśli dowolny z jej argumentów ma wartość prawda. Można również użyć || operatora.
P
Param – parametry dostępu przekazane do aplikacji kanwy podczas uruchamiania programu.
Parent – zapewnia dostęp do właściwości kontrolki kontenera.
ParseJSON — Konwertuje dokument JSON reprezentowany jako tekst na wartość obiektu bez typu.
Patch – modyfikuje lub tworzy co najmniej jeden rekord w źródle danych, a także scala rekordy poza źródłem danych.
PDF — eksport zawartości z bieżącego ekranu do obiektu w celu użycia w kilku scenariuszach.
Pi – zwraca liczbę π.
PlainText – usuwa tagi HTML i XML z ciągu.
Power – zwraca liczbę podniesioną do potęgi. Można również użyć ^ operatora.
Proper – konwertuje pierwszą literę każdego wyrazu w ciągu na wielką literę, a pozostałe litery na małe litery.
R
Radians – konwertuje stopnie na radiany.
Rand – Zwraca losową liczbę z od 0 do 1.
RandBetween – Zwraca liczbę pseudolosową między dwiema liczbami.
ReadNFC — odczytuje tag NFC (Near Field Communication).
RecordInfo — Udostępnia informacje dotyczące rekordu źródła danych.
Refresh – odświeża rekordy źródła danych.
Relate — wiąże rekordy dwóch tabel za pomocą relacji jeden-do-wielu lub wiele-do-wielu.
Remove – usuwa jeden lub więcej określonych rekordów ze źródła danych.
RemoveIf – usuwa rekordy ze źródła danych na podstawie warunku.
RenameColumns – umożliwia zmianę nazw kolumn w tabeli.
Replace – zastępuje część ciągu innym ciągiem, uwzględniając pozycję początkową w ciągu.
RequestHide — ukrywa formularz SharePoint.
Reset – resetuje kontrolkę wejściową do jej wartości domyślnej przez odrzucenie zmian wprowadzonych przez użytkownika.
ResetForm – resetuje kontrolkę formularza do edycji istniejącego elementu.
Revert – ładuje ponownie rekordy źródła danych i czyści błędy.
RGBA – zwraca wartość koloru zestawu składników: czerwony, zielony, niebieski i kanału alfa.
Right – zwraca część najdalej z prawej strony ciągu.
Round – zaokrągla do najbliższej liczby.
RoundDown – zaokrągla w dół do poprzedzającej największej liczby.
RoundUp – zaokrągla w górę do kolejnej najmniejszej liczby.
S
SaveData — Zapisuje kolekcję na hoście aplikacji, takim jak urządzenie lokalne.
Search – znajduje w tabeli rekordy, które w jednej z kolumn zawierają podany ciąg.
Second – pobiera część dotyczącą sekund z wartości daty/godziny.
Select – symuluje akcję wybierania kontrolki, co powoduje obliczenie wartości formuły OnSelect.
Self — umożliwia uzyskanie dostępu do właściwości bieżącej kontrolki.
Sequence — generuje tabelę kolejnych liczb, przydatną podczas iteracji z ForAll.
SendAppNotification (wersja zapoznawcza) — wysłanie powiadomienia w aplikacji z opcjonalnymi akcjami do adresata.
Set – ustawia wartość zmiennej globalnej.
SetFocus – przenosi fokus wprowadzania na określoną kontrolkę.
SetProperty — symuluje interakcje z kontrolkami wejściowymi.
ShowColumns – zwraca tabelę zawierającą tylko wybrane kolumny.
ShowHostInfo — wyświetla informacje użytkownikowi w aplikacji.
Shuffle – losowo zmienia kolejność rekordów tabeli.
Sin – zwraca sinus kąta określonego w radianach.
Sort – zwraca posortowaną tabelę na podstawie formuły.
SortByColumns – zwraca posortowaną tabelę na podstawie jednej kolumny lub większej liczby kolumn.
Split – dzieli ciąg tekstowy na tabelę podciągów.
Sqrt – zwraca pierwiastek kwadratowy z liczby.
StartsWith – sprawdza, czy ciąg tekstowy zaczyna się innym ciągiem tekstowym.
StdevP – zwraca odchylenie standardowe argumentów.
Substitute – zastępuje część ciągu innym ciągiem, uwzględniając pasujące ciągi.
SubmitForm – zapisuje element kontrolki formularza do źródła danych.
Sum – oblicza sumę wyrażenia tabeli lub zestawu argumentów.
Switch – dopasowuje do zestawu wartości, a następnie oblicza odpowiednią formułę.
T
Table – tworzy tymczasową tabelę.
Tan – zwraca tangens kąta określonego w radianach.
Text – konwertuje wartość i formatuje liczbę lub wartość daty/godziny na ciąg tekstowy.
ThisItem — zwraca rekord bieżącego elementu w galerii lub kontrolce formularza.
ThisRecord – Zwraca rekord dla bieżącego elementu w funkcji zakresu rekordów, takiej jak ForAll, With i Sum.
Time – zwraca wartość daty/godziny na podstawie wartości Hour, Minute i Second.
TimeValue – konwertuje ciąg godziny na wartość daty/godziny.
TimeZoneOffset – zwraca różnicę między czasem UTC a czasem lokalnym użytkownika w minutach.
Today — zwraca bieżącą wartość tylko daty.
Trace – podaj dodatkowe informacje w wynikach testu.
Trim – usuwa dodatkowe spacje z końca i wewnętrznej części ciągu tekstowego.
TrimEnds – usuwa dodatkowe spacje tylko z końca ciągu tekstowego.
Trunc – Obcina liczbę tylko do części całkowitej, usuwając część dziesiętną.
U
Ungroup – usuwa grupowanie.
UniChar – przekształca kod Unicode w ciąg.
Unrelate — usuwa powiązania rekordów dwóch tabel z relacji jeden-do-wielu lub wiele-do-wielu.
Update – zastępuje rekord w źródle danych.
UpdateContext – ustawia wartość co najmniej jednej zmiennej kontekstowej bieżącego ekranu.
UpdateIf – modyfikuje zestaw rekordów w źródle danych na podstawie warunku.
Upper – konwertuje litery w ciągu tekstowym na wielkie litery.
User – zwraca informacje o bieżącym użytkowniku.
UTCNow — zwraca bieżącą wartość daty/godzin w uniwersalnym czasie koordynowanym (UTC).
UTCToday — zwraca bieżącą wartość tylko daty w uniwersalnym czasie koordynowanym (UTC).
V
Validate – sprawdza, czy wartość pojedynczej kolumny lub pełnego rekordu jest prawidłowa dla danego źródła danych.
Value – konwertuje ciąg tekstowy na liczbę.
VarP – zwraca wariancję argumentów.
ViewForm – resetuje kontrolkę formularza do podglądu istniejącego elementu.
W
Weekday – pobiera część dotyczącą dnia tygodnia z wartości daty/godziny.
WeekNum – zwraca numer tygodnia wartości daty/godzin.
With – oblicza wartości i wykonuje akcje dla pojedynczego rekordu, łącznie z wbudowanymi rekordami nazwanych wartości.
Y
Year – pobiera część dotyczącą roku z wartości daty/godziny.