Erstellung & Konfiguration

Mit Aqua können Sie automatisierte Tests durchführen. Das Verfahren zum Ausführen eines automatisierten Tests ist dasselbe wie bei einem manuellen Test. Sie klicken einfach auf die Schaltfläche "Ausführen" in einem gegebenen Testfall. Der folgende Dialog wird durch einen Abschnitt für die Auswahl eines Agenten ergänzt. Der Agent ist verantwortlich für die Durchführung des Tests.

🔴 Rot bedeutet, dass der Agent nicht verfügbar ist.

🟢 Grün zeigt einen Ausführungsagenten an, der auf eine Aufgabe wartet.

Die folgenden Kapitel beschreiben, wie Sie die Agents mithilfe des Webclients konfigurieren können für:

  • Jenkins

  • Unixshell

  • PowerShell

Um zusätzliche Automatisierungswerkzeuge wie Ranorex, JMeter oder SoapUI oder sogar Datenbankabfragen einzurichten, müssen Sie den aqua Desktop-Client verwenden. Bitte konsultieren Sie für weitere Informationen das Kapitel zur Automatisierung im Handbuch für den Desktop

Ein Automatisierungsagent erstellen

Um einen automatisierten Testfall auszuführen, muss ein Aqua-Agent konfiguriert werden. Jeder Agent verfügt über einen einzigartigen Zugangscode. Der Code wird in Aqua generiert und dem Agenten zugewiesen. Die Agenten können dann auf jedem Computer installiert werden, solange eine Verbindung zum Aqua-Server besteht. Nach der Installation und Konfiguration kommunizieren die Agenten einfach zwischen Aqua und dem jeweiligen Automatisierungstool, starten Testausführungen und geben Ergebnisse an Aqua zurück.

Abrufen eines Agentencodes

Um einen Zugangsschlüssel abzurufen, wählen Sie Ihr Projekt im Projektbrowser aus und klicken Sie in der linken oberen Ecke der aquafarbenen Kopfzeile auf das Hamburger-Menü oder klicken Sie einfach mit der rechten Maustaste auf den Projektnamen. Im Bereich "Projektkonfiguration" wählen Sie "Automatisierungsagenten".

Wechseln Sie zum Tab "Agenten", wählen Sie "Konfiguration" und dann "Agent hinzufügen". Geben Sie Ihrem Agenten anschließend einen einzigartigen Namen.

Ein Zugangsschlüssel wird automatisch generiert und ist erforderlich, um einen Agenten erfolgreich zu konfigurieren. Kopieren Sie den Passcode in die Zwischenablage oder notieren Sie ihn für die spätere Verwendung. Der Passcode dient als Kennung, um zwischen mehreren Agenten richtig zu unterscheiden.

Stellen Sie sicher, dass zwei Agenten niemals mit demselben Passcode konfiguriert werden.

Konfigurieren eines Agenten

Ein Zugangscode ist erforderlich, um die Agenten zu konfigurieren. Er muss in die Konfigurationsdatei des entsprechenden Agenten aufgenommen werden. Konfigurieren eines Agenten

Um das Agent-Paket herunterzuladen, navigieren Sie bitte zum Download-Bereich, der im Seitenmenü unter 'aqua Downloads' zu finden ist.

Ein weiteres erforderliches Detail ist die aquaServiceUrl, die ebenfalls auf der Download-Seite gefunden werden kann.

Nachdem Sie das Agentenpaket heruntergeladen haben, befindet sich die Konfigurationsdatei im selben Ordner wie die Agenten-Exe-Datei, zum Beispiel aquaAgentPowerShell.exe.config für PowerShell oder aquaAgentRanorexGui.exe.config für Ranorex.

Der generierte Zugangscode muss in dieser Datei eingegeben werden. Je nach Agententyp können auch andere Konfigurationen in dieser Datei vorgenommen werden. Zusätzlich zum agentCode muss auch die aquaServiceUrl angegeben werden. Dort muss der korrekte Aqua-Servername oder die Server-IP-Adresse eingegeben werden.

Die relevanten Abschnitte werden im folgenden Ausschnitt gezeigt, am Beispiel des PowerShell-Agenten:

<?xml version="1.0"?>
<configuration>
  <appSettings>
    <add key="agentCode" value="84f0voteb5xtym56p4lc" />
    <add key="aquaServiceUrl" value="https://aquaServerName/aquaAPI/aquaagentwebservice.asmx" />
    <...
  </appSettings>
  ...
...
</configuration>

Nachdem Sie den Agenten korrekt konfiguriert haben, können Sie den Agenten über die .exe-Datei starten. Das sich öffnende Fenster zeigt den Verbindungsstatus und andere Protokollnachrichten an.

Im Bereich Automatisierungsagenten in aqua:

🟠 Wenn eine Verbindung mindestens einmal hergestellt wurde, aber jetzt verloren gegangen ist, erscheint ein orangefarbener Punkt.

Wenn keine Verbindung besteht, überprüfen Sie, ob der Agent gestartet wurde, ob im Agent Fehlermeldungen angezeigt werden und ob eine Verbindung zum Aqua-Server besteht. Um einen automatisierten Testfall mit diesem Agenten durchzuführen, muss der Agent gestartet und korrekt konfiguriert sein.

Last updated