Függvény meghívása alkalmazásból, folyamatból, kódból vagy más függvényből (előzetes verzió)

[Ez a témakör kiadás előtti dokumentáció, amely a későbbiekben változhat.]

A függvényeket Dataverse meghívhatja egy vászonalapú alkalmazásból, egy modellvezérelt alkalmazás egyéni oldaláról, egy folyamatból, kódból vagy egy másik függvényből.

Fontos

  • Ez egy előnézeti funkció.
  • Az előzetes funkciókat nem célszerű termelési környezetben használni, és előfordulhat, hogy korlátozott funkcionalitással rendelkeznek. Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.

Függvény meghívása vászonalapú alkalmazásból vagy egyéni oldalról

  1. A Függvények területen ( Power Apps make.powerapps.com) válassza ki azt a függvényt, amelyet meg szeretne hívni egy vászonalapú alkalmazásból vagy egyéni oldalról.
  2. Válassza a Kódrészlet másolása lehetőséget a parancssávon.
  3. Illessze be és mentse el a másolt képletet egy szövegszerkesztőbe, a Jegyzettömbbe vagy olyan helyre, amelyre könnyen hivatkozhat.
  4. In: Power Apps Studio
    1. Vászonalapú alkalmazás vagy egyéni oldal létrehozása vagy szerkesztése Power Apps Studio.

    2. A bal oldali navigációs panel Adatforrások lapján válassza az Adatok hozzáadása lehetőséget, keresse meg a Dataverse-összekötő környezeti tábláját, és jelölje ki.

      Note

      Ha a Környezeti tábla nem érhető el kijelölésre, hozzon létre egy új alkalmazást ugyanabban a környezetben a létrehozás elindításához.

    3. Szúrja be a következő összetevőket a vászonra:

      • Adjon hozzá olyan bemeneti vezérlőket, amelyek megfelelnek az egyes paraméterek adattípusának, például a számbevitelnek.
      • Adjon hozzá egy gombot a függvény meghívásához.
      • Adjon hozzá egy kimeneti vezérlőt, amely megfelel a paraméter adattípusának, például a számbevitelnek.
  5. Válassza ki a létrehozott gombot, és az OnSelect tulajdonságban adja meg a függvényt, például Environment.new_calculatesum.
  6. Az egyes bemeneti paraméterek Value leképezése a megfelelő bemeneti vezérlőkre való hivatkozáshoz:
    • Ha a függvényed igen Environment.new_CalculateSum({ X: Value, Y: Value });, akkor átírható a következőre: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • A függvény "eredmény" kimenetének beállításához frissítse a képletet a következőre: "Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))".
  7. Válassza ki a kimeneti vezérlőt, és állítsa be az "Érték" tulajdonságot a "result.z" képlettel.

Tekintse meg az alkalmazás előnézetét, adja meg az 1. és 2. bemeneti értékeket, majd válassza a gombot. Az eredménynek meg kell jelennie a kimeneti mezőben.

Függvények meghívása felhőfolyamatból Power Automate

  1. Felhőfolyamatban adjon hozzá egy új műveletet az Microsoft Dataverse összekötőből.
  2. Válassza ki a Kötetlen művelet végrehajtása nevű műveletet
  3. Válassza ki a függvényt. A függvény egyedi névvel és előtaggal rendelkezik.
  4. Adja meg az összes bemeneti paraméter értékét (ha van ilyen).

Függvények meghívása a Dataverse webes API-ból

Kövesse az Egyéni API-k meghívása a webes API-ból című cikk kötetlen műveletszakaszainak lépéseit (a beépülő modul megfelelő hatókörétől függően).

Meglévő függvények meghívása új függvényekből

Ha egy új függvényen belül egy meglévő függvényt szeretne meghívni, használja a következő szintaxist: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Mivel a kimenet mindig rekord, használja a pontjelölést a kimeneti paraméterek eléréséhez. Ha például a "LétezőFüggvény" függvény két kimeneti paraméterrel rendelkezik, amelyek out1 és out2 értéket tartalmaznak, akkor az alábbi kétféleképpen érheti el őket:

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

Korlátozások a függvényekkel Dataverse

  • A környezeti nyelvi objektumot újra hozzá kell adni az új függvények eléréséhez a meglévő vászonalapú alkalmazásokban. A környezeti tábla adatforrásának egy meglévő vászonalapú alkalmazáshoz való hozzáadása után létrehozott függvények esetében el kell távolítania, majd újra hozzá kell adnia a környezeti nyelvi objektumot Power Fx . Ezután megjelenik a függvények frissített listája műveletként.
  • Beágyazott támogatás. Függvények csak a Microsoft által közzétett Microsoft-műveleteket hívhatják meg kifejezésekből Power Fx .
  • Egyes Collect forgatókönyvek megkövetelik Patch. Vannak olyan forgatókönyvek, amikor Collect() nem működik. A megkerülő megoldás az itt található oszlop feltöltése példájában látható módon használható Patch() .
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Hibakeresés és segítségkérés a függvényekkel kapcsolatban

Ha problémákba ütközik a függvény létrehozása vagy futtatása során, használja a függvényt trace() hibakereséshez, vagy lépjen a függvények korlátozásai elemre Dataverse az esetlegesen előforduló gyakori problémákhoz.

Hibakeresés a trace() függvénnyel

  1. A nyomkövetési függvénnyel való hibakereséshez győződjön meg arról, hogy engedélyezte a beépülő modult és az egyéni munkafolyamat-tevékenység nyomon követését.
  2. Lépjen a következőre: Power Apps (make.powerapps.com), válassza a Beállítások fogaskerék ikont a jobb felső sarokban, majd válassza a Speciális beállítások lehetőséget .
  3. Válassza a Beállítások > Globális naplózási beállítások naplózása > lehetőséget.
  4. A Testreszabás lapon győződjön meg arról, hogy a Beépülő modul nyomkövetési naplójának naplózásának engedélyezése engedélyezve van az Összes számára.

A nyomon követés engedélyezése után elkezdheti használni a trace() függvényeket a képletek hibakereséséhez Power Fx . További információ a trace() függvény kifejezésen belüli Power Fx használatáról: Trace függvény - Power Platform.

Kapcsolatfelvétel a súgóval + támogatással

A kevés kódolást igénylő beépülő modulok tippjeiben nem szereplő Microsoft Dataverse funkciókkal kapcsolatos problémák és ismert problémák, például nem dokumentált hibák esetén használja a Súgó + támogatás felületet, és adja meg a következő információkat:

  • Probléma típusa – Dataverse Web API és SDK.
  • Probléma altípusa.

Példa függvények

Függvények létrehozása és használata a következő Microsoft Dataverse