Извикване на функция от приложение, поток, код или друга функция (визуализация)

[Тази тема е предварителна версия на документацията и подлежи на промяна.]

Можете да извикате функции Dataverse от приложение за платно, персонализирана страница в приложение, управлявано от модел, поток, код или от друга функция.

Важно

  • Това е функция за предварителен преглед.
  • Функциите за предварителен преглед не са предназначени за производствена употреба и може да са с ограничена функционалност. Тези функции са достъпни преди официалното издание, за да могат клиентите да получат ранен достъп и да дадат обратна връзка.

Извикване на функция от приложение за платно или персонализирана страница

  1. От областта Функции in Power Apps (make.powerapps.com) изберете функцията, която искате да извикате от приложение за платно или персонализирана страница.
  2. Изберете Копиране на кодов фрагмент в командната лента.
  3. Поставете и запазете копираната формула в текстов редактор, Notepad или някъде, към което лесно можете да се обърнете.
  4. В Power Apps Studio:

    1. Създайте или редактирайте приложение за платно или персонализирана страница в Power Apps Studio.

    2. В левия навигационен екран, под раздела Източници на данни изберете Добавяне на данни, потърсете таблицата Среда от конектора на Dataverse и го изберете.

      Забележка

      Ако таблицата "Среда" не е налична за избор, създайте ново приложение в същата среда, за да активирате създаването му.

    3. Вмъкнете следните компоненти върху платното:

      • Добавете контроли за въвеждане, които съответстват на типа данни на всеки параметър, като например въвеждане на число.
      • Добавете бутон за извикване на функцията.
      • Добавете изходна контрола, която съответства на типа данни на параметъра, като например въвеждане на число.
  5. Изберете бутона, който сте създали, и в свойството OnSelect въведете функцията си, като например Environment.new_calculatesum.
  6. Картографирайте всеки входен параметър Value , за да се позовава на съответните входни контроли:
    • Ако вашата функция е Environment.new_CalculateSum({ X: Value, Y: Value });, тя може да бъде пренаписана като: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • За да зададете изхода на функцията "резултат", актуализирайте формулата си на "Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))".
  7. Изберете изходната контрола и задайте свойството "Стойност" с формула "result.z".

Визуализирайте приложението си, въведете стойности за въвеждане 1 и 2 и изберете бутона. Резултатът трябва да се покаже в изходното поле.

Извикване на функции от облачен Power Automate поток

  1. В облачен поток добавете ново действие от конектора Microsoft Dataverse .
  2. Изберете действието, наречено Извършване на необвързано действие
  3. Изберете вашата функция. Функцията има уникално име с префикс.
  4. Посочете стойности за всички входни параметри (ако има такива).

Извикване на функции от Dataverse уеб API

Изпълнете стъпките за секциите за необвързани действия в статията Извикване на персонализирани API от уеб API (в зависимост от подходящия обхват на добавката).

Извикване на съществуващи функции от нови функции

За да извикате съществуваща функция в нова функция, използвайте синтаксиса: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Тъй като изходът винаги е запис, използвайте точковата нотация за достъп до изходните параметри. Например, ако функцията "ExistingFunction" има два изходни параметъра, дефинирани като out1 и out2, можете да получите достъп до тях по един от тези два начина:

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

Ограничения с функции в Dataverse

  • Обектът на езика на средата трябва да бъде добавен отново за достъп до нови функции в съществуващите приложения за платно. За всички функции, създадени след добавянето на източника на данни на таблицата на средата към съществуващо приложение за платно, трябва да премахнете и добавите отново обекта на езика Power Fx на средата. След това виждате актуализирания списък с функции като действия.
  • Вложена опора. функции могат да извикват само действия на Microsoft, публикувани от Microsoft от Power Fx изрази.
  • Някои Collect сценарии изискват Patch. Има някои сценарии, при които Collect() не работи. Заобиколното решение е да се използва Patch() , както е показано в примера за попълване на колоната за попълване тук.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Отстраняване на грешки и получаване на помощ за вашите функции

Ако срещнете проблеми при създаването или изпълнението на функцията, използвайте trace() функцията за отстраняване на грешки или отидете на Ограничения с функции за Dataverse често срещани проблеми, които могат да възникнат.

Отстраняване на грешки с помощта на функцията trace()

  1. За отстраняване на грешки с помощта на функцията за проследяване, уверете се, че сте разрешили проследяване на активността на приставката и персонализирания работен поток.
  2. Отидете на Power Apps (make.powerapps.com), изберете иконата на зъбно колело Настройки в горния десен ъгъл и след това изберете Разширени настройки.
  3. Изберете Настройки > Проверка > на глобалните настройки за проверка.
  4. В раздела Персонализиране се уверете, че Разрешаване на регистриране в дневника за проследяване на добавката е разрешено за Всички.

След като активирате проследяването, можете да започнете да използвате функциите trace() за отстраняване на грешки Power Fx във формули. Научете повече за това как да използвате функцията trace() в Power Fx израз: Trace function - Power Platform.

Свързване с помощ + поддръжка

За проблеми с функции, които не са обхванати в Microsoft Dataverse съветите за добавки с нисък код, и за известни проблеми, като например получени недокументирани грешки, използвайте поддръжката на Помощ + и включете следната информация:

  • Тип проблем - Dataverse Web API и SDK.
  • Подтип на проблема.

Примерни функции

Създаване и използване на функции в Microsoft Dataverse

  • Last updated on