Informacje dotyczące formuł – Power Apps

W tym artykule zapoznasz się ze wszystkimi dostępnymi funkcjami w usłudze Power Apps.

Formuły w Power Apps 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 &&.

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.

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.

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.