Omówienie logiki serwera

Power Pages logika serwera umożliwia twórcom bezpieczne uruchamianie kodu JavaScript na serwerze, dodając elastyczność bezpośrednio do środowiska uruchomieniowego witryny.
 
Ponieważ logika serwera działa na serwerze, jest ukryta przed przeglądarką i chroniona przez role sieci Web i uprawnienia tabeli. Logikę można dodać w programie Power Pages design Studio i utworzyć przy użyciu programu Visual Studio Code, który zapewnia funkcję IntelliSense i walidację czasu kompilacji.

Dataverse przechowuje kod i konfigurację, dlatego logika działania serwera korzysta z tego samego cyklu zarządzania i wdrażania, co inne składniki Power Pages.

Przepływ logiki serwera

Obsługa języków

Logika serwera umożliwia deweloperom pisanie natywnego kodu JavaScript zgodnego ze standardem ECMAScript 2023 bez obsługi interfejsów API przeglądarki (takich jak interfejsy fetch API DOM lub XMLHttpRequest). Niektóre niebezpieczne lub ograniczone wzorce są również blokowane w celu zapewnienia bezpiecznego wykonywania. Aby uzyskać więcej informacji, zobacz Ograniczenia dotyczące tworzenia logiki serwera.

Co można zrobić za pomocą logiki serwera

Logika serwera w Power Pages umożliwia twórcom i deweloperom przenoszenie krytycznych operacji z przeglądarki do serwera w celu zwiększenia kontroli, skalowalności i zabezpieczeń. Umożliwia stronie wykonywanie złożonych zadań i integracji bez ujawniania poufnej logiki lub danych po stronie klienta.

Korzystając z logiki serwera, można wykonywać następujące czynności:

  • Nawiązywanie połączenia z usługami zewnętrznymi i interfejsami API: bezpieczne integrowanie z interfejsami API REST, Azure Functions lub innymi systemami biznesowymi w celu wymiany danych, wyzwalania akcji lub pobierania informacji dynamicznych.
  • Wykonywanie bezpiecznych operacji na danych: wykonaj operacje usługi Dataverse, takie jak wykonywanie zapytań, aktualizowanie lub usuwanie rekordów — na serwerze, spójne stosowanie logiki biznesowej i walidacji.
  • Uruchom niestandardową logikę i przekształcenia: przetwarzaj lub manipuluj danymi przed zwróceniem ich do klienta. Na przykład oblicz sumy, zweryfikuj reguły biznesowe lub wzbogacij dane przy użyciu odnośników zewnętrznych.
  • Zwracanie przetworzonych odpowiedzi na strony: wysyłaj tylko wymagane i filtrowane dane na strony klienta, zapewniając szybsze renderowanie i zmniejszone obciążenie.
  • Upraszczanie bezpiecznego uwierzytelniania: zarządzanie poświadczeniami usługi i kluczami interfejsu API na serwerze, a nie w kodzie klienta, utrzymywanie bezpiecznych i zgodnych praktyk integracji.

Zalety korzystania z logiki serwera

Logika serwera zapewnia rozszerzalność klasy korporacyjnej na Power Pages, pomagając organizacjom tworzyć bezpieczniejsze, skalowalne i konserwowalne środowiska internetowe.

Najważniejsze korzyści to:

  • Zwiększone zabezpieczenia: wykonywanie i przechowywanie logiki biznesowej, wpisów tajnych i kluczy interfejsu API na serwerze — nigdy nie uwidaczniaj ich w przeglądarce ani dla użytkowników końcowych.
  • Elastyczność integracji: bezproblemowe łączenie Power Pages z systemami zewnętrznymi, w tym Azure Functions, interfejsami API REST, akcjami usługi Dataverse i usługami biznesowymi.
  • Zwiększona wydajność i wydajność: odciążanie dużych obliczeń, walidacji i przetwarzania danych na serwerze, zmniejszenie obciążenia po stronie klienta i skrócenie czasu odpowiedzi strony.
  • Spójność między kanałami: zastosuj tę samą logikę między stronami internetowymi, formularzami i integracją, zapewniając jednolitą walidację i zachowanie danych w całej aplikacji.
  • Scentralizowana konserwacja: aktualizowanie lub uściślinie logiki w jednym miejscu bez ponownego wdrażania lub edytowania wielu skryptów lub stron klienta.

Zabezpieczanie logiki serwera

Aby wykonać kod w logice serwera, użytkownicy muszą mieć odpowiednie uprawnienia skonfigurowane przez producenta. Dostęp podlega uprawnieniam ról sieci Web i tabel, które określają również, czy logika serwera może uzyskiwać dostęp do określonych tabel.

Uwierzytelnianie API logiki serwera

Nie musisz dołączać niestandardowego kodu uwierzytelniania. Uwierzytelnianie i autoryzacja są zarządzane przez sesję aplikacji. Wszystkie wywołania interfejsu API logiki serwera muszą zawierać token „Fałszerstwo żądania międzywitrynowego” (CSRF).

Ustawienie zarządzania na potrzeby wywołań usług zewnętrznych

Logika serwera może łączyć się z zewnętrznymi interfejsami API REST, usługą Azure Functions i innymi systemami biznesowymi w celu przeprowadzenia integracji po stronie serwera. Aby zapobiec eksfiltracji danych, administratorzy dzierżawy mogą blokować wychodzące wywołania HTTP tworzone przez logikę serwera w zależności od lokacji. Kiedy ta kontrola zarządcza jest egzekwowana, wszystkie wychodzące wywołania HTTP, które próbuje wykonać logika serwera, kończą się niepowodzeniem. Aby dowiedzieć się więcej, zobacz wyłączanie wywołań usług zewnętrznych z logiki serwera.

Ustawienia witryny

Użyj następujących opcjonalnych ustawień lokacji, aby ułatwić konfigurowanie logiki serwera:

Nazwa Description Default
ServerLogic/Włączony Włączanie/wyłączanie funkcji prawda
ServerLogic/AllowedDomains Ograniczanie wywoływanych domen zewnętrznych Dozwolone wszystkie domeny
SerwerLogika/CzasOczekiwaniaWSekundach Maksymalny czas wykonywania (w sekundach). Czas oczekiwania można zwiększyć do 240 sekund 120
ServerLogic/PozwólNaKomunikacjęSieciowąZeWszystkimiDomenami Zezwalaj na sieć między domenami Prawda

Adres URL interfejsu API logiki serwera

Skonstruuj adres URL interfejsu API przy użyciu następującego formatu:

https://<site-url>/_api/serverlogics/<server-logic-name>  
Przykład:

https://contoso.powerappsportals.com/_api/serverlogics/exchangerate

 

Obsługiwane metody HTTP

Logika serwera obsługuje standardowe metody HTTP do wykonywania operacji na danych lub interakcji z usługami zewnętrznymi. Każda metoda mapuje na funkcję zdefiniowaną przez użytkownika w kodzie logiki serwera.

Metoda Podpis funkcji Użycie Description
POBIERZ funkcja get() { } Pobieranie danych.  Służy do pobierania danych z usługi Dataverse, zewnętrznych interfejsów API lub niestandardowej logiki biznesowej. Idealne rozwiązanie w przypadku operacji tylko do odczytu, w których nie są wprowadzane żadne zmiany danych.
POST function post() { } Utwórz rekordy lub wyślij nowe dane.  Często używane do wstawiania nowych rekordów do usługi Dataverse lub wysyłania danych do systemów zewnętrznych. Nadaje się do przesyłania formularzy lub przepływów pracy, które muszą tworzyć lub wyzwalać akcje.
PUT function put() { } Zastąp lub zaktualizuj rekordy.  Aktualizuje lub zastępuje cały rekord lub zestaw danych. Zazwyczaj używane w scenariuszach pełnej aktualizacji lub synchronizacji.
POPRAWKA function patch() { } Aktualizacje części rekordu (upsert).  Wykonuje częściową aktualizację istniejących danych bez zastępowania całego rekordu. Użyj tej metody, gdy tylko określone pola wymagają modyfikacji.
USUNĄĆ function del() { } Usuwanie rekordów lub pól.  Usuwa rekordy lub dane z usługi Dataverse lub systemu zewnętrznego. Należy ostrożnie używać, aby zapobiec niezamierzonej utracie danych.

Następny krok

Tworzenie logiki serwera

obiekty serwera
Jak wchodzić w interakcje z tabelami Usługi Dataverse przy użyciu logiki serwera

  • Last updated on