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


Передача данных в скрипты и из скриптов в Power Automate

Цепочки Power Automate разделяют программы в единый автоматизированный рабочий процесс. Каждый соединитель имеет разные параметры, которые он принимает, и различные значения, которые он возвращает. Скрипты можно написать, чтобы развернуть действие Power Automate "Запуск скрипта" для получения дополнительных входных данных или предоставления выходных данных.

Входные данные для скрипта задаются путем добавления параметров в функцию main . Выходные данные скрипта объявляют путем добавления типа возвращаемого значения в main.

Примечание.

При создании блока "Выполнить скрипт" в потоке заполняются принятые параметры и возвращаемые типы. Если вы измените параметры или типы возвращаемых значений скрипта, вам потребуется повторить блок "Запуск скрипта" потока. Это гарантирует, что данные анализируются правильно.

Передача данных в скрипты с параметрами

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

На следующем снимку экрана показано, что будет отображаться в скрипте с сигнатурой function main(workbook: ExcelScript.Workbook, location: string = "Seattle") .

Действие Выполнить скрипт с дополнительным полем параметра с именем Location (Расположение) с предварительно заполненным значением Seattle.

Раскрывающееся меню, созданное объединениями типов, также функционирует в Power Automate.

Действие Выполнить скрипт, показывающее дополнительное поле параметра

Возврат данных из скрипта

Скрипты могут возвращать данные из книги для использования в качестве динамического содержимого в потоке Power Automate. Чтобы вернуть объект, добавьте синтаксис возвращаемого типа в функцию main . Например, если вы хотите вернуть string значение из скрипта, ваша main подпись будет иметь значение function main(workbook: ExcelScript.Workbook): string.

Возвращаемые значения отображаются как динамическое содержимое из действия Выполнить скрипт в потоке. Динамическое содержимое называется result.

Селектор динамического содержимого в Power Automate, показывающий запись из действия выполнить скрипт с именем

Допустимые типы для возвращаемых данных такие же, как и для параметров. Сведения об ограничениях типов см. в статье Получение входных данных пользователем для сценариев.

См. также