Add Picture

UiPath.Word.Activities.WordAddImage

Description

Adds a picture in a specified Word document at a specified position relative to a text or bookmark. This activity must be added inside a Use Word File activity.

Configuring the Activity

In the Body of the Activity

• Picture to insert - Click Browse  next to the field, and then browse to and select an image file to add in the document. Alternatively, click Plus  on the right side of the field, and then, from the menu, choose one of the available options to indicate the path to the image file to insert:

  • Data from the Project Notebook, a parent Excel file or Outlook account. For example, select an Excel file and then select a cell that contains the file path, or indicate a field from a selected email in Outlook that contains the file path.
  • Use Saved Value - Select a value in the form of a file path that you previously saved for later use in the project.
  • Text - Enter the file path in the Text Builder.
  • Ask when run - Prompt for a file path when the project is executed.
  • Open in Advanced Editor - Enter a VB expression.

To add the Image at the Start or at the End of the Document

• Insert relative to - Select Document.
• Position where to insert - Select the position in the document where to add the image: at the Start or at the End of the document.

To add the Image Relative to a Specific Bookmark in the Document

• Insert relative to - Select Bookmark.

• Bookmark to search for - Click Plus  on the right side of the field, and then, from the menu, select Text to enter the name of the bookmark relative to which to add the image in the Text Builder. Alternatively, choose one of the other available options in menu to indicate the bookmark name:

  • Data from the Project Notebook, a parent Excel file or Outlook account. For example, select an Excel file and then select a cell that contains the bookmark name, or indicate a field from a selected email in Outlook that contains the name.
  • Use Saved Value - Select a value that you previously saved for later use in the project.
  • Ask when run - Prompt for the bookmark name when the project is executed.
  • Open in Advanced Editor - Enter a VB expression.
• Text occurrence - Select All to add the image relative to every occurrence of the bookmark name.
• Position where to insert - Select the position where to add the image: Before, After, or in place of (Replace) the specified bookmark.

To add the Image Relative to a Specific Text in the Document

• Insert relative to - Select Text.

• Text to search for - Click Plus  on the right side of the field, and then, from the menu, select Text to enter the text relative to which to add the image in the Text Builder. Alternatively, choose one of the other available options in menu to indicate the text:

  • Data from the Project Notebook, a parent Excel file or Outlook account. For example, select an Excel file and then select a cell that contains the text to add, or indicate a field from a selected email in Outlook that contains the text.
  • Use Saved Value - Select a value that you previously saved for later use in the project.
  • Ask when run - Prompt for the text to add when the project is executed.
  • Open in Advanced Editor - Enter a VB expression.

• Text occurrence - Select the occurrences of the specified text relative to which to add the image:

  • All - Add the image relative to every occurrence of the text.
  • First - Add the image relative to the first occurrence of the text.
  • Last - Add the image relative to the last occurrence of the text.
  • Specific - Add the image relative to a specific occurrence of the text. To indicate the occurrence, select Plus  next to the Occurrence index field, and then select Number. For example, if the text to search for appears five times in the document and you want to add the image after the second occurrence of the text, the Occurrence index should be set to 2.
• Position where to insert - Select the position where to Add the image: Before, After, or in place of (Replace) the specified text.

Properties Panel

Common

• DisplayName - The name displayed for the activity in the Designer panel.

Input

• Picture to insert - See Picture to insert in the body of the activity.

Insert Options

• Bookmark - See Bookmark to search for in the body of the activity.
• Occurrence - See Text occurrence in the body of the activity.
• OccurrenceIndex - See Text occurrence > Specific in the body of the activity.
• Position - See Position to insert in the body of the activity.
• Text - See Text to search for in the body of the activity.

Misc

• Private - If selected, the values of variables and arguments are no longer logged at Verbose level.