Use the Start App component

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 1 minute to read

    • Start or launch an application or file by using the START APP component in RPA Desktop Design Studio.

    Before you begin

    Role required: none

    About this task

    You can configure the properties for the Start App component.
    Table 1. Properties of the START APP component
    Property Description
    Delay After Execution The number of seconds to pause after running.
    Delay Before Execution The number of seconds to pause before running.
    Height Specifies the height of the application window that is launched.
    Left Specifies the location of the application that is launched along the left edge of the screen.
    Top Specifies the location of the application that is launched along the top edge of the screen.
    Width Specifies the width of the application window that is launched.
    Enable Timeout Select to apply a timeout value.
    Timeout The number of seconds at which the operation will time out if it is not completed. To apply this value, the Enable Timeout property must be set.
    Max Wait Time in Seconds Maximum time, in seconds, to wait for the image or application to appear on the screen.

    The default value is 30 seconds.
    Wait For Start Specifies the wait time (in seconds) before the action is executed.
    State Specifies the state in which the Windows based or web-based application is launched. The states are normal, maximized, minimized, hidden, or custom location.

    Procedure

    1. In the Toolbox pane, navigate to General > START APP.
    2. Drag the START APP component to the Design surface.
    3. To configure the input fields, see Configure port properties.
    4. Connect the data and control ports of the Start App component to the corresponding ports of the other component as described in the following table.
      Table 2. START APP component port parameters
      Port type Port name Data type Purpose of connection Default value Mandatory?
      Data In File Path String Takes the path to the file or the application in the local disk. No default value Yes
      Data In Args String Takes the arguments for the path.

      For example, if you provide the local path to the Google Chrome browser, the argument can be https://servicenow.com

      		 No default value No. Connecting the port is optional.
      Data Out Window Handle Integer Returns the window handle of the file or application. Not applicable Not applicable
    5. Optional: To test the component, under the DESIGN tab, click Run.