Verwenden Sie den Universal App Connector

Erstellen Sie Automatisierungen für Windows, Java, Google Chrome, Und Edge Browserbasierte Anwendungen mithilfe des Universal App Connectors (UAC). Konfigurieren Sie die Anwendungen über einen einzigen, einheitlichen Connector, und erfassen Sie die Bildschirme und Elemente oder Bildschirmsteuerungen wie Kontrollkästchen und Schaltflächen. Verwenden Sie die Methoden dieser Bildschirme und Elemente, um Ihre Automatisierung zu erstellen.

Vorbereitungen

Fügen Sie das Plugin Universal App Connector aus dem Plugins-Manager hinzu, bevor Sie den Connector verwenden. Weitere Informationen zum Hinzufügen des SSH-Plugins finden Sie unter Verwalten Sie Plugins in RPA Desktop Design Studio.

Stellen Sie sicher, dass Sie offen oder aktiv haben Windows, Java, Google Chrome, Oder Edge Anwendungen.

Erforderliche Rolle: keine

Prozedur

1. Navigieren Sie im Toolbox-Bereich zu Connectors , Und ziehen Universal-App-Connector Bis Globale Objekte Im Bereich Projekt-Explorer.
   Der Connector wird als hinzugefügt Universalanwendung Objekt unter Globale Objekte .
2. Zur Verwendung der -Methoden in Universal-App-Connector Connector-Ebene, doppelklicken Sie auf Universalanwendung Objekt.

   Methodenname	Referenz
   Klicken	Verwenden Sie die Klickmethode für den Universal App Connector
   GetValue	Verwenden Sie die GetValue-Methode für den Universal App Connector
   SetValue	Verwenden Sie die SetValue-Methode für den Universal App Connector
   Start	Verwenden Sie die Startmethode für den Universal App Connector
   Warten auf Bildschirm	Verwenden Sie die Methode „WaitForAnyScreen“ für den Universal App Connector

   Beispielsweise wird die Startmethode verwendet, wenn der Browser oder die Anwendung gestartet werden soll, bevor mit Anwendungsbildschirmen oder -Elementen interagiert wird.
   Die Methoden werden im Objekt-Explorer-Bereich angezeigt.
3. Führen Sie die Schritte aus, um die Bildschirme und Elemente in der UAC zu konfigurieren.
   1. Klicken Sie unter Globale Objekte mit der rechten Maustaste Universalanwendung Und wählen Sie aus Konfigurieren .
   2. Wählen Sie im Fenster Bildschirme und Elemente konfigurieren die aus Wählen Sie aus einem offenen Fenster aus Dropdown-Liste ( ) Und wählen Sie einen Anwendungsbildschirm aus.
      

      Hinweis:

      • Wenn keine unterstützten Anwendungen geöffnet sind, wird Nachricht „App-Fenster nicht gefunden“ Wird angezeigt.
      • Um neu geöffnete Anwendungsbildschirme in der Liste anzuzeigen, wählen Sie das Symbol zum Aktualisieren von Fenstern klicken ( ).
   3. Wahlweise: Um die geöffneten Anwendungen nach ihrem Typ zu filtern, wählen Sie aus Alle Symbol für Filteranwendungstyp ( ) Und wählen Sie alle oder den Anwendungstyp aus.

      Beispiel: Wenn Sie auswählen Chrome , Nur Google Chrome-Webseiten werden im angezeigt Wählen Sie aus einem offenen Fenster aus Liste.

      Beispiel: Wenn Sie auswählen WindowsAnwendung , Nur Windows Bildschirme werden in angezeigt Wählen Sie aus einem offenen Fenster aus Liste.

      Abbildung : 1. Filtern Sie die geöffneten Anwendungen

      

   4. Um den ausgewählten Anwendungsbildschirm hinzuzufügen, wählen Sie aus Bildschirm „Hinzufügen“ .
      Nachdem Sie diesen Schritt ausgeführt haben, können Sie die Bildschirmelemente erfassen, um Aktionen auszuführen.
      Der Anwendungsbildschirm wird unter dem Bereich „Bildschirme und Elemente“ angezeigt.

      

   5. Um die Elemente vom Bildschirm zu erfassen, klicken Sie im Bereich Bildschirm und Elemente mit der rechten Maustaste auf den hinzugefügten Bildschirm, und wählen Sie aus Erfassungselement .
      
      Der Fokus wird auf dem Anwendungsbildschirm festgelegt, den Sie erfasst haben, und das Dialogfeld „Elemente erfassen“ wird angezeigt.

      Beispiel: Wenn Sie Elemente von erfassen WindowsAnwendung wie Notepad. Wenn Sie auswählen UIA Modus (UI-Automatisierung), wird auch die Bildlaufleiste des Notizblocks erfasst.

      Abbildung : 2. Erfassungsdialogfeld für Windows-Anwendung – Notepad – UIA-Modus

      

      Wenn Sie auswählen AA Modus (aktive Barrierefreiheit), die Bildlaufleiste des Notizblocks wird nicht erfasst.

      Abbildung : 3. Erfassungsdialogfeld für Windows-Anwendung – Notepad – AA-Modus

      

   6. Zur Verwendung der -Methoden in Universal-App-Connector Connector-Ebene für die beiden Modi UI-Automatisierung und aktive Barrierefreiheit doppelklicken Sie auf Universalanwendung Objekt.
      Weitere Informationen zu den Methoden für den UI-Automatisierungsmodus und den aktiven Barrierefreiheitsmodus finden Sie unter Methoden des UI-Automatisierungsmodus und des aktiven Barrierefreiheitsmodus.
      Die Methoden werden im Objekt-Explorer-Bereich angezeigt.
4. Führen Sie eine der folgenden Optionen für eine gewünschte Aktion aus.

   Option	Aktion
   Um umzubenennen Universalanwendung	Navigieren Sie zu Globale Objekte Klicken Sie im Bereich Projekt-Explorer mit der rechten Maustaste auf Universalanwendung Und wählen Sie aus Umbenennen . Abbildung : 4. Benennen Sie UniversalApplication um
   Dient zum Ändern des Namens des Bildschirms beim Konfigurieren der Bildschirme und Elemente	Wählen Sie den Namen des Anwendungsbildschirms im Bereich Bildschirme und Elemente aus. Die Informationen des ausgewählten Anwendungsbildschirms werden im Eigenschaftenbereich angezeigt. Aktualisieren Sie den Namen des Anwendungsbildschirms in Name Feld und drücken Eingabetaste . Der Name der Anwendung wird im Bereich „Bildschirme und Elemente“ aktualisiert. Abbildung : 5. Aktualisieren Sie den Namen des Anwendungsbildschirms
   Um den Bildschirm eindeutig zu identifizieren	Verwenden Sie die Bildschirmübereinstimmungsregeln, um den Bildschirm zu identifizieren und zu finden. Während der Ausführung muss das Plugin den Zielbildschirm eindeutig identifizieren, um Aktionen auf dem Bildschirm zu automatisieren. Beispiele für Attribute sind der Titel oder die URL des Anwendungsbildschirms. Die Attribute werden unter angezeigt Bildschirm-Übereinstimmungsregeln Bereich auf der Konfigurieren Sie Bildschirme und Elemente Fenster. Die UAC verwendet die Bildschirmabgleichsregeln, um den Bildschirm zuerst zu identifizieren, und verwendet die Elementabgleichsregel, um das Element zu identifizieren, und führt dann Aktionen für Elemente wie Klicken oder Text abrufen aus. Die folgende Abbildung zeigt ein Beispiel für mehrere Elemente, die denselben Kriterien entsprechen, die im Abschnitt „Attribute abgleichen“ angegeben sind. Wenn Sie das erfasste Element aktualisieren, wird in roten Klammern eine mehrere Instanzen angezeigt, falls vorhanden. In solchen Fällen müssen Sie die Attribute anpassen, um genau das Element auszuwählen, das automatisiert werden muss. Der Anwender kann aktualisieren, um zu überprüfen, ob die ausgewählten Kriterien genau einem Element entsprechen.
   Um ein Element eindeutig zu identifizieren	Verwenden Sie die Element-Übereinstimmungsregeln, um die Werte in der bereitgestellten zu bearbeiten Locator Und Attribute Abgleichen Abschnitte. Während der Ausführung muss das Plugin das Zielelement eindeutig identifizieren, um Aktionen für das Element zu automatisieren. Die Attribute werden unter angezeigt Attribute Abgleichen Bereich auf der Konfigurieren Sie Bildschirme und Elemente Fenster. Die UAC verwendet die Bildschirmabgleichsregeln, um den Bildschirm zuerst zu identifizieren, und verwendet die Elementabgleichsregel, um das Element zu identifizieren, und führt dann Aktionen für Elemente wie Klicken oder Text abrufen aus. Die Abbildung zeigt die Übereinstimmungsregeln eines erfassten Elements.
   Um die Elemente auf dem Anwendungsbildschirm zu suchen	Verwenden Sie die Locatoren der erfassten Elemente. Weitere Informationen finden Sie unter Suchen Sie die Elemente auf dem Anwendungsbildschirm.
   Dient zum Anzeigen des Pfads zu einem iFrame, falls vorhanden, in einem erfassten Element	In Bildschirme und Elemente Wählen Sie das Element aus. Wählen Sie die Registerkarte Erweitert aus. Der iFrame wird angezeigt. Von Locator Wählen Sie einen Locator aus, um den Pfad zum iFrame zu finden.

5. Wahlweise: Klicken Sie mit der rechten Maustaste auf den Anwendungsbildschirm oder das Element, um zusätzliche Vorgänge wie auszuführen Aktualisieren , Aktualisieren Sie den Bildschirm und die Elemente , Fokus , Anwenderdefiniertes Element hinzufügen , Elemente Anzeigen , Löschen , Und mehr.
   Informationen zu den verschiedenen zusätzlichen Vorgängen, die für die Anwendungsbildschirme und -Elemente verfügbar sind, finden Sie unter Zusätzliche Optionen für Anwendungsbildschirme und -Elemente in Universal App Connector.
6. Wählen Sie Aus Fertig Nachdem Sie die Konfiguration Ihrer Anwendungsbildschirme oder -Elemente abgeschlossen haben.
   Die Anwendungsbildschirme und ihre Elemente werden unter dem UAC-Objekt in angezeigt Globale Objekte .
7. Doppelklicken Sie auf den erforderlichen Anwendungsbildschirm oder das erforderliche Element, und der Objektexplorbereich wird angezeigt, der die zugehörigen Methoden auflistet.
   Wenn Sie beispielsweise einen Java-Anwendungsbildschirm oder ein Java-Element auswählen, werden die Java-Connector-Methoden im Objekt-Explorer angezeigt.

   • Weitere Informationen zu Java-Connector-Methoden finden Sie unter Java-Connector-Methoden .

   • Weitere Informationen zu Google Chrome- und Microsoft Edge-Connector-Methoden finden Sie unter Chrom-Connector-Methoden .

   • Weitere Informationen zu Windows-Connector-Methoden finden Sie unter Windows Connector-Methoden .

   • Wenn Sie einen Webanwendungsbildschirm erfasst haben und ein anwenderdefiniertes JavaScript ausführen möchten, können Sie die Methode ExecuteJavascript verwenden.

8. Erfassen Sie so viele Bildschirmelemente wie Sie benötigen, indem Sie das Dialogfeld „Element erfassen“ verwenden.

   Informationen zur Verwendung des Dialogfelds „Element erfassen“ finden Sie unter Verwenden Sie das Dialogfeld „Element erfassen“ .

   Die erfassten Bildschirmelemente werden unter dem erfassten Anwendungsbildschirm als Elemente angezeigt.

   

9. Ziehen Sie die erforderliche Methode aus dem Objekt-Explorer-Bereich auf die Design-Oberfläche.

   Die Methode wird mit dem Anwendungsbildschirm oder Elementnamen in der Designoberfläche angezeigt.

Nächste Maßnahme

Entwerfen Sie die Automatisierung mit den verschiedenen Methoden für die Anwendungsbildschirme und -Elemente, und speichern Sie die Automatisierung.