Create bookmark Version 1 (Net)
Action group: Word
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
Parameters
Input 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
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Экземпляр Word-документа, к которому будет применено действие. | Robin.Word | Контекст Word-документа | Да |
Название закладки | Название новой закладки. Должно начинаться с буквы, не иметь пробелов и не превышать 40 символов. Если в документе уже есть закладка с таким именем, то робот вернет ошибку. | Robin.String | Закладка1 | Да |
| Номер страницы | Номер страницы Word-документа, на которой будет установлена новая закладка. Если поле не заполнено, поиск места вставки закладки будет осуществлен по всему документу. | Robin.Numeric | 1 | Нет |
| Текст | Текст в Word-документе, относительно которого будет добавлена закладка. | Robin.String | Кавказский пленник | Да |
| Место добавления | Расположение закладки относительно указанного текста. Элементы выпадающего списка:
| Robin.String | Перед текстом | Да |
| Номер совпадения текста | Порядковый номер совпадения указанного текста в Word-документе. Нумерация начинается с 1. Для поиска последнего совпадения необходимо указать -1. | Robin.Numeric | -1 | Да |
Special conditions of use
More about bookmarks in Word: Bookmarks in Word
- 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 "Kavkazsky plennik".
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 "Kavkaszky plennik". 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:
Обзор
Инструменты контента