Verwenden Sie den Universal App Connector

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer
  • Erstellen Sie Automatisierungen für Windows, Java, Google Chrome, Und EdgeBrowserbasierte 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

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

    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. Wahlweise: Um umzubenennen Universalanwendung , Rechtsklicken Sie, und wählen Sie aus Umbenennen .
    3. Um die Methoden in zu verwenden Universal-App-Connector Connector-Ebene, doppelklicken Sie auf Universalanwendung Objekt.
      Beispielsweise wird die Startmethode verwendet, wenn der Browser oder die Anwendung gestartet werden soll, bevor mit Anwendungsbildschirmen oder -Elementen interagiert wird. Weitere Informationen zur Verwendung der Startmethode finden Sie unter Verwenden Sie die Startmethode .
      Die Methoden werden im Objekt-Explorer-Bereich angezeigt.
    4. 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 Dropdown-Liste aus geöffnetem Fenster auswählen ( Wählen Sie aus einer Dropdown-Liste mit geöffnetem Fenster aus.) Und wählen Sie einen Anwendungsbildschirm aus.
        Anwendungen öffnen.
        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 ( Klicken Sie, um das Fenstersymbol zu aktualisieren.).
      3. Wahlweise: Um die geöffneten Anwendungen nach ihrem Typ zu filtern, wählen Sie das Symbol für den Filteranwendungstyp ( Symbol für Filteranwendungstyp.) Und wählen Sie alle oder den Anwendungstyp aus.
        Beispiel: Wenn Sie auswählen Chrom , Nur Google Chrome-Webseiten werden in angezeigt Wählen Sie aus einem offenen Fenster aus Liste.
      4. Wählen Sie aus, um den ausgewählten Anwendungsbildschirm hinzuzufügen 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.

        Der Name des Anwendungsbildschirms wird unter Bildschirmen und Elementen 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 in Name Feld und drücken Eingabetaste .
        Der Name der Anwendung wird im Bereich „Bildschirme und Elemente“ aktualisiert.
      7. 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 Element Erfassen .
        Elementoption erfassen.
        Der Fokus wird auf dem Anwendungsbildschirm festgelegt, den Sie erfasst haben, und das Dialogfeld „Elemente erfassen“ wird angezeigt.

        Der erfasste Bildschirm im Fokus und das Erfassungsdialogfeld werden angezeigt.

      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.

        Erfasste Bildschirmsteuerungen.

    5. Wahlweise: Verwenden Sie die Bildschirm-Übereinstimmungsregeln, um die Werte in den angegebenen Übereinstimmungsregeln zu bearbeiten, um 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 angezeigt Bildschirm-Übereinstimmungsregeln Bereich auf Konfigurieren Sie Elemente und Bildschirme Fenster. Die UAC verwendet diese Attribute, um den Bildschirm zuerst 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 „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.

      Mehrere Instanzen des erfassten Elements.

    6. Wahlweise: Verwenden Sie die Element-Übereinstimmungsregeln, um die Werte in der angegebenen zu bearbeiten Locator Und Attribute Abgleichen Abschnitte zur eindeutigen Identifizierung eines Elements.
      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 Konfigurieren Sie Elemente und Bildschirme Fenster. Die UAC verwendet diese Attribute, um den Bildschirm zuerst zu identifizieren und Aktionen für Elemente wie Klicken oder Text abrufen auszuführen.

      Das Bild zeigt die Übereinstimmungsregeln 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 bietet mehrere Locator-Typen. Beispielsweise stellt der XPath-Locator den XPath für das Element bereit.

      Elementsuchzeichen.

      1. Wählen Sie im Bereich „Bildschirme und Elemente“ ein Element unter einem Bildschirm aus.
      2. Von Locator Wählen Sie einen der Elementsuchzeichen aus.
        Tabelle : 1. Bildschirmelement-Locators
        Locator-Typ 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 er 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 > Textkörper > Shop-App > /ShadowDom/ > App-Header[ID="Header"] > App-Symbolleiste > div:nth-of-type(3) > a > Paper-icon-button > /ShadowDom/ > Iron-icon[ID="icon"]
        TagName 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 > Textkörper > Shop-App > /ShadowDom/ > Eisenseiten > Shop-Home > /ShadowDom/ > div > h2 .
        Typ Java und Windows Ermöglicht es Ihnen, ein Bildschirmelement nach seinem Typ zu suchen. Beispiel: Schaltfläche oder Textfeld.

        Wenn Sie auswählen Typ Locator, der UAC-Connector füllt aus Wert Feld mit dem Typ des Elements.

        Pfad Java und Windows Ermöglicht Ihnen, ein Bildschirmelement zu suchen, indem Sie seine Position in der Hierarchie der Bildschirmelemente angeben.

        Wenn Sie auswählen Pfad Locator, der UAC-Connector füllt aus Wert Feld mit dem Pfad des Elements.

        Anwenderdefinierter Pfad Windows Ermöglicht Ihnen das Feinabstimmen oder Trimmen 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. In Bildschirme und Elemente Wählen Sie das Element aus.
      2. Wählen Sie aus Erweitert Registerkarte.
        Der iFrame wird angezeigt.

        IFrame wird angezeigt.

      3. Von Locator Wählen Sie 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 im Universal App Connector.
    10. 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 .
    11. 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.
    12. Ziehen Sie die erforderliche Methode aus dem Bereich „Objekt-Explorer“ auf die Entwurfsoberflä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.