Skip to main content

Add Picture

AutomatR.Word.Activities.AddPicture

The "Add Picture" activity in AutomatR is designed for Microsoft Word automation, allowing users to insert images into specified Word documents at precise positions relative to text or bookmarks. This activity enhances document customization by seamlessly integrating images into the content.

Properties

NameDescription
Input
Picture PathEnter the complete path of the image, including the filename, that you want to add to the Word document. Provide the local drive path (e.g., "C:\images\pic.jpeg"). String variables containing the picture path.
Insert Relative ToSpecify whether the image should be added relative to the entire document or specific text within the document. Choose from options: Document, Text.
Position Where To InsertProvide the position where the picture needs to be inserted. Choose from options: Start, End, Before, After, Replace.
Text OccurrenceSelect the occurrences of the specified text relative to which you want to add the image. Choose from options: First, Last, All, Specific.
Text To Search ForEnter the text relative to which you want to add the image. String variables containing the text to search for.
Occurrence IndexEnter the index when a specific text occurrence happens multiple times in the document. For example, if the text search appears 5 times and you want to add a picture at the 2nd occurrence, set the index value as 2. Integer variables containing the occurrence index.
Misc
Display NameProvides a customizable name for the activity displayed in the workflow. The display name enhances clarity and organization within the automation project. String variables containing the desired display name.
Optional
DelayEnter the wait time in seconds (e.g., 5 seconds) to introduce a delay before starting the activity. This can be useful for handling synchronization issues. Integer variables containing the delay duration.

How to use:

  1. Drag and drop the "Add Picture" activity onto the workflow.
  2. Configure the properties by specifying the picture path, insert relative to, position, text occurrence, and other relevant details.
  3. Optionally, configure the delay if needed.
  4. Execute the workflow to add the specified picture to the Word document.

Example:

Consider an example where the "Add Picture" activity is used to insert a picture named "image.jpg" after the first occurrence of the text "Introduction" in a Word document:

Add Picture:
Picture Path: "C:\Images\image.jpg"
Insert Relative To: Text
Position Where To Insert: After
Text Occurrence: First
Text To Search For: "Introduction"
Occurrence Index: 1