Поделиться через

Создание и использование функций в Microsoft Dataverse (предварительная версия)

[Данный раздел посвящен предварительному выпуску и может быть изменен.]

Создавайте и повторно используйте функции в Microsoft Dataverse. Функции используют Power Fx для выполнения определенного набора команд, выполняемых в Dataverse на стороне сервера.

Внимание!

  • Это предварительная версия функции.
  • Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

Предварительные требования

Членство в роли безопасности настройщика системы в среде Power Platform.

Создание функции в решении

  1. Перейдите в Power Apps, и затем выберите Решения в левой области навигации. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.
  2. Откройте решение, в котором хотите создать функцию.
  3. На панели команд выберите Создать>Автоматизация>Функция.
  4. Введите следующую информацию на появившейся боковой панели Создать функцию.
    • Укажите отображаемое имя и описание функции.
    • Выберите Создать входной параметр и/или Создать выходной параметр, затем укажите имя и тип данных для параметра. При необходимости добавьте дополнительные входные и выходные параметры.
    • В списке Ссылки на таблицы можно дополнительно выбрать таблицы. Вы можете ссылаться на выбранные таблицы Dataverse с помощью функций сбора данных, таких как Filter() и LookUp()..
    • Введите выберите Power Fx в поле Формула.
  5. Выберите Сохранить.
  6. Протестируйте функцию.

Ссылайтесь на входные параметры в формуле по их названиям.

Ссылки на выходные параметры должны быть указаны внутри фигурных скобок, например { Out: "Return value" }.

Совет

  • Обратите внимание на IntelliSense в поле Формула. Компоненты с красным подчеркиванием являются недопустимыми. Волнистая желтая линия означает, что на вашу логику могут повлиять ограничения делегирования. Во избежание проблем с делегированием используйте делегируемые функции.
  • Разверните узел Дополнительные параметры, чтобы просмотреть имя схемы.

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

В этом разделе приведено несколько примеров функций.

Вычислить сумму двух целых чисел

  1. Введите Отображаемое имя, например new_calculateSum, и Описание.

  2. Добавьте два входных параметра, x и y (оба с целым типом данных), и один выходной параметр, z (тип данных целочисленный).

  3. В поле Формула введите формулу:
    { z:x+y }

    Функция, которая умножает два числа.

  4. Протестируйте функцию.

Добавление нового заголовка в таблицу статей

  1. Создайте два входных параметра title и url (оба со строковыми типами данных) и одну выходную переменную message (тип данных string).
  2. Выберите таблицу Федеративные статьи базы знаний в раскрывающемся списке Ссылки на таблицы.
  3. В поле Формула введите формулу:
Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

Проверка того, содержит ли входная строка выбранные строки

  1. Создайте входной параметр DocumentTextInput (со строковым типом данных) и одну выходную переменную с именем результат (строковый тип данных).
  2. В поле Формула введите формулу:
{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

Рассчитать стоимость проживания в отеле

  1. Создайте шесть входных параметров: nights, rooms, tax, discount, roomservice, ratepernight (все со строковым типом данных) и одну выходную переменную, price (тип данных float).
  2. В поле Формула введите формулу:
{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

Другие примеры функций

Дополнительные примеры функций см. в разделе Примеры функций (предварительная версия).

Редактирование, тестирование или удаление функции

Изменение функции

  1. Выберите функцию в области Функции.
  2. Выберите Изменить на панели команд.
  3. Измените формулу и затем Сохраните ее.

Тестирование функции

  1. Выберите функцию в области Функции.
  2. Выберите Тест на панели команд.
  3. Введите значения для входных параметров, определенных в функции, затем выберите Воспроизвести.

Успешный тест возвращает ответ OData, который включает такие сведения, как URI организации, имя функции, а также выходные параметры и значения.

Тестирование функции

Совет

Используйте выходные параметры для проверки того, соответствуют ли поведение и результаты тому, что вы ожидаете. В противном случае вы будете наблюдать только успех или неудачу при тестировании.

Удаление функции

Внимание!

Во время предварительной версии не удаляйте функции из области Решения, так как это может привести к появлению потерянных компонентов. Функции следует удалять, перейдя в раздел Power App (make.powerapps.com) >Функции на левой панели навигации.

  1. Выберите Функции на левой панели навигации, затем выберите свою функцию. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.
  2. В панели команд выберите Удалить.

Функции в Microsoft Dataverse (предварительная версия)

  • Last updated on