История страницы
...
Create bookmark Version 1 (Net)
Группа действийAction group: Word
Описание
Действие создает закладку в указанном месте Word-документа.
Указывается Word-документ, название новой закладки, место добавления, текст, относительно которого будет добавлена закладка, и номер совпадения этого текста в документе. Также есть возможность указать номер страницы, где будет произведено добавление.
Иконка
Параметры
Входные параметры
Контекст Контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия "Открыть" (группа "Word").
Название закладки Название новой закладки. Ограничения для названия: в документе не должно быть закладки с таким же названием; не превышает 40 символов; начинается с буквы; отсутствуют пробелы.
Номер страницы Номер страницы документа, где будет установлена новая закладка. Если параметр не заполнен, то поиск текста будет произведен по всему документу.
Текст Текст в документе, относительно которого будет установлена новая закладка.
Место добавления Расположение закладки относительно указанного текста. Доступно 3 варианта: Перед текстом, После текста, Вставить текст в закладку. При выборе "Вставить текст в закладку" - указанный текст и будет закладкой.
Номер совпадения текста Номер совпадения текста, относительно которого будет установлена закладка. Нумерация начинается с 1. Если нужно указать последнее совпадение в документе, но порядковый номер совпадения неизвестен, то необходимо указать -1.
Настройки
...
Description
The action creates a bookmark in the specified place in a Word-document.
Specify the Word-document, the name of the new bookmark, the place of addition, the text relative to which the bookmark will be added, and the number of the match of this text in the document. It is also possible to specify the page number where the addition will be made.
Action icon
Settings of parameters
Parameter | Description |
---|---|
Context | The context of an open Word-document. You can open a Word document using the "Open document" action (the "Word" action group). |
Bookmark name | The name of the new bookmark. Name restrictions: the document must not contain a bookmark with the same name; does not exceed 40 characters; begins with a letter; there are no spaces. |
Page number | The page number of the document where the new bookmark will be set. If the parameter is not filled in, the text will be searched throughout the entire document. |
Place of addition | The location of the bookmark relative to the specified text. There are 3 options available: Before text, After text, Insert text into the bookmark. When you select "Insert text into a bookmark", the specified text will be the bookmark. |
Text | The text in the document relative to which the new bookmark will be set. |
Match number of the text | The number of the text match, relative to which the bookmark will be set. The numbering starts with 1. If you need to specify the last match in the document, but the sequence number of the match is unknown, then specify -1. |
Settings of parameters
Property | Description | Type | Filling example | Mandatory field |
Parameters | ||||
Context | The Word document instance to which the action will be applied. | Robin.Word | Word context | Yes |
Bookmark name | The name of the new bookmark. Must start with a letter, have no spaces, and be no longer than 40 characters. If the document already has a bookmark with the same name, the robot will return an error. | Robin.String | Yes | |
Page number | The page number of the Word document on which the new bookmark will be set. If the field is not filled in, the search for the insertion point of the bookmark will be carried out throughout the document. | Robin.Numeric | No | |
Text | The text in the Word document to which the bookmark will be added. | Robin.String | Yes | |
Place of addition | The location of the bookmark relative to the specified text. | Robin.String | Yes | |
Match number of the text | The ordinal number of the match of the specified text in the Word document. Numbering starts at 1. To find the last match, you must specify |
Свойство
Описание
Тип
Пример заполнения
Обязательность заполнения поля
Параметры
Контекст
Экземпляр Word-документа, к которому будет применено действие.
Robin.Word
Контекст Word-документа
Да
Название закладки
Название новой закладки. Должно начинаться с буквы, не иметь пробелов и не превышать 40 символов. Если в документе уже есть закладка с таким именем, то робот вернет ошибку.
Robin.String
Да
Текст в Word-документе, относительно которого будет добавлена закладка.
Расположение закладки относительно указанного текста.
Элементы выпадающего списка:
- Перед текстом
- После текста
- Вставить текст в закладку
-1. | Robin.Numeric |
Особые условия использования
Yes |
Special conditions of use
More about bookmarks in Подробнее о закладках в Word: Закладки в Word
- Если в документе уже есть закладка с введенным именем, то робот вернет ошибку.
- Если пользователь не укажет номер страницы, то поиск текста будет осуществлен по всему документу.
- Если пользователь укажет порядковый номер совпадения, который отсутствует в документе, то робот вернет ошибку.
- Если пользователь укажет порядковый номер совпадения "0" или меньше "-1", робот вернет ошибку.
- Если пользователь укажет текст, который отсутствует в документе, робот вернет ошибку.
- Если пользователь укажет несуществующий номер страницы, робот вернет ошибку.
Пример использования
Задача
- If the document already contains a bookmark with the specified name, the robot will return an error.
- If the user does not specify the page number, the text will be searched throughout the entire document.
- If the user specified the order number of the match that does not exist in the document, the robot will return an error.
- If the user specifies the order number of the match "0" or lower than "-1", the robot will return an error.
- If the user specifies the text that does not exist in the document, the robot will return an error.
- If the user specifies the non-existent page number, the robot will return an error.
Example of use
Task
You have a Word-document. Create a new bookmark after the text Имеется Word-документ. Необходимо создать новую закладку после текста "Кавказский пленник".
ДокументDocument:
...
Solution
Воспользоваться действиями "ОткрытьUse the "Open document", "Создать закладкуCreate bookmark", "Сохранить какSave as", "ЗакрытьClose document" actions.
Реализация
...
Implementation
- Assemble a robot scheme with the actions:
- Set the "Open document" action parameters. In the "Path to file" field set the path to the Word-document file. In the "Visible" field check the checkbox = true.
- Set the "Create bookmark" action parameters. In the "Context" field specify the Word-document instance where the bookmark needs to be created. in the "Bookmark name" specify the name of the new bookmark. In the "Text" field specify "Кавказский пленник". In the "Place of addition" field specify "After text". In the "Match number of the text" specify 1.
- Set the "Save as" action parameters. In the "Context" field specify the Word-document instance to be saved.
- Set the "Close document" action parameters. In the "Context" field specify the Word-document instance to be closed.
- Click "Start" in the top panel to start the robot.
Result
The program robot completed successfully. The new bookmark was created.
Bookmark names in the Word-document:
...
Результат:
Программный робот отработал успешно. Новая закладка создалась.
Имена закладок в Word-документе: