Verwenden importierter Bibliotheksprojekte in codierten Automatisierungen

Dieses Tutorial zeigt Ihnen, wie Sie Objekte aus importierten Bibliotheksprojekten in codierten Automatisierungen verwenden. Das Beispiel veranschaulicht, wie Object Repository-Elemente und Workflows aus einem importierten Bibliotheksprojekt verwendet werden. Das angegebene Szenario beinhaltet die Automatisierung der Acme-Website, um eine Bewertungskarte für Studenten auszufüllen und zur Datenbank hinzuzufügen.

Voraussetzungen

• Install UIAutomation Activities version 23.10.13 or higher.
  Note: We recommend you to use the latest minor version corresponding to the major version that you are working with. For example, if you are using the 23.10 major version of activity packages, we recommend you to upgrade them to the latest minor version available (23.10.x).
• Publish the Acme library sample and install it in the project where you are working.

1. Erstellen Sie das Bibliotheksprojekt

Erstellen Sie ein Bibliotheksprojekt, um die wesentlichen UI-Elemente für die Automatisierung der Acme-App zu speichern, insbesondere zum Ausfüllen einer Bewertungskarte für einen Studenten. Erstellen Sie außerdem einen Low-Code (.xaml) oder codierten Workflow (.cs) innerhalb des Bibliotheksprojekts, den Sie später in einer anderen codierten Automatisierung verwenden werden.

1. Erstellen Sie ein Bibliotheksprojekt namens AcmeLibrary.
2. Erfassen Sie alle UI-Elemente, die Sie im Object-Repository und im Abschnitt Deskriptoren verwenden möchten.
3. Erstellen Sie einen neuen codierten Workflow aus der Gruppe Datei.

   Dieser Schritt ist entscheidend, um den Zugriff auf das Object-Repository innerhalb einer codierten Automatisierung zu ermöglichen, wenn die Bibliothek in ein anderes Projekt importiert wird.

4. Benennen Sie den Low-Code-Hauptworkflow in Send message box um und fügen Sie eine Aktivität Message Box mit dem folgenden Text hinzu: „Sie haben eine neue Bewertungskarte für einen Studenten in Acme hinzugefügt.“
   Hinweis: Sie können die Aktivität Message Box auch als codierten Workflow neu erstellen, indem Sie die im Tutorial beschriebenen Schritte ausführen.
5. Speichern und veröffentlichen Sie das Bibliotheksprojekt in einem Feed.

   Sie installieren und verwenden diese veröffentlichte Bibliothek in einem anderen Projekt innerhalb einer codierten Automatisierung.

2. Erstellen Sie die codierte Automatisierung

Nachdem Sie das Bibliotheksprojekt erstellt haben, installieren Sie es in einem anderen Projekt, um dessen wiederverwendbare Assets zu nutzen, einschließlich Object Repository-Elementen und Workflows, ob Low-Code (.xaml) oder codiert (.cs).

Tipp: Beachten Sie bei der Verwendung von UI-Automatisierungs-APIs, dass die Überladungen mit IScreenDescriptor oder IElementDescriptor mit Object Repository-Elementen funktionieren sollen, während die Überladungen mit TargetAnchorableModel für die Verwendung mit nativen Selektoren gedacht sind, die über den UI-Explorer abgerufen werden. Unter UI-Automatisierungs-APIs erfahren Sie, wie Sie Selektoren mit UI-Automatisierungs-APIs nutzen.

1. Erstellen Sie in der Gruppe Datei einen neuen codierten Workflow.
2. Wechseln Sie zu Pakete verwalten und installieren Sie das zuvor erstellte Bibliotheksprojekt.
3. Erstellen Sie in der Gruppe Datei einen neuen Workflow.
   1. Nennen Sie den Workflow notifyStudentScoreCardAdded.
   2. Navigieren Sie zum Bereich Aktivitäten zum Abschnitt Installiert.
   3. Suchen Sie nach dem Namen des importierten Bibliotheksprojekts (zum Beispiel AcmeLibrary).
   4. Ziehen Sie die Aktivität Send message box in notifyStudentScoreCardAddedund legen Sie sie dort ab.
      Jetzt hat notifyStudentScoreCardAdded das gleiche Verhalten wie derSend message box-Workflow aus dem importierten Bibliotheksprojekt.
4. Um die Lesbarkeit zu verbessern, können Sie die importierte Object Repository-Anwendung als Variable definieren, indem Sie eine using-Anweisung zu Beginn Ihres Workflows anwenden. Hier ist ein Beispiel: using app = <ProjectName>.ObjectRepository.Descriptors.
   Mit diesem Ansatz können Sie Deskriptoren einfach im folgenden Format aufrufen: app.<AppName>.<ScreenName>.<UiElementName>
   In diesem Beispiel definieren wir das Acme Object-Repository wie folgt:

   namespace UsingImportedLibraryProjects
   {
       using AcmeApp = AcmeLibrary.ObjectRepository.Descriptors;

5. Jetzt können Sie das angegebene Szenario in Acme automatisieren. Öffnen Sie zunächst den Acme-Anmeldebildschirm mithilfe der Open-API.

   [Workflow]
           public void Execute()
           {
             // 1.Open the Acme app on the Login screen
             var AcmeLoginScreen = uiAutomation.Open(AcmeApp.Acme.LoginScreen);

6. Geben Sie die erforderlichen Anmeldeinformationen für die Anmeldung bei Acme mithilfe der TypeInto-API ein.

   // 2.Type in the necessary credentials
            AcmeLoginScreen.TypeInto(AcmeApp.Acme.LoginScreen.Email, "[e-mail]");
            AcmeLoginScreen.TypeInto(AcmeApp.Acme.LoginScreen.Password, "12345678");

7. Verwenden Sie die Click-API zusammen mit einem nativen Selektor, um auf die Schaltfläche Anmelden zu klicken.

   // 3.Use a native selector to click the Login button
   AcmeLoginScreen.Click(Target.FromSelector("<webctrl tag='BUTTON' type='submit'/>"));

8. Beim Anmeldevorgang werden Sie zum Dashboard-Bildschirm in der Acme-Webanwendung weitergeleitet. Verwenden Sie daher die Attach-API, um den Fokus auf den neuen Bildschirm zu legen.

   // 4. Focus on the Dashboard screen
   var DashboardScreen = uiAutomation.Attach(AcmeApp.Acme.Dashboard);

9. Wählen Sie auf der Website mithilfe der Click-API den Eintrag Studenten aus.

   // 5. Click the Students entry
   DashboardScreen.Click(AcmeApp.Acme.Dashboard.Students);

10. Wählen Sie Bewertungskarte aus, um das Formular Studenten – Bewertungskarte mithilfe der Click-API zu öffnen.

    // 6. Click Score card, to start filling in a student score card
    DashboardScreen.Click(AcmeApp.Acme.Dashboard.Students.ScoreCard);

11. Richten Sie Ihren Blick auf den Bildschirm Studenten – Bewertungskarte und verwenden Sie die Attach-API.

    // 7. Focus on the Score Card screen where you fill in the necessary information
    var ScoreCardScreen = uiAutomation.Attach(AcmeApp.Acme.StudentsScoreCard);

12. Füllen Sie die Hälfte der Felder im Formular „Studenten – Bewertungskarte“ mit der TypeInto-API und Elementen aus dem Object-Repository aus.

    ScoreCardScreen.TypeInto(AcmeApp.StudentsScoreCard.StudentEmail, "[e-mail]");
    ScoreCardScreen.TypeInto(AcmeApp.Acme.StudentsScoreCard.FirstName, "John");
    ScoreCardScreen.TypeInto(AcmeApp.Acme.StudentsScoreCard.LastName, "Doe");
    ScoreCardScreen.TypeInto(AcmeApp.Acme.StudentsScoreCard.ParentEmail, "[e-mail]");
    ScoreCardScreen.TypeInto(AcmeApp.Acme.StudentsScoreCard.Tuition, "Private");

13. Füllen Sie die restlichen Felder im Formular mithilfe der TypeInto-API in Kombination mit nativen Selektoren aus, die Sie über den UI-Explorer finden.

    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='mathematics' tag='INPUT' />"), "A");
    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='physics' tag='INPUT' />"), "B");
    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='biology' tag='INPUT' />"), "C");
    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='chemistry' tag='INPUT' />"), "A");
    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='geography' tag='INPUT' />"), "C");
    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='history' tag='INPUT' />"), "A");
    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='english' tag='INPUT' />"), "A");
    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='computer Science' tag='INPUT' />"), "C");
    ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='professorComments' tag='INPUT' />"), "The student is doing okay, very hardworking and does its best");

14. Wählen Sie Bewertungskartendetails hinzufügen mithilfe der Click-API aus.

    // 10. Click the "Add score card details" button using an Object Repository descriptor
    ScoreCardScreen.Click(AcmeApp.Acme.StudentsScoreCard.AddScoreCardDetailsButton);

15. Rufen Sie den Workflow auf, den Sie mit der RunWorkflow()-Methode aus dem Bibliotheksprojekt importiert haben. Geben Sie die Methode mit dem Pfad des Workflows innerhalb des Projekts an.

    // 11. Invoke imported workflow from library
    RunWorkflow("notifyStudentScoreCardAdded.xaml");

16. Schließen Sie die Browserregisterkarten, die Sie geöffnet haben, um das Szenario mithilfe der Dispose()-API zu automatisieren.

    // 12. Close the applications/browsers you opened, to finish he automation
    ScoreCardScreen.Dispose();

Beispielprojekt

To follow the steps and try out the tutorial yourself, see the following sample project: Using imported library projects in coded automations. The file contains the library project, as well.