Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


Używanie usługi Power Fx w aplikacji Power Pages (wersja zapoznawcza)

[Ten temat stanowi wstępną wersję dokumentacji i może ulec zmianie].

Power Fx to język niskokodowy wyrazu logiki w całym programie Microsoft Power Platform. Jest to ogólny, dobrze wpisany, deklaracyjny i funkcjonalny język programowania.

Power Fx jest wyrażany w przyjaznym użytkownikowi formacie tekstowym. Jest to język niskokodowy, z którym można pracować bezpośrednio w pasku formuł lub w oknie tekstowym, podobnie jak w programie Code lub w programie Excel. Określenie „niska zawartość kodu” wynika z tego, że jest to prosty i zwięzły język, co ułatwia tworzenie typowych zadań programistycznych zarówno deweloperom, jak i twórcom.

Uwaga

Składnia formuły do tworzenia Power Fx może być nieco inna niż może być używana w Power Apps lub Power Automate. Aby zainicjować wyrażenie Power Fx, musi ono zaczynać się od znaku „=” (znak równości), tak jak w programie Excel. Aby uzyskać więcej informacji, zobacz Ważne zmiany.

Program Power Fx umożliwia pełne możliwości projektowania od twórców kodu bez konieczności programowania po pro-code dla profesjonalnych deweloperów. Ułatwia współpracę między zespołami, co pozwala im zaoszczędzić czas i nakład pracy.

Ważne

  • Jest to funkcja w wersji zapoznawczej.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.
  • Ta funkcja jest dostępna z wersji Power Pages 9.6.5.x.

Użyj Power Fx w Power Pages

W witrynie Power Pages sieci Power Fx jest dostępny jako język wyrażenia używany z następującymi składnikami i ich atrybutami. Ta funkcja ułatwia dynamiczne przypisywanie wartości w zależności od wyników wykonania zadania Power Fx .

Składnik Właściwości
Tekst Tekst
Image Tekst alternatywny, adres URL dla obrazu.
Button Tekst przycisku, adres URL przycisku
Ramka iFrame Adres URL ramki iFrame

Używanie paska formuł Power Fx

Pasek narzędzi zawiera nowe polecenie fx dla składników obsługujących Power Fx:

Zrzut ekranu polecenia Power Fx na pasku poleceń formantu tekstu.

Wybierz fx, aby uzyskać dostęp do paska Power Fx formuł.

Składniki paska formuły

Na poniższych zrzutach ekranu przedstawiono niektóre ważne składniki paska formuł:

Zrzut ekranu paska formuł Power Fx w programie Power Pages.

  1. Menu rozwijane umożliwia wybór spośród dostępnych właściwości składnika.

  2. Wieloliniowa, rozszerzana skrzynka tekstowa umożliwia tworzenie formuł Power Fx .

  3. Przycisk Zresetuj ustawia właściwość składnika na domyślną.

  4. Przycisk Zapisz utrwala formułę i właściwość składnika. Kanwa studio jest natychmiast aktualizowana, jeśli wynikowa wartość jest dostępna i można ją wyświetlać, na przykład we właściwościach tekstu.

Środowisko paska formuły

Oto kilka funkcji cennych dla deweloperów w celu zwiększenia wydajności:

  • Pomoc podczas autocomplete: sugeruje formuły, parametry, tabele i obiekty. Aby ręcznie uzyskać dostęp do tej funkcji, wybierz Ctrl + spacja.

    Zrzut ekranu przedstawiający środowisko autouzupełniania w aplikacji Power Fx.

  • Wyświetlanie funkcji problemów: pomaga we wczesnym sprawdzaniu poprawności i debugowaniu formuł oraz wykrywania błędów.

    Zrzut ekranu przedstawiający sposób, w którym problem jest wykrywany w formułie Power Fx .

  • Okno dialogowe Niezapisane zmiany: jest wyświetlane w przypadku przechodzenia z paska formuł w przypadku niezapisanych zmian w formule.

    Zrzut ekranu okna dialogowego niezapisanych zmian z opcjami powrotu lub odrzuć.

    Wybierz Wróć, aby dalej edytować formułę lub Odrzuć, aby odrzucić zmiany.

Ważne uwagi

Podczas korzystania z paska formuły Power Fx należy wziąć pod uwagę następujące wskazówki Power Pages

  • Rozpocznij od znaku równości: Tekst można wprowadzić bezpośrednio jako wartość. Aby jednak rozpocząć wyrażenie Power Fx , jego rozpoczęcie powinno zaczynać się od wartości "=" (znak równości), na przykład w poniższym przykładzie.

    =Concatenate("Hello, ", User.FullName)
    
  • Bezpieczny dostęp do tabel: bezpieczny dostęp do tabel Dataverse jest możliwy za pomocą formuł. Najpierw należy sprawdzić, czy uprawnienia dotyczące tabel zostały odpowiednio skonfigurowane. Ponadto przy użyciu obiektu Użytkownik jest dostępny kontekst witryny. Na przykład następujące wyrażenie pobiera wartość DatauserId aktualnie uwierzytelnionego użytkownika.

    =Concatenate("Hello, ", First(Filter(Contacts,Contact = User.DataverseUserId)).'First Name' & "!")
    

    Uwaga

    Obiekt Użytkownik reprezentuje użytkownika, przez Power Pages co nie obsługuje tego samego zestawu właściwości co funkcja Użytkownik.

  • Wstawianie wartości do tekstu: Aby wstawić wartość do tekstu, należy użyć następującej składni.

    This text ${variable/ expression} includes a dynamic value.
    

    Na przykład:

    The total number is ${Sum(10, 20)}
    

Dostępne funkcje Power Fx

Aby zapoznać się z kompletną listą funkcji aplikacji dla Power Pages, wybierz opcję odsyłacz do formuły Power Pages.

Znane problemy i ograniczenia

  • Niektóre Power Fx funkcje przedstawiane za pośrednictwem aplikacji IntelliSense nie są obecnie obsługiwane Power Pages. Gdy są używane te funkcje, są wyświetlane następujące błędy czasu projektowania:

    Parameter 'Value': PowerFx type is not supported.

  • System nie inicjalizuje użytkownika dla anonimowych użytkowników, co skutkuje następującym błędem, gdy używasz go w dowolnym formularzu, w tym w sprawdzaniu pustych miejsc. Ten problem zostanie rozwiązany w kolejnym wydaniu.

    UserInfo object was not added to service

  • U niektórych użytkowników mogą wystąpić problemy z właściwościami przycisku i adresu URL Power Fx obrazu, które nie działają, gdy ta wartość jest ustawiona w formułach lub jeśli wartość zawiera cudzysłów podwójny. Ten problem występuje tylko w przypadku korzystania z wersji 9.6.3.x Power Pages i zostanie rozwiązany w momencie uaktualnienia witryny do wersji 9.6.5.x.

Często zadawane pytania

Czy należy używać Power Fx zamiast Liquid?

Power Fx realizuje określone scenariusze danych dynamicznych w niskiej wersji kodu, które można również osiągnąć za pomocą kodu kierunkowego za pomocą narzędzi dla deweloperów. Power Fx, obecnie na etapie publicznej wersji zapoznawczej, jest zalecane do oceny wersji próbnej lub projektowania witryny. Czekamy na Wasze opinie na tym etapie. To funkcja jest ogólnie dostępna i zapewnia znacznie więcej możliwości. Użyj Liquid dla produkcyjnych witryn sieci Web, szczególnie w sytuacjach krytycznych i złożonych.

Zobacz też