История страницы
Создать закладку / Create bookmark
Группа действий: Word
Действие создает закладку в указанном месте Word-документа.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Экземпляр Word-документа, к которому будет применено действие. | Robin.Word | Да | |
Название закладки | Название новой закладки. Должно начинаться с буквы, не иметь пробелов и не превышать 40 символов. Если в документе уже есть закладка с таким именем, то робот вернет ошибку. | Robin.String | Да | |
Номер страницы | Номер страницы Word-документа, на которой будет установлена новая закладка. Если поле не заполнено, поиск места вставки закладки будет осуществлен по всему документу. | Robin.Numeric | Нет | |
Текст | Текст в Word-документе, относительно которого будет добавлена закладка. | Robin.String | Да | |
Место добавления | Расположение закладки относительно указанного текста. Элементы выпадающего списка:
| Robin.String | Перед текстом | Да |
Номер совпадения текста | Порядковый номер совпадения указанного текста в Word-документе. Нумерация начинается с 1. Для поиска последнего совпадения необходимо указать -1. | Robin.Numeric | -1 | Да |
Особые условия использования
Если в документе уже есть закладка с введенным именем, то робот вернет ошибку.
Если пользователь не укажет номер страницы, то поиск текста будет осуществлен по всему документу.
Если пользователь укажет порядковый номер совпадения, который отсутствует в документе, то робот вернет ошибку.
Если пользователь укажет порядковый номер совпадения "0" или меньше "-1", робот вернет ошибку.
Если пользователь укажет текст, который отсутствует в документе, робот вернет ошибку.
Если пользователь укажет несуществующий номер страницы, робот вернет ошибку.
Пример использования
Задача: имеется Word-документ. Необходимо создать новую закладку после текста "Кавказский пленник".
Документ:
Решение: воспользоваться действиями "Открыть", "Создать закладку", "Сохранить как", "Закрыть".
Реализация:
- Перетащить на рабочую область действие "Открыть" и настроить его параметры. В поле "Путь к файлу" указать путь к файлу Word-документа. В поле "Видимый" проставить чекбокс = true.
- Перетащить на рабочую область действие "Создать закладку" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, в котором необходимо создать закладку. В поле "Название закладки" указать имя новой закладки.. В поле "Текст" указать "Кавказский пленник". В поле "Место добавления" указать "После текста". В поле "Номер совпадения текста" указать "1".
- Перетащить на рабочую область действие "Сохранить как" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, который нужно сохранить.
- Перетащить на рабочую область действие "Закрыть" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, который нужно закрыть.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат:
Программный робот отработал успешно. Новая закладка создалась.
Имена закладок в Word-документе: