Use Application/Browser

UiPath.UIAutomationNext.Activities.NApplicationCard

Beschreibung

Öffnet eine Desktopanwendung oder eine Webbrowserseite zur Verwendung in der UI-Automatisierung.

Nachdem Sie die Aktivität per Drag-and-drop in den Workflow gezogen und die zu verwendende Anwendung oder Webseite angegeben haben, fügen Sie die Aktivitäten hinzu, die in der Aktivität Use Application/Browser ausgeführt werden sollen. Wenn die Anwendung nicht bereits geöffnet ist, wird sie bei der Ausführung des Projekts geöffnet.

Diese Aktivität ist mit Object Repository kompatibel.

Informationen zur Verwendung dieser Aktivität finden Sie im Tutorial: Arbeiten mit UI-Automatisierung.

Hinweis:

• Ab UI Automation v20.10.x, Mehrere „ Use Application/Browser “-Aktivitäten können ineinander verschachtelt werden. Auf diese Weise können Sie mehrere Anwendungen gleichzeitig automatisieren.
• Ab UI Automation v21.10.3kann die Aktivität Use Application/Browser Anwendungen in Remoteumgebungen öffnen.
• Ab UI Automation v22.10.1kann die Aktivität auch Browser in Remoteumgebungen öffnen.

Projektkompatibilität

Windows – Legacy | Windows | Plattformübergreifend

Windows – Legacy, Windows-Konfiguration

Designer-Panel

• Klicken Sie auf Anwendung anzeigen , um die Anwendung zu identifizieren, indem Sie die Maus in ihr Fenster bewegen und darauf klicken. Wenn das Ziel eine Browser-Webseite ist, navigieren Sie zu der Seite, bevor Sie die Anwendung angeben.
• Nachdem Sie das Ziel angegeben haben, verwalten Sie es, indem Sie auf Menü klicken und die folgenden Optionen auswählen:
  • Ziel auf dem Bildschirm angeben – Geben Sie die Anwendung erneut an.
  • Ziel hervorheben – Zeigen Sie die angegebene Anwendung auf Ihrem Bildschirm an, die von einem Kasten umgeben ist.
  • Informativen Screenshot anzeigen – Zeigen Sie einen Screenshot der Zielanwendung oder Webseite an.
  • Informativen Screenshot entfernen – Entfernen Sie den Screenshot der Zielanwendung oder Webseite.
  • OCR-Modul – Wählen Sie eine von zwei Optionen aus:
    • Eingebettetes OCR-Modul – Verwenden Sie das OCR-Modul, das in das Computer Vision AI-Modell eingebettet ist, nämlich UiPath Screen OCR.
    • Benutzerdefiniertes OCR-Modul – Verwenden Sie ein benutzerdefiniertes OCR-Modul. Wenn diese Option ausgewählt ist, wird in der Aktivitätskarte ein Bereich hinzugefügt, in dem Sie eine andere OCR-Modul-Aktivität als UiPath Screen OCR ablegen können.
  • Zu Object Repository hinzufügen – Fügen Sie das aktuelle UI-Element zu einem Bibliotheksprojekt hinzu, von wo aus es im gesamten Automatisierungsprozess wiederverwendet werden kann.

• Sie können eine neue Instanz der Anwendung oder eine neue Browsersitzung unter Beibehaltung der aktuellen Konfigurationseinstellungen starten, indem Sie die Schaltfläche neben dem Feld Anwendungspfad (bei einer Anwendung) oder Browser-URL (bei einem Browser) verwenden. Wenn Sie einen Browser über diese Schaltfläche öffnen, werden alle im Abschnitt Optionen – Browser vorgenommenen Konfigurationen übernommen. So können Sie das Verhalten der Aktivität zur Entwurfszeit testen und mögliche Fehler zur Laufzeit vermeiden.

• Konfigurieren Sie die Einstellungen für den Anwendungsstart:
  • Wenn es sich bei der Anwendung um einen Webbrowser handelt, können Sie auf das Plus rechts neben dem Feld Browser-URL klicken und dann eine der Optionen im Menü verwenden, um die URL der zu öffnenden Webseite zu bearbeiten.
  • Wenn die Anwendung kein Webbrowser ist, können Sie Folgendes tun:
    • Geben Sie Parameter an, die beim Start im Feld Anwendungsargumente an die Zielanwendung übergeben werden sollen. Wenn die Zielanwendung beispielsweise Acrobat Reader ist, können Sie eine bestimmte PDF-Datei öffnen, indem Sie den vollständigen Pfad zur Datei angeben. Klicken Sie zum Öffnen der Datei C:\Sample.pdf Klicken Sie auf Plus > Text und geben Sie dann C:\Sample.pdf im Textgenerator ein. Bestimmte Anwendungstypen werden automatisch identifiziert und füllen die Argumenteigenschaft automatisch aus, z. B. Java-Apps, Office Suite-Apps, Adobe Acrobat oder der Windows File Explorer.
    • Klicken Sie auf Plus rechts neben dem Feld Anwendungspfad und verwenden Sie dann eine der Optionen im Menü, um den vollständigen Pfad der zu öffnenden ausführbaren Datei zu bearbeiten. Bei Anwendungen, die im Benutzermodus installiert werden, speichert die Automatisierung nicht den tatsächlichen Pfad, der den Benutzernamen enthält, sondern einen relativen Pfad, der im Feld als User Folder angezeigt wird.
      Hinweis: Wenn der im Feld Anwendungspfad definierte Pfad dynamisch ist, wird beim Klicken auf Ziel auf dem Bildschirm anzeigen in untergeordneten Aktivitäten ein Fehler generiert, wenn die Zielanwendung nicht bereits geöffnet ist.
    • Aktivieren oder deaktivieren Sie das Kontrollkästchen Exakte Übereinstimmung des Titels. Diese Option wird nur angezeigt, wenn Sie das gesamte Fenster einer Anwendung und nicht nur ein Element innerhalb der Anwendung angeben. Diese Option wird auch nicht angezeigt, wenn Sie einen Webbrowser angeben. Wenn diese Option aktiviert ist, werden in der Automatisierung nur Anwendungen verwendet, die genau dem aktuellen Anwendungstitel entsprechen. Wenn diese Option nicht aktiviert ist (Standard), wird das Fenster mit dem am besten passenden Titel für die Automatisierung verwendet.

Eigenschaften-Panel

Allgemein

• BeiFehler fortfahren – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf Truefestgelegt ist, wird die Ausführung des Projekts unabhängig von einem Fehler fortgesetzt.

• Anzeigename – Der Name, der für die Aktivität im Designerbereich angezeigt wird. Ein Anzeigename wird automatisch generiert, wenn Sie ein Ziel angeben.

  Wichtig:

  Der Anzeigename der Aktivität „Use Application/Browser“ wird auch als Referenz verwendet, die auf die Zielanwendung oder den Browser verweist. Nach der Angabe des Ziels wird der Anzeigename automatisch in das folgende Format geändert, es sei denn, es wird manuell festgelegt:

  • Für Anwendungen: Use Application: [title] - [app name]
  • Für Browser: Use Browser [browser type] : [title]

  Bei verschachtelten Anwendungskarten zeigt jede Aktivität innerhalb einer Karte ein Dropdownmenü im Textkörper an, in dem Sie die Anwendungskarte auswählen können, mit der Sie sie verwenden möchten.

• Zeitüberschreitung – Geben Sie die Zeitspanne (in Sekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor ein Fehler ausgegeben wird. Der Standardwert beträgt 30 Sekunden.

  Hinweis: Wenn Sie ein Fenster in einer Remotedesktop-Umgebung angeben, wird die Standardeinstellung für das Timeout auf 60 Sekunden festgelegt.

Eingabe

• Einheitliche Zielanwendung – Erweitern Sie diese Kategorie, um die folgenden Einstellungen zu konfigurieren:

  • Argumente – Wenn die Anwendung kein Webbrowser ist, können Sie Parameter angeben, die beim Start an die Zielanwendung übergeben werden sollen. Sie können diese Eigenschaft verwenden, um eine bestimmte Datei mit der Anwendung zu öffnen. Wenn die Zielanwendung beispielsweise Acrobat Reader ist, können Sie eine bestimmte Arbeitsmappe öffnen, indem Sie den vollständigen Pfad zur Datei angeben. Um die Datei C:\Sample.pdf zu öffnen, geben Sie "C:\Sample.pdf"ein. Bestimmte Anwendungstypen werden automatisch identifiziert und füllen die Eigenschaft Arguments automatisch aus, z. B. Java-Apps, Office Suite-Apps, Adobe Acrobat oder Windows File Explorer.

  • Dateipfad – Gibt den vollständigen Pfad der zu öffnenden ausführbaren Datei an, wenn es sich bei der Anwendung nicht um einen Webbrowser handelt. Wenn ein Dateipfad angegeben wird, wird die URL -Eigenschaft gelöscht.

    Hinweis: Wenn der im Feld Dateipfad definierte Pfad dynamisch ist, wird beim Klicken auf Ziel auf dem Bildschirm anzeigen in untergeordneten Aktivitäten ein Fehler generiert, wenn die Zielanwendung nicht bereits geöffnet ist.
• Selektor – Ein XML-Fragment, das die Attribute eines Benutzeroberflächenelements speichert.
• URL – Gibt die URL der zu öffnenden Webseite an, wenn es sich bei der Anwendung um einen Webbrowser handelt. Wenn eine URL angegeben wird, wird die Eigenschaft Dateipfad deaktiviert.

Eingabe/Ausgabe-Element

• Eingabeelement - DasZielelement , das Sie mit dieser Anwendung verwenden möchten, gespeichert in einem UIElement -Objekt. Dieses Objekt kann aus der Output Element- Eigenschaft einer anderen UI-Automatisierungsaktivität abgerufen werden. Sie können dieses Eigenschaftsfeld verwenden, um das Zielelement aus einer vorherigen Aktivität an diese zu übergeben, ohne es erneut angeben zu müssen. Dieses Feld unterstützt nur UIElement -Variablen.
• Ausgabeelement – Gibt das in dieser Aktivität angegebene Zielelement in eine UIElement -Variable aus, die dann in anderen Aktivitäten wiederverwendet werden kann. Dieses Feld unterstützt nur UIElement -Variablen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf ausführlicher Ebene protokolliert. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False.

Optionen

• Schließen – Wählen Sie aus, wann die Zielanwendung geschlossen werden soll, nachdem die Automatisierung alle in dieser Aktivität hinzugefügten Aktivitäten ausgeführt hat:
  • Nie – Die Anwendung nie schließen.
  • WennVonAppBrowser geöffnet – Wird nur geschlossen, wenn die Anwendung von der Automatisierung geöffnet wurde. Dies ist der Standardwert.
  • Immer – Schließt die Anwendung jedes Mal.

• Eingabemodus – Wählen Sie aus, welche Methode der Roboter für die Interaktion mit der Zielanwendung verwenden soll:

  • Hardwareereignisse – Verwendet den Hardwaretreiber, um die Aktion auszuführen. Dies ist die langsamste Methode, sie kann nicht im Hintergrund arbeiten, ist aber mit allen Desktop-Apps kompatibel.

  • Simulieren – Simuliert die Verwendung von Barrierefreiheits-APIs. Empfohlen für Browser, Java-basierte Anwendungen, SAP. 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.

  • Chromium-API – Führt Aktionen 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 ist. Weitere Informationen finden Sie auf dieser Seite.

  • Windows-Meldungen – Simulieren mit 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.

  • Hintergrund – Führt Aktionen im Hintergrund aus. Versucht, nach Möglichkeit entweder Simulate oder Chromium API zu verwenden, während komplexe Aktivitäten (Bild, nativer Text) wie gewohnt im Vordergrund ausgeführt werden. Es wird dringend empfohlen, diese Methode mit der Funktion Ausführung verifizieren zu verwenden.

    Hinweis: Die Verwendung des Hintergrundeingabemodus mit Universal Windows Platform-Anwendungen wird nicht unterstützt. Das bedeutet, dass Anwendungen dieses Typs nicht im Hintergrund automatisiert werden können.
• Öffnen – Wählen Sie aus, wann die Zielanwendung für die Ausführung der Automatisierung geöffnet werden soll:
  • Nie – Öffnen Sie die Anwendung nie.
  • IfNotOpen – Wird nur geöffnet, wenn die Anwendung geschlossen ist. Dies ist der Standardwert. Funktioniert nur, wenn die Felder Dateipfad oder URL ausgefüllt sind.
  • Immer – Öffnen Sie eine weitere Instanz der Anwendung, auch wenn bereits eine geöffnet ist. Funktioniert nur, wenn die Felder Dateipfad oder URL ausgefüllt sind.

• Fenstergröße ändern – Definiert, ob die Größe der Anwendung/des Browsers bei der Initialisierung geändert wird.

  • Keine – Auf die Anwendung/den Browser wird keine Größenänderung angewendet.
  • Maximieren – Die Anwendung/der Browser wird bei der Initialisierung maximiert.
  • Aufaktuelle Größe zurücksetzen – Die Größe der Anwendung/des Browsers wird geändert und in die Position und Größe gebracht, die sie/er zum Zeitpunkt der Angabe hatte, sofern dies möglich ist.
  • Minimieren – Die Anwendung/der Browser wird bei der Initialisierung minimiert.
• Fensteranfügemodus – Definiert, wo innere Aktivitäten nach ihren Zielelementen suchen.
  • Anwendungsinstanz - Innere Aktivitäten suchen in der angegebenen Anwendungsinstanz, einschließlich aller über-und untergeordneten Fenster (Warnungen, Popups usw.). Andere Instanzen der Anwendung werden ausgeschlossen.
  • Einzelnes Fenster – Suche nach inneren Aktivitäten nur im angegebenen Fenster.

Optionen – Browser

• Inkognito-/privates Fenster – Wenn diese Option ausgewählt ist, wird die neue Browsersitzung im Inkognito-/privaten Modus geöffnet. Standardmäßig ist dieses Kontrollkästchen deaktiviert.

• Modus des Benutzerdatenordners – Der Modus des Benutzerdatenordners, den Sie festlegen möchten. Er wird verwendet, um den Browser mit einem bestimmten Benutzerdatenordner zu starten.

  • Automatisch – Löst automatisch den Bild-in-Bild-Modus (BiB) mit einem anderen Benutzerdatenordner als dem Standardordner aus. Wenn der Pfad des Benutzerdatenordners nicht festgelegt ist, wird automatisch ein Ordner generiert. Dies kann hilfreich sein, wenn Sie während Automatisierungsaufgaben nach einer Browser-Isolation suchen und die Daten von der Hauptbrowsersitzung getrennt halten.
  • Standardordner – Verwendet den Standardbrowserordner, unabhängig davon, ob er in der Haupt- oder BiB-Sitzung ausgeführt wird. Diese Option ist nützlich, wenn der Roboter den vorhandenen Benutzerdatenordner verwenden soll und keine separate oder isolierte Sitzung für Automatisierungsaufgaben benötigt wird.
  • Benutzerdefinierter Ordner – Verwendet den in Pfad des Benutzerdatenordners angegebenen Ordner. Wenn der Pfad des Benutzerdatenordners nicht festgelegt ist, wird ein automatisch generierter Pfad verwendet. Diese Option bietet Ihnen mehr Flexibilität und Kontrolle bei der Verwaltung Ihrer Ordner für verschiedene Automatisierungsaufgaben, indem ein benutzerdefinierter Pfad für den Benutzerdatenordner festgelegt wird.

  Das Festlegen des Benutzerdatenordners des Browsers ist nur für Chrome, Edge Chromium und Firefox verfügbar.

• Pfad des Benutzerdatenordners - Der Benutzerdatenordner, den der Browser verwendet. Der Standardwert ist %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , wenn keiner festgelegt ist.

  Weitere Informationen zum Benutzerdaten-Ordnermodus und zum Benutzerdaten-Ordnerpfad finden Sie hier.

• WebDriver-Modus - Gibt an, wie der WebDriver beim Öffnen einer neuen Browsersitzung verwendet wird. Die folgenden Optionen sind verfügbar:

  • Deaktiviert – Deaktiviert die Verwendung von WebDriver.
  • WithGUI - Die GUI des Browsers wird angezeigt.
  • Monitorlos – Der Browser wird im Hintergrund gestartet, ohne GUI.

  Weitere Details zu WebDriver finden Sie hier.

Plattformübergreifende Konfiguration

Der Name der Aktivität in plattformübergreifenden Projekten lautet Use Browser und kann verwendet werden, um nur Webbrowser zu automatisieren.

• In Scope arbeiten – Wählen Sie die Browserregisterkarte aus, die die zu automatisierende Webanwendung rendert.
• URL - Die URL der Webanwendung. Der Wert wird nach Auswahl der Registerkarte automatisch ausgefüllt.
• Authentifizierung erforderlich? - Multi-Faktor-Authentifizierung aktiviert. Weitere Informationen finden Sie auf der Seite UIAutomation Browser-Verbindung .

Zusätzliche Optionen

Zeitliche Abläufe

• Zeitüberschreitung – Geben Sie die Zeitspanne (in Sekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor ein Fehler ausgegeben wird. Der Standardwert beträgt 30 Sekunden.

• BeiFehler fortfahren – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf Truefestgelegt ist, wird die Ausführung des Projekts unabhängig von einem Fehler fortgesetzt.

Optionen

• Öffnen – Definiert, ob die Zielanwendung geöffnet werden soll, bevor die Aktivitäten darin ausgeführt werden.
  • Immer – Öffnet das Browserfenster jedes Mal.
  • Wenn nicht geöffnet – öffnet ein neues Browserfenster, wenn keines mit dem Selektor und der URL übereinstimmt. Dies ist der Standardwert.
  • Nie – Öffnet niemals das Browserfenster.
• Schließen – Definiert, ob die Zielanwendung geschlossen werden soll, bevor die Aktivitäten darin ausgeführt werden.
  • Immer – Schließt das Browserfenster jedes Mal.
  • Wenn von „Use Browser“ geöffnet – Wird nur geschlossen, wenn das Browserfenster von der Aktivität „ Use Browser “ geöffnet wurde. Dies ist der Standardwert.
  • Nie – Browserfenster nie schließen.
• Eingabemodus (Input mode ) - Die Methode zum Generieren von Tastatur- und Mauseingaben.
  • ChromiumAPI – Führt Aktionen 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.
  • Simulieren – Simuliert die Actions mithilfe von Barrierefreiheits-APIs. Funktioniert für Browser. Sendet den gesamten Text in einer einzigen Actions. Arbeitet im Hintergrund (auch wenn die Zielanwendung nicht im Fokus steht).
• Inkognito-/privates Fenster – Wenn diese Option ausgewählt ist, wird die neue Browsersitzung im Inkognito-/privaten Modus geöffnet. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False.

• BenutzerdatenOrdnermodus – Der BenutzerdatenOrdnermodus, den Sie festlegen möchten. Er wird verwendet, um den Browser mit einem bestimmten Benutzerdatenordner zu starten.

  • Automatisch – Löst automatisch den Bild-in-Bild-Modus (BiB) mit einem anderen Benutzerdatenordner als dem Standardordner aus. Wenn der Pfad des Benutzerdatenordners nicht festgelegt ist, wird automatisch ein Ordner generiert. Dies kann hilfreich sein, wenn Sie während Automatisierungsaufgaben nach einer Browser-Isolation suchen und die Daten von der Hauptbrowsersitzung getrennt halten.
  • Standardordner – Verwendet den Standardbrowserordner, unabhängig davon, ob er in der Haupt- oder BiB-Sitzung ausgeführt wird. Diese Option ist nützlich, wenn der Roboter den vorhandenen Benutzerdatenordner verwenden soll und keine separate oder isolierte Sitzung für Automatisierungsaufgaben benötigt wird.
  • Benutzerdefinierter Ordner – Verwendet den in Pfad des Benutzerdatenordners angegebenen Ordner. Wenn der Pfad des Benutzerdatenordners nicht festgelegt ist, wird ein automatisch generierter Pfad verwendet. Diese Option bietet Ihnen mehr Flexibilität und Kontrolle bei der Verwaltung Ihrer Ordner für verschiedene Automatisierungsaufgaben, indem ein benutzerdefinierter Pfad für den Benutzerdatenordner festgelegt wird.

  Das Festlegen des Benutzerdatenordners des Browsers ist nur für Chrome, Edge Chromium und Firefox verfügbar.

• Pfad des Benutzerdatenordners - Der Benutzerdatenordner, den der Browser verwendet. Der Standardwert ist %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , wenn keiner festgelegt ist.

Ziel

• Selektor – Liste der Attribute, die zum Finden eines bestimmten Browserfensters verwendet werden.

Eingang/Ausgang

• Eingabeelement – Das UI-Element, für das die Aktivität ausgeführt wird, gespeichert in einem UIElement -Objekt. Dieses Feld unterstützt nur UIElement -Objekte. Dieses Objekt kann aus dem Eigenschaftsfeld „ Ausgabeelement “ anderer UI-Automatisierungsaktivitäten abgerufen werden.
• Ausgabeelement – Gibt ein Ziel-UI-Element aus und speichert es in einem UIElement -Objekt, das weiter verwendet werden kann, um dasselbe Element mit anderen Aktivitäten auszurichten.