Automation Properties, Methods, and Events

Automations have these properties, methods, and events:

 

Properties

Property

Description

Context

Indicates the context in which the automation is loaded.

DesignTime

When set to True, it indicates the control is a design time control. (Boolean)

FullName

Gets the fully-qualified name of the automation.

GridSize

 

This property applies when the GridStyle property has been set to an option other than None. It determines the size of the grid in pixels. You specify the size using the Width and Height properties. The defaults are 20 pixels in height and 20 pixels in width.

Note: This property also applies to the SnapToGrid automation property.

GridStyle

You have the option of displaying a grid on the automation page to assist in the placement of design block. Your options are:

None – no grid is shown (default)

Cross –  

Dot –  only dots are shown.

Line –  GridStyleLine

Horizontal Line  –  

Vertical Line –  

InDesign

Gets a value indicating if the automation is in design mode. (Boolean)

IsRunning

Gets a True value if the automation is running. (Boolean)

IsStartStoppable

Set to True to enable restarting the automation while the project is running. (Boolean)

IsSuspended

Gets a value that indicates whether the automation's execution is suspended. (Boolean)

LogData

Set to True to have Studio log all data messages to a file for an the automation. If you enable data logging, you must set the automation's LogFile and LogToFile properties. (Boolean)

LogEvents

Set to True to have Studio log all eventAn occurrence that is significant to a program and which may call for a response from a program. For example, when a button is clicked. messages to a file for the automation. If you enable event logging, you must set the automation's LogFile and LogToFile properties. (Boolean)

LogFile

If the LogData or LogEvents property is set to True, use this property to enter the name of the file to which you want to  log messages for an automation.

The path defaults to the installation directory of the Studio application.

LogToFile

Set to True to save Data or Event logging to a file (indicated in the LogFile Property). See the LogData and LogEvents properties. (Boolean)

Name

Sets the name assigned to the automation.

ShowDesignCompNames

Set to True to have the Design Component FullName shown in the top of the connection blocks. The default is False. (Boolean)

SnapToGrid

Set this property to True to have connection blocks snap to the positioning grid as defined by the GridSize property when the blocks are moved or placed on the automation. (Boolean)

StartOnProjectStart

By default, this property is True, which means that the automation will start when the project is run. If you set this property to False, start the automation by calling the Start method from another automation. (Boolean)

SuppressErrors

When set to True, if an error occurs during the execution of the automation, the message box for the automation error is hidden to the user. If the Diagnostics File Publisher is enabled, the error is still to the log file. (Boolean)

Note: Setting this property to True does not handle the any exceptions that occur while the automation is running, It only hides the message box normally provided to the user. Set this to True for all production releases of a project.

  • Suppress Errors - True (no message box errors thrown)

  • Suppress Errors - False (default)

See the related event, ExceptionThrown, which can yield the sender, exception, and message from any given exception encountered while running the automation.

This

A reference to the automation object.

UniqueId

Indicates the unique identifier of the automation.

 

Events

Events

Description

Completed

This method has been depreciated and should not be used.  

ExceptionThrown

Occurs when an error occurs during the execution of an automation.

Launched

This event is used to control the data and event execution between automations. When you call a Launch Method on an automation, it fires a launched event. Then, if you start a second automation off the launched event, you can chain automations together.

Started

Occurs when the Start method is called on the automation.

Starting

Occurs when the automation is starting.

Stopped

Occurs when the Stop method is called on the automation.

Stopping

Occurs while the automation is stopping.

Terminated

Occurs when the component is terminated.

 

 

Methods

Methods

Description

Parameters

Return Type

InvokeEntryPoint

Use this method to access an automation from C# code.

Object[]

Object

ResetState

Reserved for .NET use.

None

Void

Start

Starts the automation.

None

Void

Stop

Stops the automation.

None

Void

 


Privacy | Trademarks | Terms of Use | Feedback

Updated: 18 June 2020

© 2016 - 2020 Pegasystems Inc.  Cambridge, MA All rights reserved.

 

OpenSpan data classification label