UiPath Activities

The UiPath Activities Guide

Type Into

UiPath.UIAutomationNext.Activities.NTypeInto

Description

Enters text in a specified UI element, for example a text box. This activity must be added inside a Use Application/Browser activity.

Properties

Common

  • Continue on error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
  • Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
  • Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
  • DisplayName - The name displayed for the activity in the Designer panel. A display name is automatically generated when you indicate a target.
  • Timeout - Specify a number of seconds for which to wait for the activity to be executed before throwing an error. The default value is 30 seconds.

Input

  • Secure text - The secure text to enter. The field supports only SecureString variables. If specified, the Text field is cleared.
  • Text - The text to enter. You can add special keys to the text from the drop-down list in the body of the activity. If specified, the Secure text field is cleared.

Misc

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Options

  • Activate - If selected, the specified UI element is brought to the foreground and activated before the text is typed in.

    Note:

    If Activate is not selected, the activity will type into the current active window.

  • Click before typing - Select whether to click the specified UI element before typing the text, and the type of click to perform. The options are None (do not click), Single (execute a single click), or Double (execute a double click). The default option is Single.
  • Delay between keys - Delay (in seconds) between consecutive keystrokes. The default value is 0.02 seconds.
  • Empty field - Select whether to delete the existing content in the field before typing the text, and how to empty the field. Fields are emptied by sending a combination of keystrokes that differs between fields with a single line and fields with multiple lines. Make sure to select the right option depending on the indicated field.

    The options are None (do not delete the existing content), SingleLine (delete the content from a text field with a single line), or MultiLine (delete the content from a text field with multiple lines). The default option is SingleLine.

    To use the activity to clear the indicated text field, configure this property to delete the existing content, leave the Type this field empty, and set the Input Mode property to Hardware Events.

  • Input mode - Select how to execute the type:
    • Same as App/Browser - Use the same input mode as the Use Application/Browser activity. This is the default selection.
    • Hardware Events - Simulates the keystrokes by using the hardware driver. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
    • Simulate - Simulates the type using the technology of the target application. This input method is the fastest and works in the background.

      The properties Activate, Click before typing, Delay between keys, and Empty field cannot be used with the Simulate input mode.

      Note:

      If the text to type includes special keys, the input mode used when executing the project is Hardware Events regardless of the setting.

UiPath.UIAutomationNext.Activities.NTypeInto

Description

Enters text in a specified UI element, for example a text box. You can also send special keys like Tab or Enter to the UI element. If you want to enter sensitive information securely, add a Get Username/Password activity before this activity and select the saved for later username and password values from that activity as the text to type. This activity must be added inside a Use Application/Browser activity.

To learn how to use this activity, see:

  • Tutorial: Working with UI Automation.
  • Tutorial: Filling Out PDF Forms in Acrobat Reader with Data from Excel.
  • Prerequisites for Entering Login Information Securely

    Before you can enter username / password information securely using this activity, you must first:

    1. Add a Get Username/Password activity to the project.
    2. In the Get Username/Password activity, select credentials previously saved to the Windows Credential Manager. If the credentials you want to use are not already saved in the Windows Credential Manager, you can use this activity to add them.
    3. Save the credentials for later use in the project.

    Configuring the Activity

    In the Body of the Activity

    • Click Indicate target on screen to indicate the UI element where to enter the text. This step is not required if the element is already in focus in the target application.
    • Click Plus plus button on the right side of the Type this field, and use one of the options in the menu to select the text to enter:

      • Data from the Project Notebook, a parent Excel file or Outlook account. For example, you can select a cell in an Excel file, or a field from the email selected in Outlook when the project is executed.
      • Use Saved Value - Select a value that you previously saved for later use in the project.

        Use this option to enter login credentials securely. If you select a saved value that was created in a Get Username/Password activity, you can select either the username or the password as the value to type.

      • Text - Enter text in the Text Builder. You can also use the options in the Plus plus button menu inside the Text Builder to add special keys, values saved for later, or data from the Project Notebook or parent Use Excel File or Use Outlook Account activities. Any combination of text, Excel or Outlook data, and special keys is supported.
      • Special Keys - Select a special key to send to the text field.
      • Ask when run - Prompt for a text when the project is executed.
      • Open in Advanced Editor - Enter a VB expression.
    • Empty field before typing - Select whether to delete the existing content in the field before typing the text, and how to empty the field. Fields are emptied by sending a combination of keystrokes that differs between fields with a single line and fields with multiple lines. Make sure to select the right option depending on the indicated field.

      The options are:

      • None - Do not delete the existing content.

      • Single line (End, Shift++Home, Del) - Delete the content from a text field with a single line. This is the default option.

      • Multi line (Ctrl+A, Del) - Delete the content from a text field with multiple lines.

    • To use the activity to clear the indicated text field, configure this property to delete the existing content, leave the Type this field empty, and set the Input Mode property to Hardware Events.

    • Click before typing - Select whether to click the specified UI element before typing the text, and the type of click to perform. The options are None (do not click), Single (execute a single click), or Double (execute a double click). The default option is Single.
    • After you indicate the target, click Menu Options button to access the following options:
      • Indicate target on screen - Indicate the target again.
      • Edit Target - Open the selection mode to configure the target.

    For more information about indicating and configuring targets, see About the UIAutomationNext Activities Pack.

    In the Properties Panel

    Common

    • Continue on error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
    • Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
    • Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
    • DisplayName - The name displayed for the activity in the Designer panel. A display name is automatically generated when you indicate a target.
    • Timeout - Specify a number of seconds for which to wait for the activity to be executed before throwing an error. The default value is 30 seconds.

    Input

    Misc

    • Private - If selected, the data used by the activity is not saved to the StudioX logs when the project is executed.

    Options

    • Activate - If selected, the specified UI element is brought to the foreground and activated before the text is typed in.

      Note:

      If Activate is not selected, the activity will type into the current active window.

    • Click before typing - See Click before typing in the body of the activity.
    • Delay between keys - Delay (in seconds) between consecutive keystrokes. The default value is 0.02 seconds.
    • Empty field - See Empty field before typing in the body of the activity
    • Input mode - Select how to execute the type:
      • Same as App/Browser - Use the same input mode as the Use Application/Browser activity. This is the default selection.
      • Hardware Events - Simulates the keystrokes by using the hardware driver. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
      • Simulate - Simulates the type using the technology of the target application. This input method is the fastest and works in the background.

        The properties Activate, Click before typing, Delay between keys, and Empty field cannot be used with the Simulate input mode.

        Note:

        If the text to type includes special keys, the input mode used when executing the project is Hardware Events regardless of the setting.

Updated 3 months ago


Type Into


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.