Использование Power Fx в Power Pages (предварительная версия)

Статья
10/16/2024

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

Power Fx — это малокодовый язык для выражения логики в Microsoft Power Platform. Это универсальный, декларативный и функциональный язык программирования со строгой типизацией.

Power Fx выражается в удобном для человека тексте. Это малокодовый язык, с которым создатели могут работать непосредственно в строке формул в стиле Excel. Малый объем кода обусловлен лаконичной и простой природой языка, что упрощает выполнение общих задач программирования как для создателей, так и для разработчиков.

Заметка

Синтаксис для разработки формулы Power Fx может отличаться от того, к которому вы привыкли в Power Apps или Power Automate. Чтобы инициировать выражение Power Fx, оно должно начинаться с '=' (знак равенства), как в Excel. Дополнительные сведения см. в разделе Важные замечания.

Power Fx обеспечивает полный спектр разработки: от создателей, работающих без написания кода и каких-либо знаний программирования до профессиональных разработчиков. Это облегчает сотрудничество между различными рабочими группами, помогая им экономить время и усилия.

Важно

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

Использование Power Fx в Power Pages

На веб-сайте Power Pages язык Power Fx доступен как язык выражений для использования со следующими компонентами и их атрибутами. Эта функциональность обеспечивает динамическое присвоение значений на основе результатов выражений Power Fx.

Компонент	Свойства
Текст	Текст
Изображения	URL-адрес изображения, альтернативный текст
Button	URL-адрес кнопки, текст кнопки
Iframe	URL-адрес Iframe

Использование строки формул Power Fx

Панель инструментов содержит новую команду fx для компонентов, которые поддерживают Power Fx:

Снимок экрана: команда Power Fx на панели команд текстового элемента управления.

Выберите fx, чтобы получить доступ к строке формул Power Fx.

Компоненты строки формул

На следующем снимке экрана показаны некоторые важные компоненты строки формул:

Снимок экрана строки формул Power Fx в Power Pages.

Раскрывающееся меню позволяет выбирать доступные свойства компонента.
Многострочное расширяемое текстовое поле позволяет создавать формулы Power Fx.
Кнопка Сброс устанавливает для свойства компонента значение по умолчанию.
Кнопка Сохранить сохраняет формулу и выражения для свойства компонента. Холст студии немедленно обновляется, если результирующее значение доступно и может отображаться, например, в свойствах текста.

Функции строки формул

Ниже приведены некоторые ориентированные на разработчиков функции для повышения производительности:

Помощь при автозавершении: предлагает формулы, параметры, таблицы и объекты. Нажмите Ctrl + пробел, чтобы получить доступ к этой функции вручную.
Возможность просмотра проблем: помогает на ранней стадии проверки и отладки формул и выражений.
Диалоговое окно несохраненных изменений: отображается при выходе из строки формул при наличии несохраненных изменений в формуле.

Выберите Вернуться назад, чтобы продолжить редактирование формулы, или Отменить, чтобы отменить изменения.

Важные замечания

Учитывайте следующие рекомендации при использовании строки формул Power Fx в Power Pages:

Начать со знака равенства: текст можно вводить непосредственно в качестве значения. Чтобы инициировать выражение Power Fx, оно должно начинаться со знака «=» (знак равенства), как показано в следующем примере:
```
=Concatenate("Hello, ", User.FullName)
```
Защищенный доступ к таблицам: безопасный доступ к таблицам Dataverse можно получить с помощью формул. Сначала убедитесь, что разрешения таблицы настроены правильно. Также контекст пользователя сайта доступен с помощью объекта Пользователь. Например, следующее выражение извлекает значение DataverseUserId текущего пользователя, прошедшего проверку подлинности.
```
=Concatenate("Hello, ", First(Filter(Contacts,Contact = User.DataverseUserId)).'First Name' & "!")
```
Заметка

Объект Пользователь представляет собой пользователя Power Pages и, следовательно, не поддерживает тот же набор свойств, что и функция Пользователь.
Вставка значения в текст: чтобы вставить значение в текст, используйте следующий синтаксис.
```
This text ${variable/ expression} includes a dynamic value.
```
Например:
```
The total number is ${Sum(10, 20)}
```

Доступные функции Power Fx

Полный список всех доступных функций в Power Pages см. в Справочник по формулам — Power Pages.

Известные проблемы и ограничения

Некоторый функции Power Fx, представленные через IntelliSense, в настоящее время не поддерживаются в Power Pages. При использовании этих функций отображается следующая ошибка времени разработки:

Parameter 'Value': PowerFx type is not supported.
Система не инициирует пользователя для анонимных пользователей, что приводит к следующей ошибке при использовании его в любой форме, включая проверку на пустые значения. В будущем выпуске эта проблема будет решена.

UserInfo object was not added to service
Некоторые пользователи могут столкнуться с проблемами, когда свойства «Button» и «Image URL» не работают, если значение установлено с помощью формул или выражений Power Fx, содержащих двойные кавычки. Эта проблема возникает только в том случае, если у вас установлена версия 9.6.3.x, и устраняется при обновлении сайта Power Pages до версии 9.6.5.х.

Вопросы и ответы

Нужно ли использовать Power Fx вместо Liquid?

Power Fx выполняет определенные сценарии динамических данных с минимальным использованием кода, что также может быть достигнуто с применением кода Liquid с помощью средств для разработчиков. Решение Power Fx, которое в настоящее время находится на стадии общедоступной предварительной версии, рекомендуется использовать для пробной версии или оценки сайта в стадии разработки. Мы приветствуем ваши отзывы на этом этапе. Liquid — это общедоступная функция (GA), предоставляющая сравнительно больше возможностей. Используйте Liquid для своих производственных веб-сайтов, особенно в критически важных и сложных сценариях.

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