Używanie niskokodowych dodatków plug-in usługi Dataverse (wersja zapoznawcza)
[Ten temat pochodzi ze wstępnej wersji dokumentacji i może ulec zmianie.]
Microsoft Dataverse oferuje wydajne rozwiązanie, które umożliwia osiąganie bardziej efektywnej architektury danych i zmniejszanie obciążenia po stronie klienta za pomocą niskokodowych dodatków plug-in. Te dodatki plug-in są wielokrotnymi przepływami pracy używanymi w czasie rzeczywistym i mogą w czasie rzeczywistym wykonać określony zestaw poleceń Dataverse, wykonując je po stronie serwera i wyzwalając przez spersonalizowane programy obsługi zdarzeń.
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.
Tradycyjnie dodatki plug-in były tworzone jako klasy niestandardowa skompilowana w zestaw programu .NET Framework, który jest następnie przekazany i rejestrowany w Dataverse. Jednak po wprowadzeniu niskokodowych dodatków plug-in użytkownicy mogą tworzyć te programy obsługi zdarzeń z minimalną lub w ogóle bez konieczności kodowania i bez konieczności ręcznej rejestracji.
Niskokodowe dodatki plug-in są przechowywane w bazie danych Dataverse i mogą być w pełni zintegrowane z bazą danych Power Apps oraz Power Automate. Zachowanie przepływu pracy jest definiowane za pomocą języka wyrażeń Power Fx, może on też być bezpośrednio połączony z danymi biznesowymi Dataverse i zewnętrznymi źródłami danych za pośrednictwem łączników Power Platform. Dzięki tym niskokodowym dodatkom plug-in można szybko tworzyć złożone przepływy pracy przy minimalnej znajomości w zakresie kodowania, co sprzyja powstawaniu sprawnej i efektywnej architektury danych.
Korzyści z określania logiki po stronie serwera
Definiowanie logiki biznesowej na serwerze zapewnia szereg korzyści, takie jak:
- Większe bezpieczeństwo. Ponieważ logika przetwarzania jest wykonywana na serwerze, może to zapobiec nieautoryzowanym dostępom do poufnych danych lub procesów.
- Większa wydajność. Wykonywanie na serwerze logika biznesowa może zmniejszyć ilość danych, które muszą być przesyłane między programem klienckim a serwerem, co skraca czas przetwarzania.
- Spójność i niezawodność. Logika na serwerze zapewnia spójne stosowania reguł biznesowych we wszystkich programach klienckich, zmniejszając ryzyko wystąpienia błędów lub niespójności.
- Łatwiejsza konserwacja i uaktualnianie. Scentralizowanie logiki biznesowej na serwerze ułatwia utrzymywanie i aktualizowanie, ponieważ zmiany można wprowadzać w jednym miejscu, zamiast aktualizować wiele klientów.
- Skalowalność. Logikę po stronie serwera można skalować łatwiej niż logikę po stronie klienta, co pozwala na lepszą wydajność i obsługę większych obciążeń.
Niskokodowe dodatki plug-in i
Istnieją dwa rodzaje niskokodowych dodatków plug-in w Dataverse:
Type | Wyzwalacz | Obsługiwane parametry | Obsługiwany zakres |
---|---|---|---|
Błyskawiczne | Uruchamianie ręczne | Tak | Globalne i skojarzone z tabelą |
Zautomatyzowane | Zdarzenie tabeli Dataverse | Nie. | Table |
Wszystkie niskokodowe dodatki plug-in mają następujące właściwości wspólne:
Właściwości | Description |
---|---|
Display name | Przyjazna dla użytkownika nazwa dodatku plug-in. Nie można zmienić po utworzeniu. |
Nazwa/nazwisko | Wewnętrzna nazwa dodatku plug-in. Jest używana przez platformę do identyfikowania tego składnika w operacjach kodu i bazy danych. Nie można zmienić po utworzeniu. |
Description | Zapewniania dodatkowych kontekst dodatku plug-in (cel, zachowanie lub inne ważne szczegóły). |
Rozwiązanie | Informacja używana do grupowania składników i eksportowania do innych środowisk. Więcej informacji o rozwiązaniach. |
Expression | Jest to funkcja niestandardowa, która może być używana do wykonywania akcji lub obliczeń, zdefiniowanych przy użyciu języka wyrażeń Power Fx. Power Fx to język formuł używany w aplikacjach kanwy Power Apps i został rozszerzone do wersji z niskokodowymi dodatkami plug-in. Więcej szczegółów można znaleźć w informacji o obsługiwanych funkcjach. |
Niskokodowy błyskawiczny dodatek plug-in zawiera logikę biznesowa, której przetwarzanie jest wyzwalane ręcznie. Można używać niestandardowych parametrów wejściowych i wyjściowych.
Unikatowe właściwości:
Właściwości | Description |
---|---|
Scope | Używany do skojarzenia dodatku plug-in z określoną tabelą. Można go skonfigurować jako tabelę (pokazywaną jako encja) lub globalnie, gdzie zakres tabela (encja) oznacza, że dodatek plug-in jest wyzwalany w kontekście określonego rekordu tabeli, a zakres globalny oznacza, że operacja nie jest skojarzona z tabelą (więcej informacji). |
Parametry | Parametry umożliwiają przekazywanie informacji między dodatkiem plug-in a kontekstem, który go uruchamia, co ułatwia projektowanie logiki biznesowej, której można użyć w różnych sytuacjach. Parametry wejściowe służą do przekazywania danych do dodatku plug-in i umożliwiają kontrolowanie działania funkcji przez przekazywanie różnych wartości określanych w formułach Power Fx. Parametry wyjściowe umożliwiają pobranie wyników funkcji lub metody do dalszej pracy w programie użytkownika. Obsługiwane typy danych:
|
Więcej informacji na temat integrowania z aplikacji kanwy lub z przepływu w chmurze Power Automate: Integrowanie niskokodowego dodatku plug-in
Uprawnienia dodatku plug-in
Czas projektowania
Twórcy, którzy są członkami roli zabezpieczeń konfigurator systemu lub administrator systemu w środowisku Power Platform, mogą korzystać ze wszystkich dodatków plug-in w tym środowisku. W celu ograniczenia dostępu do niskokodowych dodatków plug-in można użyć niestandardowych ról zabezpieczeń.
Czas procesu
Gdy dodatek plug-in jest wywoływany, uzyskuje dostęp do danych tabeli powiązanej z definicją dodatku plug-in (tabele, które są częścią formuły, lub tabel skojarzonych z ustawieniami zautomatyzowanego dodatku plug-in) w kontekście użytkownika, który go wywołał.
Połączenia
Używając ról zabezpieczeń, dostęp do łącznika z dodatkiem plug-in może być ograniczony do określonej grupy użytkowników w organizacji. Można określić uprawnienia do tworzenia, odczytu, aktualizowania i usuwania.
Wymagania wstępne dotyczące tworzenia niskokodowych dodatków plug-in
- Rola Administrator systemu lub rola zabezpieczeń konfiguratora systemu Power Platform.
- Dostęp do aplikacji Dataverse Accelerator.
Wskazówka
Wszystkie nowe środowiska mają zainstalowaną automatycznie aplikację Dataverse Accelerator od 1 października 2023 r. Jeśli aplikacja Dataverse Accelerator była już zainstalowana, można Dataverse zaktualizować ręcznie.
Aktualizowanie aplikacji Dataverse Accelerator
- Postępuj zgodnie z instrukcjami, aby wyświetlić licencjonowane aplikacje w środowisku.
- Jeśli Akcelerator Dataverse jest już zainstalowany i dostępna jest aktualizacja, jest ona wskazana w tabeli obok elementu.
- Wybierz Akcelerator Dataverse, a następnie wybierz Aktualizacja na pasku poleceń.
Wskazówka
Włącz automatyczne aktualizowanie dla wydawcy Microsoft — Power CAT, aby automatycznie otrzymywać aktualizacje (nie jest to konieczne w przypadku nowych środowisk utworzonych po 1 październiku 2023 r.).
Notatka
Jeśli wcześniej zainstalowano opcjonalnie rozwiązanie niskokodowy dodatek plug-in dla łączników, zostanie ono automatycznie usunięte w przypadku aktualizacji po 29 czerwca 2023 r. Możliwości te będą dostępne w głównym rozwiązaniu.
Tworzenie niskokodowego błyskawicznego dodatku plug-in
- Odtówrz aplikację Dataverse Accelerator.
- Wybierz kartę Tworzenia błyskawicznego dodatku plug-in.
- Wprowadź wartość dla Nazwa wyświetlana
- Opcjonalnie zdefiniuj parametry:
- Wybierz opcję Nowy parametr wejściowy lub Nowy parametr wyjściowy, a następnie wprowadź etykietę i typ danych.
- Dodaj w razie potrzeby więcej parametrów wejściowych i wyjściowych.
- Wprowadź wyrażenie Power Fx w edytorze Wyrażenia.
- Odwoływanie się do parametrów wejściowych w formułę za pomocą nazwy etykiety.
- Odwołania do parametrów wyjściowych muszą być ujęte w nawiasy klamrowe, np. jak tutaj
{ Out: "Return value" }
. - Odwołania do Tabel Dataverse za pomocą funkcji zbierania danych, np. Filtr() i LookUp().
- Jeśli zakres ustawiono na Encja, należy użyć operatora
ThisRecord
do uzyskania dostępu do wartości kolumny w wierszu tabeli skojarzonej z uruchamianiem dodatku plug-in np.ThisRecord.'Account Name'
.
Wskazówka
Wprowadź intellisense w polu Expression. Podkreślony czerwony jest nieprawidłowy. Żółty falisty oznacza, że ograniczenia delegowania mogą mieć wpływ na logikę. Należy unikać problemów z delegowaniem, używając funkcji, które są delegowalne.
- Opcjonalnie rozwiń pole Opcje zaawansowane, aby zmodyfikować rozwiązanie lub zakres lub opis.
- Wybierz pozycję Zapisz.
- Przetestuj niskokodowy dodatek plug-in w.
Przykład: można na przykład obliczyć sumę dwóch liczb całkowitych.
- Utwórz dwa parametry wejściowe:
X
iY
, (oba typu liczba całkowita), jak i jeden parametr wyjściowyZ
(typu ciąg). - Użyj następującej formuły:
{Z: X + Y }
Tworzenie automatycznego niskokodowego dodatku plug-in
- Odtówrz aplikację Dataverse Accelerator.
- Wybierz kartę Tworzenie automatycznego dodatku plug-in.
- Podaj następujące wartości:
- Nazwa: wprowadź nazwę dodatku plug-in, na przykład Walidacja wejścia.
- Tabela: wybierz tabelę, z którą ma być skojarzony dodatek plug-in, np. Konto.
- Uruchom ten dodatek, gdy wiersz jest. Określ zdarzenie danych wywołujące ten dodatek plug-in.
- Wprowadź wyrażenie Power Fx w edytorze Wyrażenia.
- Odwołania do Tabel Dataverse za pomocą funkcji zbierania danych, np. Filtr() i LookUp().
- Użyj operatora
ThisRecord
do uzyskania dostępu do wartości kolumny w wierszu tabeli skojarzonej z uruchamianiem dodatku plug-in np.ThisRecord.'Account Name'
.
- Opcjonalnie rozwiń Opcje Zaawansowane, aby zmodyfikować etap (po jego uruchomieniu) i rozwiązanie, w którym został zapisany ten dodatek plug-in.
- Wybierz pozycję Zapisz.
- Przetestuj zautomatyzowany dodatek plug-in.
Używanie łączników Power Platform w niskokodowych dodatkach plug-in
Łączniki Power Platform mogą być używane w niskokodowych dodatkach plug-in w celu łatwej integracji danych i funkcji z systemów poza Dataverse, na przykład takich jak SQL Server, Salesforce czy SharePoint, bez konieczności złożonego kodowania ani dostosowywania.
Wymagania wstępne dotyczące korzystania z łączników w niskokodowym dodatku plug-in
- Wymagania wstępne dotyczące tworzenia niskokodowych dodatków plug-in
- Odwołanie do połączenia z aktywnym połączeniem.
Korzystanie z akcji łącznika w niskokodowych dodatkach plug-in
Łączników i niestandardowych łączników można łatwo używać z poziomu niskokodowych dodatków plug-in w formule Power Fx.
- Utwórz połączenie z łącznikiem, którego chcesz użyć.
- Dodaj odwołanie do połączenia w środowisku Dataverse.
- W edytorze wyrażenia Power Fx niskokodowego dodatku plug-in wpisz nazwę odwołania do połączenia (nazwę wewnętrzną z prefiksem i pokreślnikiem, podobnie jak w
new_connectorName
, nie nazwę wyświetlaną). - Funkcja IntelliSense pokaże dostępne akcje. Wybierz odpowiednią akcję, a następnie wprowadź wymagane parametry.
Przed użyciem łącznika w niskokodowym dodatku plug-in należy przejrzeć jego dokumentację, aby upewnić się, że parametry wejściowe i wyjściowe są stosowane prawidłowo.
Więcej informacji: przykład
Notatka
- Nie wszystkie akcje łącznika są obecnie obsługiwane.
- Nie należy używać łącznika Dataverse do łączenia się z tabelami Dataverse występującymi w wyrażeniach dodatku plug-in. Zamiast tego należy użyć funkcji macierzystych Power Fx do interakcji z kolekcjami: Filter, Search, LookUp Patch, Collect i Set, gdzie kolumny są traktowane jako zmienne globalne.
Testowanie niskokodowego dodatku plug-in
Testowanie błyskawicznych dodatki plug-in
Na Ekranie głównym wybierz błyskawiczny dodatek plug-in z listy, a następnie wybierz opcję Test na pasku poleceń. Do tego ekranu można też przejść z edytora błyskawicznego dodatku plug-in na pasku poleceń po zapisaniu dodatku.
Podaj wartości wszystkich parametrów wejściowych zdefiniowanych w niskokodowym dodatku plug-in, a następnie wybierz opcję Uruchom.
Obserwuj odpowiedź.
Wskazówka
Parametry wyjściowe pomagają sprawdzić poprawność oczekiwanego zachowania i wyników. W przeciwnym razie podczas testowania zobaczy się tylko, czy zakończyło się ono sukcesem, czy niepowodzeniem.
Testowanie automatycznych dodatków plug-in
Zautomatyzowane dodatki plug-in można przetestować, wywołując zdarzenie danych. Można dowiedzieć się, czy dodatek plug-in został pomyślnie wykonany, poprzez sprawdzanie poprawności oczekiwanych zmian zdefiniowanych w formule.
Wskazówka
W wersji zapoznawczej można wywoływać skojarzone zdarzenie danych przy użyciu edytora tabel w Power Apps
- Zaloguj się w Power Apps, przejdź do Tabele i wybierz tabelę dodatku plug-in.
- Na pasku poleceń zaznacz Edytuj.
- Utwórz, aktualizuj lub usuwaj wiersze bezpośrednio w tym widoku. Zamiast tego możesz otworzyć wiersz w formularzu domyślnym, wybierając jakiś wiersz, a następnie na pasku poleceń opcję Edytuj wiersz przy użyciu formularza.
Integrowanie niskokodowego dodatku plug-in
Wywoływanie błyskawicznego dodatku plug-in z aplikacji kanwy lub ze strony niestandardowej
- W aplikacji Dataverse Accelerator:
- Wybierz błyskawiczny dodatek plug-in z listy.
- Na pasku poleceń wybierz opcję Kopiuj fragment kodu.
- Wklej i zapisz skopiowaną formułę w edytorze tekstów lub Notatniku (do których można łatwo wrócić).
- W usłudze Power Apps:
- Tworzenie i edytowanie aplikacji kanwy (lub strony niestandardowej) w Power Apps studio.
- W lewym okienku nawigacji, na karcie Źródła danych wybierz opcję + Źródło danych i wyszukaj opcję Środowisko w łączniku Dataverse.
- Wstaw następujące składniki do kanwy:
- Dodaj kontrolki wejściowe odpowiadające typom danych każdego parametru, na przykład wartościom wejściowym tekstu dla tekstu lub liczb, przełącznik dla wartości logicznych.
- Jeśli zakres dodatku plug-in jest powiązany z tabelą, należy dodać pole kombi skojarzone z tą samą tabelą, co umożliwia wybranie danych wejściowych.
- Dodaj przycisk wywołujący dodatek plug-in.
- Wklej formułę dodatku plug-in skopiowaną wcześniej do właściwości
OnSelect
przycisku. - Zmapuj każdy parametr wejściowy
Value
w celu odwołania do odpowiednich kontrolek wejściowych:- Jeśli formułą było
Environment.new_CalculateSum({ X: Value, Y: Value });
może zostać ponownie zastąpione jako:Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
- Jeśli formułą było powiązanie, zastąp
Environment
nazwą wyświetlaną tabeli, aby uzyskać dostęp do dodatku plug-in.
- Jeśli formułą było
- Jeśli parametr wyjściowy jest zdefiniowany dla niskokodowego dodatku plug-in:
- Przechwyć odpowiedź w formule
Set()
lubUpdateContext()
:Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );
. Wyświetl tę zmienną w etykiecie. Możesz też użyć formułyNotify()
, aby wyświetlić dane w powiadomieniu.
- Przechwyć odpowiedź w formule
- Odtwórz aplikację i wybierz polecenie z paska poleceń, aby uruchomić niskokodowy dodatek plug-in.
Dowiedz się więcej o tym, jak możesz w aplikacjach kanwy wywołać akcje Dataverse bezpośrednio z Power Fx.
Wywoływanie błyskawicznego dodatku plug-in z przepływu w chmurze w usłudze Power Automate
- W przepływie w chmurze dodaj nową akcję z łącznika Microsoft Dataverse.
- Wybierz akcję o nazwie Wykonaj akcję niezwiązaną lub Wykonaj akcję powiązaną.
- Wybierz swój dodatek plug-in (ma unikatową nazwę z prefiksem).
- Podaj wartości wszystkich parametrów wejściowych (jeśli są).
Wywoływanie błyskawicznego dodatku plug-in z internetowego interfejsu API usługi Dataverse
Wykonaj kroki opisane w sekcji Akcja niepowiązana lub Funkcja powiązana z tabelą w dokumencie Wywoływanie niestandardowych interfejsów API z dokumentacji interfejsu internetowego API (w zależności od odpowiedniego zakresu dodatku plug-in).
Uzyskiwanie pomocy dotyczącej plug-inów o niskiej zawartości kodu
Jeśli napotkasz problemy z tworzeniem lub uruchamianiem plug-inów niskokodowych, zapoznaj się z poniższymi wskazówkami dotyczącymi typowych problemów, które mogą wystąpić: Wskazówki i znane problemy związane z plug-inem Microsoft Dataverse o niskiej zawartości kodu
Kontaktowanie się z Pomocą i pomocą techniczną
W przypadku problemów z instalacją rozwiązania Dataverse Accelerator lub wtyczek o niskim kodzie, które nie zostały uwzględnione w Wskazówki i znane problemy związane z plug-inem Microsoft Dataverse o niskej zawartości kodu, takich jak nieudokumentowane błędy, skorzystaj z pomocy technicznej i dołącz następujące informacje:
- Typ problemu – Dataverse, internetowy interfejs API i zestaw SDK
- Podtyp problemu – zestaw Accelerator dla Dataverse
Przykładowe niskokodowe dodatki plug-in
Kilka przykładów tworzenia niskokodowych dodatków plug-in zobaczysz w Przykłady Dataverse z niskokodowymi dodatkami plug-in (wersja zapoznawcza)
Ograniczenia
Obiekt języka środowiska musi zostać odczytany, aby uzyskać dostęp do nowych wtyczek wewnątrz istniejących aplikacji opartych na kanwie. W przypadku wszelkich dodatków plug-in utworzonych po dodaniu źródła danych tabeli środowiska do istniejącej aplikacji kanwy, konieczne będzie usunięcie i ponowne dodanie obiektu języka środowiska Power Fx. Pojawi się zaktualizowana lista dodatków plug-in jako akcji.
Funkcja IntelliSense wymaga jawnej notacji w automatycznych dodatkach plug-in, aby można było odwoływać się do tabel w formule. Użyj następującej jednoznacznej składni jak w
[@Accounts]
, używając nawiasów kwadratowych i symbolu@
(nieAccounts
).Zagnieżdżona obsługa Dodatki plug-in mogą wywołać tylko akcje „pierwszej strony” opublikowane przez firmę Microsoft z wyrażeń Power Fx.
Niektóre scenariusze funkcji
Collect
wymagają funkcjiPatch
. Istnieją scenariusze, w których funkcjaCollect()
nie działa. Obejściem tego problemu jest użycie funkcjiPatch()
, jak pokazano poniżej na przykładzie populacji kolumny. W przypadku tworzenia automatycznego dodatku plug-in każdą tabelę przywoływaną w formule Power Fx należy poprzedzić znakiem @.Patch(Faxes, Collect(Faxes, { Subject : "Sub1" } ), { Regarding : First(Accounts) } )
Gdy niskokodowe dodatki plug-in współdziałają z łącznikami i usługą DLP, administrator może zablokować tworzenie połączeń przy użyciu usługi DLP. Istniejące odwołania do połączenia w środowisku Dataverse nadal jednak działają. Jeśli administrator chce blokować wszystkie interakcje niskokodowych dodatków plug-in z łącznikami, może wyłączyć ustawienie organizacyjne
Allowconnectorsonpowerfxactions
. To ustawienie jest domyślnie włączone i może być wyłączone przez typowe metody zestawu SDK (WebAPI, SDK, PowerShell i inne). Można je wyłączyć, korzystając z niskokodowego dodatku plug-in:Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
Dodatki plug-in, które korzystają z łączników, mogą wyprowadzać wyniki tylko z określonych pól. Z tego powodu konieczne jest mapowanie określonych wartości pierwotnych z odpowiedzi łącznika na wartości wyjściowe.
Wtyczki z niską zawartością kodu z ograniczeniem niestandardowych łączników
Jeśli posiadasz wtyczki o niskim kodzie z niestandardowymi łącznikami, niestandardowe łączniki muszą zostać zaimportowane jako pierwsze, przed referencjami połączeń lub przepływami.
Jeśli środowisko nie zawiera niestandardowego łącznika w rozwiązaniu, zaimportuj oddzielne rozwiązanie, które zawiera tylko niestandardowy łącznik. Import ten należy wykonać przed zaimportowaniem rzeczywistego rozwiązania. Należy to zrobić najpierw, ponieważ platforma Azure musi zarejestrować niestandardowy łącznik, zanim będzie można zaimportować inne składniki rozwiązania.
Jeśli zaimportujesz rozwiązanie zawierające niestandardowe łączniki i przepływy, platforma Azure nie będzie w stanie zarejestrować niestandardowego łącznika podczas rejestrowania odwołań do połączeń lub przepływów. To dotyczy również odwołań do połączenia łącznika niestandardowego, który nie był wcześniej importowany w oddzielnym rozwiązaniu. Jeśli platforma Azure nie zarejestrowała niestandardowego łącznika, import nie powiedzie się lub nie będzie można go rozpocząć.
Więcej informacji: Twórz niestandardowe łączniki w rozwiązaniach: Znane ograniczenia