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

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

Описание

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

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

Параметры

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

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

Настройки

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

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

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

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

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

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

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

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

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

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

Документ:

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

Реализация:

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