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

Группа действий: Word

Описание

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

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

Параметры

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

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

Настройки

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

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

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

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

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

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

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

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

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

Документ:

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

Реализация:

1. Перетащить на рабочую область действие "Открыть" и настроить его параметры. В поле "Путь к файлу" указать путь к файлу Word-документа. В поле "Видимый" проставить чекбокс = true.
   
   
2. Перетащить на рабочую область действие "Создать закладку" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, в котором необходимо создать закладку. В поле "Название закладки" указать имя новой закладки.. В поле "Текст" указать "Кавказский пленник". В поле "Место добавления" указать "После текста". В поле "Номер совпадения текста" указать "1".
   
   
3. Перетащить на рабочую область действие "Сохранить как" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, который нужно сохранить. 
   
   
4. Перетащить на рабочую область действие "Закрыть" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, который нужно закрыть.
   
   
5. Запустить робота по кнопке "Старт" в верхней панели. 

Результат: 

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

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