Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Create bookmark Version 1 (Net)

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

Описание

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

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

Иконка

Image Removed

Параметры

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

Контекст                                 Контекст открытого 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

Image Added

Parameters

Input parameters

ParameterDescription
ContextThe context of an open Word-document. You can open a Word document using the "Open document" action (the "Word" action group).
Bookmark nameThe 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 numberThe 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 additionThe 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.
TextThe text in the document relative to which the new bookmark will be set.
Match number of the textThe 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.Numeric1Нет
Текст

Текст в Word-документе, относительно которого будет добавлена закладка.

Robin.StringКавказский пленникДа
Место добавления

Расположение закладки относительно указанного текста.

Элементы выпадающего списка:

  • Перед текстом
  • После текста
  • Вставить текст в закладку
Robin.StringПеред текстомДа
Номер совпадения текстаПорядковый номер совпадения указанного текста в Word-документе. Нумерация начинается с 1. Для поиска последнего совпадения необходимо указать -1.Robin.Numeric-1Да

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

Special conditions of use

More about bookmarks in Подробнее о закладках в Word: Закладки в Word

  1. Если в документе уже есть закладка с введенным именем, то робот вернет ошибку.
  2. Если пользователь не укажет номер страницы, то поиск текста будет осуществлен по всему документу.
  3. Если пользователь укажет порядковый номер совпадения, который отсутствует в документе, то робот вернет ошибку.
  4. Если пользователь укажет порядковый номер совпадения "0" или меньше "-1", робот вернет ошибку.
  5. Если пользователь укажет текст, который отсутствует в документе, робот вернет ошибку.
  6. Если пользователь укажет несуществующий номер страницы, робот вернет ошибку.

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

Задача

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

Документ:

Image Removed

Решение

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

Реализация

...

Bookmarks in Word

  1. If the document already contains a bookmark with the specified name, the robot will return an error.
  2. If the user does not specify the page number, the text will be searched throughout the entire document.
  3. If the user specified the order number of the match that does not exist in the document, the robot will return an error.
  4. If the user specifies the order number of the match "0" or lower than "-1", the robot will return an error.
  5. If the user specifies the text that does not exist in the document, the robot will return an error.
  6. 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:

Image Added

Solution

Use the "Open document", "Create bookmark", "Save as", "Close document" actions.

Implementation

  1. Assemble a robot scheme with the actions:
    Image Added

  2. 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.
    Image Added

  3. 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.
    Image Added

  4. Set the "Save as" action parameters. In the "Context" field specify the Word-document instance to be saved.
    Image Added

  5. Set the "Close document" action parameters. In the "Context" field specify the Word-document instance to be closed.
    Image Added

  6. Click "Start" in the top panel to start the robot.

Result 

The program robot completed successfully. The new bookmark was created.

Image Added

Bookmark names in the Word-document

...

Результат: 

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

Image Removed

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