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

Ключ

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

...

Insert image Version 1 (Net)

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

Описание

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

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

Иконка

Image Removed

Параметры

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

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

Параметр "С новой строки" выключен:

Image Removed

Параметр "С новой строки" включен:

Image Removed

Настройки

...

Description

The action inserts an image at the specified location in a Word-document.

You specify a Word-document, an image for insertion, and location where to add it. You can also optionally specify the size of the image and the possibility of adding it from a new line.

Action icon

Image Added

Settings of parameters

PropertyDescriptionTypeFilling exampleMandatory field
Parameters
ContextThe Word document instance to which the action will be applied

Свойство

Описание

Тип

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

Обязательность заполнения поля

Параметры

Контекст

Экземпляр Word-документа, к которому будет применено действие
.Robin.Word
Контекст
Word
-документа
context
Да
Yes

Изображение

Путь к файлу изображения, которое будет вставлено в Word-документ
ImageThe path to the image file to be inserted into the Word document.Robin.FilePath
C:\User\image.jpg

Да

ВысотаВысота в пикселях, которая будет установлена указанному изображению при вставке. Не учитывается, если не заполнена "Ширина". Указывается в пикселях

Yes
HeightThe height in pixels that will be set to the specified image when pasted. Not taken into account if «Width» is not filled.Robin.Numeric
500

No
НетШиринаШирина в пикселях, которая будет установлена указанному изображению при вставке. Не учитывается, если не заполнена "Высота". Указывается в пикселях.
WidthThe width in pixels that will be set to the specified image when inserted. It is not taken into account if the «Height» is not filled in.Robin.Numeric
500

No
НетМесто добавления

Место в документе, куда будет вставлено изображение.

Выпадающий список с элементами:

  • Начало документа
  • Конец документа
  • После закладки
    Place of additionThe location in the document where the image will be inserted.Robin.String
    После закладки

    Yes
    ДаНазвание закладкиНазвание закладки, после которой будет вставлено изображение
    Bookmark nameThe name of the bookmark after which the table will be inserted.Robin.String
    Закладка1

    No
    НетС новой строкиЕсли значение "true", то изображение будет вставлено с новой строки. Последующий текст в документе будет также перенесен на новую строку
    A new lineIf the value is «true», then the image will be inserted on a new line. Subsequent text in the document will also wrap to a new line.Robin.Booleantrue
    Нет

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

    No

    Special conditions of use

    The markup option for the inserted image is "In textПараметр разметки вставленного изображения -"В тексте":

    Image Removed

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

    Если указано в параметрах указано и имя закладки и место добавления, но место добавления отличное от "после закладки" , то действие будет игнорировать параметр имени закладки.

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

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

    Действие не работает с заблокированными полями в защищенных документах. В этом случае робот выдаст ошибку.

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

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

    Задача

    имеется Word-документ. Необходимо вставить изображение после закладки.

    Документ:

    Image Removed

    Решение

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

    Реализация

    1. Собрать схему робота, состоящую из действий: 
      Image Removed
    2. Настроить параметры действия "Открыть".  В поле "Путь к файлу" указать путь к файлу Word-документа. В поле "Видимый" проставить чекбокс = true.
      Image Removed
    3. Настроить параметры действия "Вставить изображение".  В поле "Контекст" указать экземпляр Word-документа, в котором необходимо вставить изображение. В поле "Изображение" указать путь к изображению для вставки. В полях "Высота" и "Ширина" указать необходимый размер изображения. В поле "Место добавления" указать "После закладки". В поле "Название закладки" указать имя существующей закладки после которой будет вставлено изображение. В поле "С новой строки" указать чекбокс = true.
      Image Removed
    4.  Настроить параметры действия "Сохранить как" В поле "Контекст" указать экземпляр Word-документа, который нужно сохранить. 
      Image Removed
    5. Настроить параметры действия "Закрыть". В поле "Контекст" указать экземпляр Word-документа, который нужно закрыть.
      Image Removed
    6. Запустить робота по кнопке "Старт" в верхней панели. 

    Результат 

    Программный робот отработал успешно. Изображение вставилось в указанное место.

    Image Removed

    Word-документ:

    Image Added

    If the place of adding after the bookmark is selected, it is necessary to specify the name of the bookmark. Otherwise, the robot will return an error.

    If both bookmark name and place of addition are specified in the parameters, but the place of addition is different from "after the bookmark" then the action will ignore the bookmark name parameter.

    If you select the location to add after the bookmark, but there are no bookmarks in the document, the robot will return an error.

    If one of the height or width parameters is not filled in, the image will be inserted into the document at its own size.

    The action does not work with locked fields in protected documents. In this case the robot will return an error.

    More about bookmarks in Word: Bookmarks in Word

    Example of use

    Task

    There is a Word-document. Insert and image after the bookmark.

    The document:

    Image Added

    Solution

    Use the "Open", "Insert image", "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 specify the path to the Word-document file. In the "Visible" field check the checkbox = true.
      Image Added
    3. Set the "Insert image" action parameters.  In the "Context" field, specify the Word-document instance in which you want to insert the image. In the "Image" field, specify the path to the image to be inserted. In the "Height" and "Width" fields, specify the required image size. In the "Place to add" field specify "After bookmark". In the "Bookmark name" field specify the name of the existing bookmark after which the image will be inserted. In the "A new line" field check the checkbox = true.
      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 image was inserted at the specified location.

    Image Added

    Word-document:

    Image AddedImage Removed