Befehlsreferenz

WENN.GLEICH

Befehl Name	WENN.GLEICH
Befehl Beschreibung	Der Befehl vergleicht den Wert von /Wert1 und /Wert2. Wenn diese gleich sind, wird der Scriptablauf mit der nächsten Zeile fortgesetzt. Wenn die Werte verschieden sind, wird der Scriptablauf mit der auf das zugehörige ENDE.WENN folgenden Zeile fortgesetzt.
Befehl Hinweis	ACHTUNG Dieser Befehl benötigt ZWINGEND ein abschließendes ENDE.WENN. Mehrere WENN. Befehle können ineinander geschachtelt verwendet werden. Das Programm erkennt automatisch das zugehörige ENDE.WENN Dieser Vergleich findet „case sensitiv“ statt, dass heißt: Die Groß- und Kleinschreibung wird beachtet !!
Parameter	/Wert1='XXX'
Parameter	/Wert2='XXX'
Parameter (opt.)	/Parameter='XXX'
Rückgabewert (opt.)	Keine Rückgabe definiert.
Änderungen	Keine Änderungen.

Beispiel zum Befehl

WENN.GLEICH

;
; Wenn im Suchbegriff des Artikels "Test" steht, dann soll dieser Artikel im Sel20 
; mit "Testartikel" beschriftet werden
;
Feld.Lesen /IDNr='M.AB.00001' /Tabelle='Artikel' /QuellFeld='SuchBeg' /Rueckgabe='Lok_Var_SuchBeg1';
;
WENN.GLEICH /Wert1='<<Lok_Var_SuchBeg1>>' /Wert2='TEST';
;
Feld.Wert /IDNr='M.AB.00001' /Tabelle='Artikel' /ZielFeld='Sel20' /Wert='Testartikel';
;
ENDE.WENN;

Parameter	/Wert1
Beschreibung	Vergleichswert 1
Hinweis	Bei Verwendung des Parameter in Verzweigungsbefehlen gilt: Die Groß-/Kleinschreibung wird bei Stringvergleichen mit WENN.GLEICH und WENN.UNGLEICH beachtet. Bei den folgenden Verzweigungsfunktionen wird die Groß-/Kleinschreibung nicht beachtet: WENN.ENTHAELT, WENN.NICHTENTHAELT, WENN.BEGINNTMIT, WENN.NICHTBEGINNTMIT, WENN.ENDETMIT, WENN.NICHTENDETMIT.
Hinweis	Bei Verwendung des Parameter in Verzweigungsbefehlen zum Verlgeich von Zahlen gilt: Bei einer WENN.GLEICH oder WENN.UNGLEICH -Verzweigung werden Zahlen als Zeichenketten betrachtet. Für eindeutige Zahlenvergleiche eignen sich die Verzweigungen: WENN.GROESSER, WENN.GROESSERGLEICH, WENN.KLEINER, WENN.KLEINERGLEICH Für den Zahlenvergleich mit WENN.GLEICH oder WENN.UNGLEICH gilt: Ein wertgleicher Zahlenwert einmal als Integer und einmal als Double gilt als ungleich. (z.B. WENN.GLEICH /Wert1='0' /Wert2='0,0';) Für den Zahlenvergleich mit WENN.GROESSER, WENN.GROESSERGLEICH, WENN.KLEINER oder WENN.KLEINERGLEICH gilt: Bei Vergleichswert 1 oder Vergleichswert 2 muss es sich um einen Zahlenwert (Integer oder Double) handeln. Buchstaben oder der Leer-String als Vergleichswert führen zu einem Fehlschlagen des Befehls. (Meldung: ist kein Gleitkommawert). In den übergebenenZahlenwert dürfen keine Tausendertrennzeichen (und Währungssymbole) verwendet werden. Die Verwendung von Tausendertrennzeichen führt zum Fehlschlagen (Meldung: ist kein Gleitkommawert).
Hinweis	Bei Verwendung des Parameter in Verzweigungsbefehlen zum Verlgeich von Datum und Zeit gilt: Für den Datums-/Zeit-Vergleich mit WENN.SPAETER, WENN.SPAETERGLEICH, WENN.FRUEHER oder WENN.FRUEHERGLEICH gilt: Vergleichswert 1 und Vergleichswert 2 müssen nach microtech-Standard formatiert sein (beachte den Datentyp des Feldes). Datum: '01.01.2017' Uhrzeit: '06:30:00' Datum und Zeit: '01.09.2017 12:05:00' Wird ein Wert (NUR Datum) mit einem Wert (DatumZeit) verglichen, so wird die Zeitangabe nicht beachtet. Es werden nur die Datumswerte verglichen. Buchstaben oder der Leer-String als Vergleichswert führen zu einem Fehlschlagen des Befehls. Meldung: ist keine gültige Datums- und Uhrzeitangabe
Fehler	Bei Nichtbeachtung der Hinweise, bei falscher Syntax oder fehlenden Parametern wird der Scipt-Ablauf fehlschlagen.