Sdílet prostřednictvím

Vyvolání funkce z aplikace, toku, kódu nebo jiné funkce (Preview)

[Toto téma představuje předběžnou dokumentaci a může se změnit.]

Funkce v Dataverse můžete vyvolat z plátěné aplikace, vlastní stránky v modelově řízené aplikaci, toku, kódu nebo z jiné funkce.

Důležité

  • Toto je funkce ve verzi Preview.
  • Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Tyto funkce jsou k dispozici před oficiální verzí, aby zákazníci mohli získat dřívější přístup a poskytnout zpětnou vazbu.

Vyvolat funkci z canvas aplikace nebo vlastní stránky

  1. V oblasti Functions v Power Apps (make.powerapps.com) vyberte funkci, kterou chcete vyvolat z aplikace plátna nebo vlastní stránky.
  2. Na panelu příkazů vyberte Kopírovat fragment kódu .
  3. Vložte a uložte zkopírovaný vzorec do textového editoru, Poznámkového bloku nebo někam, kde můžete snadno odkazovat.
  4. V Power Apps Studiu:
    1. Vytvořte nebo upravte plátěnou aplikaci nebo vlastní stránku v Power Apps Studio.
    2. V levém navigačním podokně na kartě Zdroje dat vyberte Přidat data a v konektoru Dataverse vyhledejte možnost Prostředí a vyberte ji.
    3. Na plátno vložte následující součásti:
      • Přidejte vstupní ovládací prvky, které odpovídají datovému typu každého parametru, například číselnému vstupu.
      • Přidejte tlačítko pro volání funkce.
      • Přidejte výstupní ovládací prvek, který odpovídá datovému typu parametru, například číselnému vstupu.
  5. Vyberte tlačítko, které jste vytvořili, a ve vlastnosti OnSelect zadejte funkci, například Environment.new_calculatesum.
  6. Namapujte každý vstupní parametr Value na odpovídající vstupní ovládací prvky.
    • Pokud je Environment.new_CalculateSum({ X: Value, Y: Value });vaše funkce , může být přepsána takto: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Pokud chcete nastavit výstup funkce result, aktualizujte vzorec na Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value })).)
  7. Vyberte výstupní ovládací prvek a nastavte vlastnost Value vzorcem result.z.

Zobrazte náhled aplikace, zadejte vstupní hodnoty 1 a 2 a vyberte tlačítko. Výsledek by se měl zobrazit ve výstupním poli.

Vyvolání funkcí z toku cloudu Power Automate

  1. V cloudovém toku přidejte novou akci pomocí konektoru Microsoft Dataverse.
  2. Vyberte akci s názvem Provést nevázanou akci.
  3. Vyberte funkci. Funkce má jedinečný název s předponou.
  4. Zadejte hodnoty pro všechny vstupní parametry (pokud existuje).

Vyvolání funkcí z webového rozhraní API služby Dataverse

Postupujte podle pokynů pro sekce neomezených akcí v článku Vyvolání vlastních rozhraní API z webového rozhraní API (podle příslušného oboru doplňku).

Vyvolání existujících funkcí z nových funkcí

Pokud chcete vyvolat existující funkci v rámci nové funkce, použijte syntaxi: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Vzhledem k tomu, že výstup je vždy záznamem, použijte tečku pro přístup k výstupním parametrům. Pokud má například funkce ExistingFunction dva výstupní parametry definované jako out1 a out2, můžete k nim přistupovat jedním z těchto dvou způsobů:

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

Omezení funkcí v Dataverse

  • Pro přístup k novým funkcím v existujících aplikacích plátna je potřeba přečíst objekt jazyka prostředí. U všech funkcí vytvořených po přidání zdroje dat tabulky prostředí do existující aplikace plátna musíte odebrat a znovu přidat objekt jazyka prostředí Power Fx. Pak se zobrazí aktualizovaný seznam funkcí jako akce.
  • Vnořená podpora. funkce mohou z výrazů Power Fx volat pouze akce společnosti Microsoft publikované společností Microsoft.
  • Některé Collect scénáře vyžadují Patch. Některé scénáře Collect() nefungují. Alternativním řešením je použít Patch(), jak je ukázáno v příkladu vyplnění sloupce.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Ladění a získání nápovědy k funkcím

Pokud narazíte na problémy s vytvořením nebo spuštěním funkce, použijte trace() funkci pro ladění nebo přejděte na Omezení funkcí v Dataverse , kde najdete běžné problémy, ke kterým může dojít.

Ladění pomocí funkce trace()

  1. Pokud chcete ladit pomocí funkce trasování, ujistěte se, že povolíte sledování modulu plug-in a vlastní aktivity pracovního postupu.
  2. Přejděte do Power Apps (make.powerapps.com), vyberte ikonu ozubeného kolečka Nastavení v pravém horním rohu a pak vyberte Upřesnit nastavení.
  3. Vyberte Nastavení > Auditování > Globální nastavení auditu.
  4. Na kartě Vlastní nastavení se ujistěte, že je povolena možnost Povolit protokolování do protokolu trasování modulu plug-in pro Vše.

Jakmile povolíte sledování, můžete začít pomocí funkcí trace() ladit vzorce Power Fx. Přečtěte si další informace o tom, jak používat funkci trace() uvnitř výrazu Power Fx: Funkce Trace – Power Platform.

Kontaktování nápovědy a podpory

V případě problémů s funkcemi, které nejsou pokryté v tipech a známých problémech nízkokódových plug-inů Microsoft Dataverse, jako jsou nezdokumentované chyby, použijte službu Help + support a uveďte následující informace:

  • Typ problému – webové rozhraní API a sada SDK služby Dataverse
  • Podtyp problému.

Ukázkové funkce

Vytváření a používání funkcí v Microsoft Dataverse

  • Last updated on