Wywołanie funkcji z aplikacji, przepływu, kodu lub innej funkcji (wersja zapoznawcza)

[Ten temat pochodzi ze wstępnej wersji dokumentacji i może ulec zmianie.]

Funkcje w Dataverse można wywoływać z aplikacji opartej na kanwie, niestandardowej strony w aplikacji opartej na modelu, przepływu, kodu lub z innej funkcji.

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.

Wywołanie funkcji z aplikacji opartej na kanwie lub strony niestandardowej

1. W obszarze Funkcje w Power Apps (make.powerapps.com) wybierz funkcję, którą chcesz wywołać ze strony aplikacja oparta na kanwie lub niestandardowej.
2. Na pasku poleceń wybierz opcję Kopiuj fragment kodu.
3. Wklej i zapisz skopiowaną formułę w edytorze tekstu, Notatniku lub w innym miejscu, do którego możesz łatwo się odwołać.
4. W usłudze Power Apps Studio:
   1. Utwórz lub edytuj aplikację opartą na kanwie lub stronę niestandardową w aplikacji w Power Apps Studio.
   2. W okienku nawigacji po lewej stronie na karcie Źródła danych wybierz pozycję Dodaj dane, a następnie wyszukaj opcję Środowisko w łączniku Dataverse, a następnie wybierz ją.
   3. Umieść następujące składniki na kanwie:
      • Dodaj kontrolki wejściowe, które odpowiadają typowi danych każdego parametru, na przykład wprowadzanie liczb.
      • Dodaj przycisk, aby wywołać funkcję.
      • Dodaj kontrolkę wyjściową odpowiadającą typowi danych parametru, na przykład pole numeryczne.
5. Wybierz utworzony przycisk, a następnie w właściwości OnSelect wprowadź funkcję, taką jak Environment.new_calculatesum.
6. Zmapuj każdy parametr wejściowy Value w celu odwołania do odpowiednich kontrolek wejściowych:
   • Jeśli twoja funkcja jest Environment.new_CalculateSum({ X: Value, Y: Value });, można ją przepisać jako: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
   • Aby ustawić wynik funkcji, zaktualizuj formułę do „Set(result, Environment.new_CalculateSum({1 X: NumberInput1.value, Y: NumberInput2.value }))'.
7. Wybierz kontrolkę wyjściową i ustaw właściwość "Value" z formułą "result.z".

Wyświetl podgląd aplikacji, wprowadź wartości wejściowe 1 i 2, a następnie wybierz przycisk. Wynik powinien być widoczny w polu wyjściowym.

Wywoływanie funkcji z przepływu w chmurze Power Automate

1. W przepływie w chmurze dodaj nową akcję z łącznika Microsoft Dataverse.
2. Wybierz akcję o nazwie Wykonaj akcję anulowania powiązania
3. Wybierz swoją funkcję. Funkcja ma unikatową nazwę z prefiksem.
4. Podaj wartości dla wszystkich parametrów wejściowych (jeśli istnieją).

Wywoływanie funkcji z interfejsu Dataverse Web API

Postępuj zgodnie z krokami dla niezwiązanych sekcji akcji w artykule Wywoływanie niestandardowych interfejsów API z poziomu interfejsu Web API (w zależności od odpowiedniego zakresu plug-in).

Wywoływanie istniejących funkcji z poziomu nowych funkcji

Aby wywołać istniejącą funkcję w ramach nowej funkcji, użyj składni: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Ponieważ dane wyjściowe są zawsze rekordami, użyj notacji kropkowej, aby uzyskać dostęp do parametrów wyjściowych. Jeśli na przykład funkcja "ExistingFunction" ma dwa parametry wyjściowe zdefiniowane jako out1 i out2, można uzyskać do nich dostęp na jeden z dwóch sposobów:

• Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
• Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Ograniczenia dotyczące funkcji w usłudze Dataverse

• Obiekt języka środowiska musi zostać ponownie dodany, aby uzyskać dostęp do nowych funkcji w istniejących aplikacjach kanwa. W przypadku funkcji utworzonych po dodaniu źródła danych tabeli środowiska do istniejącej aplikacji opartej na kanwie należy usunąć i ponownie dodać obiekt języka środowiska Power Fx. Następnie zostanie wyświetlona zaktualizowana lista funkcji jako akcji.
• Zagnieżdżona obsługa funkcje mogą wywoływać tylko akcje Microsoft opublikowane przez Microsoft z wyrażeń Power Fx.
• Niektóre scenariusze funkcji Collect wymagają funkcji Patch. Istnieją scenariusze, w których funkcja Collect() nie działa. Obejściem jest użycie Patch(), jak pokazano w przykładzie wypełniania kolumny tutaj.

Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Debugowanie i uzyskiwanie pomocy dotyczącej funkcji

Jeśli napotkasz problemy z tworzeniem lub uruchamianiem funkcji, użyj funkcji trace() do debugowania lub przejdź do Ograniczenia dotyczące funkcji w Dataverse dla typowych problemów, które mogą wystąpić.

Debugowanie za pomocą funkcji trace()

1. Aby debugować za pomocą funkcji trace, upewnij się, że włączono śledzenie działań dodatków plug-in i niestandardowych działań przepływu pracy.
2. Przejdź do Power Apps (make.powerapps.com), wybierz ikonę koła zębatego Ustawienia w prawym górnym rogu, a następnie wybierz pozycję Ustawienia zaawansowane.
3. Wybierz pozycję Ustawienia > Globalne ustawienia inspekcji >.
4. Na karcie Dostosowywanie upewnij się, że opcja Włącz rejestrowanie dziennika śledzenia dodatków plug-in jest włączona dla opcji Wszystkie.

Po włączeniu śledzenia można rozpocząć korzystanie z funkcji trace() do debugowania formuł Power Fx. Dowiedz się więcej o tym, jak używać funkcji trace() w Power Fx wyrażeniu: Funkcja Trace - Power Platform.

Kontakt z pomocą techniczną

W przypadku problemów z funkcjami nieuwzględnionymi we wskazówkach dotyczących plug-inów niskokodowych Microsoft Dataverse i znanych problemów, takich jak otrzymane nieudokumentowane błędy, należy skorzystać z pomocy Help + support experience i podać następujące informacje:

• Typ problemu – Dataverse, internetowy interfejs API i zestaw SDK.
• Podtyp problemu.

Powiązane artykuły

Przykładowe funkcje

Tworzenie i używanie funkcji w Microsoft Dataverse