Udostępnij za pośrednictwem


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. Dowiedz się więcej 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 Power Apps aplikacjach kanwy, który został rozszerzony do użycia we wtyczkach niskokodowych. Aby uzyskać więcej informacji, zobacz obsługiwane funkcje.

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 ustawić na wartość tabela (wyświetlana jako jednostka) lub globalna, gdzie zakres tabeli (encji) oznacza, że wtyczka jest wyzwalana z kontekstem określonego rekordu tabeli, a zakres globalny oznacza, że operacja nie jest skojarzona z tabelą (dowiedz się więcej).
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 dostarczania danych do dodatku i umożliwiają kontrolowanie zachowania funkcji przez przekazywanie różnych wartości określonych w Power Fx formule.

Parametry wyjściowe umożliwiają pobieranie wyników funkcji lub metody w celu dalszego użycia w programie.

Obsługiwane typy danych:
  • Wartość logiczna
  • String
  • Obrót
  • Dziesiętne
  • DateTime
  • Integer

Więcej informacji na temat integracji z aplikacji kanwy lub w Power Automate przepływie w chmurze: Integrowanie wtyczki niskokodowej

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 pracy

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

Korzystając z ról zabezpieczeń, dostęp do łączników w wtyczkach może być ograniczony do określonego zestawu 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.

Porada

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 akceleratora Dataverse

  1. Postępuj zgodnie z instrukcjami, aby wyświetlić licencjonowane aplikacje w swoim środowisku.
  2. Jeśli akcelerator Dataverse jest już zainstalowany i dostępna jest aktualizacja, jest ona wskazana w tabeli obok elementu.
  3. Wybierz Dataverse Akcelerator, a następnie wybierz Aktualizuj na pasku poleceń.

Porada

Włącz automatyczne aktualizacje aplikacji dla wydawcy Microsoft - Power CAT , aby automatycznie otrzymywać aktualizacje, gdy są dostępne (nie jest to konieczne w przypadku nowych środowisk utworzonych po 1 października 2023 r.).

Uwaga

Jeśli wcześniej zainstalowano opcjonalne niskokodowe wtyczki dla rozwiązania Connectors , zostanie ono automatycznie usunięte po 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

  1. Odtówrz aplikację Dataverse Accelerator.
  2. Wybierz kartę Utwórz wtyczkę natychmiastową. Utwórz natychmiastową kartę wtyczki
  3. Podaj awyświetlana nazwa.
  4. Opcjonalnie zdefiniuj parametry:
    • Wybierz pozycję 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.
  5. Wprowadź wyrażenie w Edytorze wyrażeń Power Fx .
    • Odwoływanie się do parametrów wejściowych w formułę za pomocą nazwy etykiety.
    • Parametry wyjściowe muszą być przywoływane wewnątrz nawiasów klamrowych, takich jak { Out: "Return value" }.
    • Odwoływanie się do Dataverse tabel przy użyciu funkcji zbierania danych, takich jak Filter() i LookUp().
    • Jeśli zakres jest ustawiony na jednostkę, użyj ThisRecord , aby uzyskać dostęp do wartości kolumn w wierszu tabeli skojarzonym z uruchomieniem wtyczki, na przykład ThisRecord.'Account Name'.

    Porada

    Zwróć uwagę na funkcję IntelliSense w polu Wyrażenie . Podkreślony czerwony jest nieprawidłowy. Żółty falisty oznacza, że ograniczenia delegowania mogą mieć wpływ na logikę. Unikanie problemów z delegowaniem przy użyciu funkcji, które można delegować.

  6. Opcjonalnie rozwiń węzeł Opcje zaawansowane, aby zmodyfikować rozwiązanie, zakres lub opis.
  7. Wybierz pozycję Zapisz.
  8. Przetestuj swoją błyskawiczną wtyczkę niskokodową.

Przykład: Oblicz sumę dwóch liczb całkowitych.

  • Utwórz dwa parametry X wejściowe i Y (oba typu liczba całkowita) i jeden parametr Z wyjściowy (wpisz ciąg).
  • Użyj następującej formuły: {Z: X + Y }

Przykład błyskawicznej wtyczki w Dataverse aplikacji Accelerator

Tworzenie automatycznego niskokodowego dodatku plug-in

  1. Odtówrz aplikację Dataverse Accelerator.
  2. Wybierz opcję Utwórz automatyczną wtyczkę (karta). Tworzenie zautomatyzowanej karty z wtyczką
  3. Podaj następujące wartości:
    • Nazwa: Wprowadź nazwę wtyczki, na przykład Walidacja danych wejściowych.
    • Tabela: Wybierz tabelę, z którą chcesz skojarzyć wtyczkę, na przykład Konto.
    • Uruchom tę regułę wtyczki, gdy wiersz jest. Określ zdarzenie danych wywołujące ten dodatek plug-in.
  4. Wprowadź wyrażenie w Edytorze wyrażeń Power Fx .
    • Odwoływanie się do Dataverse tabel przy użyciu funkcji zbierania danych, takich jak Filter() i LookUp().
    • Umożliwia ThisRecord dostęp do wartości kolumn w wierszu tabeli skojarzonym z uruchomieniem wtyczki, takich jak ThisRecord.'Account Name'.
  5. Opcjonalnie rozwiń węzeł Opcje zaawansowane, aby zmodyfikować etap (kiedy ma być uruchamiany) i rozwiązanie , w którym jest zapisana wtyczka.
  6. Wybierz pozycję Zapisz.
  7. Przetestuj automatyczną wtyczkę niskokodową.

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

Korzystanie z akcji łącznika w niskokodowych dodatkach plug-in

Możesz łatwo używać łączników i łączników niestandardowych z poziomu wtyczki niskokodowej formuły Power Fx .

  1. Utwórz połączenie z łącznikiem, którego chcesz użyć.
  2. Dodaj odwołanie do połączenia połączenia w Dataverse środowisku.
  3. W edytorze wyrażeń wtyczki Power Fx niskokodowej wpisz nazwę odwołania do połączenia (nazwę wewnętrzną z prefiksem i podkreśleniem, na przykład new_connectorName nie wyświetlaną nazwę).
  4. Funkcja IntelliSense pokaże dostępne akcje. Wybierz odpowiednią akcję, a następnie wprowadź wymagane parametry.

Przed użyciem łącznika we wtyczce niskokodowej zapoznaj się z dokumentacją łącznika, aby upewnić się, że parametry wejściowe i wyjściowe są przekazywane poprawnie.

Więcej informacji: przykład

Uwaga

  • 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 użyj funkcji natywnych 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

  1. Na ekranie głównym wybierz wtyczkę błyskawiczną z listy, a następnie wybierz opcję Testuj na pasku poleceń. Do tego ekranu można też przejść z edytora błyskawicznego dodatku plug-in na pasku poleceń po zapisaniu dodatku. Wybierz pozycję Test dla wtyczki niskokodowej

  2. Podaj wartości wszystkich parametrów wejściowych zdefiniowanych we wtyczce niskokodowej, a następnie wybierz pozycję Uruchom. Wybierz pozycję Uruchom, aby przetestować wtyczkę niskokodową

Obserwuj odpowiedź.

Porada

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.

Porada

W wersji zapoznawczej można wywoływać skojarzone zdarzenie danych przy użyciu edytora tabel w Power Apps

  1. Zaloguj się Power Apps, przejdź do zakładki Tabele i wybierz tabelę wtyczek .
  2. Na pasku poleceń zaznacz Edytuj.
  3. Utwórz, aktualizuj lub usuwaj wiersze bezpośrednio w tym widoku. Możesz też otworzyć wiersz w formularzu domyślnym, zaznaczając wiersz, a następnie wybrać opcję Edytuj wiersz za pomocą formularza na pasku poleceń.

Integrowanie niskokodowego dodatku plug-in

Wywoływanie błyskawicznego dodatku plug-in z aplikacji kanwy lub ze strony niestandardowej

  1. Dataverse W aplikacji Akcelerator :
    1. Wybierz błyskawiczny dodatek plug-in z listy.
    2. Wybierz opcję Kopiuj wstawkę kodu na pasku poleceń. Wywoływanie wtyczki niskokodowej wystąpienia
    3. Wklej i zapisz skopiowaną formułę w edytorze tekstów lub Notatniku (do których można łatwo wrócić).
  2. W Power Apps:
    1. Tworzenie i edytowanie aplikacji kanwy (lub strony niestandardowej) w Power Apps studio.
    2. W obszarze nawigacji po lewej stronie na karcie Źródła danych wybierz + Nowe źródło danych i wyszukaj opcję Środowisko w łączniku Dataverse .
    3. Wstaw następujące składniki do kanwy:
    • Dodaj kontrolki wejściowe, które odpowiadają typowi danych każdego parametru, takie jak Wprowadzanie tekstu dla tekstu lub liczb, przełącz dla wartości logicznej.
    • 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 , aby wywołać wtyczkę.
  3. Wklej skopiowaną formułę wtyczki do właściwości przycisku OnSelect .
  4. Zamapuj każdy parametr wejściowy Value , aby odwołać się do odpowiednich kontrolek wejściowych:
    • Jeśli formuła była Environment.new_CalculateSum({ X: Value, Y: Value });, można ją przepisać jako: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Jeśli formuła została powiązana, zastąp Environment ją wyświetlaną nazwą tabeli, aby uzyskać dostęp do wtyczki.
  5. Jeśli parametr wyjściowy jest zdefiniowany dla wtyczki niskokodowej:
    1. Uchwyć odpowiedź w formule lub Set() UpdateContext() : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Wyświetl tę zmienną w etykiecie. Alternatywnie użyj formuły, Notify() aby wyświetlić dane w powiadomieniu.
  6. Odtwórz aplikację i wybierz polecenie z paska poleceń, aby uruchomić niskokodowy dodatek plug-in.

Dowiedz się więcej o tym, jak można wywoływać Dataverse akcje bezpośrednio z Power Fx aplikacji kanwy.

Wywoływanie błyskawicznego dodatku plug-in z przepływu w chmurze w usłudze Power Automate

  1. W przepływie w chmurze dodaj nową akcję z łącznika Microsoft Dataverse.
  2. Wybierz akcję o nazwie Wykonaj akcję niezwiązaną lub Wykonaj akcję powiązaną.
  3. Wybierz swój dodatek plug-in (ma unikatową nazwę z prefiksem).
  4. 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

Postępuj zgodnie z instrukcjami opisanymi w sekcjach Akcja niepowiązana lub Funkcja powiązana z tabelą w temacie Wywoływanie niestandardowych interfejsów API z dokumentacji internetowego interfejsu API (w zależności od odpowiedniego zakresu wtyczki).

Uzyskiwanie pomocy dotyczącej plug-inów o niskiej zawartości kodu

Jeśli napotkasz problemy z tworzeniem lub uruchamianiem wtyczki niskokodowej, zapoznaj się z poniższymi wskazówkami, aby zapoznać się z typowymi problemami, które mogą wystąpić: Microsoft Dataverse Porady dotyczące wtyczek niskokodowych i znane problemy

Kontaktowanie się z Pomocą i pomocą techniczną

W przypadku problemów z instalacją rozwiązania Akcelerator lub wtyczkami niskokodowymi, które nie zostały uwzględnione w Dataverse poradach dotyczących wtyczek niskokodowych i znanych problemów Microsoft Dataverse , takich jak otrzymane nieudokumentowane błędy, skorzystaj z funkcji Pomoc + obsługa techniczna 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

Aby zapoznać się z kilkoma przykładami tworzenia wtyczki niskokodowej, przejdź do tematu Przykładowe Dataverse wtyczki niskokodowe (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 składni uściślania, takiej jak [@Accounts] użycie nawiasów kwadratowych i symbolu @ (not Accounts).

  • 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 Collect scenariusze wymagają Patch. Istnieje kilka scenariuszy, w których Collect() to nie działa. Obejście polega na użyciu Patch() zgodnie z poniższym przykładem wypełniania kolumny dotyczące. 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ą. W przypadku, gdy administrator musi zablokować wszystkie interakcje wtyczek niskokodowych z dowolnymi łącznikami, może wyłączyć ustawienie organizacji 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: Tworzenie łączników niestandardowych w rozwiązaniach: Znane ograniczenia

Zobacz też

Wtyczki Power Fx niskokodowe (wersja zapoznawcza)

Użyj wstępnie utworzonego monitu we Dataverse wtyczce o niskim kodzie Power Apps