Skip to main content
Version: Current

Word Models

Overview

This page describes object types returned by Microsoft Word workflow activities and enums used in activity configuration.

Use these models when binding activity outputs in the Process Data drawer or when mapping results in downstream activities.

For page-related behavior across operating systems, see Cross-Platform Considerations.


FindResult

Returned by:

  • Find Text (Result)

Properties

PropertyTypeDescription
TextPositionInt32Character position within the document where the text was found. This value is generally more stable across operating systems than PageIndex.
PageIndexInt32Zero-based layout page index where the match was found. This value can differ between Windows and Linux for the same document.

DocRange

Returned by:

  • Add Picture (Document Ranges)
  • Replace Picture (Document Ranges)

Properties

PropertyTypeDescription
StartInt32Start character position of the range within the document.
EndInt32End character position of the range within the document.

HyperlinkInfo

Returned by:

  • Get Hyperlinks (Hyperlinks)

Properties

PropertyTypeDescription
TargetStringHyperlink target.
NavigateUriStringNavigation URI when applicable.
AnchorStringBookmark or anchor within the document.
ToolTipStringTooltip text associated with the hyperlink.
VisitedBooleanIndicates whether the hyperlink is marked as visited.
RangeDocRangeCharacter range occupied by the hyperlink.
TextStringVisible hyperlink text.

ReplacementResult

Returned by:

  • Find and Replace (Result)

Properties

PropertyTypeDescription
BodyReplacementsInt32Number of replacements made in the document body.
ReplacedInHeaderBooleanIndicates whether a replacement occurred in a header.
ReplacedInFooterBooleanIndicates whether a replacement occurred in a footer.

Primitive Outputs

The following activities return standard .NET types directly.

ActivityOutputTypeDescription
Read TextTextStringExtracted document text.
Read Bookmarked TextTextStringText contained within the specified bookmark range.
Append TextResultBooleanReturns true when text is appended successfully.
Get Page IndexesPage IndexesList[Int32]Zero-based page indexes that correspond to a printed page number. Layout-dependent.
Get TableResultDataTableRows and columns extracted from the bookmarked table.

Enums

The following enums are used by Microsoft Word activity inputs. Values correspond to the options available in the workflow designer.


PageLookupMode

Specifies whether an operation applies to all pages, a single page, or a page range.

ValueDescription
AllAll pages.
SingleA single page.
RangeA range of pages identified by page index.

LookupPageBy

Specifies how a page is identified.

ValueDescription
PageIndexIdentify the page by its zero-based layout index.
PageNumberIdentify the page by its printed page number.

Occurrence

Specifies which matching occurrences should be processed.

ValueDescription
FirstThe first matching occurrence.
LastThe last matching occurrence.
AllAll matching occurrences.

FindBy

Specifies how content is located within the document.

ValueDescription
BookmarkLocate content using a bookmark name.
TextLocate content using text search.

Position

Used by Add Picture when inserting a picture relative to a matched location.

ValueDescription
LeftInsert before the matched content.
RightInsert after the matched content.
ReplaceReplace the matched content.

HyperlinkType

Used by Insert Hyperlink.

ValueDescription
URLNavigate to a URL.
BookmarkNavigate to a bookmark within the document.

TextFormat

Used by Read Text.

ValueDescription
PlainTextExtract plain text content.
HtmlExtract content as HTML.
RtfExtract content in Rich Text Format (RTF).

MatchColumnBy

Used by Fill Table.

ValueDescription
IndexMatch DataTable columns to Word table columns by position.
NameMatch DataTable columns to Word table columns by name.