Действия файла
Внимание
Чтобы предотвратить несанкционированный доступ, Windows требует права администратора для доступа к защищенным файлам. Чтобы получить доступ к этим ресурсам с помощью действий файлов, запустите Power Automate с правами администратора. Дополнительную информацию о выполнении Power Automate от имени администратора см. в разделе Выполнение Power Automate с повышенными правами.
Обработка файлов и их содержимого необходима для большинства сценариев автоматизации. Действия с файлами используются для управления файлами, извлечения их свойств, чтения и записи данных, а также их преобразования в другие типы.
Для большинства действий с файлами требуются пути, указывающие файлы, которыми вы хотите управлять. Эти пути могут быть жестко запрограммированными значениями или переменными с типом данных «файл».
Заметка
Чтобы предоставить несколько файлов в качестве входных данных, используйте список переменных с файловыми элементами. Способ создания списка файлов — это действие Получить файлы в папке.
Точно так же вы можете заполнить жестко заданное в коде значение или переменную типа данных папки, чтобы указать папку назначения в действиях, которые в ней нуждаются.
Некоторые действия с файлами имеют обширную конфигурацию, позволяющую автоматизировать практически любой сценарий. Например, действие Переименовать файлы включает параметры для установки нового имени или добавления, замены или удаления текстовой строки к существующему имени файла.
Чтобы добавить текстовое содержимое или перезаписать текстовые файлы, разверните действие Записать текст в файл. Чтобы прочитать содержимое текстового файла, используйте действие Чтение текста из файла.
Аналогичным образом, если вам нужно прочитать или записать содержимое в CSV-файлы, используйте действия Чтение из CSV-файла и Запись в CSV-файл. Вы можете найти пример классического потока, который обрабатывает файлы CSV, в разделе Преобразование CSV-файла в электронную таблицу Excel.
Если вы хотите проверить, существует ли файл в определенной папке, используйте действие Если файл существует. Это действие является условным и позволяет запускать разные блоки кода в зависимости от того, существует ли файл. Дополнительную информацию об условных выражениях см. в статье Использование условных выражений.
Если файл существует
Помечает начало условного блока действий в зависимости от того, существует ли файл.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| If file | Н/Д | Существует, Не существует | Существует | Состояние файла для проверки |
| Путь к файлу | Нет | Файл | Полный путь к папке, в которой следует искать файл |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Ожидать файла
Приостановить выполнение автоматизации до тех пор, пока файл не будет создан или удален.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Wait for file to be | Н/Д | Создано, Удалено | Создано | Указывает, следует ли приостановить поток при создании или удалении определенного файла. |
| Путь к файлу | Нет | Файл | Полный путь к папке, в которой следует искать файл |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Копировать файлы
Копирует один или несколько файлов в папку назначения.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| File(s) to copy | Нет | Списокфайлов | Файлы для копирования. Это значение может представлять собой путь к файлу или переменную, содержащую файл, список файлов, текстовый путь или список текстовых путей. Используйте действие "Получить файлы в папке", чтобы заполнить переменную списком файлов. | |
| Папка назначения | Нет | Папка | Папка назначения для копируемых файлов | |
| If file exists | Н/Д | Ничего не делать, Перезаписать | Ничего не делать | Указывает, что нужно сделать, если в папке назначения уже есть файл с таким именем |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| CopiedFiles | Списокфайлов | Скопированные файлы в виде списка файлов |
Исключения
| Исключение | Описание |
|---|---|
| Исходная папка не существует. | Указывает, что исходная папка не существует. |
| Папка назначения не существует. | Указывает, что папка назначения не существует. |
| Файл не найден | Указывает, что файл не существует. |
| Невозможно скопировать файл | Указывает на проблему при копировании файла. |
Переместить файлы
Перемещает один или несколько файлов в папку назначения.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| File(s) to move | Нет | Списокфайлов | Файлы для перемещения. Это значение может представлять собой путь к файлу или переменную, содержащую файл, список файлов, текстовый путь или список текстовых путей. Используйте действие "Получить файлы в папке", чтобы заполнить переменную списком файлов. | |
| Папка назначения | Нет | Папка | Папка назначения для перемещаемых файлов | |
| If file exists | Н/Д | Ничего не делать, Перезаписать | Ничего не делать | Указывает, что нужно сделать, если в папке назначения уже есть файл с таким именем |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| MovedFiles | Списокфайлов | Перемещенные файлы в виде списка файлов |
Исключения
| Исключение | Описание |
|---|---|
| Исходная папка не существует. | Указывает, что исходная папка не существует. |
| Папка назначения не существует. | Указывает, что папка назначения не существует. |
| Файл не найден | Указывает, что файл не существует. |
| Невозможно переместить файл | Указывает на проблему при перемещении файла. |
Удалить файлы
Удаляет один или несколько файлов.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| File(s) to delete | Нет | Списокфайлов | Файлы для удаления. Это значение может представлять собой путь к файлу или переменную, содержащую файл, список файлов, текстовый путь или список текстовых путей. Используйте "Получить файлы в папке", чтобы заполнить переменную списком файлов |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Путь к файлу не существует. | Указывает, что путь к файлу не существует. |
| Файл не найден | Указывает, что файл не существует. |
| Невозможно удалить файл. | Указывает на проблему при удалении файла. |
Переименовать файлы
Изменяет имя одного или нескольких файлов.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Файлы для переименования | Нет | Списокфайлов | Файлы для переименования. Это значение может представлять собой путь к файлу или переменную, содержащую файл, список файлов, текстовый путь или список текстовых путей. Используйте действие "Получить файлы в папке", чтобы заполнить переменную списком файлов. | |
| Add number to | Неприменимо | Логическое значение | Истина | Указывает, следует ли добавлять номер к существующим именам файлов или к новому имени. |
| Rename scheme | Н/Д | Задать новое имя, Добавить текст, Удалить текст, Заменить текст, Изменить расширение, Добавить дату и время, Сделать последовательными | Задать новое имя | Указывает, как следует переименовать файлы. |
| New file name | Нет | Текстовое значение | Новое имя файлов | |
| New extension | Да | Текстовое значение | Текст, который следует добавить в качестве нового расширения для файлов | |
| New file name | Нет | Текстовое значение | Новое имя файлов | |
| Add number to | Н/Д | После имени, Перед именем | После имени | Указывает, следует ли номер добавлять перед исходными именами или новым базовым именем или после них. |
| Text to add | Да | Текстовое значение | Текст для добавления к исходным именам файлов | |
| Text to remove | Да | Текстовое значение | Текст для удаления из исходных имен файлов. При этой схеме выполняется поиск по всем именам файлов, после чего из них удаляются все вхождения указанного фрагмента. | |
| Text to replace | Нет | Текстовое значение | Текст для замены в исходных именах файлов. При этой схеме выполняется поиск по всем именам файлов, после чего в них заменяется все вхождения введенного текста | |
| Use custom datetime | Н/Д | Логическое значение | Ложь | Указывает, следует ли использовать пользовательские дату и время. |
| Datetime to add | Н/Д | Текущая дата и время, Время создания, Последнее обращение, Последнее изменение | Текущие дата и время | Указывает, какое значение даты и времени следует добавить к именам файлов. |
| Keep extension | Н/Д | Логическое значение | Истина | Указывает, следует ли включать предыдущее расширение в имена файлов. Отключите этот параметр, чтобы добавить расширение к файлам вручную. |
| Replace with | Да | Текстовое значение | Текст, которым будет заменен исходный текст | |
| Start numbering at | Нет | Числовое значение | Начальное значение номера | |
| Add text | Н/Д | После имени, Перед именем | После имени | Указывает, следует ли текст добавлять перед исходными именами или после них. |
| Custom datetime | Нет | Дата и время | Дата и время для добавления к именам файлов | |
| Increment by | Нет | Числовое значение | Шаг последовательного увеличения начального значения | |
| Add datetime | Н/Д | После имени, Перед именем | После имени | Указывает, следует ли дату и время добавлять перед исходными именами или после них. |
| Separator | Н/Д | Ничего, Пробел, Тире, Точка, Подчеркивание | ПРОБЕЛ | Указывает, как отделить исходное имя файла от добавляемого номера. Разделитель также может полностью отсутствовать. |
| Separator | Н/Д | Ничего, Пробел, Тире, Точка, Подчеркивание | ПРОБЕЛ | Указывает, как отделить исходное имя файла от добавляемого значения даты и времени. Разделитель также может полностью отсутствовать. |
| Use padding | Н/Д | Логическое значение | False | Указывает, следует ли использовать заполнение. |
| Формат «Дата и время» | Нет | Текстовое значение | ггггММдд | Формат значения даты и времени для добавления к имени файла, например ММ/дд/гггг для даты и чч:мм:сс для времени |
| Make each number at least | Да | Числовое значение | 3 | Минимальная длина каждого добавляемого номера |
| If file exists | Н/Д | Ничего не делать, Перезаписать | Ничего не делать | Указывает, что нужно сделать, если в папке уже есть файл с таким именем. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| RenamedFiles | Списокфайлов | Переименованные файлы в виде списка файлов |
Исключения
| Исключение | Описание |
|---|---|
| Каталог не найден | Указывает, что каталог не найден. |
| Файл не найден | Указывает, что файл не существует. |
| Невозможно переименовать файл | Указывает на проблему при переименовании файла. |
Читать текст из файла
Считывает содержимое текстового файла.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| File path | Нет | Файл | Файл для чтения | |
| Store content as | Н/Д | Единое текстовое значение, Список (каждая строка — элемент списка) | Единое текстовое значение | Указывает, как хранить текст. Выберите "Единое текстовое значение", чтобы сохранить весь текст как одно текстовое значение. Выберите «Список», чтобы сохранить каждую строку исходного текста как текстовый элемент в списке. |
| Кодировка | Неприменимо | Системное значение по умолчанию, ASCII, Unicode, Unicode с обратным порядком байтов, UTF-8 | UTF-8 | Кодировка для чтения указанного текста из текстового файла. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| FileContents | Текстовое значение | Содержимое в виде текста |
| FileContents | Списоктекстовых значений | Содержимое в виде списка текстов |
Исключения
| Исключение | Описание |
|---|---|
| Каталог не найден | Указывает, что каталог не найден. |
| Файл не найден | Указывает, что файл не существует. |
| Не удалось прочитать файл. | Указывает на проблему при чтении файла. |
Записать текст в файл
Записывает или добавляет текст в файл.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Путь к файлу | Нет | Файл | Файл для записи текста. Это значение может представлять собой путь к файлу, переменную, содержащая файл, или текстовый путь. | |
| Text to write | Да | Общее значение | Текст, который необходимо записать в указанный файл | |
| Append new line | Н/Д | Логическое значение | Истина | Указывает, следует ли добавить новую строку в конец всего текста при записи в файл. |
| If file exists | Н/Д | Перезаписать существующее содержимое, Добавить содержимое | Перезаписать существующее содержимое | Указывает, следует ли перезаписать существующее содержимое или добавить в конец существующего содержимого. Если файл не существует, это действие автоматически создает его. |
| Кодировка | Неприменимо | Системное значение по умолчанию, ASCII, Unicode, Unicode (с обратным порядком байтов), UTF-8, Unicode (без маски порядка байтов), UTF-8 (без маски порядка байтов) | Unicode | Кодировка для записи указанного текста в текстовый файл |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Не удалось записать текст в файл. | Указывает на проблему при записи в файл. |
| Недопустимый каталог для файла | Указывает, что указан недопустимый каталог |
Читать из CSV-файла
Считывает CSV-файл в таблицу данных.
Вы можете использовать действие Читать из CSV-файла, чтобы создать переменную таблицы данных, содержащую содержимое файла. Вам необходимо определить путь к файлу CSV и кодировку, которая будет использоваться для его чтения. Также вы можете удалить любые пробелы из извлеченных ячеек, обработать первую строку как заголовки столбцов и указать разделитель столбцов.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Путь к файлу | Нет | Файл | CSV-файл для чтения. Это значение может представлять собой путь к файлу, переменную, содержащая файл, или текстовый путь | |
| Encoding | Н/Д | UTF-8, Unicode, Unicode (с обратным порядком байтов), UTF-8 (без метки порядка байтов), Unicode (без метки порядка байтов), Системное значение по умолчанию, ASCII | UTF-8 | Кодировка, которая будет использоваться для чтения указанного CSV-файла |
| Trim fields | Неприменимо | Логическое значение | Истина | Указывает, следует ли автоматически удалять пробелы в начале и в конце извлеченных ячеек. |
| First line contains column names | Н/Д | Логическое значение | Ложь | Указывает, следует ли использовать первую строку ресурса CSV для установки имен столбцов варианта результирующей таблицы данных. Включите этот параметр, чтобы имена не считывались как данные в таблицу. Последующие действия могут получить доступ к данным, содержащимся в таблице данных, используя имена столбцов (вместо номеров столбцов). |
| Columns separator | Неприменимо | Предварительно определенный, Произвольный, Фиксированная ширина столбцов | Предварительно определенный | Указывает, следует ли использовать предварительно определенный разделитель столбцов, пользовательский разделитель или же столбцы фиксированной ширины. |
| Separator | Н/Д | По умолчанию, Запятая, Точка с запятой, Символ табуляции | По умолчанию | Разделитель столбцов для анализа CSV-файла |
| Custom separator | Нет | Текстовое значение | Пользовательский разделитель столбцов для анализа указанного ресурса CSV | |
| Fixed column widths | Нет | Текстовое значение | Фиксированная ширина столбцов для использования при анализе указанного ресурса CSV. Разделите значения ширины с помощью запятых, пробелов, символов табуляции или новой строки. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| CSVTable | Таблица данных | Содержимое CSV-файла в виде таблицы данных |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось прочитать CSV-файл. | Указывает на проблему при чтении CSV-файла. |
Записать в CSV-файл
Записывает таблицу данных, строку данных или список в CSV-файл.
Используйте действие Записать в файл CSV, чтобы записать таблицу данных, строку данных или переменную списка в целевой файл CSV. В параметре Путь к файлу укажите путь к файлу или переменную, содержащую файл или текстовый путь, куда будут экспортированы данные.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Variable to write | Нет | Общее значение | Таблица данных, переменная строки данных или переменная списка для записи в целевой CSV-файл | |
| Путь к файлу | Нет | Файл | CSV-файл для экспорта переменной. Это значение может представлять собой путь к файлу, переменную, содержащая файл, или текстовый путь. | |
| Кодировка | Неприменимо | UTF-8, Unicode, Unicode (с обратным порядком байтов), UTF-8 (без метки порядка байтов), Unicode (без метки порядка байтов), Системное значение по умолчанию, ASCII | UTF-8 | Кодировка для записи указанного CSV-файла |
| Include column names | Н/Д | Логическое значение | Ложь | Указывает, должны ли имена столбцов указанного варианта стать первой строкой файла CSV. Этот параметр вступает в силу только в том случае, если целевой CSV-файл изначально не существует или существует, но в остальном не содержит текста. |
| Если файл существует | Неприменимо | Перезаписать существующее содержимое, Добавить содержимое | Перезаписать существующее содержимое | Указывает желаемое поведение, если целевой CSV-файл уже существует в файловой системе. |
| Separator | Н/Д | По умолчанию, Запятая, Точка с запятой, Символ табуляции | По умолчанию | Разделитель столбцов для использования в указанном CSV-файле |
| Custom columns separator | Нет | Текстовое значение | Пользовательский разделитель столбцов для использования в CSV-файле | |
| Use custom columns separator | Н/Д | Логическое значение | Ложь | Указывает, следует ли использовать пользовательский разделитель столбцов или же предварительно определенный разделитель. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Не удалось выполнить запись. | Указывает на проблему при записи в CSV-файл. |
Получить часть пути к файлу
Извлекает одну или несколько частей (каталог, имя файла, расширение и т. д.) из текста, представляющего путь к файлу.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Путь к файлу | Нет | Файл | Путь к файлу, который будет использоваться в качестве исходного |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| RootPath | Файл | Путь к корневому каталогу исходного файла |
| Каталог | Папка | Каталог исходного файла |
| FileName | Текстовое значение | Имя исходного файла |
| FileNameNoExtension | Текстовое значение | Имя исходного файла (без расширения) |
| FileExtension | Текстовое значение | Расширение (например, .doc) исходного файла |
Исключения
| Исключение | Описание |
|---|---|
| Путь к файлу содержит недопустимые символы | Указывает, что путь к файлу не существует |
Получить временный файл
Создает на диске пустой файл с уникальным именем и получает объект файла (т. е. представление, позволяющее обращаться к файлу и информации в нем).
Входные параметры
Это действие не требует никаких входных данных.
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| TempFile | Файл | Объект временного файла |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось создать временный файл | Указывает на проблему при создании временного файла |
Преобразовать файл в Base64
Преобразование файла в текст в кодировке Base64.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Путь к файлу | Нет | Файл | Путь к файлу, из которого производится чтение |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| Base64Text | Текстовое значение | Текст в кодировке Base64 |
Исключения
| Исключение | Описание |
|---|---|
| Файл не найден | Указывает, что файл не существует |
| Не удается преобразовать файл в Base64 | Указывает, что предоставленный файл невозможно преобразовать в текст в кодировке Base64 |
Преобразовать Base64 в файл
Преобразование текста в кодировке Base64 в файл.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Текст в кодировке Base64 | Нет | Текстовое значение | Текст в кодировке Base64 | |
| Путь к файлу | Нет | Файл | Файл, в который производится запись | |
| Если файл существует | Неприменимо | Ничего не делать, Перезаписать | Ничего не делать | Указывает, что нужно сделать, если в папке назначения уже есть файл с таким именем |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Недопустимый каталог для файла | Указывает, что указан недопустимый каталог |
| Не удается преобразовать Base64 в файл | Указывает, что предоставленный текст в кодировке Base64 невозможно преобразовать в файл |
Преобразовать файл в двоичные данные
Преобразовать файл в двоичные данные.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Путь к файлу | Нет | Файл | Файл, из которого производится чтение. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| BinaryData | Текстовое значение | Двоичные данные для записи. |
Исключения
| Исключение | Description |
|---|---|
| Файл не найден | Указывает, что файл не существует. |
| Не удается преобразовать файл в двоичные данные | Указывает, что предоставленный файл невозможно преобразовать в двоичные данные |
Преобразовать двоичные данные в файл
Преобразовать двоичные данные в файл.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Двоичные данные | Нет | Текстовое значение | Двоичные данные. | |
| Путь к файлу | Нет | Файл | Файл, в который производится запись | |
| Если файл существует | Неприменимо | Ничего не делать, Перезаписать | Ничего не делать | Указывает, что нужно сделать, если в папке назначения уже есть файл с таким именем |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Недопустимый каталог для файла | Указывает, что указан недопустимый каталог |
| Не удается преобразовать двоичный файл в файл | Указывает, что предоставленные двоичные данные невозможно преобразовать в файл |