Anhängen

Konzentriert sich auf eine Desktopanwendung oder eine bereits geöffnete Webbrowserseite zur Verwendung in der UI-Automatisierung.

Diese API wird durch Aufrufen des UIAutomation-Diensts verwendet, basierend auf dem folgenden Format: uiAutomation.<APIMethod>(). Beispiel: uiAutomation.Open().

Definition

Namespace: UiPath.UIAutomationNext.API.Contracts

Assembly: UiPath.UIAutomationNext.API.Contracts (in UiPath.UIAutomationNext.API.Contracts dll)

Überladungen

Überladen	Beschreibung
Attach(String, TargetAppOptions, String, String)	Konzentriert sich auf eine bestimmte Desktopanwendung oder Webseite, die in der UI-Automatisierung verwendet werden soll, identifiziert durch den Bildschirmnamen aus dem Objekt-Repository.
Attach(TargetAppModel, TargetAppOptions)	Konzentriert sich auf eine bestimmte Desktopanwendung oder Webseite zur Verwendung in der UI-Automatisierung, identifiziert durch das TargetAppModel -Objekt.
Attach(String, String, String, NAppAttachMode, NWindowResize, NInteractionMode)	Konzentriert sich auf eine bestimmte Desktopanwendung oder Webseite, die in der UI-Automatisierung verwendet werden soll, identifiziert durch den Bildschirmnamen aus dem Objekt-Repository, zusammen mit anderen Anpassungen der App oder Webseite.

Attach(String, TargetAppOptions, String, String)

Konzentriert sich auf eine bestimmte Desktopanwendung oder Webseite, die in der UI-Automatisierung verwendet werden soll, identifiziert durch den Bildschirmnamen aus dem Objekt-Repository.

Attach(
    string screenName,
    TargetAppOptions targetAppOptions,
    [string appName],
    [string appVersion])

screeName String

Der Name des Bildschirms, auf den Sie sich konzentrieren möchten, als String, der im Objekt-Repository aufgezeichnet wird.

targetAppOptions TargetAppOptions

Zusätzliche Optionen und Einstellungen zum Anhängen an die Anwendung oder Webseite:

• Timeout Double – Geben Sie eine Anzahl von Sekunden an, die auf die Ausführung der Aktivität gewartet werden soll, bevor ein Fehler ausgegeben wird. Der Standardwert beträgt 30 Sekunden. Wenn ein Fenster in einer Remotedesktop-Umgebung angegeben wird, ist die Standardeinstellung Timeout auf 60 Sekunden festgelegt.
• InteractionMode NInteractionMode:
  • HardwareEvents – Verwendet den Hardwaretreiber, um die Actionsauszuführen. Dies ist die langsamste API, sie kann nicht im Hintergrund arbeiten, aber sie ist mit allen Desktop-Apps kompatibel.
  • Simulate - Simuliert die Actions mithilfe von Barrierefreiheits-APIs. Empfohlen für die Browserautomatisierung, Java-Apps oder SAP. Zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Actions. Funktioniert auch dann, wenn die Zielanwendung nicht im Fokus steht. Testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.
  • DebuggerApi – Führt Actions mithilfe von Debugger-APIs aus. Funktioniert nur für Chromium-Elemente. Sendet den gesamten Text auf einmal. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Weitere Informationen finden Sie auf dieser Seite.
  • WindowMessages – Sendet die Maus- und Tastatureingabe über Win32-Meldungen. Empfohlen für Desktop-Apps. In der Regel zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Actions. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.
  • Background – Führt Actions im Hintergrund aus. Versucht, nach Möglichkeit entweder Simulate- oder Chromium-API zu verwenden, während komplexe APIs (Bild, nativer Text) wie gewohnt im Vordergrund ausgeführt werden. Es wird dringend empfohlen, diese API mit der Funktion „Ausführung verifizieren“ zu verwenden.
• OpenMode NAppOpenMode – Wählen Sie aus, wann die App geöffnet werden soll:
  • Never (Öffnen Sie niemals die Anwendung)
  • IfNotOpen (nur geöffnet, wenn die Anwendung geschlossen ist; dies ist die Standardauswahl; funktioniert nur, wenn FilePath oder URL angegeben ist)
  • Always (eine andere Instanz der Anwendung öffnen, auch wenn bereits eine geöffnet ist; funktioniert nur, wenn FilePath oder URL angegeben ist)
• WindowResize NWindowResize – wählen Sie die Größe des Fensters aus:
  • Keine
  • Maximieren
  • Wiederherstellen
  • Minimize
• UserDataFolderMode BrowserUserDataFolderMode – Der UserDataFolderMode , den Sie festlegen möchten. Er wird verwendet, um den Browser mit einem bestimmten Benutzerdatenordner zu starten.
  • Automatic – Der Bild-in-Bild-Modus verwendet einen anderen Ordner als der Standardmodus, der automatisch generiert wird, wenn UserDataFolderPath nicht festgelegt ist.
  • DefaultFolder - Verwendet den Standard-Browserordner, unabhängig davon, ob in der Haupt- oder BiB-Sitzung ausgeführt wird.
  • CustomFolder – Verwendet den in UserDataFolderPath angegebenen Ordner oder einen automatisch generierten Pfad, wenn UserDataFolderPath nicht festgelegt ist.
• UserDataFolderPath String – Der Benutzerdatenordner, den der Browser verwendet. Der Standardwert ist %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , wenn keiner festgelegt ist.
• IsIncognito Boolean – Geben Sie True ein, wenn Sie den Browser im Inkognito-Modus öffnen möchten. Standardmäßig ist sie auf Falsefestgelegt.
• WebDriverMode NWebDriverMode - gibt an, wie der WebDriver beim Öffnen einer neuen Browsersitzung verwendet wird. Die folgenden Optionen sind verfügbar:
  • Disabled - Deaktiviert die Verwendung von WebDriver.
  • WithGUI - Die GUI des Browsers wird angezeigt.
  • Headless – Der Browser wird im Hintergrund gestartet, ohne GUI.

appName String

Der Name der Anwendung, an die angehängt werden soll. Dieser Parameter gilt für Desktop-Anwendungen.

appVersion String

Die Version der Anwendung, an die angehängt werden soll. Dieser Parameter gilt für Desktop-Anwendungen.

Attach(TargetAppModel, TargetAppOptions)

Konzentriert sich auf eine bestimmte Desktopanwendung oder Webseite zur Verwendung in der UI-Automatisierung, identifiziert durch das TargetAppModel -Objekt.

Attach(
    TargetAppModel targetApp,
    [TargetAppOptions targetAppOptions]))

targetApp Zielanwendungsmodell

Die Zielanwendung oder Webseite, an die angehängt werden soll. Es ist ein Objekt vom Typ TargetAppModel , das Informationen über die Anwendung bereitstellt:

• Selector String – Ein XML-Fragment, das die Attribute eines UI-Elements speichert.
• FilePath String – Gibt den vollständigen Pfad der zu öffnenden ausführbaren Datei an, wenn es sich bei der Anwendung nicht um einen Webbrowser handelt.
• Arguments String – Wenn es sich bei der Anwendung nicht um einen Webbrowser handelt, können Sie Parameter angeben, die beim Start an die Zielanwendung übergeben werden sollen.
• Url String – Gibt die URL der zu öffnenden Webseite an, wenn es sich bei der Anwendung um einen Webbrowser handelt.
• Title String – Der Titel der Anwendung oder des Browsers.

targetAppOptions TargetAppOptions

Zusätzliche Optionen und Einstellungen zum Anhängen an die Anwendung oder Webseite:

• Timeout Double – Geben Sie eine Anzahl von Sekunden an, die auf die Ausführung der Aktivität gewartet werden soll, bevor ein Fehler ausgegeben wird. Der Standardwert beträgt 30 Sekunden. Wenn ein Fenster in einer Remotedesktop-Umgebung angegeben wird, ist die Standardeinstellung Timeout auf 60 Sekunden festgelegt.
• InteractionMode NInteractionMode:
  • HardwareEvents – Verwendet den Hardwaretreiber, um die Actionsauszuführen. Dies ist die langsamste API, sie kann nicht im Hintergrund arbeiten, aber sie ist mit allen Desktop-Apps kompatibel.
  • Simulate - Simuliert die Actions mithilfe von Barrierefreiheits-APIs. Empfohlen für die Browserautomatisierung, Java-Apps oder SAP. Zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Actions. Funktioniert auch dann, wenn die Zielanwendung nicht im Fokus steht. Testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.
  • DebuggerApi – Führt Actions mithilfe von Debugger-APIs aus. Funktioniert nur für Chromium-Elemente. Sendet den gesamten Text auf einmal. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Weitere Informationen finden Sie auf dieser Seite.
  • WindowMessages – Sendet die Maus- und Tastatureingabe über Win32-Meldungen. Empfohlen für Desktop-Apps. In der Regel zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Actions. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.
  • Background – Führt Actions im Hintergrund aus. Versucht, nach Möglichkeit entweder Simulate- oder Chromium-API zu verwenden, während komplexe APIs (Bild, nativer Text) wie gewohnt im Vordergrund ausgeführt werden. Es wird dringend empfohlen, diese API mit der Funktion „Ausführung verifizieren“ zu verwenden.
• OpenMode NAppOpenMode – Wählen Sie aus, wann die App geöffnet werden soll:
  • Never (Öffnen Sie niemals die Anwendung)
  • IfNotOpen (nur geöffnet, wenn die Anwendung geschlossen ist; dies ist die Standardauswahl; funktioniert nur, wenn FilePath oder URL angegeben ist)
  • Always (eine andere Instanz der Anwendung öffnen, auch wenn bereits eine geöffnet ist; funktioniert nur, wenn FilePath oder URL angegeben ist)
• WindowResize NWindowResize – wählen Sie die Größe des Fensters aus:
  • Keine
  • Maximieren
  • Wiederherstellen
  • Minimize
• UserDataFolderMode BrowserUserDataFolderMode – Der UserDataFolderMode , den Sie festlegen möchten. Er wird verwendet, um den Browser mit einem bestimmten Benutzerdatenordner zu starten.
  • Automatic – Der Bild-in-Bild-Modus verwendet einen anderen Ordner als der Standardmodus, der automatisch generiert wird, wenn UserDataFolderPath nicht festgelegt ist.
  • DefaultFolder - Verwendet den Standard-Browserordner, unabhängig davon, ob in der Haupt- oder BiB-Sitzung ausgeführt wird.
  • CustomFolder – Verwendet den in UserDataFolderPath angegebenen Ordner oder einen automatisch generierten Pfad, wenn UserDataFolderPath nicht festgelegt ist.
• UserDataFolderPath String – Der Benutzerdatenordner, den der Browser verwendet. Der Standardwert ist %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , wenn keiner festgelegt ist.
• IsIncognito Boolean – Geben Sie True ein, wenn Sie den Browser im Inkognito-Modus öffnen möchten. Standardmäßig ist sie auf Falsefestgelegt.
• WebDriverMode NWebDriverMode - gibt an, wie der WebDriver beim Öffnen einer neuen Browsersitzung verwendet wird. Die folgenden Optionen sind verfügbar:
  • Disabled - Deaktiviert die Verwendung von WebDriver.
  • WithGUI - Die GUI des Browsers wird angezeigt.
  • Headless – Der Browser wird im Hintergrund gestartet, ohne GUI.

Attach(String, String, String, NAppAttachMode, NWindowResize, NInteractionMode)

Konzentriert sich auf eine bestimmte Desktopanwendung oder Webseite, die in der UI-Automatisierung verwendet werden soll, identifiziert durch den Bildschirmnamen aus dem Objekt-Repository, zusammen mit anderen Anpassungen der App oder Webseite.

Attach(string screenName,
    [string appName],
    [string appVersion],
    [NAppAttachMode appAttachMode],
    [NWindowResize windowResize],
    [NInteractionMode interactionMode]))

screeName String

Der Name des Bildschirms, auf den Sie sich konzentrieren möchten, als String, der im Objekt-Repository aufgezeichnet wird.

appName String

Der Name der Anwendung, an die angehängt werden soll. Dieser Parameter gilt für Desktop-Anwendungen.

appVersion String

Die Version der Anwendung, an die angehängt werden soll. Dieser Parameter gilt für Desktop-Anwendungen.

appAttachMode NAppAttachMode

• ByProcessName – Weitere APIs suchen in allen Fenstern mit dem gleichen Prozessnamen wie die angegebene App.
• ByInstance – Weitere APIs suchen in der angegebenen Anwendungsinstanz, einschließlich aller übergeordneten und untergeordneten Fenster (Warnungen, Popups usw.). Andere Instanzen der Anwendung werden ausgeschlossen.
• SingleWindow – Weitere APIs suchen nur im angegebenen Fenster.

windowResize NWindowResize

Wählen Sie die Größe des Fensters aus:

• Keine
• Maximieren
• Wiederherstellen
• Minimize

interactionMode NInteractionMode

Wählen Sie aus, welche API der Roboter zur Interaktion mit der Zielanwendung verwenden soll:

• HardwareEvents – Verwendet den Hardwaretreiber, um die Actionsauszuführen. Dies ist die langsamste API, sie kann nicht im Hintergrund arbeiten, aber sie ist mit allen Desktop-Apps kompatibel.
• Simulate - Simuliert die Actions mithilfe von Barrierefreiheits-APIs. Empfohlen für die Browserautomatisierung, Java-Apps oder SAP. Zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Actions. Funktioniert auch dann, wenn die Zielanwendung nicht im Fokus steht. Testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.
• DebuggerApi – Führt Actions mithilfe von Debugger-APIs aus. Funktioniert nur für Chromium-Elemente. Sendet den gesamten Text auf einmal. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Weitere Informationen finden Sie auf dieser Seite.
• WindowMessages – Sendet die Maus- und Tastatureingabe über Win32-Meldungen. Empfohlen für Desktop-Apps. In der Regel zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Actions. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.
• Background – Führt Actions im Hintergrund aus. Versucht, nach Möglichkeit entweder Simulate- oder Chromium-API zu verwenden, während komplexe APIs (Bild, nativer Text) wie gewohnt im Vordergrund ausgeführt werden. Es wird dringend empfohlen, diese API mit der Funktion „Ausführung verifizieren“ zu verwenden.

Ausführen von WebDriverMode als monitorlos

Um WebDriverMode in einer monitorlosen Konfiguration zu verwenden, können diese Schritte als Richtlinie dienen.

Beginnen Sie mit der Definition einer Variablen für Ihren Bildschirm. Verwenden Sie die Funktion uiAutomation.Open, um eine neue Anwendung im Browser Ihrer Wahl zu öffnen – in diesem Fall: Edge. Verwenden Sie anschließend die Klasse Options in der Überladung, um bestimmte Browseroptionen anzugeben. Legen Sie unter diesen Optionen webDriverMode auf NWebDriverMode.Headless fest.

Der entsprechende Code sieht folgendermaßen aus:

var screen = uiAutomation.Open(Descriptors.NewApplication.Edge, Options.AppOpen().WithBrowserOptions(webDriverMode: NWebDriverMode.Headless));

Dieser Code versetzt Ihren WebDriver in den monitorlosen Modus und ermöglicht so die Browser-Automatisierung, ohne dass der Browser sichtbar geöffnet ist.