Tworzenie i używanie funkcji w Microsoft Dataverse (wersja zapoznawcza)

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

Tworzenie i używanie funkcji wielokrotnego użytku w Microsoft Dataverse. Funkcje używają Power Fx do wykonywania określonego zestawu poleceń w Dataverse, które działają po stronie serwera.

Wymagania wstępne

Członkostwo w roli zabezpieczeń konfiguratora systemu w środowisku Power Platform.

Tworzenie funkcji w rozwiązaniu

1. Przejdź do Power Apps i wybierz Rozwiązania z panelu nawigacji po lewej. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
2. Otwórz rozwiązanie, w którym chcesz utworzyć funkcję.
3. Na pasku poleceń wybierz Nowy>Automatyzacja>Funkcja.
4. Wprowadź następujące informacje w wyświetlonym panelu bocznym Nowa funkcja.
   • Podaj nazwę wyświetlaną i opis funkcji.
   • Wybierz pozycję Nowy parametr wejściowy i/lub Nowy parametr wyjściowy, a następnie podaj nazwę i typ danych parametru. Dodaj w razie potrzeby więcej parametrów wejściowych i wyjściowych.
   • Na liście Referencje tabel, możesz opcjonalnie wybrać tabele. Do wybranych tabel Dataverse można odwoływać się za pomocą funkcji gromadzenia danych, takich jak Filter() i LookUp().
   • Wprowadź wyrażenie Power Fx w polu Formuła.
5. Wybierz pozycję Zapisz.
6. Testowanie funkcji.

W formule odwołuje się do parametrów wejściowych, używając ich nazw.

Odwołania do parametrów wyjściowych muszą być ujęte w nawiasy klamrowe, np. jak tutaj { Out: "Return value" }.

Przykładowe funkcje

W tej sekcji przedstawiono kilka przykładowych funkcji.

Obliczanie sumy dwóch liczb całkowitych

1. Wprowadź Nazwa wyświetlania, na przykład new_calculateSum, oraz Opis.

2. Dodaj dwa parametry wejściowe, x i y (oba typu liczba całkowita) oraz jeden parametr wyjściowy, z (typ danych liczba całkowita).

3. W polu formuła wprowadź formułę:
   { z:x+y }

   

4. Testowanie funkcji.

Dodawanie nowego tytułu do tabeli artykułów

1. Utwórz dwa parametry wejściowe title i url (oba z typami danych string) oraz jedną zmienną wyjściową message (ciąg typu danych).
2. Wybierz tabelę Artykuły federacji wiedzy z listy rozwijanej Odniesienia do tabeli.
3. W polu formuła wprowadź formułę:

Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

Sprawdź, czy ciąg wejściowy zawiera wybrane ciągi

1. Utwórz parametr wejściowy DocumentTextInput (z typem danych string) i jedną zmienną wyjściową o nazwie rezultat (typ danych string).
2. W polu formuła wprowadź formułę:

{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

Oblicz cenę pobytu w hotelu

1. Utwórz sześć parametrów wejściowych: noce, pokoje, podatek, zniżka, roomservice, ratepernight (wszystkie z typem danych string) i jedną zmienną wyjściową, cena (typ danych float).
2. W polu formuła wprowadź formułę:

{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

Więcej przykładów funkcji

Aby uzyskać więcej przykładowych funkcji, przejdź do Przykładowe funkcje (wersja zapoznawcza).

Edytowanie, testowanie lub usuwanie funkcji

Edytuj funkcję

1. Wybierz funkcję w obszarze Funkcje.
2. Na pasku poleceń wybierz pozycję Edytuj.
3. Zmodyfikuj formułę, a następnie Zapisz ją.

Funkcje testów

1. Wybierz funkcję w obszarze Funkcje.
2. Na pasku poleceń wybierz pozycję Test.
3. Podaj wartości parametrów wejściowych zdefiniowanych w funkcji, a następnie wybierz pozycję Uruchom.

Pomyślny test zwraca odpowiedź OData, która zawiera informacje, takie jak identyfikator URI organizacji, nazwa funkcji oraz parametry i wartości wyjściowe.

Usuwanie funkcji

1. Wybierz pozycję Funkcje w lewym panelu nawigacyjnym, a następnie wybierz funkcję. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
2. Na pasku poleceń wybierz Usuń.

Powiązane artykuły

Funkcje w usłudze Microsoft Dataverse (wersja zapoznawcza)