Skip to main content

StartMyDay properties, methods, and events

Suggest edit Updated on November 10, 2021
Pega Robot Studio v21 Preview

Use StartMyDay properties, methods, and events to define automations that run when you launch Runtime.

The StartMyDay feature is a set of tools to automate activities you see when starting Robot Runtime or Agile Desktop. This list can include non‐Pega programs and URLs, as well as Pega Robot Studio solutions. Users can use the Manage Applications dialog to prioritize the order in which applications are launched, to maximize their readiness.

In addition, each Runtime/Agile Desktop user can add to and remove from the list of processes to be started by Runtime/Agile Desktop. The items on the list are specific to the user.

StartMyDay properties

PropertyDescription
Enable

Enter True to allow associated applications to integrate with StartMyDay. Enter False if the applications are not integrated with this solution.

QueueActivity

Enter True if you want the Interaction Framework to queue StartMyDay activities that are received from applications.

Enter False if you want to initiate StartMyDay activities that are received from applications upon receipt.

Note: This property has no effect if the Enable property is set to False.

StartMyDay methods

MethodDescriptionParametersReturn type
AddExeApplication

Use this method to add an executable application to the StartMyDay list.

String friendlyName, String pathBoolean result
AddWebApplicationUse this method to add a web application to the StartMyDay list. String friendlyName, String urlBoolean result
GetApplicationPositionAndSize

Use this method to get the position of the top-left corner of the application and the width and height of the application.

The method also returns a True or False value to indicate the success of your request.

Note: Be sure to set the StartMyDayControls property on the application. Otherwise, the system does not retrieve the application’s position and size.

String friendlyName int left, Int top, int width, int height, Boolean result
GetStartupApplicationsUse this method to get a list of the applications designated to be started. none List<StartMyDayApplication> Result
OrganizeApplication

Use this method to set the position and size of a single StartMyDay application to the saved values.

Note: Be sure to set the StartMyDayControls property on the application. Otherwise, the system does not retrieve the application’s position and size.

String friendlyName int left, int top, int width, int height, Boolean result
OrganizeDesktop

Use this method to set the position and size for all StartMyDay applications to their saved values.

This method does not affect applications that are added manually by users or applications that are added using the AddExeApplication or AddWebApplication methods.

Note: Be sure to set the StartMyDayControls property on the application. Otherwise, the system does not retrieve the application’s position and size.

noneBoolean result
ResetStateUse this method to reset all component properties to their initial values. nonevoid
SetApplicationOrder

Use this method to set the ordinal (0-based) position of an application in the list for the Manage Applications window.

Reference applications and web applications added using the AddWebApplication method and the FriendlyName property.

Reference applications added with the AddExeApplication method using their path.

String friendlyNameOrPath, Int indexBoolean result
SetApplicationPositionAndSize

Use this method to set the position and size of an application.

Note: You can only call this method for applications. Also set the StartMyDayControls property on the application. Otherwise, the system does not retrieve the application’s position and size.

String friendlyName, int left, Int top, int width, int heightBoolean result
ShowDialogUse this method to display the Manage Applications window. noneBoolean clickedOK
ShowStartDialog

This method shows a list of applications that are not started. The user can select one or more applications from the list to start.

For more information, see Using the Start Dialog.

noneBoolean clickedOK
StartApplicationUse this method to start a single application. friendlyNameBoolean result
StartApplications Add one or more applications to the automation block inputs so you can start multiple applications. String friendlyNames Boolean result
StartApplicationListUse this method to start all of the applications that you include in the string array. This list can include one or more applications. String[] friendlyNames Boolean result
StartMyDayUse this method to execute StartMyDay functionality. nonevoid

StartMyDay events

EventDescription
ApplicationOrganizedThe system raises this event when the OrganizeApplication method completes its work. This event returns the following event arguments: Name, Adapter, Left, Top, Width, and Height.

Note: Be sure to set the StartMyDayControls property on the application. Otherwise, the system does not retrieve the application’s position and size.

ApplicationOrganizing

The system raises this event when the OrganizeApplication method is invoked. This event returns the following event arguments: Name, Adapter, Left, Top, Width, and Height.

You can cancel this event by sending a True value to the Cancel port.

Note: Be sure to set the StartMyDayControls property on the application. Otherwise, the system does not retrieve the application’s position and size.

OnStartAdapterThe system raises this event when the application starts.
OrganizedThe system raises this event when the OrganizeDesktop method completes its work.
Organizing

The system raises this event when the OrganizeDesktop method is invoked.

You can cancel this event by sending a True value to the Cancel port.

StartMyDayCompletedThe system raises this event when the StartMyDay component finishes its tasks.
Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us