Verwenden Sie den Universal App Connector

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

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

    Vorbereitungen

    Vergewissern Sie sich, dass die Anwendungen Windows, Java, Google Chromeoder Edge geöffnet oder aktiv sind.

    Erforderliche Rolle: keine

    Prozedur

    1. Navigieren Sie im Toolbox-Bereich zu Connectors, und ziehen Sie Universal App Connector im Projektexplorer-Bereich zu Globale Objekte.
      Der Connector wird als UniversalApplication -Objekt unter Globale Objektehinzugefügt.
    2. Wahlweise: Um UniversalApplicationumzubenennen, klicken Sie mit der rechten Maustaste, und wählen Sie Umbenennenaus.
    3. Um die Methoden auf der Connector-Ebene von Universal App Connector zu verwenden, doppelklicken Sie auf das UniversalApplication -Objekt.
      Beispielsweise wird die Start-Methode verwendet, wenn der Browser oder die Anwendung gestartet werden soll, bevor mit Anwendungsbildschirmen oder -elementen interagiert wird. Weitere Informationen zur Verwendung der Start-Methode finden Sie unter Start-Methode verwenden.
      Die Methoden werden im Objekt-Explorer angezeigt.
    4. Führen Sie die Schritte aus, um die Bildschirme und Elemente in der Benutzerkontensteuerung zu konfigurieren.
      1. Klicken Sie unter Globale Objekte mit der rechten Maustaste auf UniversalApplication, und wählen Sie Konfigurierenaus.
      2. Wählen Sie im Fenster „Bildschirme und Elemente konfigurieren“ die Dropdown-Liste „ Aus einer geöffneten Fenstern auswählen“ ( Dropdown-Liste „Aus einer geöffneten Fensternwählen“ ) und dann einen Anwendungsbildschirm aus.
        Öffnen Sie Anwendungen.
        Hinweis:
        • Wenn keine unterstützten Anwendungen geöffnet sind, wird die Meldung angezeigt, dass das App-Fenster nicht gefunden wurde.
        • Um neu geöffnete Anwendungsbildschirme in der Liste anzuzeigen, wählen Sie das Symbol Zum Aktualisieren von Fenstern klicken (Symbol Zum Aktualisieren von Fenstern klicken).
      3. Wahlweise: Um die geöffneten Anwendungen nach ihrem Typ zu filtern, wählen Sie das Symbol zum Filtern des Anwendungstyps (Symbol zum Filterndes Anwendungstyps) und dann Alle oder den Anwendungstyp aus.
        Wenn Sie beispielsweise Chromeauswählen, werden in der Liste Auswahl aus einem geöffneten Fenster nur Google Chrome-Webseiten angezeigt.
      4. Um den ausgewählten Anwendungsbildschirm hinzuzufügen, wählen Sie Bildschirmhinzufü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.

        Der Name des Anwendungsbildschirms wird unter Bildschirme und Elemente angezeigt.

      5. Wahlweise: Um den Namen des Bildschirms zu ändern, wählen Sie im Bereich Bildschirme und Elemente den Namen des Anwendungsbildschirms aus.
        Die Informationen des ausgewählten Anwendungsbildschirms werden im Eigenschaftenbereich angezeigt.
      6. Wahlweise: Aktualisieren Sie den Namen des Anwendungsbildschirms im Feld Name, und drücken Sie die Eingabetaste.
        Der Name der Anwendung wird im Bereich Bildschirme und Elemente aktualisiert.
      7. Um die Elemente aus dem Bildschirm zu erfassen, klicken Sie im Bereich Bildschirm und Elemente mit der rechten Maustaste auf den hinzugefügten Bildschirm, und wählen Sie Elementerfassen aus.
        Option „Element erfassen“
        Der Fokus wird auf den erfassten Anwendungsbildschirm gesetzt, und das Dialogfeld „Elemente erfassen“ wird angezeigt.

        Erfasster Bildschirm im Fokus, und das Dialogfeld zum Erfassen wird angezeigt.

      8. Erfassen Sie mithilfe des Dialogfelds „Element erfassen“ beliebig viele Bildschirmelemente.

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

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

        Steuerelemente für erfasste Bildschirme.

    5. Wahlweise: Verwenden Sie die Bildschirmabgleichsregeln, um die Werte in den bereitgestellten Abgleichsregeln zu bearbeiten und den Bildschirm eindeutig zu identifizieren.
      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 im Bereich „Übereinstimmungsregeln überprüfen“ im Fenster „Elemente und Bildschirme konfigurieren“ angezeigt. Die Benutzerkontensteuerung verwendet diese Attribute, um den Bildschirm zuerst zu identifizieren und Aktionen für Elemente wie Klicken oder Text abrufen auszuführen.

      Bildschirmabgleichsregeln.

      Die folgende Abbildung zeigt ein Beispiel für mehrere Elemente, die denselben Kriterien entsprechen, die im Abschnitt „Übereinstimmungsattribute“ angegeben sind. Mehrere Instanzen, die, falls vorhanden, angezeigt werden, wenn Sie das erfasste Element aktualisieren, werden innerhalb der Klammern in Rot angezeigt. In solchen Fällen müssen Sie die Attribute anpassen, um genau das Element auszuwählen, das automatisiert werden muss. Der Benutzer kann aktualisieren, um zu überprüfen, ob die ausgewählten Kriterien genau einem Element entsprechen.

      Mehrere Instanzen des erfassten Elements.

    6. Wahlweise: Verwenden Sie die Elementabgleichsregeln, um die Werte in den bereitgestellten Abschnitten „ Locator “ und „Abgleichsattribute“ zu bearbeiten und ein Element eindeutig zu identifizieren.
      Während der Ausführung muss das Plugin das Zielelement eindeutig identifizieren, um Aktionen für das Element zu automatisieren. Die Attribute werden im Fenster „Elemente und Bildschirme konfigurieren “ im Bereich „Attribute abgleichen“ angezeigt. Die Benutzerkontensteuerung verwendet diese Attribute, um den Bildschirm zuerst zu identifizieren und Aktionen für Elemente wie Klicken oder Text abrufen auszuführen.

      Die Abbildung zeigt die Übereinstimmungsregeln eines erfassten Elements.

      Element und seine Übereinstimmungsregeln.

    7. Wahlweise: Verwenden Sie die Finder der erfassten Elemente, um die Elemente auf dem Anwendungsbildschirm zu suchen.
      Die Benutzerkontensteuerung stellt mehrere -Locator-Typen bereit. Beispielsweise stellt der XPath-Locator den XPath für das Element bereit.

      Elementfinder

      1. Wählen Sie im Bereich Bildschirme und Elemente ein Element unter einem Bildschirm aus.
      2. Wählen Sie in der Liste „Locator “ einen der Element-Locators aus.
        Tabelle : 1. Bildschirmelement-Locators
        Ortungstyp Anwendungstyp Beschreibung
        ID Web, Java und Windows Eindeutiger Bezeichner des Elements, wenn er in der Zielanwendung definiert ist.
        Name Web, Java und Windows Eindeutiger Name des Elements, wenn es in der Zielanwendung definiert ist.
        CssSelector Web Die CSS-Auswahl, die das erfasste Web-Element sucht. Beispiel: div#navbarNav > ul > li > a. Wenn eine Webanwendung Shadow DOM unterstützt, zeigt die CSS-Auswahl den Pfad mit den Schatten-DOM-Elementen an. Beispiel: „html“ > „body“ > „shop-app“ > „/ShadowDom/“ > „app-header[id="header"]“ > „app-toolbar“ > „div:nth-of-type(3)“ > „a“ > „paper-icon-button“ > / ShadowDom/ > „Eisen-Symbol“ [id="icon"]
        TagName Web Eindeutiger Tag-Name des Web-Elements.
        JavaScript Web Ermöglicht dem Benutzer, einen benutzerdefinierten JavaScript-Code zum Suchen eines Elements zu definieren.
        XPath Web XPath, um das Web-Element zu finden. Wenn eine Webanwendung Shadow DOM unterstützt, zeigt dieser Finder den vollständigen XPath mit den Shadow DOM-Elementen an. Zum Beispiel „html“ > „body“ > „shop-app“ > „/ShadowDom/“ > „isner-pages“ > „shop-home“ > „/ShadowDom/“ > „div“ > „h2“.
        Typ Java und Windows Ermöglicht die Suche nach einem Bildschirmelement anhand seines Typs. Beispiel: Schaltfläche oder Textfeld.

        Wenn Sie den Typ- Locator auswählen, füllt der UAC-Connector das Feld Wert mit dem Typ des Elements aus.
        Pfad Java und Windows Ermöglicht die Suche nach einem Bildschirmelement durch Angabe seiner Position in der Hierarchie der Bildschirmelemente.

        Wenn Sie den Pfad -Locator auswählen, füllt der UAC-Connector das Feld Wert mit dem Pfad des Elements aus.
        BenutzerdefinierterPfad Windows Ermöglicht das Optimieren oder Kürzen des Pfads zu einem Element.
    8. Wahlweise: Führen Sie die Schritte aus, um den Pfad zu einem iframe (falls vorhanden) in einem erfassten Element anzuzeigen.
      1. Wählen Sie im Bereich Bildschirme und Elemente das Element aus.
      2. Wählen Sie die Registerkarte Erweitert aus.
        Der IFrame wird angezeigt.

        IFrame wird angezeigt.

      3. Wählen Sie in der Liste „ Locator “ einen Finder aus, um den Pfad zum IFrame zu finden.
        IFrame-Locator.
    9. Wahlweise: Klicken Sie mit der rechten Maustaste auf den Anwendungsbildschirm oder das Element, um zusätzliche Vorgänge auszuführen.
      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.
    10. Wählen Sie Fertig aus, nachdem Sie die Konfiguration der Anwendungsbildschirme oder -elemente abgeschlossen haben.
      Die Anwendungsbildschirme und ihre Elemente werden unter dem UAC-Objekt in Globale Objekteangezeigt.
    11. Doppelklicken Sie auf den erforderlichen Anwendungsbildschirm oder das erforderliche Element. Daraufhin wird der Objekt-Explorer mit den zugehörigen Methoden angezeigt.
      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 Chrome- Connector-Methoden.

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

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

    12. Ziehen Sie die erforderliche Methode aus dem Objekt-Explorer auf die Designoberfläche.

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

    Nächste Maßnahme

    Entwerfen Sie die Automatisierung mithilfe der verschiedenen Methoden für die Anwendungsbildschirme und -elemente, und speichern Sie die Automatisierung.