Verwenden Sie den Universal App Connector

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer

    • Erstellen Sie Automatisierungen für Ihre browserbasierten Anwendungen Windows, Java, Google Chromeund Edge mit dem 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 Bereich Toolbox zu Connectors, und ziehen Sie Universal App Connector im Projekt-Explorer auf 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 Connector-Ebene des Universal-App-Connectors zu verwenden, doppelklicken Sie auf das Objekt UniversalApplication.
      Beispielsweise wird die Start-Methode verwendet, wenn der Browser oder die Anwendung gestartet werden soll, bevor Sie mit Anwendungsbildschirmen oder -elementen interagieren. Weitere Informationen zur Verwendung der Start-Methode finden Sie unter Start-Methode verwenden.
      Die Methoden werden im Objekt-Explorer-Fenster angezeigt.
    4. Führen Sie die folgenden Schritte aus, um die Bildschirme und Elemente in der UAC zu konfigurieren.
      1. Klicken Sie unter Globale Objekte mit der rechten Maustaste auf UniversalAnwendung, und wählen Sie Konfigurierenaus.
      2. Wählen Sie im Fenster Bildschirme und Elemente konfigurieren die Dropdownliste Aus geöffnetem Fenster auswählen ( Dropdownliste aus geöffnetem Fenster auswählen.), und wählen Sie 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 Windows 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 Filtern des Anwendungstyps.), und wählen Sie Alle oder den Anwendungstyp aus.
        Wenn Sie beispielsweise Chromeauswählen, werden in der Liste Aus geöffnetem Fenster auswählen nur Google Chrome-Webseiten angezeigt.
      4. Um den ausgewählten Anwendungsbildschirm hinzuzufügen, wählen Sie Bildschirm hinzufügen.
        Nachdem Sie diesen Schritt ausgeführt haben, können Sie die Bildschirmelemente erfassen, um Aktionen auszuführen.
        Der Anwendungsbildschirm wird im 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 den Namen des Anwendungsbildschirms im Bereich Bildschirme und Elemente 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 Element erfassenaus.
        Option „Element erfassen“.
        Der Fokus wird auf den erfassten Anwendungsbildschirm gesetzt, und das Dialogfeld „Elemente erfassen“ wird angezeigt.

        Erfasster Bildschirm im Fokus und Dialogfeld „Erfassen“ wird angezeigt.

      8. Erfassen Sie mit dem Dialogfeld „Element erfassen“ beliebig viele Bildschirmelemente.

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

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

        Erfasste Bildschirmsteuerelemente.

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

      Bildschirm-Übereinstimmungsregeln.

      Die folgende Abbildung zeigt ein Beispiel für mehrere Elemente, die denselben Kriterien entsprechen, die im Abschnitt „Übereinstimmungsattribute“ angegeben sind. Wenn Sie das erfasste Element aktualisieren, werden ggf. mehrere Instanzen angezeigt, die in den Klammern rot angezeigt werden. In solchen Fällen müssen Sie die Attribute optimieren, um genau das Element auszuwählen, das automatisiert werden muss. Der Anwender kann aktualisieren, um zu überprüfen, ob die ausgewählten Kriterien mit genau einem Element übereinstimmen.

      Mehrere Instanzen des erfassten Elements.

    6. Wahlweise: Verwenden Sie die Elementübereinstimmungsregeln, um die Werte in den bereitgestellten Abschnitten „Locator“ und „ Übereinstimmungsattribute“ 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 Bereich „Attribute abgleichen“ im Fenster „Elemente und Bildschirme konfigurieren“ angezeigt. Die UAC verwendet diese Attribute, um zuerst den Bildschirm zu identifizieren und Aktionen für Elemente wie Klicken oder Text abrufen auszuführen.

      Die Abbildung zeigt die Abgleichregeln eines erfassten Elements.

      Element und seine Übereinstimmungsregeln.

    7. Wahlweise: Verwenden Sie die Locatoren der erfassten Elemente, um die Elemente auf dem Anwendungsbildschirm zu finden.
      Die UAC stellt mehrere Locator-Typen bereit. Beispielsweise stellt der XPath-Locator dem Element den XPath 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
        Locator-Typ Anwendungstyp Beschreibung
        ID Web, Java und Windows Eindeutiger Bezeichner des Elements, wenn es 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 Webelement sucht. Beispiel: div#navbarNav > ul > li > a. Wenn eine Webanwendung Schatten-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 > work-icon-button > / Schattendom/ > „Iron-icon[id="icon"]“
        Tag-Name Web Eindeutiger Tag-Name des Webelements.
        JavaScript Web Ermöglicht dem Anwender, einen anwenderdefinierten JavaScript-Code zu definieren, um ein Element zu finden.
        XPath Web XPath zum Suchen des Webelements. Wenn eine Webanwendung Schatten-DOM unterstützt, zeigt dieser Locator den vollständigen XPath mit den Schatten-DOM-Elementen an. Beispiel: html >body >shop-app > /ShadowDom/ >Iron-pages >shop-home > /ShadowDom/ > div > h2.
        Typ Java und Windows Ermöglicht Ihnen, ein Bildschirmelement anhand seines Typs zu finden. Zum 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.
        Pfad Java und Windows Ermöglicht Ihnen, ein Bildschirmelement durch Angabe seiner Position in der Hierarchie der Bildschirmelemente zu finden.

        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 folgenden Schritte aus, um den Pfad zu einem IFrame in einem erfassten Element anzuzeigen, falls vorhanden.
      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 Locator 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, nachdem Sie die Konfiguration Ihrer Anwendungsbildschirme oder -elemente abgeschlossen haben.
      Die Anwendungsbildschirme und ihre Elemente werden unter dem UAC-Objekt in Globale Objekteangezeigt.
    11. Doppelklicken Sie auf den gewünschten Anwendungsbildschirm oder das gewünschte Element, um den Objekt-Explorer mit den zugehörigen Methoden aufzulisten.
      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 den Connector-Methoden von Google Chrome und Microsoft Edge finden Sie unter Chrome-Connector-Methoden.

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

      • Wenn Sie den Bildschirm einer Webanwendung erfasst haben und darauf ein anwenderdefiniertes JavaScript ausführen möchten, können Sie die ExecuteJavascript-Methode verwenden.

    12. Ziehen Sie die gewünschte Methode aus dem Bereich 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, indem Sie die verschiedenen Methoden für die Anwendungsbildschirme und -elemente verwenden, und speichern Sie die Automatisierung.