Funktsiooni kutsumine rakendusest, voost, koodist või muust funktsioonist (eelvaade)

[See teema on väljalaske-eelne dokumentatsioon ja seda võidakse muuta.]

Funktsioone saate käivitada Dataverse lõuendirakendusest, mudelipõhise rakenduse kohandatud lehelt, voost, koodist või mõnest muust funktsioonist.

Oluline

  • See on eelvaate funktsioon.
  • Eelvaatefunktsioonid ei ole mõeldud kasutamiseks tootmises ja nende funktsioonid võivad olla piiratud. Need funktsioonid on saadaval enne ametlikku väljastamist, et kliendid saaksid sellele varakult juurdepääsu ja võiksid tagasisidet anda.

Funktsiooni kutsumine lõuendirakendusest või kohandatud lehelt

  1. Valige ala Funktsioonid alal Power Apps (make.powerapps.com) funktsioon, mille soovite lõuendirakendusest või kohandatud lehelt välja kutsuda.
  2. Valige käsuribal Kopeeri koodilõik .
  3. Kleepige ja salvestage kopeeritud valem tekstiredaktorisse, Notepadi või mujale, kuhu saate hõlpsasti viidata.
  4. In Power Apps Studio:
    1. Looge või muutke lõuendirakendust või kohandatud lehte rakenduses Power Apps Studio.
    2. Valige vasakpoolsel navigeerimispaanil vahekaardil AndmeallikadLisa andmed ja otsige suvandit Keskkond ja valige suvand Dataverse või valige see.
    3. Sisestage lõuendile järgmised komponendid:
      • Lisage sisendjuhtelemendid, mis vastavad iga parameetri andmetüübile (nt numbrisisend).
      • Funktsiooni kutsumiseks lisage nupp.
      • Lisage väljundi juhtelement, mis vastab teie parameetri andmetüübile (nt numbrisisend).
  5. Valige loodud nupp ja sisestage atribuudis OnSelect oma funktsioon, näiteks Environment.new_calculatesum.
  6. Kaardistage iga sisendparameeter Value , et viidata vastavatele sisendi juhtelementidele:
    • Kui teie funktsioon on Environment.new_CalculateSum({ X: Value, Y: Value });, võib selle ümber kirjutada järgmiselt: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Funktsiooni ’result’ väljundi määramiseks värskendage valemit väärtuseks Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))’.
  7. Valige väljundi juhtelement ja määrake atribuut "Väärtus" valemiga "result.z".

Vaadake oma rakenduse eelvaadet, sisestage sisendi 1 ja 2 väärtused ning valige nupp. Tulemus peaks ilmuma väljundväljale.

Funktsioonide käivitamine Power Automate pilvevoost

  1. Pilvevoos lisage Microsoft Dataverse konnektori kaudu uus toiming.
  2. Valige toiming nimega Soorita sidumata toiming
  3. Valige oma funktsioon. Funktsioonil on kordumatu nimi koos eesliitega.
  4. Esitage kõigi sisendparameetrite väärtused (kui need on olemas).

Funktsioonide käivitamine Dataverse veebi API-st

Järgige sidumata toimingute jaotiste juhiseid artiklis Kohandatud API-de kutsumine veebi API-st (olenevalt pistikprogrammi sobivast ulatusest).

Olemasolevate funktsioonide kutsumine uute funktsioonide seest

Olemasoleva funktsiooni käivitamiseks uues funktsioonis kasutage süntaksit: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Kuna väljund on alati kirje, kasutage väljundi parameetritele juurdepääsuks punktimärki. Näiteks kui funktsioonil "ExistingFunction" on kaks väljundparameetrit, mis on määratletud kui out1 ja out2, pääsete neile juurde ühel kahel viisil.

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

Funktsioonide piirangud Dataverse

  • Olemasolevates lõuendirakendustes uutele funktsioonidele juurdepääsemiseks tuleb keskkonna keeleobjekti lugeda. Kõigi funktsioonide puhul, mis on loodud pärast keskkonnatabeli andmeallika lisamist olemasolevasse lõuendirakendusse, peate eemaldama ja lugema keskkonnakeele objekti Power Fx . Seejärel näete toimingutena värskendatud funktsioonide loendit.
  • Pesastatud tugi. Funktsioonid saavad kutsuda ainult Microsofti poolt avaldatud Microsofti toiminguid Power Fx avaldistest.
  • Mõned Collect stsenaariumid nõuavad Patch. On stsenaariume, kus Collect() ei tööta. Lahenduseks on kasutada Patch() , nagu on näidatud siin veeru täitmise näites.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Siluge ja hankige oma funktsioonide osas abi

Kui teil tekib funktsiooni loomisel või käitamisel probleeme, kasutage silumiseks funktsiooni trace() või avage jaotises Funktsioonide piirangud jaotises Dataverse , et näha levinumaid probleeme.

Silumine funktsiooni trace() abil

  1. Jälgimisfunktsiooni abil silumiseks veenduge, et oleksite lubanud pistikprogrammi ja kohandatud töövoo tegevuse jälgimise.
  2. Minge aadressile Power Apps (make.powerapps.com), valige paremas ülanurgas hammasrattaikoon Settings ja seejärel valige Advance settings.
  3. Valige Seaded > Auditeerimine > Globaalsed auditi sätted.
  4. Veenduge, et vahekaardil Kohandamine oleks Luba logimine pistikprogrammi jälgimislogi jaoks lubatud Kõik.

Kui olete jälgimise lubanud, saate hakata kasutama trace()-funktsioone valemite silumiseks Power Fx . Lisateave selle kohta, kuidas kasutada funktsiooni trace() avaldises Power Fx : Jälgimisfunktsioon - Power Platform.

Abi + tugi poole pöördumine

Probleemide puhul, mis on seotud funktsioonidega, mida ei käsitleta Microsoft Dataverse madala koodiga pistikprogrammide näpunäidetes, ja teadaolevate probleemide (nt saadud dokumenteerimata vead) korral kasutage abi ja tugiteenust ja lisage järgmine teave.

  • Probleemi tüüp – Dataverse veebi API ja SDK.
  • Probleemi alamtüüp.

Näidisfunktsioonid

Looge ja kasutage funktsioone Microsoft Dataverse