Logic Plug-in

<< Click to Display Table of Contents >>

RayQC > 2026.3 > User Guide > Plug-ins > Internal Plug-ins 

Logic Plug-in

Das Logic-Plug-in stellt Funktionen zum Konvertieren, Vergleichen und Analysieren von Werten bereit.

 

Funktionsübersicht

BooleanToString

CompareValue

ContainsString

FormatString

GetRegexGroup

GetStringLength

GetSubString

GetTrimmedString

GetTrimmedStringStatic

InvertBoolean

MatchRegex

NumberInRange

StringToString

TrimWhitespace

 

 

Funktionsdetails

BooleanToStringMulti-OptionData Field

Konvertiert einen booleschen Wert oder ein Checkpoint-Ergebnis in eine definierte Zeichenfolge. Diese Funktion kann beispielsweise verwendet werden, um einen Checkpoint-Status einem Multi-Option-Element zuzuordnen.

Verwendbar in Kombination mit Elementen des Typs Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Wert

boolean

Standard: true

 
 

Boolescher Wert, der in den meisten Fällen als Verweis auf ein Checkpoint-Ergebnis definiert ist.

 

Optionen:

enabled: Der in den Parameter True Text eingegebene Text wird zurückgegeben.

disabled: Der in den Parameter False Text eingegebene Text wird zurückgegeben.

TrueText

string

Der Text, der zurückgegeben wird, wenn der Wert true ist.

 

Beispiel:

64bit Architecture

FalseText

string

Der Text, der zurückgegeben wird, wenn der Wert false ist.

 
Beispiel:

32bit Architecture

 

 

CompareValueCheckpoint

Vergleicht zwei Werte. Dies kann erforderlich sein, um das Ergebnis zweier Checklisten-Elemente oder eine statische Zeichenfolge mit einem Elementergebnis zu vergleichen.

Verwendbar in Kombination mit Elementen des Typs Checkpoint.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Ist-Wert

string

 
 

Die erste Zeichenfolge für den Vergleich.

 

Beispiel:

Raynet GmbH

Erwarteter Wert

string

Die zweite Zeichenfolge für den Vergleich.

 

Beispiel:

raynet gmbh

Groß-/Kleinschreibung beachten

boolean

optional

Standard: true

Legt fest, ob der Vergleich unter Berücksichtigung der Groß-/Kleinschreibung durchgeführt werden soll oder nicht.

 
Beispiel:

enabled = Die zwei als Beispiel verwendeten Zeichenfolgen oben gelten als 

unterschiedlich.

disabled = Die zwei als Beispiel verwendeten Zeichenfolgen oben gelten als 

übereinstimmend.

Benutzerdefinierter Fehlerkommentar

string

optional

Der Standardfehlerkommentar für das Checkpoint-Element

kann bei Bedarf durch diese Zeichenfolge ersetzt werden.
 

Beispiel:

Diese Umgebung erfordert, dass die Herstellereigenschaft und das Autorenattribut

des Zusammenfassungsinformationsstroms unter Berücksichtigung der Groß-/Kleinschreibung übereinstimmen.

 

 

ContainsStringCheckpoint

Sucht nach einer bestimmten Zeichenfolge in einer anderen Zeichenfolge.

Verwendbar in Kombination mit Elementen des Typs Checkpoint.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

 
 

Der Bereich, in dem gesucht wird.

 

Beispiel:

RayQC ist ein regelbasiertes Werkzeug zum Erstellen und Ausführen von Testkriterien in einer oder mehreren Checklisten.

 

Suche

string

Die gesuchte Zeichenfolge.

 

Beispiel:

Checklist

Groß-/Kleinschreibung beachten

boolean

optional

Standard: true

Legt fest, ob die gesuchte Zeichenfolge mit exakt der Groß-/Kleinschreibung

gefunden werden muss, wie sie im Parameter Suche definiert ist.

 
Beispiel:

enabled = Die oben definierte Zeichenfolge wird in der 

Beispielzeichenfolge nicht gefunden.

disabled = Die oben definierte Zeichenfolge wird in der

Beispielzeichenfolge gefunden.

Benutzerdefinierter Fehlerkommentar

string

optional

Der Standardfehlerkommentar des Checkpoint-Elements

kann bei Bedarf durch diese Zeichenfolge ersetzt werden.

 
Beispiel:

Die Suche nach einem Teilstring unter Berücksichtigung der Groß-/Kleinschreibung führte zu keiner Übereinstimmung.

 

 

FormatStringMulti-OptionData Field

Formatiert eine Zeichenfolge, indem bis zu fünf definierte Platzhalter durch Argumente ersetzt werden. Ein Platzhalter hat das Format '#x#', wobei 'x' die Nummer des Arguments ist.

Verwendbar in Kombination mit Elementen des Typs Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

 
 

Die Zeichenfolge, die die zu ersetzenden Platzhalter enthält.

 

Beispiel:

Der Wert der Eigenschaft #1# ist als #2# definiert.

Ersetzung

#<number>#

string

Der Wert der Eigenschaft #1# ist als #2#

Der an der Position des Platzhalters #number# in den Originaltext eingefügte Wert.

 

Beispiel:

manufacturer

 

GetRegexGroupMulti-OptionData Field

Prüft, ob ein Text dem durch eine einzelne Gruppe eines regulären Ausdrucks definierten Muster entspricht.

Verwendbar in Kombination mit Elementen des Typs Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

 
 

Die Zeichenfolge, die auf Übereinstimmung mit dem regulären Ausdruck geprüft wird.

 

Beispiel:

uninst_myApp.lnk

Regulärer Ausdruck

string

Das Muster des regulären Ausdrucks, anhand dessen die Zeichenfolge ausgewertet wird.

Das unten angegebene Beispielmuster stimmt mit dem obigen Beispieltext überein.

 

Beispiel:

First test value is "AAA" and the second test value 

is "111".

 

"(.*?)"

 

Gets the string between first quote.

 

tip

Tipp:

Weitere Informationen und Hilfe zur Verwendung regulärer Ausdrücke finden Sie im Abschnitt Reguläre Ausdrücke.

 

GetStringLengthMulti-OptionData Field

Gibt die Länge einer Zeichenfolge zurück. Wenn keine Zeichenfolge angegeben wird, wird 0 zurückgegeben.

Verwendbar in Kombination mit Elementen der Typen  Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

optional

Standard: keine

 
 

Zeichenfolge, deren Zeichen gezählt werden.

 

Beispiel:

Der folgende Satz hat eine Zeichenfolgenlänge von 161:

RayQC steigert die Qualität Ihrer Software-Deployments durch mehrstufige und standardisierte Testpläne und entlastet Ihre Mitarbeiter von manuellen Testaufgaben.

 

 

GetSubStringMulti-OptionData Field

Gibt einen Teilstring aus einem gegebenen Text zurück.

Verwendbar in Kombination mit Elementen des Typs Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

 
 

Die Zeichenfolge, aus der der Teilstring extrahiert wird. Die hier verwendeten Beispiele führen zur Extraktion des Teilstrings experience.

 

Beispiel:

Improve end-user experience and productivity!

Erster

integer

Mindestwert: 1

Der erste Buchstabe, die erste Zahl oder das erste Sonderzeichen, das als Teil des Teilstrings zurückgegeben wird. Der Zählwert beginnt bei 1 für das erste Zeichen des Parameters Text. Bei negativen Zahlen wird vom Ende gezählt (gilt für beide Parameter).

 

Beispiel:

17

Letzter

integer

 

 

 

Der letzte Buchstabe, die letzte Zahl oder das letzte Sonderzeichen, das als Teil des Teil-

strings zurückgegeben wird. Der Zählwert beginnt bei 1 für das erste Zeichen des Parameters Text.

 
Achtung:

Der für diesen Parameter angegebene Wert darf nicht niedriger sein als der für den Parameter Erster eingegebene Wert.

 
Beispiel:

26

 

 

GetTrimmedStringMulti-OptionData Field

Gibt einen Teilstring als Ergebnis des Kürzens einer gegebenen Zeichenfolge zurück.

Verwendbar in Kombination mit Elementen der Typen Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

 
 

Die Zeichenfolge, die gekürzt wird. Das hier verwendete Beispiel führt zur Extraktion des gekürzten Teilstrings 00FF00.

 

Beispiel:

<#!"§00FF00+#>

TrimStart

string

optional

Standard: keine

Die Zeichenmenge, die vom Anfang der ursprünglichen Zeichenfolge entfernt wird. Die Reihenfolge der Zeichen ist nicht relevant.

 

Beispiel:

<§"!#

TrimEnd

string

optional

Standard: keine

 

Die Kombination von Zeichen, die vom Ende der ursprünglichen Zeichenfolge entfernt wird. Die Reihenfolge der Zeichen ist nicht relevant.

 
Beispiel:

#+>

 

 

GetTrimmedStringStaticMulti-OptionData Field

Gibt einen Teilstring als Ergebnis des Kürzens einer gegebenen Zeichenfolge zurück.

Verwendbar in Kombination mit Elementen der Typen Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

 
 

Die Zeichenfolge, die gekürzt wird. Das hier verwendete Beispiel führt zur Extraktion des gekürzten Teilstrings 00FF00+#.

 

Beispiel:

<#!"§00FF00>

TrimStart

string

optional

Standard: keine

Die Zeichenmenge, die vom Anfang der ursprünglichen Zeichenfolge entfernt wird.

 

Achtung:

Die Reihenfolge der Zeichen ist wichtig. Die angegebene Zeichenfolge muss exakt mit dem Anfang des Parameters Text übereinstimmen, andernfalls wird die Kürzung nicht ausgeführt.

 

Beispiel:

<#!"§

TrimEnd

string

optional

Standard: keine

 

 

 

Die Kombination von Zeichen, die vom Ende der ursprünglichen Zeichenfolge entfernt wird.

 
Achtung:

Die Reihenfolge der Zeichen ist wichtig. Die angegebene Zeichenfolge muss exakt mit dem Ende des Parameters Text übereinstimmen, andernfalls wird die Kürzung nicht ausgeführt.

 
Beispiel:

#+>

 

 

InvertBooleanCheckpoint

Invertiert einen booleschen Wert (Ja / Nein).

Verwendbar in Kombination mit Elementen des Typs Checkpoint.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Wert

boolean

 
 

Der ursprüngliche boolesche Wert, der invertiert werden soll.

 

Achtung:
Das Invertieren eines booleschen Werts invertiert nicht die Werteerwartung des Elements selbst! Wenn Ja das erwartete Ergebnis des Checkpoint-Elements ist, das durch diese Plug-in-Funktion erweitert wurde, und der Parameter Wert auf Nein gesetzt ist, wird das Element als false / Nein ausgewertet. Stellen Sie sicher, dass Sie die erwarteten Auswertungsergebnisse immer dann überprüfen, wenn Erwarteter Wert und/oder Invertiertes Boolean auf Checkpoint-Elemente angewendet werden!  

 

Optionen:

enabled: wird invertiert zu Nein

disabled: wird invertiert zu Ja

 

 

MatchRegexCheckpoint

Prüft, ob der Text eine Zeichenfolge enthält, die einem bestimmten regulären Ausdruck entspricht. Wenn FailureComment nicht gesetzt ist, wird er automatisch vom Plug-in generiert.

Verwendbar in Kombination mit Elementen des Typs Checkpoint.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

optional
 

Die Zeichenfolge, die auf Übereinstimmung mit dem regulären Ausdruck geprüft wird.

 

Beispiel:

uninst_myApp.lnk

Regulärer Ausdruck

string

Das Muster des regulären Ausdrucks, anhand dessen die Zeichenfolge ausgewertet wird. Das unten angegebene Beispielmuster stimmt mit dem obigen Beispieltext überein.

 

Beispiel:

^unins(|t|tall)\d*\.(cif|cfg|dat|dll|ini|exe|xml|lnk)$

FailureComment

string

optional

Standard: generiert von RayQC

Der Fehlerkommentar, der angezeigt wird, wenn der reguläre Ausdruck nicht mit dem Parameter Text übereinstimmt.

 

tip

Tipp:

Weitere Informationen und Hilfe zur Verwendung regulärer Ausdrücke finden Sie im Abschnitt Reguläre Ausdrücke.

 

 

NumberInRangeCheckpoint

Prüft, ob der Eingabeparameter eine ganze Zahl im angegebenen Bereich ist.

Verwendbar in Kombination mit Elementen des Typs Checkpoint.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

 
 

Die numerische Zeichenfolge, die hinsichtlich ihres ganzzahligen Werts ausgewertet wird.

 

Beispiel:

15

F

HexValue

boolean

optional

Standard: false

Wenn eine Hexadezimalzahl als Eingabeparameterwert angegeben wird, muss diese Option auf true gesetzt werden, um ein gültiges Prüfergebnis zu erzielen.

 

Optionen:

enabled = Kontrollkästchen ist aktiviert: Eingabe wird als Hexadezimalwert ausgewertet.

disabled = Kontrollkästchen ist nicht aktiviert: Eingabe wird als Ganzzahlwert ausgewertet.

Minimum

integer

optional

Standard: keine

Der Mindestwert des geprüften Bereichs (inklusive).

 
Beispiel:

14 führt zur Auswertung als true für den Beispielparameter Text (oben definiert)

 

15 führt zur Auswertung als true für den Beispielparameter Text (oben definiert)

 

16 führt zur Auswertung als false für den Beispielparameter Text (oben definiert)

 

Maximum

integer

optional

Standard: keine

Der Höchstwert des geprüften Bereichs (inklusive).

 
Beispiel:

14 führt zur Auswertung als false für den oben definierten Beispielparameter Text

 

15 führt zur Auswertung als true für den oben definierten Beispielparameter Text

 

16 führt zur Auswertung als true für den oben definierten Beispielparameter Text

 

 

 

StringToStringMulti-OptionData Field

Konvertiert Zeichenfolge zu Zeichenfolge auf Basis zweier synchronisierter Listen. Listen gelten als synchronisiert, wenn sie die gleiche Anzahl von Elementen haben. Diese Funktion kann beispielsweise verwendet werden, um die Ausgabe einer Plug-in-Funktion auf Multi-Option-Werte abzubilden.

Verwendbar in Kombination mit Elementen des Typs Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Umzuwandelnder Wert

formatierte Zeichenfolge

Die Zeichenfolge, die konvertiert wird

 

Beispiel:

There is a bird in the tree.

 

Entsprechend den unten stehenden Beispiellisten wird diese Zeichenfolge in “There is a cat in the house.”

Von

formatierte Zeichenfolge

Die Liste der zu suchenden Zeichenfolgen. Listenelemente müssen durch das Pipe-Zeichen (|) getrennt werden.

 

Beispiel:

Bird|Mouse|Dog|Tree

Nach

string

Die Liste der Zeichenfolgen, die die im Parameter Von definierten Zeichenfolgen ersetzen.

 
Beispiel:

Cat|Home|Fish|House

 

TrimWhitespaceMulti-OptionData Field

Gibt den angegebenen Text mit entfernten Leerzeichen zurück.

Verwendbar in Kombination mit Elementen der Typen Data Field und Multi-Option.

 

Eingabeparameter

Name

Typ

Beschreibung & Beispiele

Text

string

 
 

Die Zeichenfolge, die gekürzt werden soll. Die Beispielzeichenfolge hat sowohl 1 führendes als auch 1 nachfolgendes Leerzeichen.

 

Beispiel:

" This is a sample text! "

TrimStart

boolean

optional

Standard: false

Legt fest, ob führende Leerzeichen entfernt werden sollen oder nicht.

 

Optionen:

enabled = Kontrollkästchen ist aktiv: Führende Leerzeichen werden entfernt.

disabled = Kontrollkästchen ist nicht aktiv: Führende Leerzeichen werden nicht entfernt.

TrimEnd

boolean

optional

Standard: false

Legt fest, ob nachfolgende Leerzeichen entfernt werden sollen oder nicht.

 

Optionen:

enabled = Kontrollkästchen ist aktiv: Nachfolgende Leerzeichen werden entfernt.

disabled = Kontrollkästchen ist nicht aktiv: Nachfolgende Leerzeichen werden nicht entfernt.