Группа «Word»

Взять таблицу / Get table

Задача: необходимо сохранить таблицу из документа Word в переменную типа «таблица».

Решение: воспользоваться действиями: «Открыть», «Взять таблицу», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий группы Word.

  • Настроить параметры действия «Открыть».

  • Настроить параметры действия «Взять таблицу».

  • Настроить параметр действия «Закрыть».

  • Запустить робота по кнопке «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Таблица получена.

Дополнительно

Для чек-бокса «С заголовком»:

Работа параметра: При значении «true» действие первую строку исходной таблицы сохранит в заголовок возвращаемого табличного значения, т.е. она не будет являться строкой с содержимым таблицы.
При «false» первую строку оставит в части с содержимым таблицы, а в заголовке будут использоваться названия по умолчанию - 1, 2, 3 и т.д.

Пример. Забираем таблицу:

При включенном параметре в логе будет указано «Столбцов: 3; строк: 2», т.к. Первая строка взятой области стала заголовком с названиями столбцов «№», «Название» и «Тесты». К этим заголовкам нельзя обратиться как к строке данных, чтобы прочитать, но можно использовать имена столбцов, чтобы обратиться к конкретной ячейке или столбцу (действиями из группы «Таблицы»). Если параметр выключен, то в логе будет указано «Столбцов: 3; строк: 3», названия столбцов в заголовке будут «1», «2» и «3».

Для чек-бокса «Убрать дубли заголовка»:

При значении «true», в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1. Пример №1. Есть таблица:

При «Убрать дубли заголовка» = true, и «С заголовком» = True, действие «Взять таблицу» вернет таблицу из 10 строк и 4х столбцов. Названия столбцов этой таблицы будут «№», «Название робота», «Тесты1», «Тесты2».

Пример №2. Есть таблица:

При «Убрать дубли заголовка» = true, и «С заголовком» = True, действие «Взять таблицу» вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут: «Тест31», «Тест21», «Тест22», «Тест32», «Тест1».

При значении «false», названия столбцов останутся прежними. Действия на net, которые возвращаютобрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов.

Например, в исходной таблице есть столбцы «Тест1», «Тест» и «Тест». Если добавлять индексы только к текущим дублям, то названия станут такими «Тест1», «Тест1» и «Тест2», т.е. в итоге появятся новые дубли с названием «Тест1». Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как «Тест1», «Тест2» и «Тест3».

Ввести текст / Enter text

Описание

Добавляет текст в документ.

Иконка

Параметры

Входные параметры

Контекст Уникальный идентификатор сеанса, к которому будет применено действие. Текст Текст, которой необходимо добавить в документ Word. Место добавления Место в документе, куда будет добавлен текст в виде выпадающего списка.

Выпадающий список:
  • Начало документа
  • Конец документа
  • После закладки
Название закладки Название закладки, после которой необходимо ввести текст.
Предполагается, что поле для заполнения станет доступным после выбора значения «После закладки» в параметре «Место добавления» С новой строки Текст будет добавлен с новой строки.

Настройки

Особые условия использования

В защищенных документах действие вставляет текст только в незаблокированные поля. Для этого необходимо установить закладку перед незаблокированным полем с помощью действия «Создать закладку», после чего в действии «Ввести текст» указать в параметре «Место добавления» - «После закладки» и указать название закладки в параметре «Название закладки». Так, ввод текста будет произведен в первом незаблокированном поле после указанной закладки.

Пример использования

Задача: существует файл test (2).docx. Необходимо открыть документ и добавить туда запись = «тестовая запись» в начало документа. Далее, сохранить документ и закрыть.

Решение: воспользоваться действием «Открыть», «Ввести текст», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Заполнить параметры для действия «Открыть».

В поле «Путь к файлу» указать путь к файлу test (2).docx

  • Заполнить параметры для действия «Ввести текст».

В поле «Контекст» указать созданный контекст в п.1 В поле «Текст» указать значение «тестовая запись». В поле «Место добавления» указать значение «Начало документа».

  • Перетащить на рабочую область действие «Сохранить как» и заполнить его параметр.

В поле «Контекст» указать контекст открытого документа.

  • Перетащить на рабочую область действие «Закрыть» и заполнить его параметр.

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Требуемый текст добавлен в документ. Файл сохранен и закрыт.

Взять закладки / Get bookmarks

Задача: существует файл test (2).docx. В нем установлена закладка с именем «Закладка1». Необходимо получить имя закладки в переменную и ввести текст после закладки «New text». Далее, сохранить документ и закрыть.

Решение: воспользоваться действием «Открыть», «Взять закладки», «Получить значение по индексу», «Ввести текст», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры для действия «Открыть».

В поле «Путь к файлу» указать путь к файлу test (2).docx

  • Настроить параметры для действия «Взять закладки».

В переменную «Контекст» указать контекст открытого документа. В переменную «Результат» указать переменную типа «Коллекция» (в данном случае «Имена закладок»).

  • Настроить параметры для действия «Получить значение по индексу».

  • Настроить параметры для действия «Ввести текст».

В поле «Контекст» указать созданный контекст в п.1 В поле «Текст» указать значение «New text». В поле «Место добавления» указать значение «После закладки». В поле «Название закладки» указать результат действия «Получить значение по индексу». Проставить чекбокс=true в поле «С новой строки».

  • Настроить параметры для действия «Сохранить как».

В поле «Контекст» указать контекст открытого документа.

  • Настроить параметр для действия «Закрыть».

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Текст добавлен в документ после закладки. Файл сохранен и закрыт.

Взять текст / Get text

Задача: существует файл test (2).docx. с записями имен. Необходимо получить текст документа в переменную типа «Строка». Далее, сохранить документ и закрыть.

Решение: воспользоваться действием «Открыть», «Взять текст», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Заполнить параметры для действия «Открыть».

В поле «Путь к файлу» указать путь к файлу test (2).docx

  • Заполнить параметры для действия «Взять текст».

В поле «Контекст» указать созданный контекст в п.1.

В поле «Результат» указать текстовую переменную, созданную ранее.

  • Заполнить параметр для действия «Сохранить как».

В поле «Контекст» указать контекст открытого документа.

  • Заполнить параметр для действия «Закрыть».

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Текст сохранен из документа в переменную «Текст». Файл сохранен и закрыт.

Закрыть / Close document

Задача: существует файл test (2).docx. Необходимо открыть документ и добавить туда запись = «тестовая запись» в начало документа. Далее, сохранить документ и закрыть.

Решение: воспользоваться действием «Открыть», «Ввести текст», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Заполнить параметры для действия «Открыть».

В поле «Путь к файлу» указать путь к файлу test (2).docx

  • Заполнить параметры для действия «Ввести текст».

В поле «Контекст» указать созданный контекст в п.1 В поле «Текст» указать значение «тестовая запись». В поле «Место добавления» указать значение «Начало документа».

  • Перетащить на рабочую область действие «Сохранить как» и заполнить его параметр.

В поле «Контекст» указать контекст открытого документа.

  • Перетащить на рабочую область действие «Закрыть» и заполнить его параметр.

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Требуемый текст добавлен в документ. Файл сохранен и закрыт.

Заменить текст/ Replace text

Описание

Действие заменяет все вхождения строки в документе другой строкой.

Иконка

Параметры

Входные параметры

*Контекст Контекст действия для работы с Word-документом.

*Заменить Текст, который необходимо заменить. Длина текста не должна превышать 254 символа.

*На Новое значение для текста, который необходимо заменить. Длина текста не должна превышать 254 символа.

*Заменить совпадение При выборе соответствующего значения будут заменены все совпадения или только первое.

Настройки

Особые условия использования

В защищенных документах действие работает только с незаблокированными полями.

Задача: существует Word-документ с текстом имен. Необходимо заменить имя Саша на Петя (все совпадения).

Решение: воспользоваться действиями «Открыть», «Заменить текст», «Сохранить как».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры для действия «Открыть».

В поле «Путь к файлу» указать путь по которому располагается требуемый файл; В поле «Видимый» проставить чек-бокс = true для открытия файла в видимом режиме.

  • Настроить параметры для действия «Заменить текст».

В поле «Контекст» указать контекст открытого документа; В поле «Заменить» указать значение в тексте, которое подлежит изменению; В поле «На» указать на какое значение необходимо заменить указанный текст; В поле «Заменить совпадение» указать значение - Все совпадения.

  • Настроить параметры для действия «Сохранить как».

Указать в поле «Word-документ» контекст документа. Документ будет сохранен.

  • Запустить робота по кнопке «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Требуемый текст заменен.

Открыть / Open document

Описание

Открывает Word-документ.

Иконка

Параметры

Входные параметры

*Путь до файла Путь к файлу, который необходимо открыть.

*Видимый Указывать, если документ необходимо открыть с интерфейсом Word. Иначе документ будет открыт в фоновом режиме.

*Пароль Пароль от защищенного документа.

Выходные параметры

Результат

*Контекст Уникальный идентификатор открытого сеанса

Настройки

Особые условия использования

Если на документе установлен пароль, необходимо ввести его в параметре «Пароль». При указании неверного пароля робот бросит ошибку. Если параметр «Пароль» не заполнен, а на документе установлен пароль, то робот бросит ошибку.

Пример использования

Задача: существует файл test (2).docx. Необходимо открыть документ и добавить туда запись = «тестовая запись» в начало документа. Далее, сохранить документ и закрыть.

Решение: воспользоваться действием «Открыть», «Ввести текст», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Заполнить параметры для действия «Открыть».

В поле «Путь к файлу» указать путь к файлу test (2).docx

  • Заполнить параметры для действия «Ввести текст».

В поле «Контекст» указать созданный контекст в п.1 В поле «Текст» указать значение «тестовая запись». В поле «Место добавления» указать значение «Начало документа».

  • Перетащить на рабочую область действие «Сохранить как» и заполнить его параметр.

В поле «Контекст» указать контекст открытого документа.

  • Перетащить на рабочую область действие «Закрыть» и заполнить его параметр.

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Требуемый текст добавлен в документ. Файл сохранен и закрыт.

Сохранить как / Save as

Задача: существует файл test (2).docx. Необходимо открыть документ и добавить туда запись = «тестовая запись» в начало документа. Далее, сохранить документ и закрыть.

Решение: воспользоваться действием «Открыть», «Ввести текст», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Заполнить параметры для действия «Открыть».

В поле «Путь к файлу» указать путь к файлу test (2).docx

  • Заполнить параметры для действия «Ввести текст».

В поле «Контекст» указать созданный контекст в п.1 В поле «Текст» указать значение «тестовая запись». В поле «Место добавления» указать значение «Начало документа».

  • Перетащить на рабочую область действие «Сохранить как» и заполнить его параметр.

В поле «Контекст» указать контекст открытого документа.

  • Перетащить на рабочую область действие «Закрыть» и заполнить его параметр.

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Требуемый текст добавлен в документ. Файл сохранен и закрыт.

Вставить изображение / Insert image

Описание

Действие вставляет изображение в указанное место Word-документа.

Указывается Word-документ, изображение для вставки и место его добавления. Также по желанию можно указать размер изображения и возможность добавления его с новой строки.

Иконка

Параметры

Входные параметры:

  • Контекст - контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия «Открыть» (группа «Word»).

  • Изображение - путь к файлу изображения, которое необходимо вставить в документ.

  • Высота - высота в пикселях, на которое изменится указанное изображение. Параметр учитывается только, если заполнен параметр «Ширина». Иначе изображение останется в исходном размере.

  • Ширина - ширина в пикселях, на которое изменится указанное изображение. Параметр учитывается только, если заполнен параметр «Высота». Иначе изображение останется в исходном размере.

  • Место добавления - место в документе, куда необходимо вставить изображение. Доступно 3 варианта: Начало документа, Конец документа, После закладки.

  • Название закладки - название закладки, после которой будет вставлено изображение. Параметр учитывается только, если заполнен параметр «Место добавления» - После закладки.

  • С новой строки - параметр, с помощью которого указанное изображение вставляется с новой строки. Последующий текст после изображения также переносится на новую строку. Примеры с выключенным и включенным параметром соответственно:

    Параметр «С новой строки» выключен:

    Параметр «С новой строки» включен:

Настройки

Параметр разметки вставленного изображения -«В тексте»:

Если выбрано место добавления после закладки, то необходимо указать имя закладки. Иначе робот выдаст ошибку.

Если указано в параметрах указано и имя закладки и место добавления, но место добавления отличное от «после закладки» , то действие будет игнорировать параметр имени закладки.

Если выбрано место добавления после закладки, но в документе отсутствуют какие-либо закладки, то робот выдаст ошибку.

Если один из параметров высоты или ширины не будет заполнен, то изображение вставится в документ в своем размере.

Действие не работает с заблокированными полями в защищенных документах. В этом случае робот выдаст ошибку.

Пример использования

Задача: имеется Word-документ. Необходимо вставить изображение после закладки.

Документ:

Решение: воспользоваться действиями «Открыть», «Вставить изображение», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры действия «Открыть». В поле «Путь к файлу» указать путь к файлу Word-документа. В поле «Видимый» проставить чекбокс = true.

  • Настроить параметры действия «Вставить изображение». В поле «Контекст» указать экземпляр Word-документа, в котором необходимо вставить изображение. В поле «Изображение» указать путь к изображению для вставки. В полях «Высота» и «Ширина» указать необходимый размер изображения. В поле «Место добавления» указать «После закладки». В поле «Название закладки» указать имя существующей закладки после которой будет вставлено изображение. В поле «С новой строки» указать чекбокс = true.

  • Настроить параметры действия «Сохранить как» В поле «Контекст» указать экземпляр Word-документа, который нужно сохранить.

  • Настроить параметры действия «Закрыть». В поле «Контекст» указать экземпляр Word-документа, который нужно закрыть.

  • Запустить робота по кнопке «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Изображение вставилось в указанное место.

Word-документ:

Вставить таблицу / Insert table

Описание

Действие вставляет готовую таблицу в указанную область Word-документа.

Указывается Word-документ, таблица для вставки и место вставки. Также есть возможность перенести таблицу с заголовком или без.

Иконка

Параметры

Входные параметры:

  • Контекст - контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия «Открыть» (группа «Word»).
  • Таблица - таблица, которую необходимо вставить.
  • С заголовком - параметр, с помощью которого можно вставить таблицу с заголовком или без.
  • Место вставки - место в документе, куда необходимо вставить таблицу. Доступно 3 варианта: Начало документа, Конец документа, После закладки.
  • Название закладки - название закладки, после которой необходимо вставить таблицу. Параметр учитывается, если заполнен параметр «Место вставки» - После закладки.

Настройки

Особые условия использования

Если выбрано место добавления после закладки, то необходимо указать имя закладки. Иначе робот выдаст ошибку.

Если указано имя закладки, но выбрано другое место добавления, то действие будет игнорировать параметр имени закладки.

Если выбрано место добавления после закладки, но в документе отсутствуют какие-либо закладки, то робот выдаст ошибку.

Действие не работает с заблокированными полями в защищенных документах. В этом случае робот бросит ошибку.

Пример использования

Задача: имеется Word-документ. Необходимо вставить таблицу после закладки.

Документ:

Решение: воспользоваться действиями «Открыть», «Вставить таблицу», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры действия «Открыть». В поле «Путь к файлу» указать путь к файлу Word-документа. В поле «Видимый» проставить чекбокс = true.

  • Настроить параметры действия «Вставить таблицу». В поле «Контекст» указать экземпляр Word-документа, в котором необходимо вставить таблицу. В поле «Таблица» указать таблицу для вставки. В поле «С заголовком» указать чекбокс = true. В поле «Место добавления» указать «После закладки». В поле «Название закладки» указать имя существующей закладки после которой будет вставлена таблица.

  • Настроить параметры действия «Сохранить как». В поле «Контекст» указать экземпляр Word-документа, который нужно сохранить.

  • Настроить параметры действия «Закрыть». В поле «Контекст» указать экземпляр Word-документа, который нужно закрыть.

  • Запустить робота по кнопке «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Изображение вставилось в указанное место.

Word-документ:

Форматировать текст / Format text

Описание

Действие форматирует указанный текст.

Указывается Word-документ, название закладки, относительно которой будет форматироваться текст, и параметры форматирования.

Иконка

Параметры

Входные параметры:

  • Контекст - контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия «Открыть» (группа «Word»).
  • Название закладки - название закладки, с которой будет изменен текст. Будет изменен весь текст от закладки и до конца документа или до начала следующей закладки при ее наличии. Если в закладке указан точный отрывок текста, к которому она относится, то изменен будет только этот текст. Можно указать сразу несколько закладок, указав каждое название через «;». Если закладка не будет указана, то форматирование применится ко всему документу.
  • Убрать форматирование - параметр, с помощью которого можно привести текст к классическому формату: черный цвет текста без курсива, полужирности, подчеркивания и выделения.
  • Полужирный - выделение текста полужирным шрифтом.
  • Курсив - выделение текста курсивом.
  • Подчеркнутый - выделение текста подчеркиванием.
  • Размер текста - установка размера шрифта текста. Диапазон возможного размера от 1 до 1638. Размер должен быть кратен 0.5.
  • Цвет текста - установка цвета шрифта текста. Доступно 11 вариантов: Темно-красный, Красный, Оранжевый, Желтый, Светло-зеленый, Зеленый, Голубой, Синий, Темно-синий, Сиреневый, Черный.
  • Цвет выделения текста - установка выделения текста. Доступно 16 вариантов: Нет цвета, Желтый, Зеленый, Бирюзовый, Розовый, Синий, Красный, Темно-синий, Сине-зеленый, Зеленый, Фиолетовый, Бордовый, Коричнево-зеленый, Серый, Светло-серый, Черный.

Настройки

Особые условия использования

Если указано имя несуществующей закладки, то робот выдаст ошибку.

Если указан текст, но не указан ни один параметр режима форматирования, действие ничего не меняет.

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

Если выбран элемент режима форматирования, а также отмена режима форматирования, робот выдаст ошибку.

Если в параметре размера шрифта будет указано число не входящее в диапазон, робот выдаст ошибку.

Действие не работает с заблокированными полями в защищенных документах. В этом случае робот выдаст ошибку.

Пример использования

Задача: имеется Word-документ. Необходимо задать новый режим форматирования, применимый к тексту всего документа.

Документ:

Решение: воспользоваться действиями «Открыть», «Форматировать текст», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры действия «Открыть». В поле «Путь к файлу» указать путь к файлу Word-документа. В поле «Видимый» проставить чекбокс = true.

  • Настроить параметры действия «Форматировать текст». В поле «Контекст» указать экземпляр Word-документа, в котором необходимо форматировать текст. В поле «Полужирный» указать чекбокс = true. В поле «Курсив» указать чекбокс = true. В поле «Подчеркнутый» указать чекбокс = true. В поле «Размер текста» указать «15». В поле «Цвет текста» указать «Зеленый». В поле «Цвет выделения текста» указать «Желтый».

  • Настроить параметры действия «Сохранить как». В поле «Контекст» указать экземпляр Word-документа, который нужно сохранить.

  • Настроить параметры действия «Закрыть». В поле «Контекст» указать экземпляр Word-документа, который нужно закрыть.

  • Запустить робота по кнопке «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Тексту всего документа задано новое форматирование.

Word-документ:

Получить количество элементов / Get number of elements

Описание

Действие возвращает количество элементов указанного типа из Word-документа.

Указывается Word-документ и тип элементов для подсчета. Также возможен учитыватьне учитывать сноски и надписи при подсчете.

Иконка

Параметры

Входные параметры:

  • Контекст - контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия «Открыть» (группа «Word»).
  • Тип элементов - тип элементов, который необходимо посчитать. Доступно 5 вариантов: Изображения, Таблицы, Символы, Слова, Страницы.
  • Учитывать надписи и сноски - подсчет элементов с учетом или не учетом надписей и сносок в документе.

Выходные параметры:

  • Результат - количество подсчитанных в документе элементов.

Настройки

Пример использования

Задача: имеется Word-документ. Необходимо посчитать количество слов.

Решение: воспользоваться действиями «Открыть», «Посчитать количество элементов», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры действия «Открыть». В поле «Путь к файлу» указать путь к файлу Word-документа. В поле «Видимый» проставить чекбокс = true.

  • Настроить параметры действия «Посчитать количество элементов». В поле «Контекст» указать экземпляр Word-документа, в котором необходимо посчитать количество слов. В поле «Тип элементов» указать «Слова».

  • Настроить параметры действия «Сохранить как». В поле «Контекст» указать экземпляр Word-документа, который нужно сохранить.

  • Настроить параметры действия «Закрыть». В поле «Контекст» указать экземпляр Word-документа, который нужно закрыть.

  • Запустить робота по кнопке «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Действие вернуло количество слов в документе.

Создать закладку / Create bookmark

Описание

Действие создает закладку в указанном месте Word-документа.

Указывается Word-документ, название новой закладки, место добавления, текст, относительно которого будет добавлена закладка, и номер совпадения этого текста в документе. Также есть возможность указать номер страницы, где будет произведено добавление.

Иконка

Параметры

Входные параметры:

  • Контекст - контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия «Открыть» (группа «Word»).
  • Название закладки - название новой закладки. Ограничения для названия: в документе не должно быть закладки с таким же названием; не превышает 40 символов; начинается с буквы; отсутствуют пробелы.
  • Номер страницы - номер страницы документа, где будет установлена новая закладка. Если параметр не заполнен, то поиск текста будет произведен по всему документу.
  • Текст - текст в документе, относительно которого будет установлена новая закладка.
  • Место добавления - расположение закладки относительно указанного текста. Доступно 3 варианта: Перед текстом, После текста, Вставить текст в закладку. При выборе «Вставить текст в закладку» - указанный текст и будет закладкой.
  • Номер совпадения текста - номер совпадения текста, относительно которого будет установлена закладка. Нумерация начинается с 1. Если нужно указать последнее совпадение в документе, но порядковый номер совпадения неизвестен, то необходимо указать -1.

Настройки

Особые условия использования

Если в документе уже есть закладка с введенным именем, то робот вернет ошибку.

Если пользователь не укажет номер страницы, то поиск текста будет осуществлен по всему документу.

Если пользователь укажет порядковый номер совпадения, который отсутствует в документе, то робот выдаст ошибку.

Если пользователь укажет порядковый номер совпадения «0» или меньше «-1», робот выдаст ошибку.

Если пользователь укажет текст, который отсутствует в документе, робот выдаст ошибку.

Если пользователь укажет несуществующий номер страницы, робот выдаст ошибку.

Пример использования

Задача: имеется Word-документ. Необходимо создать новую закладку после текста «Кавказский пленник».

Документ:

Решение: воспользоваться действиями «Открыть», «Создать закладку», «Сохранить как», «Закрыть».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры действия «Открыть». В поле «Путь к файлу» указать путь к файлу Word-документа. В поле «Видимый» проставить чекбокс = true.

  • Настроить параметры действия «Создать закладку». В поле «Контекст» указать экземпляр Word-документа, в котором необходимо создать закладку. В поле «Название закладки» указать имя новой закладки.. В поле «Текст» указать «Кавказский пленник». В поле «Место добавления» указать «После текста». В поле «Номер совпадения текста» указать «1».

  • Настроить параметры действия «Сохранить как». В поле «Контекст» указать экземпляр Word-документа, который нужно сохранить.

  • Настроить параметры действия «Закрыть». В поле «Контекст» указать экземпляр Word-документа, который нужно закрыть.

  • Запустить робота по кнопке «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Новая закладка создалась.

Имена закладок в Word-документе:

Запустить макрос/ Run macro

Описание

Действие запускает указанный макрос в Word-документе.

Более подробно по работе с макросами можно посмотреть тут:

https://support.microsoft.com/ru-ru/office/%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA-%D0%BC%D0%B0%D0%BA%D1%80%D0%BE%D1%81%D0%B0-c6b99036-905c-49a6-818a-dfb98b7c3c9c /

https://lumpics.ru/how-to-create-a-macro-in-word/?ysclid=lnjxq1a0ca542683172/

https://pikabu.ru/story/osnovyi_programmirovaniya_v_microsoft_word_rabota_s_makrosami_5469153?ysclid=lnjxws167k969472532/

Иконка

Параметры

Входные параметры:

  • Поле «Контекст» - Экземпляр Word-документа, в котором будет запущен макрос.
  • Поле «Имя макроса» - Наименование макроса, который будет запущен.

Настройки

Особые условия использования

Макрос предварительно должен быть создан в Word, можно либо создать свой макрос, либо вставить готовый в данное поле и сохранить его при помощи клавиш CTRL+S.

Пример использования

Задача:

Существует Word-документ «Тестовый документ». Необходимо запустить макрос, который будет заменять все вхождения буквы “е” на букву “ё”.

Решение:

Для любых действий с конкретным Word-документом, сначала необходимо открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу.

  1. Открыть документ «Teкстовый документ.dokm».
  2. Запустить макрос.
  3. Сохранить документ.

Реализация:

  1. Открыть группу действий «Word».
  2. Поместить в рабочее пространство студии действие «Открыть».
  1. Поместить в рабочее пространство студии действие «Запустить макрос» и настроить его параметры.
  1. Поместить в рабочее пространство студии действие «Сохранить как», настроить его параметры.

  2. Поместить в рабочее пространство студии действие «Закрыть», настроить его параметры.

  3. Запустить робота по кнопке «Запуск» в верхней панели.

Результат:

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

Запустить внешний макрос/ Run external macro

Описание

Действие запускает в Word-документе макрос, VBA-код которого указан в отдельном текстовом файле.

Более подробно по работе с макросами можно посмотреть тут:

https://support.microsoft.com/ru-ru/office/%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA-%D0%BC%D0%B0%D0%BA%D1%80%D0%BE%D1%81%D0%B0-c6b99036-905c-49a6-818a-dfb98b7c3c9c /

https://lumpics.ru/how-to-create-a-macro-in-word/?ysclid=lnjxq1a0ca542683172/

https://pikabu.ru/story/osnovyi_programmirovaniya_v_microsoft_word_rabota_s_makrosami_5469153?ysclid=lnjxws167k969472532/

Иконка

Параметры

Входные параметры:

  • Контекст Экземпляр Word-документа, в котором будет запущен внешний макрос.
  • Путь к макросу Путь к текстовому файлу макроса, который содержит VBA-код.
  • Имя процедуры Имя вызываемой функции или подпрограммы, которая указана в VBA-коде макроса.
  • Входной параметр Значения входных параметров вызываемой функции или подпрограммы в коде макроса. Значения параметров необходимо указывать в том же порядке, в каком эти параметры указаны в вызываемой функции.

Настройки

Особые условия использования

  1. В параметрах безопасности должен быть выбран чек-бокс “Доверять доступ к объектной модели проектов VBA“.

  2. Если необходимо указать несколько параметров, пользователь должен указать в поле «Параметры» коллекцию, содержащую эти параметры.

  3. Значения параметров необходимо указывать в том же порядке, в каком эти параметры указаны в вызываемой функции.

  4. Русский язык не поддерживается в названии макроса (функции).

Пример использования

Задача:

Существует Word-документ. Нужно запустить в этом документе внешний макрос.

Решение:

Для реализации действия необходимо выполнить следующие действия - «Открыть», «Запустить внешний макрос». Предварительно должен быть создан внешний макрос.

Реализация

  1. Собрать робота, состоящего из следующих действий:

  2. Настроить параметры для действия «Открыть».

  3. Настроить параметры для действия «Запустить внешний макрос».

  4. Настроить параметры действия «Сохранить как».

  1. Настроить параметры действия «Закрыть».

  2. Нажать на кнопку «Старт» в верхней панели.

Результат:

Действие запускает в Word-файле внешний макрос, VBA-код которого указан в отдельном текстовом файле.