SAP Logon

UiPath.UIAutomationNext.Activities.NSAPLogon

Description

Use the activity to directly log on to an SAP system. Provide the exact SAP connection name from the SAP Logon or the SAP Logon Pad window used to log on to your SAP system.

Project compatibility

Windows - Legacy | Windows

Configuration

Designer panel

• SAP Logon Path - The path to your SAP Logon or SAP Logon Pad program. The default path is obtained from the corresponding system registry entry.
• Connection Name - The exact SAP connection name from the SAP Logon or the SAP Logon Pad window used to log on to your SAP system.
• Do sequence - Executes a set of child activities according to a single, defined order.

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.
  Note: If this activity is included in Try Catch and the value of the ContinueOnError property is set to True, no error is caught when the project is executed.
• Display name - The display name of the activity.

• Timeout - Specify the amount of time (in seconds) to wait for the activity to be executed before throwing an error. The default value is 30 seconds.

Input

• Unified Target Application - Expand this category to configure the following settings:

  • Arguments - If the application is not a web browser, you can specify parameters to pass to the target application at startup. You can use this property to open a specific file with the application.

  • File path - If the application is not a web browser, specifies the full path of the executable file to open. If a file path is specified, the URL property is cleared.

  • Selector - An XML fragment that stores the attributes of a user interface element.
  • URL - If the application is a web browser, specifies the URL of the web page to open. If a URL is specified, the File path property is cleared.

Input/Output Element

• Output element - Outputs a target UI Element and stores it in a UIElement object, which can be further used to target the same element with other activities.

Misc

• Private - If selected, the values of variables and arguments are no longer logged at Verbose level. This field supports only Boolean (True, False) values. The default value is False.

Options

• Close - Select when to close the target application after the automation executes all the activities added inside this activity:
  • Never - Never close the application.
  • If opened by App/Browser - Close only if the application was opened by the automation. This is the default value.
  • Always - Close the application every time.

• Input mode - Select which method the Robot should use to interact with the target application:

  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.

  • Simulate - Simulates using accessibility APIs. Recommended for browsers, Java based applications, SAP. Usually more reliable than Hardware Events. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.

  • Chromium API - Performs actions using debugger APIs. Works only for Chromium elements. Sends all text in one go. Works even if target app is not in focus. For more details, check out this page.

  • Window Messages - Simulate using Win32 messages. Recommended for desktop apps. Usually more reliable than Hardware Events. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.

  • Background - Runs actions in the background. Tries to use either Simulate or Chromium API where possible, while complex activities (image, native text) run as usual, in the foreground.

• Number Of Retries - The number of times that the activity tries to connect to SAP Scripting interface. The default value is 5.

• Resize window - Defines whether the application/browser is resized when initialized.

  • None – No resize is applied to the application/browser.
  • Maximize – The application/browser is maximized when initialized.
  • Restore to design-time size – The application/browser is resized and moved to the position and size it had when indicated, if possible.
  • Minimize – The application/browser is minimized when initialized.
• Retry Interval - The amount of time (in seconds) between each retry. The default amount of time is 0.5 seconds.
• Window attach mode - Defines where inner activities search for their target elements.
  • Process name - Inner activities search in all windows with the same process name as the indicated app.
  • Application instance - Inner activities search the indicated application instance, including all parent and child windows (alerts, popups, etc). Other instances of the application are excluded.
  • Single window - Inner activities search only in the indicated window.