Compartir por


IA-Connect Microsoft Office

IA-Connect is a Robotic Process Automation 'RPA' platform which adds RPA functionality from the Cloud to on-premises virtual machines or over Citrix or Microsoft Remote Desktop 'RDS' connections. This is the module for Microsoft Office automation.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Ultima Labs
URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
Connector Metadata
Publisher Ultima Labs
Website https://www.ultima.com/ultima-labs
Privacy policy https://www.ultima.com/privacy-policy
Categories IT Operations;Productivity

IA-Connect is a Robotic Process Automation (RPA) platform which adds RPA functionality from Power Automate Cloud Flows to on-premises virtual machines or over Citrix or Microsoft Remote Desktop (RDS) connections. The IA-Connect Connectors provide over 650 actions, allowing you to automate every type of on-premise application directly from a Power Automate Cloud Flow. All IA-Connect actions are available directly from your Power Automate Cloud Flow providing easy integration between Cloud based and on-premises applications, the ability to leverage existing Power Automate conditions, loops, dynamic content, expressions and exception handling in your RPA processes. Utilising the IA-Connect Connectors also provides full execution history and auditability from the Flow run history whilst also removing the need to have a separate application/console/studio for developing your RPA processes.

Prerequisites

To use any of the IA-Connect Connectors, you must install the IA-Connect software. This is free to test for 30 days, following which you will require an IA-Connect license.

The IA-Connect software consists of two main components:

  • The IA-Connect Orchestrator, which is an Azure WebApp which you would host in your own Azure tenant. This handles the routing and security of RPA Flows to one or more on-premises or cloud-based virtual machines.

  • The IA-Connect Agent and Director, which is installed onto the virtual machines where the software you wish to automate is accessible. Additionally, the IA-Connect Agent can run inside a Citrix or Microsoft Remote Desktop Services (RDS) session, where the RPA commands are passed down a virtual channel into the remote session for execution. The IA-Connect Agent can be run from a network share and does not require installation.

Available IA-Connect Connectors

The available IA-Connect Connectors are:

  • IA-Connect Dynamic Code
  • IA-Connect Java
  • IA-Connect Mainframe
  • IA-Connect Microsoft Office
  • IA-Connect SAP GUI
  • IA-Connect Session
  • IA-Connect UI
  • IA-Connect Web Browser

How to get credentials

In order to receive your license and begin your 30-day free trial, please submit a request on our website (https://www.ultima.com/IA-Connect/Power-Automate).

Once a trial request is received, we will contact you via the email address provided to assist with setting up the IA-Connect software and to provide you with the trial license. This is a fully featured trial and will enable you to test any of the 650 actions across all 8 IA-Connect Connectors within your own environment during the trial period.

Get started with your connector

After submitting a trial request for IA-Connect, you will be able to download a ZIP file containing the IA-Connect software and documentation covering the installation and setup. We will also contact you to offer support and guidance through the installation process as required.

Support

During the trial period, you can contact Ultima Labs (IAConnect@ultima.com) for support and assistance.

Upon purchasing IA-Connect licenses you will receive support tokens which can be redeemed for bespoke training or support from Ultima's UK-based Technical Service Centre (TSC).

Known issues, common errors and FAQs

Our Knowledge Base contains a number of articles covering any known issues, common errors that may occur when using the IA-Connect Connectors and frequently asked questions. This is accessible at https://support.ultima.com/ultimalabs and an account to access these resources is provided during the IA-Connect trial and upon purchasing an IA-Connect license.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True
IA-Connect Orchestrator address string Specify the IA-Connect Orchestrator address without the HTTP(S) component True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Activate MS Excel worksheet

Activates a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Add macro to MS Excel workbook

Adds a macro to a workbook in an instance of Microsoft Excel (referenced by the handle).

Add table column to MS Word document

Adds a column to a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Add table row to MS Word document

Adds a row to a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Add table to MS Word document

Adds a table with the specified number of rows and columns to a named document in an instance of Microsoft Word (referenced by the handle).

Attach to existing MS Excel instance

Attaches to an instance Microsoft Excel that has already been started.

Attach to existing MS Outlook instance

Attaches to a running Outlook instance to allow Outlook to be automated using the actions in this IA-Connect module.

Attach to existing MS Word instance

Attaches to an instance Microsoft Word that has already been started.

Check OLE object in MS Excel worksheet

Check or uncheck an OLE checkbox or radio button (ActiveX control) in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Clear clipboard

Clears the contents of the clipboard in the IA-Connect Agent user session.

Clear MS Excel clipboard

Clears the current Excel clipboard (the dotted area) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Close current MS Excel workbook

Closes the current Excel workbook in an instance of Microsoft Excel (referenced by the handle).

Close MS Excel instance

Closes an instance Microsoft Excel that was started using a Visual Basic Object (or attached to later). The instance of Excel to close is defined by the handle.

Close MS Excel workbook

Closes an open Excel workbook in an instance of Microsoft Excel (referenced by the handle).

Close MS Outlook instance

Closes an instance of Microsoft Outlook that was started using the 'Create instance' action (or attached to later), without waiting for any active requests to complete. This action can sometimes cause issues when Outlook cached mode is enabled and should be used after calling 'Wait for mails to send' to ensure that Outlook has successfully completed any ongoing tasks such as sending emails.

Close MS Outlook instance using Window

Closes an instance of Microsoft Outlook that was started using the 'Create instance' action (or attached to later), by making Outlook visible and then closing the Outlook window (as a user would close Outlook). This can be more reliable when Outlook cached mode is enabled.

Close MS Word document

Closes an open Word document in an instance of Microsoft Word (referenced by the handle).

Close MS Word instance

Closes an instance of Microsoft Word that was started using a Visual Basic Object (or attached to later). The instance of Word to close is defined by the handle.

Copy between cells in MS Excel workbook

Copy and paste between cells in a workbook in an instance of Microsoft Excel (referenced by the handle).

Copy MS Word selection to clipboard

Copies the selected contents of a document in an instance of Microsoft Word (referenced by the handle).

Copy selection in MS Excel workbook

Copies the current selection or a specified selection (by making use of the Excel clipboard) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Create mail folder in MS Outlook

Creates a mail folder within the current Outlook profile. This action can be used to create top-level folders if no parent folder path is provided, or child folders by providing a parent folder path.

Create MS Excel instance

Starts Microsoft Excel using a Visual Basic Object to allow Excel to be automated using the actions in this IA-Connect module. Microsoft Excel starts hidden, unless you enable ShowExcel, because it doesn't need to be visible for automation, unless you are also using UIA to control Excel.

Create MS Excel workbook

Creates a new Excel workbook in an instance of Microsoft Excel (referenced by the handle).

Create MS Excel worksheet

Creates a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Create MS Outlook instance

Starts Microsoft Outlook using a Visual Basic Object to allow Outlook to be automated using the actions in this IA-Connect module. Microsoft Outlook starts hidden, unless you enable ShowOutlook, because it doesn't need to be visible for automation, unless you are also using UIA to control Outlook. Only one instance of Outlook can be running at any one time.

Create MS Word document

Creates a new Word document in an instance of Microsoft Word (referenced by the handle).

Create MS Word instance

Starts Microsoft Word using a Visual Basic Object to allow Word to be automated using the actions in this IA-Connect module. Microsoft Word starts hidden, unless you enable ShowWord, because it doesn't need to be visible for automation, unless you are also using UIA to control Word.

Cut between cells in MS Excel workbook

Cut and paste between cells in a workbook in an instance of Microsoft Excel (referenced by the handle).

Cut selection in MS Excel workbook

Cuts the current selection or a specified selection (by making use of the Excel clipboard) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Delete email in MS Outlook

Deletes an email in Outlook.

Delete MS Excel worksheet

Deletes a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Delete selection in MS Excel workbook

Deletes the current selection in a workbook in an instance of Microsoft Excel (referenced by the handle).

Detach from MS Word instance

Detaches from a running instance of Microsoft Word that was started using a Visual Basic Object (or attached to later). The instance of Word to detach from is defined by the handle.

Does OLE object exist in MS Excel worksheet

Determines whether an OLE object exists in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Evaluate MS Excel expression

Returns the result of evaluating an expression in an instance of Microsoft Excel (referenced by the handle).

Execute MS Excel command bar object

Executes any command bar object in an instance of Microsoft Excel (referenced by the handle) given the Control Name. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. Some command-bar objects will work without additional interaction, while some might need to be used in conjunction with some UIA actions.

Execute MS Outlook command bar object

Executes any command bar object in a Microsoft Outlook window or dialog, given the Control Name. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. The action is performed on the currently active Outlook window so Outlook must be visible (use the action 'Show MS Outlook'). Some command-bar objects will work without additional interaction, while some might need to be used in conjunction with some UIA actions.

Execute MS Word command bar object

Executes any command bar object in an instance of Microsoft Word (referenced by the handle) given the Control Name. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. Some command-bar objects will work without additional interaction, while some might need to be used in conjunction with some UIA actions.

Export MS Word document as PDF

Saves a named document as a PDF in an instance of Microsoft Word (referenced by the handle).

Find next cell with value in MS Excel worksheet

Finds the next cell with a specified value in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Find next empty cell in MS Excel worksheet

Finds the next empty cell in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Format cell in active MS Excel worksheet

Formats a cell in the active worksheet in an instance of Microsoft Excel (referenced by the handle).

Format current cell in active MS Excel worksheet

Formats the active cell in the active worksheet in an instance of Microsoft Excel (referenced by the handle).

Forward email in MS Outlook

Forwards an email in Outlook.

Get active cell in active MS Excel worksheet

Returns the cell reference of the active cell in an instance of Microsoft Excel (referenced by the handle).

Get active MS Excel worksheet name

Returns the name of the worksheet at a specified index (starting at 1) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Get and set cell text in active MS Excel worksheet

Read a single cell text value and store into a different cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Get and set cell value 2 in active MS Excel worksheet

Read a single raw cell value and store into a different cell in the active workbook in an instance of Microsoft Excel (referenced by the handle). Gets and sets the underlying value of the cell without any formatting applied.

Get and set cell value in active MS Excel worksheet

Read a single cell value and store into a different cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Get cell background colour in MS Excel worksheet

Gets the background colour of the specified cell in an instance of Microsoft Excel (referenced by the handle).

Get cell text in active MS Excel worksheet

Get text in a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Get cell value 2 in active MS Excel worksheet

Gets the raw value in a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle). This returns the underlying value of the cell without any formatting applied.

Get cell value in active MS Excel worksheet

Get the string value in a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Get email attachment filenames in MS Outlook

Retrieves details about the attachments on an email in Outlook.

Get email body in MS Outlook

Retrieves the body of an email in Outlook.

Get emails in MS Outlook

Retrieves emails from a specified folder in Outlook.

Get first email in MS Outlook

Retrieves the first email from a specified folder in Outlook. As the emails are not ordered in any particular way, if you require the emails to be in a specific order (e.g. the first email by date received) then you should instead use the 'Get emails' action and then sort the output.

Get highlighted text in MS Word document

Returns all highlighted text in a document in an instance of Microsoft Word (referenced by the handle).

Get mail folders in MS Outlook

Retrieves all mail folders in Outlook by providing a folder path and optionally a flag to indicate whether subfolders should also be returned.

Get MS Excel country setting

Returns the Country setting for an instance of Microsoft Excel (referenced by the handle).

Get MS Excel worksheet as collection enhanced

Retrieves the contents of a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Get MS Excel worksheet names

Returns the names of worksheets in a workbook in an instance of Microsoft Excel (referenced by the handle).

Get MS Excel worksheet sensitivity label

Retrieves the sensitivity label (e.g. Public, Internal, Confidential) from a workbook in an instance of Microsoft Excel (referenced by the handle). This is useful to obtain the label and site Id from an existing document, allowing you to apply the same label to other documents (using the 'Set MS Excel worksheet sensitivity label' action).

Get MS Excel worksheet used range

Returns the used range in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Get MS Outlook MAPI profiles

Retrieves all the configured MAPI profiles which can be used with Outlook.

Get MS Outlook namespace information

Retrieves information about the current Outlook instance running and the Exchange server that it is connected to.

Get MS Outlook process Id

Returns the dynamic Process ID (PID) of the running Outlook process which could be used for performing UIA actions.

Get MS Word document body text

Reads the content from a specified character range in the body of a named document in an instance of Microsoft Word (referenced by the handle).

Get MS Word document table bounds

Returns the number of rows and columns in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Get MS Word document table cell text value trimmed

Gets the text value of a cell with any leading or trailing whitespace characters (e.g. spaces) removed in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Get number of MS Outlook mails

Returns the number of emails from a specified folder in Outlook that match the provided search criteria.

Get number of rows in MS Excel worksheet

Returns the number of data rows in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Get number of tables in MS Word document

Returns the number of tables in a named document in an instance of Microsoft Word (referenced by the handle).

Get OLE object value in MS Excel worksheet

Retrieve the text value of an OLE object in the active workbook in an instance of Microsoft Excel (referenced by the handle). If the OLE object is a checkbox, the value 'True' or 'False' will be returned.

Get table cell text value in MS Word document

Gets the text value of a cell in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Go to cell in active MS Excel worksheet

Goes to (selects) a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Go to next empty cell down in MS Excel worksheet

Go to next empty cell down in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Go to next empty cell left in MS Excel worksheet

Go to next empty cell to the left in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Go to next empty cell right in MS Excel worksheet

Go to next empty cell to the right in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Go to next empty cell up in MS Excel worksheet

Go to next empty cell up in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Hide MS Excel

Hides an instance of Microsoft Excel (referenced by the handle). This would typically only be used during development because Excel doesn't need to be visible for automation.

Hide MS Word

Hides an instance of Microsoft Word (referenced by the handle). This would typically only be used during development because Word doesn't need to be visible for automation.

Input text into OLE object in MS Excel worksheet

Input text into an OLE object in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Insert on selection in MS Excel workbook

Inserts on the current selection in a workbook in an instance of Microsoft Excel (referenced by the handle).

Is MS Outlook connected

Checks to see if IA-Connect is connected to an instance of Outlook.

Mark email as read in MS Outlook

Marks a specific email in Outlook as read or unread, depending on the input flag set.

Maximise MS Excel window

Maximise the active instance of Microsoft Excel (referenced by the handle).

Minimise MS Excel window

Minimise the active instance of Microsoft Excel (referenced by the handle).

Move email in MS Outlook

Moves a specific email from a specified folder in Outlook to another folder.

Normalise MS Excel window

Normalise the active instance of Microsoft Excel (referenced by the handle).

Open MS Excel workbook

Opens a specified Excel workbook in an instance of Microsoft Excel (referenced by the handle).

Open MS Word document

Opens a specified Word document in an instance of Microsoft Word (referenced by the handle).

Paste into MS Word from clipboard

Pastes the content of the clipboard into a document at the currently selected point in an instance of Microsoft Word (referenced by the handle).

Paste into selection in MS Excel workbook

Pastes into the current selection or a specified selection (by making use of the Excel clipboard) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Press OLE object in MS Excel worksheet

Presses an OLE button object (ActiveX control) in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Put MS Excel workbook in edit mode

Puts a Microsoft Excel workbook into edit mode. This is useful if a workbook opened in read-only mode and there is an 'Enable editing' button which you must press to edit the workbook.

Reply to email in MS Outlook

Replies to an email in Outlook.

Run MS Excel macro

Runs a macro in a workbook in an instance of Microsoft Excel (referenced by the handle).

Save As MS Word document

Saves a specified open document in an instance of Microsoft Word (referenced by the handle) as a specified filename.

Save current MS Excel workbook

Saves the current workbook in an instance of Microsoft Excel (referenced by the handle).

Save current MS Excel workbook as

Saves the current workbook in an instance of Microsoft Excel (referenced by the handle) as a specified filename.

Save current MS Excel workbook as CSV

Saves the current workbook as CSV in an instance of Microsoft Excel (referenced by the handle) as a specified filename.

Save email attachments as file in MS Outlook

Saves the attachments from a specific email in Outlook.

Save MS Excel workbook

Saves a specified open workbook in an instance of Microsoft Excel (referenced by the handle).

Save MS Excel workbook as

Saves a specified open workbook in an instance of Microsoft Excel (referenced by the handle) as a specified filename.

Save MS Excel workbook as CSV

Saves a specified open workbook as CSV in an instance of Microsoft Excel (referenced by the handle) as a specified filename.

Save MS Excel workbook as with password

Saves a specified open workbook in an instance of Microsoft Excel (referenced by the handle) as a specified filename with a password.

Save MS Word document

Saves a specified open document in an instance of Microsoft Word (referenced by the handle).

Select all in MS Word document

Selects all of the content in an open document in an instance of Microsoft Word (referenced by the handle).

Select cell range in MS Excel worksheet

Selects a range in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Select range in MS Word document

Selects a character range in a named document in an instance of Microsoft Word (referenced by the handle).

Select table cell in MS Word document

Selects a cell in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Select table in MS Word document

Selects a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Send email in MS Outlook

Sends a new email in Outlook.

Set cell background colour in MS Excel worksheet

Sets the background colour of the specified cell or cells in an instance of Microsoft Excel (referenced by the handle).

Set cell value in active MS Excel worksheet

Set the string value of a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Set MS Excel calculation mode

Sets the calculation mode (0 = manual, 1 = automatic, 2 = semi automatic) in an instance of Microsoft Excel (referenced by the handle).

Set MS Excel worksheet sensitivity label

Sets the sensitivity label (e.g. Public, Internal, Confidential) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Set MS Outlook Allow popup details

Overrides the default Outlook 'Allow' popup element search details used by IA-Connect Agent to locate the 'Allow' button. Button names may change with the language settings, if so use this before calling 'Background monitor for Allow popup'.

Set MS Word document table cell text value

Sets the text value of a cell in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Show MS Excel

Makes an instance of Microsoft Excel visible (referenced by the handle). This would typically only be used during development because Excel doesn't need to be visible for automation, unless you are also using UIA to control Excel.

Show MS Outlook

Shows the current Outlook instance that is being automated. This would typically only be used during development because Outlook doesn't need to be visible for automation, unless you are also using UIA to control Outlook.

Show MS Word

Makes an instance of Microsoft Word visible (referenced by the handle). This would typically only be used during development because Word doesn't need to be visible for automation, unless you are also using UIA to control Word.

Start background monitor for MS Outlook Allow popup

Creates a background thread that monitors the remote session for a specified number of seconds, searching for an 'Allow' popup, which can be triggered by a number of Outlook actions such as 'Send email'. Once the element is located, the action will then click the 'Allow' button to permit the triggering action to complete successfully.

Trust MS Excel VB object model in registry

Sets the registry value for Excel to trust VB object model (needed to create macros). Excel must not be running and only works if not overridden by GPO. This is the same as enabling the 'Trust access to the VBA project object model' option in the 'Developer Macro Settings' section of Trust Center.

Type text in MS Word document

Types the specified text into a document from the currently selected point in an instance of Microsoft Word (referenced by the handle).

Update MS Word bookmark

Updates a bookmark in a named document in an instance of Microsoft Word (referenced by the handle).

Write array to MS Excel worksheet

Writes an array into a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Write collection to MS Excel worksheet

Writes a collection (table) into a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Write collection to MS Excel worksheet with dates

Writes a collection (table) with date fields into a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Activate MS Excel worksheet

Activates a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Create if missing
CreateIfMissing boolean

If a Worksheet with the specified name does not exist, should it be created?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Add macro to MS Excel workbook

Adds a macro to a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Macro code
MacroCode True string

The code that will be executed when the macro runs.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Add table column to MS Word document

Adds a column to a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Table index
TableIndex True integer

The table number, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Add table row to MS Word document

Adds a row to a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Table index
TableIndex True integer

The table number, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Add table to MS Word document

Adds a table with the specified number of rows and columns to a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Number of rows
NumberOfRows True integer

The number of rows in the table to be added.

Number of columns
NumberOfColumns True integer

The number of columns in the table to be added.

Auto fit behaviour
AutoFitBehaviour integer

The AutoFit behaviour of the table (0 for fixed table size, 1 for fit to content and 2 for fit to window).

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Attach to existing MS Excel instance

Attaches to an instance Microsoft Excel that has already been started.

Parameters

Name Key Required Type Description
File Name
Filename string

The filename of an open spreadsheet in Excel to attach to. If it is an empty worksheet then enter the name of the sheet (e.g. 'Book1').

Toggle window
ToggleWindow boolean

Should the Excel window be toggled before attempting to attach? This helps to ensure that recently opened Excel windows are visible to the Windows operating system.

Toggle uses global left mouse click agent
ToggleUsesGlobalLeftMouseClickAgent boolean

If choosing to toggle the Excel window, this specifies whether to use global mouse clicks to focus the IA-Connect Agent first.

Toggle delay in seconds
ToggleDelay double

If choosing to toggle the Excel window, this specifies the pause after toggling.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Excel handle
Handle integer

A handle for this instance of Excel to be used by other Excel actions to distinguish between different instance of Excel if more than one instance is running.

Attach to existing MS Outlook instance

Attaches to a running Outlook instance to allow Outlook to be automated using the actions in this IA-Connect module.

Parameters

Name Key Required Type Description
Toggle window
ToggleWindow boolean

Should the Outlook window be toggled before attempting to attach? This helps to ensure that recently opened Outlook windows are visible to the Windows operating system.

Toggle uses global left mouse click agent
ToggleUsesGlobalLeftMouseClickAgent boolean

If choosing to toggle the Outlook window, this specifies whether to use global mouse clicks to focus the IA-Connect Agent first.

Toggle delay in seconds
ToggleDelay double

If choosing to toggle the Outlook window, this specifies the pause after toggling.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Current profile name
CurrentProfileName string

The name of the Outlook mail profile that is in use.

Attach to existing MS Word instance

Attaches to an instance Microsoft Word that has already been started.

Parameters

Name Key Required Type Description
File name
Filename string

The filename of an open document in Word to attach to. If it is an empty document then enter the name of the document (e.g. 'Document1').

Toggle window
ToggleWindow boolean

Should the Word window be toggled before attempting to attach? This helps to ensure that recently opened Word windows are visible to the Windows operating system.

Toggle uses global left mouse click agent
ToggleUsesGlobalLeftMouseClickAgent boolean

If choosing to toggle the Word window, this specifies whether to use global mouse clicks to focus the IA-Connect Agent first.

Toggle delay in seconds
ToggleDelay double

If choosing to toggle the Word window, this specifies the pause after toggling.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Word handle
Handle integer

A handle for this instance of Word to be used by other Word actions to distinguish between different instance of Word if more than one instance is running.

Check OLE object in MS Excel worksheet

Check or uncheck an OLE checkbox or radio button (ActiveX control) in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

OLE object name
OLEObjectName True string

The name of the OLE object.

Check
Checked boolean

Set to true to check the OLE object or false to uncheck.

Run in background
RunInBackground boolean

Should the IA-Connect Agent await a response or should this be run as a background task? Set to true if changing the object state would show a message box, dialog or prompt.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelCheckOLEObjectResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Clear clipboard

Clears the contents of the clipboard in the IA-Connect Agent user session.

Parameters

Name Key Required Type Description
Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Clear MS Excel clipboard

Clears the current Excel clipboard (the dotted area) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Close current MS Excel workbook

Closes the current Excel workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Close MS Excel instance

Closes an instance Microsoft Excel that was started using a Visual Basic Object (or attached to later). The instance of Excel to close is defined by the handle.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Close MS Excel workbook

Closes an open Excel workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook Name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Save Data
SaveData boolean

Should the Excel workbook be saved before closing?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Close MS Outlook instance

Closes an instance of Microsoft Outlook that was started using the 'Create instance' action (or attached to later), without waiting for any active requests to complete. This action can sometimes cause issues when Outlook cached mode is enabled and should be used after calling 'Wait for mails to send' to ensure that Outlook has successfully completed any ongoing tasks such as sending emails.

Parameters

Name Key Required Type Description
Seconds to wait for process to close
SecondsToWaitForProcessToClose integer

The number of seconds to wait for the Outlook instance to close down.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Close MS Outlook instance using Window

Closes an instance of Microsoft Outlook that was started using the 'Create instance' action (or attached to later), by making Outlook visible and then closing the Outlook window (as a user would close Outlook). This can be more reliable when Outlook cached mode is enabled.

Parameters

Name Key Required Type Description
Use native windows
UseNativeWindow boolean

Should Outlook be closed using the native Outlook window handle? If both 'Use native windows' and 'Use UIA' are set to true, this method will be attempted first.

Use UIA
UseUIA boolean

Should Outlook be closed using UIA methods?

Seconds to wait for process to close
SecondsToWaitForProcessToClose integer

The number of seconds to wait for the Outlook instance to close down.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Close MS Word document

Closes an open Word document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Close MS Word instance

Closes an instance of Microsoft Word that was started using a Visual Basic Object (or attached to later). The instance of Word to close is defined by the handle.

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Copy between cells in MS Excel workbook

Copy and paste between cells in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Source Excel handle
SourceHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance'), or 0 for the currently active instance of Excel, from which to read from.

Source Workbook name
SourceWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook, from which to read from.

Source Worksheet name
SourceWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, from which to read from.

Source cell reference
SourceCellReference True string

The cell or cell range reference to copy the data from, for example: A1 or B2:C5.

Source entire row
SourceEntireRow boolean

Should the entire row that contains the reference cell(s) be selected?

Source entire column
SourceEntireColumn boolean

Should the entire column that contains the reference cell(s) be selected?

Target Excel handle
TargetHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance'), or 0 for the currently active instance of Excel, to write the copied data into.

Target Workbook name
TargetWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook, to write the copied data into.

Target Worksheet name
TargetWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, to write the copied data into.

Target cell reference
TargetCellReference True string

The cell or cell range reference to paste the data to, for example: A1 or B2:C5.

Target entire row
TargetEntireRow boolean

Should the entire row that contains the target reference cell(s) be selected?

Target entire column
TargetEntireColumn boolean

Should the entire column that contains the target reference cell(s) be selected?

Values Only
ValuesOnly boolean

Should only values be pasted or should formatting be preserved?

Simple paste only
SimplePasteOnly boolean

Simple paste or paste special?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelCopyBetweenCellsResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Copy MS Word selection to clipboard

Copies the selected contents of a document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Copy selection in MS Excel workbook

Copies the current selection or a specified selection (by making use of the Excel clipboard) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference string

The cell or cell range reference, for example: A1 or B2:C5. Leave blank to read the current selection.

Entire row
EntireRow boolean

Should the entire row that contains the reference cell(s) be selected and copied?

Entire column
EntireColumn boolean

Should the entire column that contains the reference cell(s) be selected and copied?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Create mail folder in MS Outlook

Creates a mail folder within the current Outlook profile. This action can be used to create top-level folders if no parent folder path is provided, or child folders by providing a parent folder path.

Parameters

Name Key Required Type Description
Parent folder path
ParentFolderPath string

The path to the parent folder to create the folder within, e.g. Inbox.

New folder name
NewFolderName string

The name of the new folder to be created, e.g. Processed Items.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Create MS Excel instance

Starts Microsoft Excel using a Visual Basic Object to allow Excel to be automated using the actions in this IA-Connect module. Microsoft Excel starts hidden, unless you enable ShowExcel, because it doesn't need to be visible for automation, unless you are also using UIA to control Excel.

Parameters

Name Key Required Type Description
Enable Events
EnableEvents boolean

Enables VBA events such as BeforeSave, Open etc.

Show MS Excel
ShowExcel boolean

Show MS Excel after the instance has been created. This could be useful when developing the MS Excel automation, or if you are also using UIA to control Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Excel handle
Handle integer

A handle for this instance of Excel to be used by other Excel actions to distinguish between different instance of Excel if more than one instance is running.

Create MS Excel workbook

Creates a new Excel workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Workbook name
WorkbookName string

The name of this Excel workbook to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Create MS Excel worksheet

Creates a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) to be created within the workbook.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Create MS Outlook instance

Starts Microsoft Outlook using a Visual Basic Object to allow Outlook to be automated using the actions in this IA-Connect module. Microsoft Outlook starts hidden, unless you enable ShowOutlook, because it doesn't need to be visible for automation, unless you are also using UIA to control Outlook. Only one instance of Outlook can be running at any one time.

Parameters

Name Key Required Type Description
Mail profile name
ProfileName string

The Outlook mail profile to use. If no mail profile name is provided, then the default profile will be used.

Show MS Outlook
ShowOutlook boolean

Show MS Outlook after the instance has been created. This could be useful when developing the MS Outlook automation, or if you are also using UIA to control Outlook.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Current profile name
CurrentProfileName string

The name of the Outlook mail profile that is in use.

Create MS Word document

Creates a new Word document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Document name
DocumentName string

The name of this Word document to be used by other Word actions to distinguish between different Word documents if more than one is open.

Create MS Word instance

Starts Microsoft Word using a Visual Basic Object to allow Word to be automated using the actions in this IA-Connect module. Microsoft Word starts hidden, unless you enable ShowWord, because it doesn't need to be visible for automation, unless you are also using UIA to control Word.

Parameters

Name Key Required Type Description
Show MS Word
ShowWord boolean

Show MS Word after the instance has been created. This could be useful when developing the MS Word automation, or if you are also using UIA to control Word.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Word handle
Handle integer

A handle for this instance of Word to be used by other Word actions to distinguish between different instance of Word if more than one instance is running.

Cut between cells in MS Excel workbook

Cut and paste between cells in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Source Excel handle
SourceHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance'), or 0 for the currently active instance of Excel, from which to read from.

Source Workbook name
SourceWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks), or blank for the currently active workbook, from which to read from.

Source Worksheet name
SourceWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, from which to read from.

Source cell reference
SourceCellReference True string

The cell or cell range reference to cut the data from, for example: A1 or B2:C5.

Source entire row
SourceEntireRow boolean

Should the entire row that contains the reference cell(s) be selected?

Source entire column
SourceEntireColumn boolean

Should the entire column that contains the reference cell(s) be selected?

Target Excel handle
TargetHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance'), or 0 for the currently active instance of Excel, to write the cut data into.

Target Workbook name
TargetWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook, to write the cut data into.

Target Worksheet name
TargetWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, to write the cut data into.

Target cell reference
TargetCellReference True string

The cell or cell range reference to paste the cut data to, for example: A1 or B2:C5.

Target entire row
TargetEntireRow boolean

Should the entire row that contains the target reference cell(s) be selected?

Target entire column
TargetEntireColumn boolean

Should the entire column that contains the target reference cell(s) be selected?

Values Only
ValuesOnly boolean

Should only values be pasted or should formatting be preserved?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelCutBetweenCellsResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Cut selection in MS Excel workbook

Cuts the current selection or a specified selection (by making use of the Excel clipboard) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference string

The cell or cell range reference, for example: A1 or B2:C5. Leave blank to read the current selection.

Entire row
EntireRow boolean

Should the entire row that contains the reference cell(s) be selected and cut?

Entire column
EntireColumn boolean

Should the entire column that contains the reference cell(s) be selected and cut?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Delete email in MS Outlook

Deletes an email in Outlook.

Parameters

Name Key Required Type Description
Email entry ID
EntryID True string

The email entry ID of the email to be actioned. This can be retrieved from the output of the action 'Get emails'.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Delete MS Excel worksheet

Deletes a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Delete selection in MS Excel workbook

Deletes the current selection in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference string

The cell or cell range reference to paste into, for example: A1 or B2:C5. Leave blank to paste into the current selection.

Entire row
EntireRow boolean

Should the entire row that contains the reference cell(s) be pasted into?

Entire column
EntireColumn boolean

Should the entire column that contains the reference cell(s) be pasted into?

Shift
Shift string

Which direction should the rest of the worksheet data be shifted, L (Left) or U (Up)?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Detach from MS Word instance

Detaches from a running instance of Microsoft Word that was started using a Visual Basic Object (or attached to later). The instance of Word to detach from is defined by the handle.

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Does OLE object exist in MS Excel worksheet

Determines whether an OLE object exists in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

OLE object name
OLEObjectName True string

The name of the OLE object.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
OLE object exists
OLEObjectExists boolean

True if the OLE object exists. False if the OLE object does not exist.

Evaluate MS Excel expression

Returns the result of evaluating an expression in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Expression
Expression True string

The expression to be evaluated, for example A1+A2 or SUM(A1:A6).

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Expression result
ExpressionResult string

The result of evaluating the expression.

Execute MS Excel command bar object

Executes any command bar object in an instance of Microsoft Excel (referenced by the handle) given the Control Name. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. Some command-bar objects will work without additional interaction, while some might need to be used in conjunction with some UIA actions.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Object Id
ObjectId True string

The Object Id (or Control Name) of the command bar object. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. Example actions which operate on the sheet: Copy, Undo, Bold, BorderNone, BordersAll, SortAscendingExcel, SortDecendingExcel. Example actions which open controls (set run in background to true): FileSaveACopy, FormatCellsDialog, FindDialogExcel.

Run in background
RunInBackground boolean

If set to false, the IA-Connect Agent will wait for the action to complete. This is suitable for simple actions (for example: Copy, Undo, Bold). If set to true, the IA-Connect Agent will run the action in a background thread and return for more instructions. This should be used when an action results in a dialog being displayed or causes Excel to wait for additional input.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Execute MS Outlook command bar object

Executes any command bar object in a Microsoft Outlook window or dialog, given the Control Name. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. The action is performed on the currently active Outlook window so Outlook must be visible (use the action 'Show MS Outlook'). Some command-bar objects will work without additional interaction, while some might need to be used in conjunction with some UIA actions.

Parameters

Name Key Required Type Description
Object Id
ObjectId True string

The Object Id (or Control Name) of the command bar object. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. Example actions which operate on a compose email window: Copy, Undo, Bold, IndentIncreaseWord, IndentDecreaseWord, AlignLeft, AlignCenter, AlignRight. Example actions which operate on a compose email window and open controls (set run in background to true): FontDialog, ParagraphDialog. Example actions which operate on the main Outlook email view: Forward, AddressBook, FilePrintQuick, NewItem.

Run in background
RunInBackground boolean

If set to false, the IA-Connect Agent will wait for the action to complete. This is suitable for simple actions (for example: Copy, Undo, Bold). If set to true, the IA-Connect Agent will run the action in a background thread and return for more instructions. This should be used when an action results in a dialog being displayed or causes Outlook to wait for additional input.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSOutlookExecuteCommandBarObjectResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Execute MS Word command bar object

Executes any command bar object in an instance of Microsoft Word (referenced by the handle) given the Control Name. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. Some command-bar objects will work without additional interaction, while some might need to be used in conjunction with some UIA actions.

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Object Id
ObjectId True string

The Object Id (or Control Name) of the command bar object. These are documented by Microsoft as 'Office Fluent UI Command Identifiers'. Example actions which operate on the document: Copy, Undo, Bold, IndentIncreaseWord, IndentDecreaseWord, AlignLeft, AlignCenter, AlignRight. Example actions which open controls (set run in background to true): FileSaveACopy, SymbolsDialog, FontDialog.

Run in background
RunInBackground boolean

If set to false, the IA-Connect Agent will wait for the action to complete. This is suitable for simple actions (for example: Copy, Undo, Bold). If set to true, the IA-Connect Agent will run the action in a background thread and return for more instructions. This should be used when an action results in a dialog being displayed or causes Word to wait for additional input.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSWordExecuteCommandBarObjectResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Export MS Word document as PDF

Saves a named document as a PDF in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Save filename
SaveFileName True string

The filename to save the PDF as.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Find next cell with value in MS Excel worksheet

Finds the next cell with a specified value in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Direction
Direction True string

Provide a direction (U, D, L, R).

Search value
SearchValue True string

The cell value to search for.

Case sensitive
CaseSensitive boolean

Should the search be case sensitive?

Comparison type
ComparisonType string

The comparison type (equals, contains, startswith or endswith).

Max cells to search
MaxCellsToSearch integer

The maximum number of cells to search.

Activate cell
ActivateCell boolean

Should the matching cell be activated?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell reference
CellReference string

The cell reference of the matching cell.

Row index
RowIndex integer

The row index of the matching cell.

Column index
ColumnIndex integer

The column index of the matching cell.

Find next empty cell in MS Excel worksheet

Finds the next empty cell in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Direction
Direction True string

Provide a direction (U, D, L, R).

Activate cell
ActivateCell boolean

Should the matching cell be activated?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell reference
CellReference string

The cell reference of the matching cell.

Row index
RowIndex integer

The row index of the matching cell.

Column index
ColumnIndex integer

The column index of the matching cell.

Format cell in active MS Excel worksheet

Formats a cell in the active worksheet in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Cell Format
CellFormat True string

The cell format to be set, e.g. dd/mm/yyyy or #,##0.000 - refer to MS Excel format code guidelines for further examples.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Format current cell in active MS Excel worksheet

Formats the active cell in the active worksheet in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Cell Format
CellFormat True string

The cell format to be set, e.g. dd/mm/yyyy or #,##0.000 - refer to MS Excel format code guidelines for further examples.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Forward email in MS Outlook

Forwards an email in Outlook.

Parameters

Name Key Required Type Description
Email entry ID
EntryID True string

The email entry ID of the email to be actioned. This can be retrieved from the output of the action 'Get emails'.

Email to
To string

The email address(es) of the primary recipient(s).

Email CC
CC string

The email address(es) of any recipient(s) who should be included on CC.

Email BCC
BCC string

The email address(es) of any recipient(s) who should be included on BCC.

Override subject
OverrideSubject boolean

Should the default forward subject be overridden? If set to true, alternative subject text should be provided in the 'Email subject' parameter.

Email subject
Subject string

The email subject text to be used if the default is overridden. This should be left blank if the default subject is being used.

Override body
OverrideBody boolean

Should the body of the forwarded email be overridden? If set to true, alternative email body text should be provided in the 'Email body' parameter.

Email body format
BodyFormat string

Provide a body type (HTML, Plain or RTF).

Email body
Body string

The alternative email body to be used if the email body format has been provided as 'Plain'.

Email HTML body
HTMLBody string

The alternative email body to be used if the email body format has been provided as 'HTML'.

Email RTF body
RTFBody string

The alternative email body to be used if the email body format has been provided as 'RTF'.

Click allow button if required
ClickAllowButtonIfRequired boolean

Should IA-Connect attempt to click the 'Allow' button if prompted?

Voting options
VotingOptions string

A semicolon separated list of voting options.

Send as SMTP address
SendAsSMTPAddress string

The 'Send as' email address. This option can be used if the profile has permissions to send on behalf of another person or group.

Include existing hidden attachments
IncludeExistingHiddenAttachments boolean

Should existing hidden attachments be included in the forwarded email?

Include existing visible attachments
IncludeExistingVisibleAttachments boolean

Should existing visible attachments be included in the forwarded email?

Attachment filenames JSON
AttachmentFilenamesJSON string

A list of full filepaths to the files that should be attached to the email, in JSON format.

Dont send if attachment filename missing
DontSendIfAttachmentFilenameMissing boolean

Should the email not be sent if one of the provided attachments cannot be found?

Body contains stored password
BodyContainsStoredPassword boolean

Set to true if the email body contains an IA-Connect stored password identifier, in the format {IAConnectPassword:StoredPasswordIdentifier} or an IA-Connect Orchestrator generic credential, in the format {OrchestratorCredential:FriendlyName}. This stored password could have been generated by the 'Generate password' action. For example: 'Welcome new starter, your new account password is {IAConnectPassword:GeneratedPassword}'.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Get active cell in active MS Excel worksheet

Returns the cell reference of the active cell in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell reference
CellReference string

The cell reference of the matching cell.

Row index
RowIndex integer

The row index of the matching cell.

Column index
ColumnIndex integer

The column index of the matching cell.

Get active MS Excel worksheet name

Returns the name of the worksheet at a specified index (starting at 1) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet position
Position integer

The position (index) of the desired Worksheet, starting from 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Worksheet name
WorksheetName string

The name of the worksheet in the workbook.

Get and set cell text in active MS Excel worksheet

Read a single cell text value and store into a different cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Source Excel handle
SourceHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Source Workbook name
SourceWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks), or blank for the currently active workbook, from which to read from.

Source Worksheet name
SourceWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, from which to read from.

Source cell reference
SourceCellReference True string

The cell which contains the text value to read, for example: A1.

Target Excel handle
TargetHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance'), or 0 for the currently active instance of Excel, to write the copied data into.

Target Workbook name
TargetWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook, to write the copied data into.

Target Worksheet name
TargetWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, to write the copied data into.

Target cell reference
TargetCellReference True string

The cell in which to set the retrieved text value, for example: B2.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelGetAndSetCellTextResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Get and set cell value 2 in active MS Excel worksheet

Read a single raw cell value and store into a different cell in the active workbook in an instance of Microsoft Excel (referenced by the handle). Gets and sets the underlying value of the cell without any formatting applied.

Parameters

Name Key Required Type Description
Source Excel handle
SourceHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Source Workbook name
SourceWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks), or blank for the currently active workbook, from which to read from.

Source Worksheet name
SourceWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, from which to read from.

Source cell reference
SourceCellReference True string

The cell which contains the value to read, for example: A1.

Target Excel handle
TargetHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance'), or 0 for the currently active instance of Excel, to write the copied data into.

Target Workbook name
TargetWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook, to write the copied data into.

Target Worksheet name
TargetWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, to write the copied data into.

Target cell reference
TargetCellReference True string

The cell in which to set the retrieved value, for example: B2.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelGetAndSetCellValue2Result boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Get and set cell value in active MS Excel worksheet

Read a single cell value and store into a different cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Source Excel handle
SourceHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Source Workbook name
SourceWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks), or blank for the currently active workbook, from which to read from.

Source Worksheet name
SourceWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, from which to read from.

Source cell reference
SourceCellReference True string

The cell which contains the value to read, for example: A1.

Target Excel handle
TargetHandle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance'), or 0 for the currently active instance of Excel, to write the copied data into.

Target Workbook name
TargetWorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook, to write the copied data into.

Target Worksheet name
TargetWorksheetName string

The name of the worksheet (tab) within the workbook, or blank for the currently active worksheet, to write the copied data into.

Target cell reference
TargetCellReference True string

The cell in which to set the retrieved value, for example: B2.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelGetAndSetCellValueResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Get cell background colour in MS Excel worksheet

Gets the background colour of the specified cell in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell to retrieve the background colour from, for example: A1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Colour index
ColourIndex integer

The MS Excel colour index number, for example: Black = 1, White = 2, Red = 3, Green = 4, Blue = 5. The index -4142 will be returned for cells with no fill. For a full colour index see our KB article.

Get cell text in active MS Excel worksheet

Get text in a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell value
CellValue string

The text value of the referenced cell.

Get cell value 2 in active MS Excel worksheet

Gets the raw value in a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle). This returns the underlying value of the cell without any formatting applied.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell value
CellValue string

The raw value of the referenced cell.

Get cell value in active MS Excel worksheet

Get the string value in a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell value
CellValue string

The string value of the referenced cell.

Get email attachment filenames in MS Outlook

Retrieves details about the attachments on an email in Outlook.

Parameters

Name Key Required Type Description
Email entry ID
EntryID True string

The email entry ID of the email to be actioned. This can be retrieved from the output of the action 'Get emails'.

Click allow button if required
ClickAllowButtonIfRequired boolean

Should IA-Connect attempt to click the 'Allow' button if prompted?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of attachments
NumberOfAttachments integer

The number of attachments on the specified email.

Email attachment filenames JSON
EmailAttachmentFilenamesJSON string

The email attachment filenames, in JSON format.

Get email body in MS Outlook

Retrieves the body of an email in Outlook.

Parameters

Name Key Required Type Description
Email entry ID
EntryID True string

The email entry ID of the email to be actioned. This can be retrieved from the output of the action 'Get emails'.

Click allow button if required
ClickAllowButtonIfRequired boolean

Should IA-Connect attempt to click the 'Allow' button if prompted?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Body format
BodyFormat string

The format of the email body.

Plain body
PlainBody string

The plain text content of the email body.

Formatted body
FormattedBody string

The formatted content of the email body.

Get emails in MS Outlook

Retrieves emails from a specified folder in Outlook.

Parameters

Name Key Required Type Description
Folder path
FolderPath string

The path to the specified folder to get emails from, e.g. Inbox.

Search read
SearchRead boolean

Should read emails be returned?

Search unread
SearchUnread boolean

Should unread emails be returned?

Search subject
SearchSubject string

A search subject or keyword to match emails on, for example 'Invoice'.

Search from SMTP
SearchFromSMTP string

A sender email address to match emails from.

Search from name
SearchFromName string

A sender name to match emails from.

Search query
SearchQuery string

A search query to match emails on. Example 1: [Importance] = 2. Example 2: [Categories] = 'Personal'. See the documentation for more examples.

Search max age in days
SearchMaxAgeInDays integer

A maximum age of emails to return, in days.

Search start date time
SearchStartDateTimeAsString date-time

A start search datetime string. For example: '2020-01-21T00:00:00' which would return all emails received after midnight on the 21st of January 2020. Please note, all datetimes are in UTC so you may wish to use the Convert DateTime action to convert your local time to UTC. If you do not provide a value, this will default to '1901-01-01T00:00:00'

Search end date time
SearchEndDateTimeAsString date-time

An end search datetime string. For example: '2020-01-28T00:00:00' which would return all emails received before midnight on the 28th of January 2020. Please note, all datetimes are in UTC so you may wish to use the Convert DateTime action to convert your local time to UTC. If you do not provide a value, this will default to '2999-01-01T00:00:00'

Max results to return
MaxResultsToReturn integer

The maximum number of emails to return. Used to limit the search results.

Click allow button if required
ClickAllowButtonIfRequired boolean

Should IA-Connect attempt to click the 'Allow' button if prompted?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of emails match filter
NumberOfEmailsMatchFilter integer

The number of emails in the specified folder that match the provided search criteria.

Number of emails returned
NumberOfEmailsReturned integer

The number of emails returned. This may be lower than 'Number of emails match filter' if a 'Max results to return' value is provided in the input parameters.

Emails JSON
EmailsJSON string

The emails retrieved, in JSON format.

Get first email in MS Outlook

Retrieves the first email from a specified folder in Outlook. As the emails are not ordered in any particular way, if you require the emails to be in a specific order (e.g. the first email by date received) then you should instead use the 'Get emails' action and then sort the output.

Parameters

Name Key Required Type Description
Folder path
FolderPath string

The path to the specified folder to get emails from, e.g. Inbox.

Search read
SearchRead boolean

Should read emails be returned?

Search unread
SearchUnread boolean

Should unread emails be returned?

Search subject
SearchSubject string

A search subject or keyword to match emails on, for example 'Invoice'.

Search from SMTP
SearchFromSMTP string

A sender email address to match emails from.

Search from name
SearchFromName string

A sender name to match emails from.

Search query
SearchQuery string

A search query to match emails on. Example 1: [Importance] = 2. Example 2: [Categories] = 'Personal'. See the documentation for more examples.

Search max age in days
SearchMaxAgeInDays integer

A maximum age of emails to return, in days.

Search start date time
SearchStartDateTimeAsString date-time

A start search datetime string. For example: '2020-01-21T00:00:00' which would return all emails received after midnight on the 21st of January 2020. Please note, all datetimes are in UTC so you may wish to use the Convert DateTime action to convert your local time to UTC. If you do not provide a value, this will default to '1901-01-01T00:00:00'

Search end date time
SearchEndDateTimeAsString date-time

An end search datetime string. For example: '2020-01-28T00:00:00' which would return all emails received before midnight on the 28th of January 2020. Please note, all datetimes are in UTC so you may wish to use the Convert DateTime action to convert your local time to UTC. If you do not provide a value, this will default to '2999-01-01T00:00:00'

Click allow button if required
ClickAllowButtonIfRequired boolean

Should IA-Connect attempt to click the 'Allow' button if prompted?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of emails match filter
NumberOfEmailsMatchFilter integer

The number of emails in the specified folder that match the provided search criteria.

Email entry ID
EmailEntryID string

The unique email entry ID of the email.

Sender email type
SenderEmailType string

The senders email address type (SMTP or Exchange).

Sender email address
SenderEmailAddress string

The senders email address.

Received by name
ReceivedByName string

The recipient name.

Email to
To string

The names of all email recipients.

Email subject
EmailSubject string

The email subject line.

Email read
EmailRead boolean

Returns true if the email has been read or false if not.

Email sent on
SentOnAsString date-time

The DateTime when the email was sent

Number of attachments
NumberOfAttachments integer

The number of attachments included in the email

Get highlighted text in MS Word document

Returns all highlighted text in a document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Highlighted text JSON
HighlightedTextJSON string

All of the highlighted pieces of text in the document, in JSON format.

Get mail folders in MS Outlook

Retrieves all mail folders in Outlook by providing a folder path and optionally a flag to indicate whether subfolders should also be returned.

Parameters

Name Key Required Type Description
Folder path
FolderPath string

The path to the parent folder to get folders from, e.g. Inbox.

Subfolders
SubFolders boolean

Should any subfolders also be returned?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Mail folders JSON
MailFoldersJSON string

The mail folders, in JSON format.

Get MS Excel country setting

Returns the Country setting for an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Country setting
CountrySetting integer

The country setting value, for instance 44 for UK English.

Get MS Excel worksheet as collection enhanced

Retrieves the contents of a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Use Header
UseHeader boolean

Should the first row of the worksheet be used as headers?

Start Cell
StartCell string

The cell reference to start reading from, for example A1.

Maximum column number
MaximumColumnNumber integer

The maximum number of columns to return.

Skip Blank Rows
SkipBlankRows boolean

Should blank rows in the worksheet be skipped?

Skip columns with no header
SkipColumnsWithNoHeader boolean

Should columns with no headers be skipped?

Key column
KeyColumn string

The name of the key column, if one exists. If you are using a 'Minimum number of populated cells' value, the key column will not count as a populated cell.

Get raw data
GetRawData boolean

Should the raw, unformatted data be returned?

Minimum number of populated cells
IgnoreRowsWithLowCellCount integer

The minimum number of cells that must be populated in each row. If the row contains less than this number, it will be skipped.

Max concurrent blank rows
MaxConcurrentBlankRows integer

The maximum number of concurrent blank rows that are allowed in the Worksheet data.

First data row to return
FirstDataRowToReturn integer

The index of the first row to return, or 0 for all rows.

Max number of data rows to return
MaxNumberOfDataRowsToReturn integer

The maximum number of rows to return, or 0 for all rows.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Sheet exists
SheetExists boolean

Returns true if the sheet exists or false if not.

Any more rows to return
AnyMoreRowsToReturn boolean

Contains either true or false depending on if there were more rows in the worksheet that were omitted due to the max number of data rows to return input.

First data row in returned collection
FirstDataRowInReturnedCollection integer

The worksheet index of the first row returned.

Last data row in returned collection
LastDataRowInReturnedCollection integer

The worksheet index of the last row returned.

Total number of rows in worksheet
TotalNumberOfRowsInWorksheet integer

The total number of rows in the worksheet.

Worksheet collection JSON
WorksheetCollectionJSON string

The contents of the Worksheet, in JSON format.

Get MS Excel worksheet names

Returns the names of worksheets in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Worksheet names
WorksheetNames array of object

The names of the worksheets in the workbook.

items
WorksheetNames object

Get MS Excel worksheet sensitivity label

Retrieves the sensitivity label (e.g. Public, Internal, Confidential) from a workbook in an instance of Microsoft Excel (referenced by the handle). This is useful to obtain the label and site Id from an existing document, allowing you to apply the same label to other documents (using the 'Set MS Excel worksheet sensitivity label' action).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Assignment method
AssignmentMethod string

The assignment method of the current sensitivity label.

Assignment label Id
LabelId string

The current sensitivity label Id. These are pre-defined in your organisation.

Assignment label name
LabelName string

The current sensitivity label name.

Assignment site Id
SiteId string

The current sensitivity site Id which is a unique Id for your organisation.

Assignment justification
Justification string

The justification if the sensitivity label was downgraded.

Set Date
SetDate string

The date when the label was set.

Get MS Excel worksheet used range

Returns the used range in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Left
Left integer

The index of the leftmost column in the used range in the worksheet.

Right
Right integer

The index of the rightmost column in the used range in the worksheet.

Top
Top integer

The index of the topmost row in the used range in the worksheet.

Bottom
Bottom integer

The index of the bottommost row in the used range in the worksheet.

Get MS Outlook MAPI profiles

Retrieves all the configured MAPI profiles which can be used with Outlook.

Parameters

Name Key Required Type Description
Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of MAPI profiles
NumberOfMAPIProfiles integer

The number of MAPI profiles which can be used with Outlook.

MAPI profiles JSON
MAPIProfilesJSON string

A list of MAPI profiles, in JSON format.

Default MAPI profile
DefaultMAPIProfile string

The name of the default MAPI profile.

Get MS Outlook namespace information

Retrieves information about the current Outlook instance running and the Exchange server that it is connected to.

Parameters

Name Key Required Type Description
Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Current profile name
CurrentProfileName string

The name of the Outlook mail profile that is in use.

Exchange mailbox server name
ExchangeMailBoxServerName string

The fully qualified name of the Exchange server that hosts the primary Exchange account mailbox.

Exchange mailbox server version
ExchangeMailBoxServerVersion string

The full version number of the Exchange server that hosts the primary Exchange account mailbox.

Offline
Offline boolean

Returns true if Outlook is currently offline (not connected to an Exchange server) or false if not.

Current user address
CurrentUserAddress string

The email address of the current Outlook user.

Current user name
CurrentUserName string

The user name of the current Outlook user.

Application name
ApplicationName string

The name of the Outlook application.

Application version
ApplicationVersion string

The version of the Outlook application.

Get MS Outlook process Id

Returns the dynamic Process ID (PID) of the running Outlook process which could be used for performing UIA actions.

Parameters

Name Key Required Type Description
Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Outlook process Id
ProcessId integer

The dynamic Process ID (PID) of the running Outlook process.

Get MS Word document body text

Reads the content from a specified character range in the body of a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Start
Start True integer

The starting character position, starting at 1.

Finish
Finish True integer

The ending character position, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Body text
BodyText string

The text that has been read from the document body.

Get MS Word document table bounds

Returns the number of rows and columns in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Table index
TableIndex True integer

The table number, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of rows
NumberOfRows integer

The number of rows in the table.

Number of columns
NumberOfColumns integer

The number of columns in the table.

Get MS Word document table cell text value trimmed

Gets the text value of a cell with any leading or trailing whitespace characters (e.g. spaces) removed in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Table index
TableIndex True integer

The table number, starting at 1.

Row index
RowIndex True integer

The row number, starting at 1.

Column index
ColumnIndex True integer

The column number, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell text
CellText string

The text value of the referenced cell within the table with any leading or trailing whitespace characters (e.g. spaces) removed.

Get number of MS Outlook mails

Returns the number of emails from a specified folder in Outlook that match the provided search criteria.

Parameters

Name Key Required Type Description
Folder path
FolderPath string

The path to the specified folder to get emails from, e.g. Inbox.

Search read
SearchRead boolean

Should read emails be returned?

Search unread
SearchUnread boolean

Should unread emails be returned?

Search subject
SearchSubject string

A search subject or keyword to match emails on, for example 'Invoice'.

Search from SMTP
SearchFromSMTP string

A sender email address to match emails from.

Search from name
SearchFromName string

A sender name to match emails from.

Search query
SearchQuery string

A search query to match emails on. Example 1: [Importance] = 2. Example 2: [Categories] = 'Personal'. See the documentation for more examples.

Search max age in days
SearchMaxAgeInDays integer

A maximum age of emails to return, in days.

Search start date time
SearchStartDateTimeAsString date-time

A start search datetime string. For example: '2020-01-21T00:00:00' which would return all emails received after midnight on the 21st of January 2020. Please note, all datetimes are in UTC so you may wish to use the Convert DateTime action to convert your local time to UTC. If you do not provide a value, this will default to '1901-01-01T00:00:00'

Search end date time
SearchEndDateTimeAsString date-time

An end search datetime string. For example: '2020-01-28T00:00:00' which would return all emails received before midnight on the 28th of January 2020. Please note, all datetimes are in UTC so you may wish to use the Convert DateTime action to convert your local time to UTC. If you do not provide a value, this will default to '2999-01-01T00:00:00'

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of emails match filter
NumberOfEmailsMatchFilter integer

The number of emails in the specified folder that match the provided search criteria.

Get number of rows in MS Excel worksheet

Returns the number of data rows in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of rows
NumberOfRows integer

The number of rows in the worksheet.

Get number of tables in MS Word document

Returns the number of tables in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of tables
NumberOfTables integer

The number of tables that were found in the Word document.

Get OLE object value in MS Excel worksheet

Retrieve the text value of an OLE object in the active workbook in an instance of Microsoft Excel (referenced by the handle). If the OLE object is a checkbox, the value 'True' or 'False' will be returned.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

OLE object name
OLEObjectName True string

The name of the OLE object.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
OLE object value
OLEObjectValue string

The value retrieved from the specified OLE object.

Get table cell text value in MS Word document

Gets the text value of a cell in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Table index
TableIndex True integer

The table number, starting at 1.

Row index
RowIndex True integer

The row number, starting at 1.

Column index
ColumnIndex True integer

The column number, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell text
CellText string

The text value of the referenced cell within the table.

Go to cell in active MS Excel worksheet

Goes to (selects) a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Go to next empty cell down in MS Excel worksheet

Go to next empty cell down in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell reference
CellReference string

The cell reference of the matching cell.

Row index
RowIndex integer

The row index of the matching cell.

Column index
ColumnIndex integer

The column index of the matching cell.

Go to next empty cell left in MS Excel worksheet

Go to next empty cell to the left in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell reference
CellReference string

The cell reference of the matching cell.

Row index
RowIndex integer

The row index of the matching cell.

Column index
ColumnIndex integer

The column index of the matching cell.

Go to next empty cell right in MS Excel worksheet

Go to next empty cell to the right in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell reference
CellReference string

The cell reference of the matching cell.

Row index
RowIndex integer

The row index of the matching cell.

Column index
ColumnIndex integer

The column index of the matching cell.

Go to next empty cell up in MS Excel worksheet

Go to next empty cell up in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Cell reference
CellReference string

The cell reference of the matching cell.

Row index
RowIndex integer

The row index of the matching cell.

Column index
ColumnIndex integer

The column index of the matching cell.

Hide MS Excel

Hides an instance of Microsoft Excel (referenced by the handle). This would typically only be used during development because Excel doesn't need to be visible for automation.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Hide MS Word

Hides an instance of Microsoft Word (referenced by the handle). This would typically only be used during development because Word doesn't need to be visible for automation.

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Input text into OLE object in MS Excel worksheet

Input text into an OLE object in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

OLE object name
OLEObjectName True string

The name of the OLE object.

Text to input
TextToInput string

The text to enter into the OLE object.

Run in background
RunInBackground boolean

Should the IA-Connect Agent await a response or should this be run as a background task? This should be set to true if changing the object state would show a message box, dialog or prompt.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelInputTextIntoOLEObjectResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Insert on selection in MS Excel workbook

Inserts on the current selection in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference string

The cell or cell range reference to paste into, for example: A1 or B2:C5. Leave blank to paste into the current selection.

Entire row
EntireRow boolean

Should the entire row that contains the reference cell(s) be pasted into?

Entire column
EntireColumn boolean

Should the entire column that contains the reference cell(s) be pasted into?

Shift
Shift string

Which direction should the current selection be shifted, R (Right) or D (Down)?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Is MS Outlook connected

Checks to see if IA-Connect is connected to an instance of Outlook.

Parameters

Name Key Required Type Description
Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Is Outlook connected
IsOutlookConnected boolean

Returns true if IA-Connect is connected to an instance of Outlook or false if not.

Mark email as read in MS Outlook

Marks a specific email in Outlook as read or unread, depending on the input flag set.

Parameters

Name Key Required Type Description
Email entry ID
EntryID True string

The email entry ID of the email to be actioned. This can be retrieved from the output of the action 'Get emails'.

Read
Read boolean

Should the email be marked as read? This can be set to false to mark the email as unread.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Maximise MS Excel window

Maximise the active instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelMaximiseWindowResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Minimise MS Excel window

Minimise the active instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelMinimiseWindowResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Move email in MS Outlook

Moves a specific email from a specified folder in Outlook to another folder.

Parameters

Name Key Required Type Description
Email entry ID
EntryID True string

The email entry ID of the email to be actioned. This can be retrieved from the output of the action 'Get emails'.

Destination mail folder
DestinationFolder string

The email folder path to move the email to, for example 'Inbox\Processed Items'.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Normalise MS Excel window

Normalise the active instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelNormaliseWindowResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Open MS Excel workbook

Opens a specified Excel workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

File Name
Filename string

The filename of the Excel workbook to be opened.

Open read only
ReadOnly boolean

Should the Excel workbook be opened in read only mode?

Update links
UpdateLinks boolean

Should any links in the Excel workbook be updated on open?

Open password
Password password

The password for the Excel workbook, if required.

Enable events
EnableEvents boolean

Should Excel events be enabled?

Put HTTP workbooks in edit mode
PutHTTPWorkbooksIntoEditMode boolean

Set to true if you want IA-Connect to automatically put workbooks opened from an HTTP URL (for example: Opened from SharePoint) into edit mode. This will only be performed if the workbook is detected to have opened in read-only mode.

Put file path workbooks in edit mode
PutFilePathWorkbooksIntoEditMode boolean

Set to true if you want IA-Connect to automatically put workbooks opened from a file path (for example: a drive letter or network share) into edit mode. This will only be performed if the workbook is detected to have opened in read-only mode.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Workbook name
WorkbookName string

The name of this Excel workbook to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Open MS Word document

Opens a specified Word document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

File name
Filename True string

The filename of the Word document to be opened.

Open read only
OpenReadOnly boolean

Should the Word document be opened in read only mode?

Add to recent files
AddToRecentFiles boolean

Should the Word document be added to the recently used files list?

Password
Password password

The password for the Word document, if required.

Open and repair
OpenAndRepair boolean

Should the document be repaired when it is opened? This can be used to prevent document corruption.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Document name
DocumentName string

The name of this Word document to be used by other Word actions to distinguish between different Word documents if more than one is open.

Paste into MS Word from clipboard

Pastes the content of the clipboard into a document at the currently selected point in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Paste into selection in MS Excel workbook

Pastes into the current selection or a specified selection (by making use of the Excel clipboard) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Values Only
ValuesOnly boolean

Should only values be pasted or should formatting be preserved?

Simple paste only
SimplePasteOnly boolean

Simple paste or paste special? If pasting a cut, simple paste must be set to true.

Cell reference
CellReference string

The cell or cell range reference to paste into, for example: A1 or B2:C5. Leave blank to paste into the current selection.

Entire row
EntireRow boolean

Should the entire row that contains the reference cell(s) be pasted into?

Entire column
EntireColumn boolean

Should the entire column that contains the reference cell(s) be pasted into?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Press OLE object in MS Excel worksheet

Presses an OLE button object (ActiveX control) in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

OLE object name
OLEObjectName True string

The name of the OLE object.

Run in background
RunInBackground boolean

Should the IA-Connect Agent await a response or should this be run as a background task? Set to true if changing the object state would show a message box, dialog or prompt.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelPressOLEObjectResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Put MS Excel workbook in edit mode

Puts a Microsoft Excel workbook into edit mode. This is useful if a workbook opened in read-only mode and there is an 'Enable editing' button which you must press to edit the workbook.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook Name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Force
Force boolean

If set to false and IA-Connect determines the workbook is not in read-only mode, no action is performed since the workbook is already in edit mode. If set to true, IA-Connect will attempt to enable editing regardless of workbook read-only state - this might cause an exception if the workbook is not in read-only mode.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelPutWorkbookInEditModeResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Reply to email in MS Outlook

Replies to an email in Outlook.

Parameters

Name Key Required Type Description
Email entry ID
EntryID True string

The email entry ID of the email to be actioned. This can be retrieved from the output of the action 'Get emails'.

Reply to all
ReplyToAll boolean

Should this reply be sent to all recipients? If false, the reply will be sent directly to the sender.

Email body format
BodyFormat string

Provide a body type (HTML, Plain or RTF).

Email body
Body string

The email body to be used if the email body format has been provided as 'Plain'.

Email HTML body
HTMLBody string

The email HTML body to be used if the email body format has been provided as 'HTML'.

Email RTF body
RTFBody string

The email RTF body to be used if the email body format has been provided as 'RTF'.

Attachment filenames JSON
AttachmentFilenamesJSON string

A list of full filepaths to the files that should be attached to the email, in JSON format.

Dont send if attachment filename missing
DontSendIfAttachmentFilenameMissing boolean

Should the email not be sent if one of the provided attachments cannot be found?

Click allow button if required
ClickAllowButtonIfRequired boolean

Should IA-Connect attempt to click the 'Allow' button if prompted?

Voting options
VotingOptions string

A semicolon separated list of voting options.

Send as SMTP address
SendAsSMTPAddress string

The 'Send as' email address. This option can be used if the profile has permissions to send on behalf of another person or group.

Body contains stored password
BodyContainsStoredPassword boolean

Set to true if the email body contains an IA-Connect stored password identifier, in the format {IAConnectPassword:StoredPasswordIdentifier}. This stored password could have been generated by the 'Generate password' action. For example: 'Welcome new starter, your new account password is {IAConnectPassword:GeneratedPassword}'.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Run MS Excel macro

Runs a macro in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Macro name
MacroName True string

The name of the macro in the MS Excel workbook.

Number of arguments
NumberOfArguments integer

The number of arguments that will be passed to the macro.

Argument 1
Argument1 string

The first argument that will be passed to the macro.

Argument 2
Argument2 string

The second argument that will be passed to the macro.

Argument 3
Argument3 string

The third argument that will be passed to the macro.

Argument 4
Argument4 string

The fourth argument that will be passed to the macro.

Argument 5
Argument5 string

The fifth argument that will be passed to the macro.

Argument 6
Argument6 string

The sixth argument that will be passed to the macro.

Argument 7
Argument7 string

The seventh argument that will be passed to the macro.

Argument 8
Argument8 string

The eighth argument that will be passed to the macro.

Argument 9
Argument9 string

The ninth argument that will be passed to the macro.

Argument 10
Argument10 string

The tenth argument that will be passed to the macro.

Run in background
RunInBackground boolean

If set to false, the IA-Connect Agent will wait for the macro to complete. This is suitable for simple macros which perform a task and exit. If set to true, the IA-Connect Agent will run the macro in a background thread and return for more instructions. This should be used for long running macros, if the macro displays a dialog or causes Excel to wait for additional input.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Result
Result string

The result of the macro execution.

Save As MS Word document

Saves a specified open document in an instance of Microsoft Word (referenced by the handle) as a specified filename.

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Save filename
SaveFilename True string

The filename to save the document as.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
New document name
NewDocumentName string

The new name of the Word document (after it has been saved) to be used by other Word actions to distinguish between different Word documents if more than one is open.

Save current MS Excel workbook

Saves the current workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
New workbook name
NewWorkbookName string

The new name of the Excel workbook (after it has been saved) to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Save current MS Excel workbook as

Saves the current workbook in an instance of Microsoft Excel (referenced by the handle) as a specified filename.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Save filename
SaveFilename string

The filename to save the Workbook as.

Delete existing save filename
DeleteExistingSaveFilename boolean

If set to true and a file already exists with the chosen save filename, that file will be deleted.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
New workbook name
NewWorkbookName string

The new name of the Excel workbook (after it has been saved) to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Save current MS Excel workbook as CSV

Saves the current workbook as CSV in an instance of Microsoft Excel (referenced by the handle) as a specified filename.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Save filename
SaveFilename True string

The filename to save the Workbook as.

Delete existing save filename
DeleteExistingSaveFilename boolean

If set to true and a file already exists with the chosen save filename, that file will be deleted.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
New workbook name
NewWorkbookName string

The new name of the Excel workbook (after it has been saved) to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Save email attachments as file in MS Outlook

Saves the attachments from a specific email in Outlook.

Parameters

Name Key Required Type Description
Email entry ID
EntryID True string

The email entry ID of the email to be actioned. This can be retrieved from the output of the action 'Get emails'.

Save folder path
SaveFolderPath string

The full folder path to save the attachments to in the IA-Connect Agent session.

Create folder
CreateFolder boolean

Should the save folder path be created if it does not already exist?

Only save attachments matching wildcard
OnlySaveAttachmentsMatchingWildcard string

An optional wildcard filter to specify which attachments should be saved, for example '.xlsx' to save all attachments with a '.xlsx' extension or 'Daily Report' to save all attachments with a name starting 'Daily Report'.

Save hidden attachments
SaveHiddenAttachments boolean

Should hidden attachments be saved from the email?

Click allow button if required
ClickAllowButtonIfRequired boolean

Should IA-Connect attempt to click the 'Allow' button if prompted?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Number of saved attachments
NumberOfSavedAttachments integer

The number of attachments saved.

Number of attachments failed to save
NumberOfAttachmentsFailedToSave integer

The number of attachments that failed to save.

Number of attachments not matching wildcard
NumberOfAttachmentsNotMatchingWildcard integer

The number of attachments that were skipped as they did not match the wildcard.

Number of attachments skipped
NumberOfAttachmentsSkipped integer

The number of attachments that were skipped as they were hidden.

Email attachment save as filenames JSON
EmailAttachmentSaveAsFilenamesJSON string

The full path to each attachment that was saved, in JSON format.

Save MS Excel workbook

Saves a specified open workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
New workbook name
NewWorkbookName string

The new name of the Excel workbook (after it has been saved) to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Save MS Excel workbook as

Saves a specified open workbook in an instance of Microsoft Excel (referenced by the handle) as a specified filename.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Save filename
SaveFilename True string

The filename to save the Workbook as.

Delete existing save filename
DeleteExistingSaveFilename boolean

If set to true and a file already exists with the chosen save filename, that file will be deleted.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
New workbook name
NewWorkbookName string

The new name of the Excel workbook (after it has been saved) to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Save MS Excel workbook as CSV

Saves a specified open workbook as CSV in an instance of Microsoft Excel (referenced by the handle) as a specified filename.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Save filename
SaveFilename True string

The filename to save the Workbook as.

Delete existing save filename
DeleteExistingSaveFilename boolean

If set to true and a file already exists with the chosen save filename, that file will be deleted.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
New workbook name
NewWorkbookName string

The new name of the Excel workbook (after it has been saved) to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Save MS Excel workbook as with password

Saves a specified open workbook in an instance of Microsoft Excel (referenced by the handle) as a specified filename with a password.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Save filename
SaveFilename True string

The filename to save the Workbook as.

Save password
Password True password

The password to be used to access the Workbook after it has been saved.

Delete existing save filename
DeleteExistingSaveFilename boolean

If set to true and a file already exists with the chosen save filename, that file will be deleted.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
New workbook name
NewWorkbookName string

The new name of the Excel workbook (after it has been saved) to be used by other Excel actions to distinguish between different Excel workbooks if more than one is open.

Save MS Word document

Saves a specified open document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Select all in MS Word document

Selects all of the content in an open document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Select cell range in MS Excel worksheet

Selects a range in a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell or cell range reference, for example: A1 or B2:C5.

Entire row
EntireRow boolean

Should the entire row that contains the reference cell(s) be selected?

Entire column
EntireColumn boolean

Should the entire column that contains the reference cell(s) be selected?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Select range in MS Word document

Selects a character range in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Start
Start True integer

The starting character position, starting at 1.

Finish
Finish True integer

The ending character position, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Select table cell in MS Word document

Selects a cell in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Table index
TableIndex True integer

The table number, starting at 1.

Row index
RowIndex True integer

The row number, starting at 1.

Column index
ColumnIndex True integer

The column number, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Select table in MS Word document

Selects a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Table index
TableIndex True integer

The table number, starting at 1.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Send email in MS Outlook

Sends a new email in Outlook.

Parameters

Name Key Required Type Description
Email to
To string

The email address(es) of the primary recipient(s).

Email CC
CC string

The email address(es) of any recipient(s) who should be included on CC.

Email BCC
BCC string

The email address(es) of any recipient(s) who should be included on BCC.

Email subject
Subject string

The email subject text to be used.

Email body format
BodyFormat string

Provide a body type (HTML, Plain or RTF).

Email body
Body string

The email body to be used if the email body format has been provided as 'Plain'.

Email HTML body
HTMLBody string

The email HTML body to be used if the email body format has been provided as 'HTML'.

Email RTF body
RTFBody string

The email RTF body to be used if the email body format has been provided as 'RTF'.

Attachment filenames JSON
AttachmentFilenamesJSON string

A list of full filepaths to the files that should be attached to the email, in JSON format.

Dont send if attachment filename missing
DontSendIfAttachmentFilenameMissing boolean

Should the email not be sent if one of the provided attachments cannot be found?

Click allow button if required
ClickAllowButtonIfRequired boolean

Should IA-Connect attempt to click the 'Allow' button if prompted?

Voting options
VotingOptions string

A semicolon separated list of voting options.

Send as SMTP address
SendAsSMTPAddress string

The 'Send as' email address. This option can be used if the profile has permissions to send on behalf of another person or group.

Body contains stored password
BodyContainsStoredPassword boolean

Set to true if the email body contains an IA-Connect stored password identifier, in the format {IAConnectPassword:StoredPasswordIdentifier}. This stored password could have been generated by the 'Generate password' action. For example: 'Welcome new starter, your new account password is {IAConnectPassword:GeneratedPassword}'.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Set cell background colour in MS Excel worksheet

Sets the background colour of the specified cell or cells in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell or cells where you want to change the background colour, for example: A1.

Colour index
ColourIndex True integer

The MS Excel colour index number, for example: No fill = 0, Black = 1, White = 2, Red = 3, Green = 4, Blue = 5. For a full colour index see our KB article.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelSetCellBackgroundColourResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Set cell value in active MS Excel worksheet

Set the string value of a cell in the active workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Cell value
CellValue True string

The new value to set the cell to.

Cell value is stored password
CellValueContainsStoredPassword boolean

Set to true if the cell value contains an IA-Connect stored password identifier, in the format {IAConnectPassword:StoredPasswordIdentifier} or an IA-Connect Orchestrator generic credential, in the format {OrchestratorCredential:FriendlyName}. This stored password could have been generated by the 'Generate password' action, for example, or be held by the IA-Connect Orchestrator.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Set MS Excel calculation mode

Sets the calculation mode (0 = manual, 1 = automatic, 2 = semi automatic) in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Calculation mode
CalculationMode True integer

Provide a calculation mode (0 = Manual, 1 = Automatic, 2 = Semi automatic.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Set MS Excel worksheet sensitivity label

Sets the sensitivity label (e.g. Public, Internal, Confidential) in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Assignment method
AssignmentMethod True string

The assignment method for the sensitivity label.

Assignment label Id
LabelId True string

The sensitivity label Id. These are pre-defined in your organisation. One method of determining the correct label Id would be to read the label Id from an existing workbook.

Assignment label name
LabelName string

The sensitivity label name.

Assignment site Id
SiteId string

The sensitivity site Id which is a unique Id for your organisation. One method of determining the correct site Id would be to read the site Id from an existing workbook.

Assignment justification
Justification string

If downgrading the sensitivity label, this input allows you to provide the justification.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelSetWorksheetSensitivityLabelResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Set MS Outlook Allow popup details

Overrides the default Outlook 'Allow' popup element search details used by IA-Connect Agent to locate the 'Allow' button. Button names may change with the language settings, if so use this before calling 'Background monitor for Allow popup'.

Parameters

Name Key Required Type Description
Outlook allow button name
OutlookAllowButtonName string

The element name of the 'Allow' button in the popup. By default, this is 'Allow'.

Outlook allow button automation Id
OutlookAllowButtonAutomationId string

The automation ID of the 'Allow' button in the popup. By default, this is '4774'.

Outlook allow checkbox automation Id
OutlookAllowCheckboxAutomationId string

The automation ID of the 'Do not ask me for X minutes' checkbox. By default, this is '4771'.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Set MS Word document table cell text value

Sets the text value of a cell in a table (specified by index) in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Table index
TableIndex True integer

The table number, starting at 1.

Row index
RowIndex True integer

The row number, starting at 1.

Column index
ColumnIndex True integer

The column number, starting at 1.

New cell text
NewCellText string

The text value that the specified table cell should be set to.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Show MS Excel

Makes an instance of Microsoft Excel visible (referenced by the handle). This would typically only be used during development because Excel doesn't need to be visible for automation, unless you are also using UIA to control Excel.

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Show MS Outlook

Shows the current Outlook instance that is being automated. This would typically only be used during development because Outlook doesn't need to be visible for automation, unless you are also using UIA to control Outlook.

Parameters

Name Key Required Type Description
Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Show MS Word

Makes an instance of Microsoft Word visible (referenced by the handle). This would typically only be used during development because Word doesn't need to be visible for automation, unless you are also using UIA to control Word.

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Start background monitor for MS Outlook Allow popup

Creates a background thread that monitors the remote session for a specified number of seconds, searching for an 'Allow' popup, which can be triggered by a number of Outlook actions such as 'Send email'. Once the element is located, the action will then click the 'Allow' button to permit the triggering action to complete successfully.

Parameters

Name Key Required Type Description
Seconds to wait for dialog
SecondsToWaitForDialog integer

The number of seconds to wait for the dialog to appear. By default, this is 10 seconds.

Seconds to wait for allow button
SecondsToWaitForAllowButton integer

The number of seconds to wait for the allow button to appear. By default, this is 10 seconds.

Seconds to wait for allow button to be enabled
SecondsToWaitForAllowButtonToBeEnabled integer

The number of seconds to wait for the allow button to be enabled. By default, this is 10 seconds.

Outlook allow button name
OutlookAllowButtonName string

The UIA element name of the 'Allow' button. This is only required if the button element is not named 'Allow'.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Trust MS Excel VB object model in registry

Sets the registry value for Excel to trust VB object model (needed to create macros). Excel must not be running and only works if not overridden by GPO. This is the same as enabling the 'Trust access to the VBA project object model' option in the 'Developer Macro Settings' section of Trust Center.

Parameters

Name Key Required Type Description
Excel version
ExcelVersion integer

The Excel version, e.g. 9 for Excel 2000 or 16 for Excel 2016.

Trust VBOM
TrustVBOM boolean

Should the VBOM be trusted?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Type text in MS Word document

Types the specified text into a document from the currently selected point in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Text to type
Text True string

The text content to type into the Word document.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Update MS Word bookmark

Updates a bookmark in a named document in an instance of Microsoft Word (referenced by the handle).

Parameters

Name Key Required Type Description
Word handle
Handle integer

The handle of the instance of Word (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Word.

Document name
DocumentName string

The name of the open Word document (used to distinguish between documents) or blank for the currently active document.

Bookmark name
BookmarkName True string

The name of the bookmark to be updated in the Word document.

New value
NewValue string

The value that the bookmark should be updated to.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Write array to MS Excel worksheet

Writes an array into a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Array to write
ArrayToWriteJSON True string

The array to write, in JSON or CSV format. For example: ["Value 1", "Value 2", "Value 3"] (JSON array format), or Value 1,Value 2,Value 3 (CSV format).

Direction
Direction True string

Provide a direction (U, D, L, R) to move between each write.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Name Path Type Description
Command result
MSExcelWriteArrayResult boolean

The result of the command (success or failure).

Error message
ErrorMessage string

If the command was not successful, this will contain the error message that was returned.

Write collection to MS Excel worksheet

Writes a collection (table) into a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Collection
CollectionToWriteJSON True string

The collection (table) to write, in JSON format.

Include Column Names
IncludeColumnNames boolean

Should the column names also be written?

Workflow
Workflow True string

Add the following expression here: workflow()

Returns

Write collection to MS Excel worksheet with dates

Writes a collection (table) with date fields into a named worksheet in a workbook in an instance of Microsoft Excel (referenced by the handle).

Parameters

Name Key Required Type Description
Excel handle
Handle integer

The handle of the instance of Excel (as provided by 'Create instance' or 'Attach to existing instance') or 0 for the currently active instance of Excel.

Workbook name
WorkbookName string

The name of the open Excel workbook (used to distinguish between workbooks) or blank for the currently active workbook.

Worksheet name
WorksheetName string

The name of the worksheet (tab) within the workbook or blank for the currently active worksheet.

Cell reference
CellReference True string

The cell reference, for example: A1.

Collection
CollectionToWriteJSON True string

The collection (table) to write, in JSON format.

Include Column Names
IncludeColumnNames boolean

Should the column names also be written?

Try to convert all fields to date
TryToConvertAllFieldsToDate boolean

Should all fields be converted to dates if possible?

Columns to convert to date
ColumnsToConvertToDateJSON string

The column headers of columns that should be converted to dates, in JSON format.

Workflow
Workflow True string

Add the following expression here: workflow()

Returns