Vyvolanie funkcie z aplikácie, toku, kódu alebo inej funkcie (ukážka)

[Táto téma je predbežnou dokumentáciou a môže sa zmeniť.]

Funkcie v Dataverse môžete vyvolať z aplikácie plátna, vlastnej stránky v modelom riadenej aplikácii, toku, kódu alebo inej funkcie.

Dôležité

  • Toto je ukážková funkcia.
  • Funkcie ukážky nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.

Vyvolajte funkciu z aplikácie na plátne alebo vlastnej stránky

  1. V oblasti Funkcie v Power Apps (make.powerapps.com) vyberte funkciu, ktorú chcete vyvolať z aplikácie na plátne alebo vlastnej stránky.
  2. Na paneli príkazov vyberte možnosť Kopírovať útržok kódu .
  3. Prilepte a uložte skopírovaný vzorec do textového editora, poznámkového bloku alebo niekam, kam sa môžete ľahko odvolať.
  4. V Power Apps Studio:

    1. Vytvorte alebo upravte aplikáciu na plátne alebo vlastnú stránku v Power Apps Studio.

    2. Na ľavej navigačnej table na karte Zdroje údajov vyberte položku Pridať údaje, v konektore Dataverse vyhľadajte tabuľku Prostredie a vyberte ju.

      Poznámka

      Ak na výber nie je k dispozícii tabuľka Prostredie , vytvorte novú aplikáciu v tom istom prostredí, čím sa spustí jej vytvorenie.

    3. Vložte na plátno nasledujúce súčasti:

      • Pridajte ovládacie prvky vstupu, ktoré zodpovedajú typu údajov každého parametra, ako je napríklad zadávanie čísel.
      • Pridajte tlačidlo na zavolanie funkcie.
      • Pridajte ovládací prvok výstupu, ktorý zodpovedá typu údajov vášho parametra, ako je napríklad vstup čísla.
  5. Vyberte tlačidlo, ktoré ste vytvorili, a vo vlastnosti OnSelect zadajte svoju funkciu, napríklad Environment.new_calculatesum.
  6. Mapujte každý vstupný parameter Value tak, aby odkazoval na príslušné ovládacie prvky vstupu:
    • Ak je vaša funkcia Environment.new_CalculateSum({ X: Value, Y: Value });, môže byť prepísaná ako: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Ak chcete nastaviť výstup funkcie „výsledok“, aktualizujte svoj vzorec na „Nastaviť (výsledok, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))“.
  7. Vyberte ovládanie výstupu a nastavte vlastnosť 'Value' pomocou vzorca 'result.z'.

Ukážte svoju aplikáciu, zadajte vstupné hodnoty 1 a 2 a vyberte tlačidlo. Výsledok by sa mal zobraziť vo výstupnom poli.

Vyvolávajte funkcie z Power Automate cloudového toku

  1. V cloudovom toku pridajte novú akciu z konektora Microsoft Dataverse .
  2. Vyberte akciu s názvom Vykonajte neviazanú akciu
  3. Vyberte svoju funkciu. Funkcia má jedinečný názov s predponou.
  4. Zadajte hodnoty pre všetky vstupné parametre (ak existujú).

Vyvolávajte funkcie z Dataverse Web API

Postupujte podľa krokov pre sekcie neviazaných akcií v článku Vyvolanie vlastných rozhraní API z webového rozhrania API (v závislosti od vhodného rozsahu doplnku).

Vyvolávajte existujúce funkcie z nových funkcií

Ak chcete vyvolať existujúcu funkciu v rámci novej funkcie, použite syntax: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Keďže výstupom je vždy záznam, na prístup k výstupným parametrom použite bodkovú notáciu. Napríklad, ak má funkcia "ExistingFunction" dva výstupné parametre definované ako out1 a out2, môžete k nim pristupovať jedným z týchto dvoch spôsobov:

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

Obmedzenia s funkciami v Dataverse

  • Aby ste získali prístup k novým funkciám v rámci existujúcich aplikácií plátna, je potrebné načítať objekt jazyka prostredia. Pre všetky funkcie vytvorené po pridaní zdroja údajov tabuľky prostredia do existujúcej aplikácie plátna musíte odstrániť a prečítať objekt jazyka prostredia Power Fx . Potom uvidíte aktualizovaný zoznam funkcií ako akcie.
  • Vnorená podpora. Funkcie môžu volať iba akcie Microsoftu publikované spoločnosťou Microsoft z Power Fx výrazov.
  • Niektoré Collect scenáre vyžadujú Patch. Existujú scenáre, v ktorých Collect() nefunguje. Riešením je použiť Patch() ako je uvedené v príklade vypĺňania stĺpca tu.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Laďte a získajte pomoc s vašimi funkciami

Ak narazíte na problémy pri vytváraní alebo spúšťaní funkcie, použite na ladenie funkciu trace() alebo prejdite na stránku Obmedzenia s funkciami v Dataverse , kde nájdete bežné problémy, ktoré sa môžu vyskytnúť.

Ladenie pomocou funkcie trace().

  1. Ak chcete ladiť pomocou funkcie sledovania, uistite sa, že máte povolený doplnok a sledovanie aktivity vlastného pracovného toku.
  2. Prejdite na Power Apps (make.powerapps.com), vyberte ikonu ozubeného kolieska Nastavenia v pravom hornom rohu a potom vyberte Rozšírené nastavenia.
  3. Vyberte Nastavenia > Audit > Globálne nastavenia auditu.
  4. Na karte Prispôsobenie skontrolujte, či je pre Všetky povolené prihlásenie do denníka sledovania doplnku .

Keď povolíte sledovanie, môžete začať používať funkcie trace() na ladenie vzorcov Power Fx . Prečítajte si viac o tom, ako používať funkciu trace() vo výraze Power Fx : Funkcia sledovania - Power Platform.

Kontaktovanie pomoci + podpory

V prípade problémov s funkciami, ktoré nie sú zahrnuté v Microsoft Dataverse tipoch pre doplnky s nízkym kódom, a známych problémoch, ako sú prijaté nezdokumentované chyby, použite Pomocník + podporu a zahrňte nasledujúce informácie:

  • Typ problému- Dataverse Webové rozhranie API a SDK.
  • Podtyp problému.

Príklady funkcií

Vytvárajte a používajte funkcie v Microsoft Dataverse

  • Last updated on