Documentation - aqua cloud
🇩🇪 Deutsch
🇩🇪 Deutsch
  • 💻WEB-CLIENT
    • Erste Schritte
    • Allgemein
      • Startseite
      • App-Sprache
      • Benutzerkonto
      • Passwort ändern
      • Tastenkombinationen & Barrierefreiheit
    • Kontakt zu unserem Support
  • 🧑‍🔧Verwaltung
  • Benutzerverwaltung
    • Hinzufügen und Verwalten von Benutzern
    • Rollen und Berechtigungen
    • Zuweisung von Lizenzen, Projekten und Rollen
    • Vergleich der Lizenzen
    • Lizenzstatistik
    • Statistiken
  • Projektkonfiguration
    • Konfiguration der Projektvorlage (Felder)
    • Feldregeln
    • Geteilte Wertesätze
    • Erstellen von Feldgruppen
    • Workflow-Konfiguration
    • Weitere Projekteinstellungen
    • Projektintegrationen
    • System-Log
    • E-Mail-Benachrichtigungen
      • Projekt-Standardbenachrichtigungen
      • Meine Benachrichtigungen
      • Konfiguration der Projektbenachrichtigungsvorlagen
      • Troubleshooting
  • Projekte und Ordner
    • Projekt erstellen
    • Projekte
      • Projekt exportieren
      • Projekt importieren
        • Migration von Testrail
      • Projekt archivieren
    • Ordner
      • Projektordner exportieren
      • Projektordner importieren
  • 🧩Module
  • Navigation
    • Projektbaum
    • Elementbrowser (Grid)
    • Filter und Gruppierung
    • Ansichten
    • Suche
    • Vorschau der Elementdetails
  • Elemente
    • Anforderungsmanagement
      • Anforderungen
      • Unteranforderungen
      • Anforderungsabdeckung
    • Testfallmanagement
      • Testfälle
      • Eingebettete Testfälle
      • Manuelles Testen
      • Testdaten oder Variablen-Manager
      • Verfolgung der Testumgebung mit Labels (Tags)
      • Ergebnisse der Testausführung
      • Capture: Testrekorder/ Fehlerreporter
      • Jetzt Testen: einfacher Start einer Testausführung
      • Schnelle Ausführung: Testlauf von mehreren Testfällen auf einmal
    • Management von Testszenarien
      • Testszenarien
      • Hinzufügen von Testfällen zu einem Testszenario
      • Ausführen von Testszenarios
    • Fehlermanagement
      • Fehler
      • Fehler aus einer Testausführung erstellen
      • Reviewen von gefundenen oder mit der Testdurchführung verknüpften Fehlern
      • Erstellen eines Fehler mit Capture
    • Allgemeine Funktionen in den Elementen
      • Erstellen und Bearbeiten von Elementen
      • Element in ein Zielprojekt kopieren oder innerhalb eines Projekts duplizieren
      • Übernahme von Feldwerten zwischen Elementen
      • Elementvorlage (Standardwerte)
      • Abhängigkeiten
      • Links zu einer Beschreibung hinzufügen
      • Bildschirmfotos erstellen
      • Element beobachten und andere Benutzer benachrichtigen
      • Anhänge (Dateien)
      • Verlauf der Änderungen
      • Diskussionen (Kommentare)
      • Elementdaten drucken
  • Berichte
    • Erstellen einer neuen Berichtsvorlage
    • Grundelemente des Berichts
    • Baumstruktur der Elemente
    • Eigenschaften der Elemente
    • Diagramme
    • Pivot-Tabelle
    • Funktion 'Sum'
    • Erstellen eines benutzerdefinierten Berichtsskripts
    • Parametrisierung von Berichten
    • Leere Elemente aus einem Bericht ausschließen
    • Hinzufügen eines Inhaltsverzeichnisses zu einem Bericht
  • Dashboards
    • Erstellen eines Dashbords
    • Dashboards veröffentlichen/teilen
    • Erstellen eines Diagramms
    • KPI-Warnungen
    • Drilldown zu Details aus einem Diagramm
    • Vorlage für Burndown-Chart
  • Agile
    • Backlog
    • Sprint-Board
    • Vorschau
  • 🖥️Desktop-Client
  • Wichtiger Hinweis: Abschaffung des Desktop-Clients bis April 2025
  • FAQ: Umstellung vom Desktop-Client auf den Web-Client
  • Desktop Client-Installation
  • 💿Installation für On-Premise
  • System Anforderungen
    • Server
    • Rich Client
    • Web Client
    • Agenten
  • Installation des Servers
  • Installation des Webclients
  • Desktop Client und Agenten
  • Verbindung zur MSSQL Datenbank
  • Verbindung zur Oracle Datenbank 12.2c
  • Lizenzen
  • Monitoring
  • SSL-Konfiguration
  • Einstellungen für die Content Security Policy (CSP)
  • Server-Parameter
  • Update Ihrer Installation
    • Info
    • Server stoppen
    • Update der MSSQL Datenbank
    • Update der Oracle Datenbank
    • Update des Servers
    • Update des Webclients
    • Server starten
    • Update des Desktop-Clients
    • Update der Agenten
    • Update der Hinweise
  • ❔FAQ
    • E-Mail Benachrichtigung - Web Client Links
    • E-Mail Template für neue Benutzer und Passwort zurücksetzen anpassen
    • Maximale Anhanggröße anpassen
    • 🪄KI-Kopilot
    • Transformieren Sie Ihr Test- und Projektmanagement mit KI Copilot von aqua
    • Aktivieren und Verwalten der KI Copilot Optionen
    • Einfache Erstellung von Dokumenten mit KI-Kopilot
    • KI-Kopilot: Generieren Sie eine umfassende Beschreibung für die Testfälle mit nur einem Klick
    • KI-Copilot - Testfälle aus Anforderungen oder aus dem Kontext in Sekunden erstellen
      • Erstellen von Testfällen aus einer Anforderung
      • Erstellen eines Testfalls von einer Testfallseite aus
      • Erstellen von Testfällen über die Navigationsseite
    • Generierung von Testdaten mit KI Copilot
    • Generierung von Testfall basierend auf einer Datei
    • Erstellen Sie User Stories, BDDs oder PRDs basierend auf einer Datei
    • KI-Kopilot-Chat
    • Generierung von Testfällen mit AI Copilot unter Verwendung von Unterstützte Testendesigntechniken
    • 🔗Integrationen
    • Jira-Synchronisierung: Synchronisierung von Elementen zwischen aqua- und Jira-Projekten
      • Checkliste vor dem Start
      • SyncConfigurator herunterladen
      • Erste Einrichtung der Synchronisation
      • Synchronisierung der Projekte zwischen aqua und Jira
      • Feldermapping
        • Unterstützte Jira Standardfelder
        • Kompatibilität der Felder zwischen aqua und Jira
        • Besondere Kompatibilität der Felder zwischen aqua und Jira
      • Erlaube das Mapping nur ausgewählter Werte und ignoriere andere Feldwerte für die Synchronisierung
      • Troubleshooting
      • Formatierungsunterstützung
    • Azure Devops Synchronisierung
    • Jira-Link: Erstellen und/oder Verknüpfen von Jira-Themen mit aqua-Tickets
    • aqua4Jira-Plugin: Jira-Ausgabe mit aqua-Testfällen abdecken
      • Installation des Plug-ins
        • aqua4Jira Plugin - Jetzt kompatibel mit Jira Data Center!
      • Konfiguration in Jira
      • Konfiguration in aqua
    • Confluence Integration
    • Testlink: Importer-Tool für die Migration von Testfällen nach aqua
    • SSO
      • LDAP
      • SAML-Konfiguration
        • Installation
        • Beispiel
    • 🌀Automatisierung
    • Desktop Client
      • Erstellen eines Automatisierungsagenten
      • Konfiguration der Automatisierung
      • Ranorex
      • UFT
      • JMeter
      • SoapUI
      • Datenbank
      • UnixShell
      • PowerShell
      • Jenkins Integration
      • Automatisierungsbibliothek
    • Web Client
      • Automatisierungsagent
        • Erstellung & Konfiguration
        • Agentenpools
        • Laufende Aufgabe
      • PowerShell
      • Unix Shell
      • Jenkins
      • Selenium
    • REST-API
    • Automatisierung: CI/CD-Werkzeuge und aqua REST API
      • Gitlab CI/CD: JAVA/Playwright
      • Gitlab CI/CD: TypeScript/Cypress
      • Gitlab CI/CD: TypeScript/Playwright
      • Gitlab CI/CD: TypeScript/Cypress/Cucumber
    • 🚀Produktaktualisierungen On Premise
    • Funktionsleitlinien
      • 25.30.0 - On Premise
      • 25.18.0 - On premise
      • 25.10.0- On premise
      • 24.126.0 - On premise
      • 24.108.0 - On premise
      • 24.101.0 - On premise
      • 24.93.0 - On Premise
      • 24.83.0 - On Premise
      • 24.71.0 - On Premise
      • 24.53.0 - On Premise
      • 24.8 - On Premise
      • 23.140 - On Premise
      • 23.126.0 - On Premise
      • 23.102.0 - On Premise
      • 23.70.0 - On Premise
      • 23.22.0 - On Premise
      • 22.132.0 - On Premise
      • 22.123.0 - On Premise
    • Release Notes
      • 25.31.0 und 25.33.0 - On Premise
      • 25.30.0 - On Premise
      • 25.26.0 - On Premise
      • 25.18.0 - On Premise
      • 25.10.0 - On Premise
      • 24.135.0 - On Premise
      • 24.130.0 - On Premise
      • 24.126.0 - On Premise
      • 24.114.0 - On Premise
      • 24.108.0 - On Premise
      • 24.101.0 - On Premise
      • 24.93.0 - On Premise
      • 24.83.0 - On Premise
      • 24.71.0 - On Premise
      • 24.53.0 - On Premise
      • 24.8.0 - On Premise
      • 23.140.0 - On Premise
      • 23.126.0 - On Premise
      • 23.102.0 - On Premise
      • 23.70.0 - On Premise
      • 23.22.0 - On Premise
      • 22.132.0 - On Premise
      • 22.123.0 - On Premise
    • 🚀Produktaktualisierungen für Kunden von Public und Private Clouds
    • Funktionsleitlinien
      • 25.36.0 - public und private cloud
      • 25.33.0 - Public und Private cloud
      • 25.18.0 - Public und Private cloud
      • 25.10.0 -Public and Private Cloud
      • 24.126.0 - Public and Private Cloud
      • 24.108.0 - Public and Private Cloud
      • 24.101.0 - Public and Private Cloud
      • 24.93.0 - Public and Private Cloud
      • 24.88.0 - Public und Private Clouds
      • 24.88.0 - Public und Private Clouds
      • 24.83.0 - Public und Private Clouds
      • 24.71.0 - Public und Private Clouds
      • 24.63.0 - Public und Private Clouds
      • 24.50.0 - Public und Private Clouds
      • 24.33.0 - Public und Private Clouds
      • 24.8.0 - Public und Private Clouds
      • 23.140 - Public und Private Clouds
      • 23.126.0 - Public und Private Clouds
      • 23.107.0 - Public und Private Clouds
      • 23.92 - Public und Private Clouds
      • 23.70.0 - Public und Private Clouds
      • 23.46.0 - Public und Private Clouds 1/3
      • 23.46.0 - Public und Private Clouds 2/3e
      • 23.46.0 - Public und Private Clouds 3/3
      • 23.22.0 - Public und Private Clouds
      • 22.123.0 - Public und Private Clouds
    • Release Notes
      • 25.33.0- Public und Private Clouds
      • 25.31.0- Public und Private Clouds
      • 25.30.0 - Public und Private Cloud
      • 25.24.0 - Public und Private Cloud
      • 25.18.0 - Public und Private Cloud
      • 25.10.0 - Public und Private Cloud
      • 24.135.0 - Public and Private Clouds
      • 24.130.0 - Public and Private Clouds
      • 24.126.0 - Public and Private Clouds
      • 24.114.0 - Public and Private Clouds
      • 24.108.0 - Public and Private Clouds
      • 24.101.0 - Public and Private Clouds
      • 24.93.0 - Public and Private Clouds
      • 24.88.0 - Public und Private Clouds
      • 24.83.0 - Public und Private Clouds
      • 24.71.0 - Public und Private Clouds
      • 24.63.0 - Public und Private Clouds
      • 24.50.0 - Public und Private Clouds
      • 24.33.0 - Public und Private Clouds
      • 24.8.0 - Public und Private Clouds
      • 23.140.0 - Public und Private Clouds
      • 23.126.0 - Public und Private Clouds
      • 23.107.0 - Public und Private Clouds
      • 23.92 - Public und Private Clouds
      • 23.70.0 - Public und Private Clouds
      • 23.46.0 - Public und Private Clouds
      • 23.22.0 - Public und Private Clouds
      • 22.132.0 - Public und Private Clouds
      • 22.123.0 - Public und Private Clouds
    • 📢 AQUA NEWS
      • Vorschau auf die öffentliche API von aqua
    • 📹Capture
    • Was ist Capture?
    • Installation der Chrome-Erweiterung
    • Aufnehmen im Inkognito-Modus
    • Verwenden von Capture mit Edge
    • Aufzeichnung mit Video
      • Option zum Aktivieren des Mikrofons für Sprachaufnahmen während der Bildschirmaufnahme
      • Option zum Pausieren/Fortsetzen während der Videoaufzeichnung
    • Erfassen mit Screenshot
    • Ausführung eines Tests
    • Last-Minute-Sitzungswiederholung
    • Maskierte Eingaben beim Erstellen von Captures
Powered by GitBook
On this page
  • Ein Automatisierungsagent erstellen
  • Abrufen eines Agentencodes
  • Konfigurieren eines Agenten

Was this helpful?

  1. FAQ
  2. Web Client
  3. Automatisierungsagent

Erstellung & Konfiguration

PreviousAutomatisierungsagentNextAgentenpools

Last updated 10 months ago

Was this helpful?

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 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.

Ein grüner Punkt wird für diesen Agenten angezeigt, wenn die Verbindung erfolgreich ist (die Ansicht muss möglicherweise einmal aktualisiert werden). Wenn keine anfängliche Verbindung hergestellt werden kann, wird der Punkt grau sein.

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

❔
🟠
🟢
Ausführen von automatisierten Testfällen mit dem Agenten
Hinzufügen eines Automatisierungsagenten
Kopieren vom Zugangsschlüssel des automatischen Agenten
Verfügbarkeit der Agenten