Der PowerShell-Agent stellt mehrere Objekte für PowerShell-Skripte zur Verfügung:
-
variables - Array von aqua.ProcessEngine.WebServiceProxy.VariableValue Objekten, die Testfallvariablen (und ihre Werte) für die Ausführung beinhaltet. Name und Value sind die wichtigsten Eigenschaften für VariableValue
-
tempDir - String Variable, die den Pfad des temporären Verzeichnisses enthält, in dem Skriptanhänge gespeichert wurden (wenn vorhanden)
-
aquaCallback - Verweis auf das AquaShellCallbackHelper Objekt, dass genutzt werden kann, um mit aqua vom PowerShell-Skript zu kommunizieren. Die verfügbare Funktionalität beinhaltet:
-
Senden von Log-Nachrichten nach aqua (auch mit Screenshots)
-
Senden von Anhängen nach aqua (gespeichert als Anhänge im Ausführungsobjekt)
-
StopRequest Eigenschaft - wird bei Abbruchanfragen, die von aqua erhalten werden, vom Agenten gesetzt. Lang laufende Skripte sollten diesen Flag periodisch überprüfen und langsam stoppen, wenn gesetzt. Wenn nicht nach 5 Sekunden gestoppt wird, nachdem dieser Flag gesetzt wurde, macht der Agent einen Forced Stop des laufenden Skripts.
Zum Aufrufen von nunit aus Powershell können Sie einen Befehl nutzen wie:
$output = & $nunitLocation $testDll --test=$testCaseName 2>&1
Um exponierte Objekte zu nutzen, muss das PowerShell-Skript ihre Benutzung deklarieren, indem der folgende Befehl eingegeben wird:
param($variables, $tempDir, $aquaCallback)
Beachten Sie, dass alle genutzten Variablen in einem einzelnen "param"-Befehl deklariert werden müssen. Ein Beispielskript, dass diese Objekte benutzt:
# Beispiel PowerShell Skript, dass .NET Objekte und Testfallvariablen von aqua benutzt
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
}
# Mögliche Typen von [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");
}
# Gibt den Status der Skriptausführung zurück. Einen von: Ready, Blocked, Fail, Aborted (Bereit, Blockiert, Gescheitert, Abgebrochen)
return "Ready"
