Priklic funkcije iz aplikacije, toka, kode ali druge funkcije (predogled)

[Ta tema je namenjena predizdajni dokumentaciji in se lahko spremeni.]

Funkcije lahko prikličete v Dataverse iz aplikacije platna, strani po meri v aplikaciji, ki temelji na modelu, toka, kode ali iz druge funkcije.

Pomembno

  • To je funkcija predogleda.
  • Poskusne funkcije niso za komercialno uporabo, njihovo delovanje je lahko omejeno. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.

Prikličite funkcijo iz aplikacije platna ali strani po meri

  1. V območju Funkcije v Power Apps (make.powerapps.com) izberite funkcijo, ki jo želite priklicati iz platnene aplikacije ali strani po meri.
  2. V ukazni vrstici izberite Kopiraj delček kode .
  3. Kopirano formulo prilepite in shranite v urejevalnik besedila, beležnico ali nekam, kamor se zlahka obrnete.
  4. V Power Apps Studio:
    1. Ustvarite ali uredite aplikacijo za platno ali stran po meri v Power Apps Studio.

    2. V levem podoknu za krmarjenje pod zavihkom Viri podatkov izberite Dodaj podatke, poiščite tabelo Okolje v povezovalniku Dataverse in jo izberite.

      opomba,

      Če tabela »Okolje « ni na voljo za izbiro, ustvarite novo aplikacijo v istem okolju, da sprožite njeno ustvarjanje.

    3. Na platno vstavite te komponente:

      • Dodajte kontrolnike vnosa, ki ustrezajo vrsti podatkov vsakega parametra, kot je vnos števila.
      • Dodajte gumb za klic funkcije.
      • Dodajte izhodni kontrolnik, ki ustreza tipu podatkov vašega parametra, kot je vnos števila.
  5. Izberite gumb, ki ste ga ustvarili, in v lastnost OnSelect vnesite svojo funkcijo, na primer Environment.new_calculatesum.
  6. Preslikaj vsak vhodni parameter Value za sklicevanje na ustrezne vhodne kontrole:
    • Če je vaša funkcija Environment.new_CalculateSum({ X: Value, Y: Value });, jo lahko prepišete kot: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Če želite nastaviti izhod 'rezultata' funkcije, posodobite formulo na 'Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))'.
  7. Izberite izhodni kontrolnik in nastavite lastnost 'Vrednost' s formulo 'result.z'.

Oglejte si predogled svoje aplikacije, vnesite vrednosti vnosa 1 in 2 ter izberite gumb. Rezultat bi moral biti prikazan v izpisnem polju.

Priklic funkcij iz Power Automate toka v oblaku

  1. V toku oblaka dodajte novo dejanje iz Microsoft Dataverse konektorja.
  2. Izberite dejanje z imenom Izvedi nevezano dejanje
  3. Izberite svojo funkcijo. Funkcija ima edinstveno ime s predpono.
  4. Podajte vrednosti za vse vhodne parametre (če obstajajo).

Priklic funkcij iz Dataverse spletnega API-ja

Sledite korakom za odseke nevezanih dejanj v članku Priklic API-jev po meri iz spletnega API-ja (odvisno od ustreznega obsega vtičnika).

Prikličite obstoječe funkcije znotraj novih funkcij

Če želite priklicati obstoječo funkcijo znotraj nove funkcije, uporabite sintakso: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Ker je izhod vedno zapis, za dostop do izhodnih parametrov uporabite zapis s piko. Na primer, če ima funkcija "ExistingFunction" dva izhodna parametra, definirana kot out1 in out2, lahko do njih dostopate na enega od teh dveh načinov:

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

Omejitve s funkcijami v Dataverse

  • Predmet jezika okolja je treba prebrati za dostop do novih funkcij v obstoječih aplikacijah platna. Za vse funkcije, ki so bile ustvarjene po dodajanju vira podatkov tabele okolja v obstoječo aplikacijo platna, morate odstraniti in prebrati Power Fx objekt jezika okolja. Nato vidite posodobljen seznam funkcij kot dejanja.
  • Ugnezdena podpora. Funkcije lahko samo kličejo Microsoftova dejanja, ki jih je objavil Microsoft, iz Power Fx izrazov.
  • Nekateri Collect scenariji zahtevajo Patch. V nekaterih primerih Collect() ne deluje. Rešitev je uporaba Patch() kot je prikazano v primeru zapolnitve stolpca glede tukaj.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Odpravite napake in poiščite pomoč pri svojih funkcijah

Če naletite na težave pri ustvarjanju ali izvajanju svoje funkcije, uporabite trace() funkcijo za odpravljanje napak ali pojdite na Omejitve s funkcijami v Dataverse za pogoste težave, ki se lahko pojavijo.

Odpravljanje napak s funkcijo trace().

  1. Če želite odpraviti napake s funkcijo sledenja, se prepričajte, da ste omogočili sledenje dejavnosti vtičnika in poteka dela po meri.
  2. Pojdite na Power Apps (make.powerapps.com), izberite Nastavitve ikono zobnika v zgornjem desnem kotu in nato izberite Napredne nastavitve.
  3. Izberite Nastavitve > Revizija > Globalne nastavitve revizije.
  4. Na zavihku Prilagajanje zagotovite, da je Omogoči beleženje v dnevnik sledenja vtičnika omogočeno za Vse.

Ko omogočite sledenje, lahko začnete uporabljati funkcije trace() za odpravljanje napak Power Fx formul. Izvedite več o uporabi funkcije trace() znotraj Power Fx izraza: Funkcija sledenja - Power Platform.

Obrnite se na pomoč in podporo

Za težave s funkcijami, ki niso zajete v Microsoft Dataverse nasvetih za vtičnike z nizko kodo, in znane težave, kot so prejete nedokumentirane napake, uporabite izkušnjo Pomoč + podpora in vključite naslednje informacije:

  • Vrsta težave- Dataverse Spletni API in SDK.
  • Podvrsta težave.

Primeri funkcij

Ustvarite in uporabite funkcije v Microsoft Dataverse