Действия Word
Функция автоматизации Word позволяет вам беспрепятственно взаимодействовать с файлами Word, хранящимися локально или в облаке. Для начала вам необходимо создать экземпляр Word, используя действие «Запустить Word» или «Подключиться к выполняемому Word». Этот экземпляр служит входным параметром для остальных действий в группе, позволяя легко выполнять действия с нужным файлом Word.
В настоящее время доступны перечисленные ниже действия:
- Запуск Word: когда это действие запускается в Power Automate для компьютеров, оно открывает документ Word и создает экземпляр Word, который можно использовать в последующих действиях Word в том же классическом потоке. Пользователь может открыть новый пустой документ Word или существующий документ, расположенный на локальном компьютере или в облаке (через OneDrive или SharePoint). В зависимости от конфигурации действия приложение Word может быть запущено видимым или невидимым образом, а документ может быть открыт в режиме только для чтения. Важно отметить, что если документ открыт в режиме только для чтения, его нельзя редактировать ни с помощью действий Power Automate для компьютера, ни вручную.
- Подключиться к выполняемому Word: это действие предоставляет возможность подключиться к существующему документу Word, который открыт в данный момент, и создать экземпляр Word, который можно использовать в последующих действиях Word в том же классическом потоке. Пользователь имеет возможность вставить документ Word, который уже открыт на том же компьютере во время проектирования, через раскрывающееся меню или выбрать существующий документ Word, расположенный на локальном компьютере или в облаке (через OneDrive или SharePoint).
- Сохранить Word: это действие позволяет пользователю сохранить документ Word в любом формате, который в настоящее время поддерживает приложение Word. Формат документа по умолчанию — «По умолчанию (из расширения)», что означает, что пользователь должен установить формат документа в параметре Путь к документу, например установить значение C:\TestWord.pdf, чтобы сохранить его в формате PDF.
- Закрыть Word: это действие закрывает документ Word и делает конкретный экземпляр Word в Power Automate неактивным. Пользователь может сохранить документ Word перед его закрытием в любом формате, который в настоящее время поддерживает приложение Word. Обратите внимание, что формат документа по умолчанию — «По умолчанию (из расширения)», что означает, что пользователь должен установить формат документа в параметре «Путь к документу», например установить значение C:\TestWord.pdf, чтобы сохранить его в формате PDF.
- Чтение из документа Word: это действие позволяет пользователям извлекать содержимое из документа Word и использовать его в последующем действии потока. У вас есть возможность прочитать весь документ, отдельные страницы или содержимое закладки. Для страниц можно указать конкретную страницу или список страниц. Например, вы можете вставить значение 2-5 в соответствующий параметр Страницы, чтобы получить содержимое страниц со второй по пятую, например страницы 2, 3, 4 и 5, или вставить значение 3,5,6,7, чтобы получить содержимое соответствующих страниц, или использовать комбинацию обоих способов, например 2-4,6,8,9. Важно отметить, что формат документа Word не может быть получен, а выходной параметр представлен в виде обычного текста.
- Поиск и замена слов в документе Word: с помощью этого действия пользователи могут применять новую функциональность, а именно возможность находить и заменять определенный текст в документе Word. Пользователи имеют возможность заменить только первое вхождение текста или все совпадения. Кроме того, использование подстановочных знаков позволяет осуществлять динамический поиск текста, при этом подстановочный знак вставляется во входной параметр Текст для поиска. Для дальнейшего уточнения поиска настройте инструмент на соответствие регистру текста или только целым словам. Эти настройки доступны, если параметр Использовать подстановочные знаки отключен.
- Записать в документ Word: это действие позволяет пользователям вставлять текст в определенные позиции в документе Word. Это можно сделать в начале или конце файла, или до либо после определенной закладки. Кроме того, пользователи имеют возможность добавлять или не добавлять новую строку перед вставленным текстом, в зависимости от своих предпочтений.
- Вставить изображение в документ Word: это действие позволяет пользователям вставлять изображения в определенные позиции в документе Word. Это можно сделать в начале или конце файла, до или после определенной закладки или до или после определенного текста. Обратите внимание, что пробелы и новые строки не добавляются. Пользователи имеют возможность получить изображение либо в виде файла, хранящегося на их локальном компьютере, либо в виде содержимого из буфера обмена.
Заметка
Действия Word в Power Automate для компьютеров совместимы с Microsoft Word 2013 или более поздними версиями.
Запуск Word
Открывает новый экземпляр Word или открывает документ Word.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Запуск Word | Неприменимо | С пустым документом, и открыть следующий документ | С пустым документом | Укажите, следует ли открыть новый документ Word или же существующий |
| Путь документа | Нет | Файлы | Полный путь к существующему документу Word, который нужно открыть | |
| Make instance visible | Неприменимо | Логическое значение | Истина | Укажите, нужно ли сделать окно Word видимым или же следует скрыть его |
| Open as ReadOnly | Неприменимо | Логическое значение | False | Укажите, следует ли открывать сохраненный документ в режиме только для чтения |
| Пароль защиты от чтения | Да | Прямой ввод зашифрованного текста или Текстовое значение | Пароль защиты от чтения документа Word, если он защищен паролем | |
| Пароль для защиты от записи | Да | Прямой ввод зашифрованного текста или Текстовое значение | Пароль защиты от записи документа Word, если он защищен паролем |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
WordInstance |
Экземпляр Word | Определенный экземпляр Word для использования с последующими действиями Word. Это позволяет пользователю указать, к какому из возможных нескольких документов Word следует получить доступ |
Исключения
| Исключение | Description |
|---|---|
| Не удалось запустить Word | Указывает на проблему при запуске экземпляра Word |
| Документ Word не найден | Указывает, что не удалось найти заданный документ Word в указанном местоположении |
| Не удалось открыть существующий документ Word | Указывает на проблему при открытии заданного документа Word |
| Не удалось запустить приложение Word | Указывает, что приложение Word не удалось запустить из-за внутренней ошибки |
| Приложение Word не установлено | Указывает, что приложение Word не установлено на конкретном компьютере |
Подключиться к выполняемому документу Word
Подключается к уже открытому документу Word.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Document name | Нет | Файлы | Имя или путь к документу Word для подключения |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
WordInstance |
Экземпляр Word | Экземпляр Word, к которому установило подключение это действие, для использования в последующих действиях с Word |
Исключения
| Исключение | Description |
|---|---|
| Не удалось подключиться к документу Word | Указывает на проблему при подключении к указанному документу Word |
| Указанный документ Word не найден | Указывает, что не удалось найти заданный документ Word в указанном местоположении |
| Не удалось запустить Word | Указывает, что приложение Word не удалось запустить из-за внутренней ошибки |
Сохранить Word
Сохраняет ранее запущенный экземпляр Word.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Экземпляр Word | Нет | Экземпляр Word | Экземпляр Word для сохранения. Эта переменная должна была быть ранее указана в действии Запустить Word или Подключиться к выполняемому Word. | |
| Режим сохранения | Неприменимо | Сохранить документ, Сохранить документ как | Сохранить документ | Как сохранить документ этого экземпляра. |
| Document format | Неприменимо | Все доступные форматы из приложения Word | По умолчанию (из расширения) | Формат документа. |
| Путь документа | Нет | Файлы | Полный путь к документу. Вставьте желаемое расширение файла документа в соответствии с выбором в параметр Формат документа. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Не удалось сохранить Word | Указывает на проблему при сохранении документа Word |
| Экземпляр Word или документ Word не инициализирован | Указывает, что экземпляр Word или документ Word, указанный в действии, не инициализирован |
| Операцию невозможно выполнить с документом, доступным только для чтения | Указывает, что документ Word невозможно сохранить, поскольку он открыт только для чтения |
Закрыть Word
Закрывает экземпляр Word.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Экземпляр Word | Нет | Экземпляр Word | Экземпляр Word, который требуется закрыть. Эта переменная должна была быть ранее указана в действии Запустить Word или Подключиться к выполняемому Word. | |
| Перед закрытием Word | Неприменимо | Не сохранять документ, Сохранить документ, Сохранить документ как | Не сохранять документ | Укажите, нужно ли сохранять документ в этом экземпляре перед закрытием экземпляра и как его сохранять. |
| Document format | Неприменимо | Все доступные форматы из приложения Word | По умолчанию (из расширения) | Формат документа. |
| Путь документа | Нет | Файлы | Полный путь к документу. Вставьте желаемое расширение файла документа в соответствии с выбором в параметр «Формат документа». |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Не удалось закрыть Word | Указывает на проблему при закрытии документа Word |
| Не удалось сохранить Word | Указывает на проблему при сохранении документа Word |
| Операцию невозможно выполнить с документом, доступным только для чтения | Указывает, что документ Word невозможно сохранить, поскольку он открыт только для чтения |
Читать из документа Word
Считывает текстовое содержимое из документа экземпляра Word.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Экземпляр Word | Нет | Экземпляр Word | Экземпляр Word, с которым требуется работать | Эта переменная должна была быть ранее указана в действии Запустить Word или Подключиться к выполняемому Word |
| Retrieve | Неприменимо | Весь документ/Страницы/Закладка | Весь документ | Получать ли содержимое всего документа, отдельных страниц или закладки |
| Страница | Нет | Числовое значение | 1 | Страницы документа Word, которые требуется прочитать. Диапазон страниц или список могут быть предоставлены как 2-5, при этом будет извлекаться содержимы со страниц со 2 по 5, или 2,3,7, чтобы получить содержимое со страниц 2, 3, 7 |
| Закладка | Нет | Текстовое значение | Закладка документа Word, которую требуется прочитать |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| WordData | Текстовое значение | Значение извлеченного содержимого |
Исключения
| Исключение | Description |
|---|---|
| Не удалось прочитать содержимое документа Word | Указывает на проблему с получением содержимого из указанного документа Word |
| Экземпляр Word или документ Word не инициализирован | Указывает, что экземпляр Word или документ Word, указанный в действии, не инициализирован |
Записать в документ Word
Записывает или добавляет текст в файл Word.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Экземпляр Word | Нет | Экземпляр Word | Экземпляр Word, с которым требуется работать | Эта переменная должна была быть ранее указана в действии Запустить Word или Подключиться к выполняемому Word |
| Text to write | Да | Общее значение | Текст, который требуется записать в указанный документ Word | |
| Append new line | Неприменимо | Логическое значение | Истина | Указывает, следует ли добавить новую строку в начала всего текста для записи в документ |
| Записать текст в | Неприменимо | Начало файла Word/Конец файла Word/До закладки/После закладки | Начало файла Word | Указывает положение в документе Word, куда будет добавлен текст |
| Закладка | Нет | Текстовое значение | Целевая закладка в документе Word, куда будет добавлен текст | Это действие добавляет текст до или после указанной закладки в документе Word |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Экземпляр Word или документ Word не инициализирован | Указывает, что экземпляр Word или документ Word, указанный в действии, не инициализирован |
| Операцию невозможно выполнить с документом, доступным только для чтения | Указывает, что документ Word невозможно изменить, поскольку он открыт только для чтения |
| Не удалось выполнить операцию записи в экземпляре документа Word | Указывает на проблему с записью содержимого в указанный документ Word |
Вставить изображение в документ Word
Вставка изображения в файл Word.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Экземпляр Word | Нет | Экземпляр Word | Экземпляр Word, с которым требуется работать | Эта переменная должна была быть ранее указана в действии Запустить Word или Подключиться к выполняемому Word |
| Вставить изображение в | Неприменимо | Начало файла Word/Конец файла Word/До закладки/После закладки/Перед определенным текстом/После определенного текста | Начало файла Word | Указывает положение в документе Word, куда будет добавлено изображение |
| Вставить изображение из | Неприменимо | Файл/Буфер обмена | Файлы | Расположение изображения, которое требуется вставить в указанный документ Word |
| Путь к изображению | Нет | Файлы | Полный путь к вставляемому изображению | |
| Текст для поиска | Нет | Текстовое значение | Текст, который нужно найти в документе Word для вставки изображения | Изображение будет добавлено до или после любого появления указанного текста |
| Закладка | Нет | Текстовое значение | Целевая закладка в документе Word, куда будет добавлено изображение |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Экземпляр Word или документ Word не инициализирован | Указывает, что экземпляр Word или документ Word, указанный в действии, не инициализирован |
| Операцию невозможно выполнить с документом, доступным только для чтения | Указывает, что документ Word невозможно изменить, поскольку он открыт только для чтения |
| Не удалось вставить изображение | Указывает на проблему со вставкой изображения в указанный документ Word |
Найти и заменить слова в документе Word
Находит текст и заменяет его другим текстом на активном листе экземпляра Excel.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Экземпляр Word | Нет | Экземпляр Word | Экземпляр Word, с которым требуется работать | Эта переменная должна была быть ранее указана в действии Запустить Word или Подключиться к выполняемому Word |
| Все совпадения | Неприменимо | Логическое значение | False | Следует ли найти/ и заменить текст во всех найденных вхождениях или только в первом найденном вхождении |
| Текст для поиска | Нет | Текстовое значение | Текст для поиска на листе | |
| Заменить на | Нет | Текстовое значение | Текст, используемый для замены текста в найденных ячейках | |
| Использовать подстановочные знаки | Неприменимо | Логическое значение | False | Использовать ли подстановочные знаки для искомого текста |
| Учитывать регистр | Неприменимо | Логическое значение | False | Следует ли учитывать при поиске регистр данных |
| Только слова целиком | Неприменимо | Логическое значение | False | Следует ли искать слова, совпадающие с указанным текстом |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Description |
|---|---|
| Не удалось заменить текст в документе Word | Указывает на проблему с заменой указанного текста на указанные входные данные |
| Экземпляр Word или документ Word не инициализирован | Указывает, что экземпляр Word или документ Word, указанный в действии, не инициализирован |
| Операцию невозможно выполнить с документом, доступным только для чтения | Указывает, что документ Word невозможно изменить, поскольку он открыт только для чтения |
Известные ограничения
Использование файлов Word, синхронизированных с помощью OneDrive или SharePoint
Взаимодействие с файлами Microsoft Word, содержащимися в папках, синхронизированных в OneDrive или SharePoint , может привести к ошибочному потоку. Power Automate для компьютеров использует объекты COM для взаимодействия с Word. OneDrive и SharePoint не полностью совместимы с экземплярами Word, запущенными через COM.
По этой причине при попытке открыть файл Word, хранящийся в каталоге OneDrive или SharePoint, вы можете столкнуться с ошибкой файл не найден. Чтобы устранить эту проблему, используйте одно из следующих временных решений:
Обходное решение 1
- Сделайте локальную копию соответствующего файла Word.
- Измените локальную копию файла Word, используя действия автоматизации Word из Power Automate для компьютеров.
- Переопределите копию файла Word, синхронизированную через OneDrive или SharePoint, локальной копией, содержащей последние изменения.
Обходное решение 2
- Откройте новый экземпляр Word с помощью действия Запустить приложение. Убедитесь, что вы предоставляете достаточно времени ожидания между действиями, позволяя процессу Word полностью загрузиться, включая любые надстройки.
- Используйте действие Подключиться к выполняемому Word , чтобы подключиться к новому процессу.
Заметка
Этот обходной путь обычно можно использовать, когда действие Запустить Word не удается выполнить.