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.48.0.0- On Premise
      • 25.36.0 - On Premise
      • 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

Was this helpful?

  1. FAQ
  2. Web Client

PowerShell

PreviousLaufende AufgabeNextUnix Shell

Last updated 11 months ago

Was this helpful?

Die Einrichtung eines PowerShell-Agenten kann im Kapitel Automatisierungsagent; nachgelesen werden. Der PowerShell-Agent wird benötigt, um einen Testfall mit PowerShell-Skripten auszuführen.

Um ein PowerShell-Skript zu einem Testfall hinzuzufügen, öffnen Sie den Testfall und navigieren zum Schrittdesigner. Wechseln Sie dann zum Tab 'Automatisierung'.

Wenn Sie PowerShell auswählen, wird automatisch ein PowerShell-Beispielskript eingefügt. Sie können das Beispielskript nutzen, um die Funktionalität, die der PowerShell-Agent bietet, leicht zu verstehen. Anschließend können Sie das Skript weiter anpassen oder es direkt durch andere Skripte ersetzen.

Hier sind einige weitere Informationen ĂĽber die Objekte und Funktionen, die der PowerShell-Agent fĂĽr PowerShell-Skripte bereitstellt:

  • variables – Array von Objekten, die TC-Variablen (und ihre Werte) enthalten, die bei der AusfĂĽhrung verwendet werden. Name und Wert sind die wichtigsten Eigenschaften jedes Objekts.

  • tempDir – Zeichenfolge, die den Pfad des temporären Verzeichnisses enthält, in dem die Skriptanhänge gespeichert wurden (falls zutreffend).

  • aquaCallback – Referenz auf das AquaShellCallbackHelper-Objekt, das verwendet werden kann, um aus dem PowerShell-Skript heraus mit aqua zu kommunizieren. VerfĂĽgbar sind Funktionen wie:

    • das Senden von Protokollnachrichten an aqua (auch mit Screenshots)

    • das Senden von Anhängen an aqua (gespeichert als Anhänge im AusfĂĽhrungsobjekt)

    • das Senden des AusfĂĽhrungsstatus ĂĽber AddExecutionData

    • das Abrufen von TestausfĂĽhrungsinformationen (IDs von Projekt, Testfall, TestausfĂĽhrung, Testszenario, TestszenarioausfĂĽhrung)

  • StopRequest-Eigenschaft – wird vom Agenten bei Abbruchanfragen von aqua gesetzt. Langlaufende Skripte sollten dieses Flag periodisch ĂĽberprĂĽfen und sich schonend beenden, falls es gesetzt ist. Wird nicht innerhalb von 5 Sekunden nach Setzen des Flags gestoppt, fĂĽhrt der Agent einen erzwungenen Stopp des laufenden Skripts durch.

Um NUnit über PowerShell aufzurufen, können Sie Befehle wie folgt verwenden:

$output = & $nunitLocation $testDll --test=$testCaseName 2>&1

Um exponierte Objekte zu nutzen, muss das PowerShell-Skript ihren Gebrauch durch AusfĂĽhren des folgenden Befehls deklarieren:

param($variables, $tempDir, $aquaCallback)

Beachten Sie, dass alle verwendeten Variablen in einem einzigen "param"-Befehl deklariert werden mĂĽssen.

Beispielskript mit diesen Objekten:

# Beispiel fĂĽr ein PowerShell-Skript, das .NET-Objekte und TC-Variablen von aqua verwendet

param($variables, $tempDir, $aquaCallback)  
$text = new-object System.Text.StringBuilder  
$date = [System.DateTime]::Now  
$text.AppendLine($date.ToLongDateString())  
$text.AppendLine($date.ToLongTimeString())  
echo "$text" > script-sample.log  
foreach ($var in $variables)  
{  
    $varName = $var.Name  
    $varValue = $var.Value  
    echo "Variable: $varName : $varValue" >> script-sample.log  
}

#Request Test Execution information via $aquaCallback.GetExecutionInfo()#Returns an object with ProjectId, TestCaseId, TestExecutionId, [TestScenarioId and TestScenarioExecutionId]

$executionInfo = $aquaCallback.GetExecutionInfo()                                                             
Write-Output "Project ID: $($executionInfo.ProjectId)" >> script-sample.log
Write-Output "TestCase ID: $($executionInfo.TestCaseId)"  >> script-sample.log
Write-Output "Execution ID $($executionInfo.TestExecutionId)" >> script-sample.log
Write-Output "Scenario ID (when run in scenario): $($executionInfo.TestScenarioId)" >> script-sample.log
Write-Output "Scenario Execution ID (when run in scenario): $($executionInfo.TestScenarioExecutionId)" >> script-sample.log

# Possible Types of [aqua.ProcessEngine.WebServiceProxy.ExecutionLogMessageType]

# SUTError, ScriptExecutionError, PreparationError, ExecutionError, InformationalInfo, InformationalDebug, InformationalWarn, InformationalSuccess

$aquaCallback.SendMessage("hello, I was sent from script", [aqua.ProcessEngine.WebServiceProxy.ExecutionLogMessageType]::InformationalWarn, "my category");   
$aquaCallback.SendMessageWithScreenshot("and this is Screenshot", "c:\sample.jpg", [aqua.ProcessEngine.WebServiceProxy.ExecutionLogMessageType]::InformationalWarn, "my category");   
dir $tempDir >> script-sample.log  
$aquaCallback.AddExecutionAttachment("script-sample.log");  
while ($true)  
{  
    if ($aquaCallback.StopRequest)  
    {
        $aquaCallback.SendMessage("Aborting on StopRequest", [aqua.ProcessEngine.WebServiceProxy.ExecutionLogMessageType]::InformationalWarn, "my category");   
        return "Aborted"   
    }  
    Start-Sleep -s 10  
    aquaCallback.SendMessage("Looping in PowerShell…", [aqua.ProcessEngine.WebServiceProxy.ExecutionLogMessageType]::InformationalWarn, "my category");   
}  

# Return status of script execution. One of: Ready, Blocked, Fail, Aborted return "Ready"

âť”
Erstellung & Konfiguration