Variablenscript: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
|||
(10 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
Das Script zum Variablendialog erlaubt es automatisch oder nach Benutzeraktionen den Variablendialog zu steuern und die | Das Script zum Variablendialog erlaubt es automatisch oder nach Benutzeraktionen den Variablendialog zu steuern und die Variablen zu verwalten. | ||
=Steuerfunktionen= | =Steuerfunktionen= | ||
Zeile 16: | Zeile 16: | ||
==Grundfunktionen== | ==Grundfunktionen== | ||
=== | ===Variablen Grundfunktionen=== | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
!Funktion!!Beschreibung!!Beispiel | !Funktion!!Beschreibung!!Beispiel | ||
|- | |- | ||
|<code>AfterEditOf_Variablenname</code>||Wird nach dem Ändern einer Variablen aufgerufen.||void function AfterEditOf_BREITE() | |<code>AfterEditOf_Variablenname</code>||Wird nach dem Ändern einer Variablen aufgerufen.||void function AfterEditOf_BREITE() | ||
Zeile 46: | Zeile 44: | ||
|<code>SelectVariable(string _ep_VarName)</code>||Springt in der Variablenabfrage auf die bestimmte Variable||SelectVariable("M_ZUBEHOER"); | |<code>SelectVariable(string _ep_VarName)</code>||Springt in der Variablenabfrage auf die bestimmte Variable||SelectVariable("M_ZUBEHOER"); | ||
|- | |- | ||
|<code>SetFilter(string _ep_VarName, string _ep_Filter)</code>||Setzt den Datenbankfilter bei der entsprechenden Variablen. Die Variable muss vom Typ „Datenbankzugriff“ sein.Parameter | |<code>SetFilter(string _ep_VarName, string _ep_Filter)</code>||Setzt den Datenbankfilter bei der entsprechenden Variablen. Die Variable muss vom Typ „Datenbankzugriff“ sein. | ||
_ep_VarName: Name der Variablen in Doppelhochkomma. | Parameter: | ||
_ep_VarName: Name der Variablen in Doppelhochkomma. | |||
_ep_Filter: Der where-Teil einer SQL-Querry in Doppelhochkomma. | |||
||SetFilter("ARTIKEL", "M_MATGRUPPE_ID = 1050 and PD_STATUS_ID = 1 and PD_BEZ like '%schrank%'"); | |||
|- | |||
|} | |||
===Menü Grundfunktionen=== | |||
{| class="wikitable" | |||
|- | |||
!Funktion!!Beschreibung!!Beispiel | |||
|- | |||
|<code>HideMenu(string _ep_VarName)</code>||Versteckt das ganze Menü mit den darin enthaltenen Menüs und Variablen||HideMenu("M_ZUBEHOER"); | |||
|- | |||
|<code>ShowMenu(string _ep_VarName)</code>||Blendet das ganze Menü ein||ShowMenu("M_ZUBEHOER"); | |||
|- | |||
|<code>ExpandMenu(string _ep_VarName)</code>||Öffnet ein Menü||ExpandMenu("M_ZUBEHOER"); | |||
|- | |||
|<code>CollapseMenu(string _ep_VarName)</code>||Schliesst ein Menü||CollapseMenu("M_ZUBEHOER"); | |||
|- | |||
|<code>SelectMenu(string _ep_VarName)</code>||Springt in der Variablenabfrage auf das entsprechende Menü.||SelectMenu("M_ZUBEHOER"); | |||
|- | |||
|} | |||
===Funktionen für Scriptvariablen=== | |||
{| class="wikitable" | |||
|- | |||
!Funktion!!Beschreibung!!Beispiel | |||
|- | |||
|<code>OnEdit_Variablenname()</code>||Diese Funktion wird bei Variablen vom Typ Script benötigt. Sie wird ausgeführt, wenn die Variable im Variablendialog aufgerufen wird.||void function OnEdit_BREITE(){ «Script»} | |||
|- | |||
|<code>ShowdetailsOf_Variablenname()</code>||Die angesprochene Variable sollte vom Typ Scriptabfrage sein, wodurch der rechte Fensterbereich ein Infoview wird. Es können mit der Funktion Daten und Zeichnungen im Infoview angezeigt werden. Zum Beispiel können über Scriptvariablen durch Dialoge mehrere Eingaben/Auswahlen getroffen werden und die Zusammenfassung dazu kann im Infoview angezeigt werden.||bool function OnEdit_BREITE(); | |||
void function ShowdetailsOf_BREITE() | |||
{ | |||
SetPosition(5,5); | |||
DrawText("TEST",500); | |||
} | |||
|- | |||
|} | |||
==Erweiterte Steuerfunktionen== | |||
{| class="wikitable" | |||
|- | |||
!Funktion!!Beschreibung!!Beispiel | |||
|- | |||
|<code>SetVariableFromDouble(string __varname, double __val_d);</code>||Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. | |||
Parameter | |||
__varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. | |||
__val_d: Wert vom Typ double, der im angesprochenen Werte-Bereich gesetzt werden soll. | |||
||SetVariableFromDouble("BREITE_STD", 300.5); | |||
|- | |||
|<code>SetVariableFromLong(string __varname, long __val_l);</code>||Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. | |||
Parameter | |||
__varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. | |||
__val_d: Wert vom Typ long, der im angesprochenen Werte-Bereich gesetzt werden soll. | |||
||SetVariableFromLong("BREITE_STD", 300); | |||
|- | |||
|<code>SetVariableFromString(string __varname, string __val_s);</code>||Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. | |||
Parameter | |||
__varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. | |||
__val_d: Wert vom Typ string in Doppelhochkomma, der im angesprochenen Werte-Bereich gesetzt werden soll. | |||
||SetVariableFromString("TABLAR_STD","WERT"); | |||
|- | |||
|} | |||
==Subvariablen-Steuerfunktionen== | |||
{| class="wikitable" | |||
|- | |||
!Funktion!!Beschreibung!!Beispiel | |||
|- | |||
|<code>SetSubVariable(string _ep_SubVarName, string _ep_VarName, string _ep_VarValue)</code>||Setzt einen Wert im angesprochenen Werte-Bereich der Subvariablen. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_VarName: Name der Subvariable in Doppelhochkomma | |||
_ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. | |||
||SetSubVariable("ZUBEHOER", "BREITE_STD", "200"); | |||
|- | |||
|<code>SetVGRVariable(string _ep_VarName, string _ep_VarValue) </code>||Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | |||
Parameter | |||
_ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. | |||
_ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. Die Typkonvertierung erfolgt automatisch. | |||
||SetVGRVariable ("ZUBEHOER.BREITE_STD", "300"); | |||
Das Ergebnis der obigen Funktion entspricht dem Ergebnis folgender Funktion: | |||
SetSubVariable("ZUBEHOER", "BREITE_STD", "300"); | |||
|- | |||
|<code>SetVGRVariableFromString(string _ep_VarName, string _ep_VarValue)</code>||Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | |||
Parameter | |||
_ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. | |||
_ep_VarValue: Wert vom Typ string, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. | |||
||SetVGRVariableFromString ("ZUBEHOER.BREITE_STD", "300"); | |||
|- | |||
|<code>SetVGRVariableFromLong(string _ep_VarName, long _ep_VarValue)</code>||Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | |||
Parameter | |||
_ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. | |||
_ep_VarValue: Wert vom Typ long, der im angesprochenen Werte-Bereich gesetzt werden soll. | |||
||SetVGRVariableFromLong("ZUBEHOER.BREITE_STD", 300); | |||
|- | |||
|<code>SetVGRVariableFromDouble(string _ep_VarName, double _ep_VarValue)</code>||Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehreren Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | |||
Parameter | |||
_ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. | |||
_ep_VarValue: Wert vom Typ double, der im angesprochenen Werte-Bereich gesetzt werden soll. | |||
||SetVGRVariableFromDouble("ZUBEHOER.BREITE_STD", 300.5); | |||
|- | |||
|} | |||
==Parent-Steuerfunktionen== | |||
{| class="wikitable" | |||
|- | |||
!Funktion!!Beschreibung!!Beispiel | |||
|- | |||
|<code>SetParentVariable(string _ep_VarName, string _ep_VarValue)</code>||Setzt einen Wert im angesprochenen Werte-Bereich der Parent-Variablen. | |||
Parameter | |||
_ep_VarName: Name der Variablen mit angeführtem Werte-Bereich der Parent-Variablen, in Doppelhochkomma | |||
_ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. | |||
||SetParentVariable("BREITE_STD", "200"); | |||
|- | |||
|} | |||
=Abfragefunktionen= | |||
==Allgemeine Abfragefunktionen== | |||
{| class="wikitable" | |||
|- | |||
!Funktion!!Beschreibung!!Beispiel | |||
|- | |||
|<code>IsVariableVisible(long _ep_idx)</code>||Zum Abfragen, ob die angesprochene Variable unsichtbar oder sichtbar ist. | |||
||MgB( string(IsVariableVisible(0) ); | |||
Rückgabewert vom Typ long: 0 = Variable ist unsichtbar | |||
1 = Variable ist sichtbar | |||
|- | |||
|<code>IsVariableLocked(long _ep_idx)</code>||Zum Abfragen, ob die angesprochene Variable nicht gesperrt oder gesperrt ist.||MgB( string(IsVariableLocked(0) ); | |||
Rückgabewert vom Typ long: 0 = Variable ist nicht gesperrt | |||
1 = Variable ist gesperrt | |||
|- | |||
|<code>GetVariableIndex(string _ep_VarName)</code>||Gibt die Indexnummer der entsprechenden Variablen wieder.||MgB(string( GetVariableIndex("BREITE") )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetVariableCount()</code>||Gibt die Anzahl der Variablen in der Variablengruppe wieder.||MgB( GetVariableCount() ); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetVariableName(long _ep_idx)</code>||Gibt den Namen der Variablen wieder, welche die entsprechende Indexnummer besitzt. Die fortlaufende Indexnummerierung der Variablengruppe beginnt mit 0.|| | |||
MgB( GetVariableName(0) ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetVariableBez(long _ep_idx)</code>||Gibt die Bezeichnung der Variablen wieder, welche die entsprechende Indexnummer besitzt.||MgB( GetVariableBez(0) ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetVariableId(long _ep_idx)</code>||Gibt die ID der Variablen wieder, welche die entsprechende Indexnummer besitzt.||MgB(string( GetVariableId(0) )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetVariableType(long _ep_idx, long _ep_bereich) </code>||Gibt einen Wert vom Typ long wieder, welcher den Grundtyp der Variable im jeweiligen Werte-Bereich beschreibt. | |||
Parameter | |||
_ep_idx : Indexnummer der Variablen | |||
_ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: | |||
0 = STD | |||
1 = CAD | |||
2 = PE | |||
3 = AV | |||
||MgB( string(GetVariableType(2, 0) ); | |||
Rückgabewert vom Typ long: 0 = keinen Typ definiert | |||
1 = A (alphanummerische Zeichen = string) | |||
2 = I (ganze Zahlen = long) | |||
3 = N (nummerische Zahlen = double) | |||
|- | |||
|<code>GetVariableTypeDynamic(long _ep_idx, long _ep_bereich)</code>||Funktioniert wie GetVariableType, nur wenn im angesprochenen Werte-Bereich kein Typ definiert ist, wird der Typ vom STD-Werte-Bereich wiedergegeben. | |||
|- | |||
|<code>GetVariableTypeDef(long _ep_idx, long _ep_bereich)</code>||Gibt den genauen Wert wieder, welcher den Typ der Variable im jeweiligen Werte-Bereich beschreibt. | |||
Parameter | |||
_ep_idx : Indexnummer der Variablen | |||
_ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: | |||
0 = STD | |||
1 = CAD | |||
2 = PE | |||
3 = AV | |||
||MgB( string(GetVariableTypeDef(2, 0) ); | |||
Rückgabewert vom Typ string, zum Beispiel: | |||
A30 | |||
N10.2 | |||
I | |||
|- | |||
|<code>GetVariableDBTable(long _ep_idx)</code>||Gibt den/die Tabellennamen-Feld der Variablen wieder. Die Variable muss vom Typ Datenbankzugriff sein. | |||
||MgB( GetVariableDBTable(4) ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetVariableDBFilter(long _ep_idx)</code>||Gibt das Filter-Feld der Variablen wieder. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Filter-Feld der Variablen in der Variablendefinition enthalten ist. Wird ein Filter per Script mit SetFilter gesetzt, wird dieser nicht wiedergegeben. | |||
||MgB( GetVariableDBFilter(4) ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetVariableDBSearchField(long _ep_idx)</code>||Gibt das Suchfeld der Variablen wieder. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Suchfeld der Variablen in der Variablendefinition enthalten ist. | |||
||MgB( GetVariableDBSearchField(4) ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetVariableAsLong(string __VarName)</code>||Gibt den Wert der Variablen im angegebenen Werte-Bereich als long wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB(string( GetVariableAsLong("BREITE_STD") )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetVariableAsDouble(string __VarName)</code>||Gibt den Wert der Variablen im angegebenen Werte-Bereich als double wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB(string( GetVariableAsDouble("BREITE_STD") )); | |||
Rückgabewert vom Typ double. | |||
|- | |||
|<code>GetVariableAsString(string __VarName)</code>||Gibt den Wert der Variablen im angegebenen Werte-Bereich als string wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB( GetVariableAsString("BREITE_STD") ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|} | |||
==SubVariablen-Abfragefunktionen== | |||
{| class="wikitable" | |||
|- | |||
!Funktion!!Beschreibung!!Beispiel | |||
|- | |||
|<code>HasSubVariables(string _ep_SubVarName)</code>||Überprüft, ob in der angesprochenen Variablen Subvariablen enthalten sind. | |||
||MgB(string( HasSubVariables("ZUBEHOER") )); | |||
Rückgabewert vom Typ long: | |||
0 = es sind keine Subvariablen enthalten | |||
1 = es sind Subvariablen enthalten | |||
|- | |||
|<code>GetSubVariableCount(string _ep_SubVarName)</code>||Gibt die Anzahl der enthaltenen Subvariablen in der angesprochenen Variablen wieder (Anzahl Variablen im angesprochenen Artikel). | |||
||MgB(string( GetSubVariableCount("ZUBEHOER") )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetSubVariableName(string _ep_SubVarName, long _ep_idx)</code>||Gibt den Namen der angesprochenen Subvariablen mit der entsprechenden Indexnummer wieder. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_idx : Indexnummer der Subvariablen | |||
||MgB(string( GetSubVariableName("ZUBEHOER",2) )); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetSubVariableBez(string _ep_SubVarName, long _ep_idx)</code>||Gibt die Bezeichnung der angesprochenen Subvariablen mit der entsprechenden Indexnummer wieder. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_idx : Indexnummer der Subvariablen | |||
||MgB(string( GetSubVariableBez("ZUBEHOER",2) )); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetSubVariableId(string _ep_SubVarName, long _ep_idx)</code>||Gibt die Variablen-ID der angesprochenen Subvariablen mit der entsprechenden Indexnummer wieder. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_idx : Indexnummer der Subvariablen | |||
||MgB(string( GetSubVariableId("ZUBEHOER",2) )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetSubVariableType(string _ep_SubVarName, long _ep_idx, long _ep_bereich)</code>||Gibt einen Wert vom Typ long wieder, welcher den Grundtyp der Subvariable im jeweiligen Werte-Bereich beschreibt. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_idx : Indexnummer der Subvariablen | |||
_ep_bereich: Werte-Bereich der Subvariablen, der angesprochen werden soll: | |||
0 = STD | |||
1 = CAD | |||
2 = PE | |||
3 = AV | |||
||MgB(string( GetSubVariableType("ZUBEHOER", 2, 0) ); | |||
Rückgabewert vom Typ long: | |||
0 = keinen Typ definiert | |||
1 = A (alphanummerische Zeichen = string) | |||
2 = I (ganze Zahlen = long) | |||
3 = N (nummerische Zahlen = double) | |||
|- | |||
|<code>GetSubVariableTypeDynamic(string _ep_SubVarName, long _ep_idx, long _ep_bereich)</code>||Funktioniert wie GetSubVariableType, nur wenn im angesprochenen Werte-Bereich kein Typ definiert ist, wird der Typ vom STD-Werte-Bereich wiedergegeben. | |||
|- | |||
|<code>GetSubVariableTypeDef(string _ep_SubVarName, long _ep_idx, long _ep_bereich) </code>||Gibt einen Wert wieder, welcher den Typ der Subvariablen im jeweiligen Werte-Werte-Bereich beschreibt. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_idx : Indexnummer der Subvariablen | |||
_ep_bereich: Werte-Bereich der Subvariablen, der angesprochen werden soll: | |||
0 = STD | |||
1 = CAD | |||
2 = PE | |||
3 = AV | |||
||MgB(string( GetSubVariableTypeDef("ZUBEHOER", 2, 0) ); | |||
Rückgabewert vom Typ string, zum Beispiel: | |||
A30 | |||
N10.2 | |||
I | |||
|- | |||
|<code>GetSubVariableDBTable(string _ep_SubVarName, long _ep_idx)</code>||Gibt den/die Tabellennamen der angesprochenen Subvariablen wieder. Die Subvariable muss vom Typ Datenbankzugriff sein. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_idx : Indexnummer der Subvariablen | |||
||MgB(string( GetSubVariableDBTable("ZUBEHOER",4) )); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetSubVariableDBFilter(string _ep_SubVarName, long _ep_idx)</code>||Gibt das Filter-Feld der angesprochenen Subvariablen wieder. Die Subvariable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Filter-Feld der Subvariablen in der Variablendefinition enthalten ist. Wird ein Filter per Script mit SetFilter gesetzt, wird dieser nicht wiedergegeben. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_idx : Indexnummer der Subvariablen | |||
||MgB(string( GetSubVariableDBTable("ZUBEHOER",4) )); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetSubVariableDBSearchField(string _ep_SubVarName, long _ep_idx)</code>||Gibt das Suchfeld der angesprochenen Subvariablen wieder. Die Subvariable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Suchfeld der Subvariablen in der Variablendefinition enthalten ist. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_idx : Indexnummer der Subvariablen | |||
||MgB(string( GetSubVariableDBTable("ZUBEHOER",4) )); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetSubVariableIndex(string _ep_SubVarName, string _ep_VarName)</code>||Gibt die Indexnummer der angesprochenen Subvariablen wieder. | |||
Parameter | |||
_ep_SubVarName: Name der Variablen in Doppelhochkomma | |||
_ep_VarName: Name der Subvariablen in Doppelhochkomma | |||
||MgB(string( GetSubVariableIndex("SUB","HO") )); | |||
Rückgabewert vom Typ long (-1 = keine Subvariable definiert oder keine Variable mit dem entsprechenden Variablennamen vorhanden). | |||
|- | |||
|<code>GetSubVariableAsLong(string _ep_SubVarName, string _ep_VarName)</code>||Gibt den Wert der Subvariablen im angegebenen Werte-Bereich als long wieder. Der Variablennamen und der Subvariablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB(string( GetSubVariableAsLong("ZUBEHOER", "BREITE_STD") )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetSubVariableAsDouble(string _ep_SubVarName, string _ep_VarName)</code>||Gibt den Wert der Subvariablen im angegebenen Werte-Bereich als double wieder. Der Variablennamen und der Subvariablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB(string( GetSubVariableAsDouble("ZUBEHOER", "BREITE_STD") )); | |||
Rückgabewert vom Typ double. | |||
|- | |||
|<code>GetSubVariableAsString(string _ep_SubVarName, string _ep_VarName)</code>||Gibt den Wert der Subvariablen im angegebenen Werte-Bereich als string wieder. Der Variablennamen und der Subvariablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB( GetSubVariableAsString("ZUBEHOER", "BREITE_STD") ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetVGRVariableAsLong(string _ep_VarName)</code>||Gibt einen Wert im angesprochenen Werte-Bereich der Variablen wieder. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) wiedergegeben werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | |||
||MgB(string( GetVGRVariableAsLong("ZUBEHOER.BREITE_STD") )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetVGRVariableAsDouble(string _ep_VarName)</code>||Gibt einen Wert im angesprochenen Werte-Bereich der Variablen wieder. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) wiedergegeben werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | |||
||MgB(string( GetVGRVariableAsDouble("ZUBEHOER.BREITE_STD") )); | |||
Rückgabewert vom Typ double. | |||
|- | |||
|<code>GetVGRVariableAsString(string_ep_VarName) </code>||Gibt einen Wert im angesprochenen Werte-Bereich der Variablen wieder. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) wiedergegeben werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | |||
||MgB(GetVGRVariableAsString("ZUBEHOER.BREITE_STD") ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|} | |||
==Parent-Abfragefunktionen== | |||
{| class="wikitable" | |||
|- | |||
!Funktion!!Beschreibung!!Shortcut | |||
|- | |||
|<code>HasParentVariables() </code>||Überprüft, ob die aktuelle Variablengruppe eine Subvariablengruppe ist. | |||
||MgB(string( HasParentVariables() )); | |||
Rückgabewert vom Typ long: | |||
0 = die Variablengruppe ist keine Subvariablengruppe | |||
1 = die Variablengruppe ist eine Subvariablengruppe | |||
|- | |||
|<code>GetParentVariableCount()</code>||Gibt die Anzahl der Variablen in der Parent-Variablengruppe wieder. | |||
||MgB(string( GetParentVariableCount() )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetParentVariableName(long _ep_idx)</code>||Gibt den Variablennamen mit der angesprochenen Indexnummer von der Parent-Variablengruppe wieder. | |||
||MgB(string( GetParentVariableName(1) )); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetParentVariableBez(long _ep_idx)</code>||Gibt die Variablenbezeichnung mit der angesprochenen Indexnummer von der Parent-Variablengruppe wieder. | |||
||MgB(string( GetParentVariableBez(1) )); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetParentVariableId(long _ep_idx)</code>||Gibt die VariablenID von der angesprochenen Indexnummer der Parent-Variablengruppe wieder. | |||
||MgB(string( GetParentVariableId(1) )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetParentVariableType(long _ep_idx, long _ep_bereich)</code>||Gibt einen Wert vom Typ long wieder, welcher den Grundtyp der Variablen im jeweiligen Werte-Bereich von der Parent-Variablengruppe beschreibt. | |||
Parameter | |||
_ep_idx : Indexnummer der Variablen von der Parent-Variablengruppe | |||
_ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: | |||
0 = STD | |||
1 = CAD | |||
2 = PE | |||
3 = AV | |||
||MgB(string( GetParentVariableType(1, 0) )); | |||
Rückgabewert vom Typ long: | |||
0 = keinen Typ definiert | |||
1 = A (alphanummerische Zeichen = string) | |||
2 = I (ganze Zahlen = long) | |||
3 = N (nummerische Zahlen = double) | |||
|- | |||
|<code>GetParentVariableTypeDynamic(long _ep_idx, long _ep_bereich)</code>||Funktioniert wie GetParentVariableType, nur wenn im angesprochenen Werte-Bereich kein Typ definiert ist, wird der Typ vom STD-Werte-Bereich wiedergegeben. | |||
|- | |||
|<code>GetParentVariableTypeDef(long _ep_idx, long _ep_bereich)</code>||Gibt einen Wert wieder, welcher den Typ der Variable im jeweiligen Werte-Bereich von der Parent-Variablengruppe beschreibt. | |||
Parameter | |||
_ep_idx : Indexnummer der Variablen von der Parent-Variablengruppe | |||
_ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: | |||
0 = STD | |||
1 = CAD | |||
2 = PE | |||
3 = AV | |||
||MgB( GetParentVariableTypeDef(1, 0) ); | |||
Rückgabewert vom Typ string, zum Beispiel: | |||
A30 | |||
N10.2 | |||
I | |||
|- | |||
|<code>GetParentVariableDBTable(long _ep_idx)</code>||Gibt den/die Tabellennamen der angesprochenen Variablen von der Parent-Variablengruppe wieder. Die Variable muss vom Typ Datenbankzugriff sein. | |||
||MgB( GetParentVariableDBTable(5) ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetParentVariableDBFilter(long _ep_idx)</code>||Gibt das Filter-Feld der angesprochenen Variablen von der Parent-Variablengruppe wieder. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Filter-Feld der Variablen in der Variablendefinition enthalten ist. Wird ein Filter per Script mit SetFilter gesetzt, wird dieser nicht wiedergegeben. | |||
||MgB( GetParentVariableDBFilter(5) ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetParentVariableDBSearchField(long _ep_idx)</code>||Gibt das Suchfeld der angesprochenen Variablen von der Parent-Variablengruppe wieder. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Suchfeld der Variablen in der Variablendefinition enthalten ist. | |||
||MgB(string( GetSubVariableDBTable("ZUBEHOER",4) )); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|<code>GetParentVariableIndex(string _ep_VarName)</code>||Gibt die Indexnummer der angesprochenen Variablen von der Parent-Variablengruppe wieder. | |||
||MgB(string( GetParentVariableIndex("ZUBEHOER") )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetParentVariableAsLong(string _ep_VarName) </code>||Gibt den Wert der Variablen im angegebenen Werte-Bereich als long von der Parent-Variablengruppe wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB(string( GetParentVariableAsLong("BREITE_STD") )); | |||
Rückgabewert vom Typ long. | |||
|- | |||
|<code>GetParentVariableAsDouble(string _ep_VarName)</code>||Gibt den Wert der Variablen im angegebenen Werte-Bereich als double von der Parent-Variablengruppe wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB(string( GetParentVariableAsDouble("BREITE_STD") )); | |||
Rückgabewert vom Typ double. | |||
|- | |||
|<code>GetParentVariableAsString(string _ep_VarName)</code>||Gibt den Wert der Variablen im angegebenen Werte-Bereich als string von der Parent-Variablengruppe wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | |||
||MgB( GetParentVariableAsString("ZUBEHOER_STD") ); | |||
Rückgabewert vom Typ string. | |||
|- | |||
|} | |||
=Globale Variablen für den Variablendialog= | |||
{| class="wikitable" | |||
|- | |||
!Variable!!Beschreibung | |||
|- | |||
|<code>current_vgr_id</code>||Gibt die ID der aktuellen Variablengruppe wieder. | |||
|- | |||
|<code>current_variable</code>||Gibt den Namen der aktuellen Variable wieder. | |||
|- | |||
|<code>vgr_pd_id</code>||Gibt die PD_ID des aktuellen Artikels zurück dem die Variablengruppe zugeordnet ist. | |||
|- | |- | ||
|} | |} |
Aktuelle Version vom 13. Februar 2017, 10:04 Uhr
Das Script zum Variablendialog erlaubt es automatisch oder nach Benutzeraktionen den Variablendialog zu steuern und die Variablen zu verwalten.
Steuerfunktionen
Ereignisgrundfunktionen des Variablendialogs
Funktion | Beschreibung | Beispiel |
---|---|---|
function Init() |
Wird beim Öffnen des Variablendialogs aufgerufen. | void function Init(){ «Script»} |
function Exit() |
Wird beim Schliessen des Variablendialogs aufgerufen. Die Funktion muss true zurück geben ansonsten wird der Variablendialog nicht geschlosen. Dies dient zur Prüfung der Variablenwerte ob diese Konsistent sind. | bool function Exit(){ «Script» return true;} |
Grundfunktionen
Variablen Grundfunktionen
Funktion | Beschreibung | Beispiel |
---|---|---|
AfterEditOf_Variablenname |
Wird nach dem Ändern einer Variablen aufgerufen. | void function AfterEditOf_BREITE()
{ «Script» } |
AfterEditOfUnhandledVariable() |
Wird nach dem Ändern einer Variablen aufgerufen, für die kein AfterEditOf definiert ist. | void function AfterEditOfUnhandledVariable()
{ «Script» } |
LockVariable(string _ep_VarName) |
Sperrt die entsprechende Variable. Es können keine Werte mehr gesetzt werden. |
LockVariable("BREITE"); |
UnlockVariable(string _ep_VarName) |
Entsperrt die entsprechende Variable. Es können wieder Werte gesetzt werden. | UnlockVariable("BREITE"); |
HideVariable(string _ep_VarName) |
Blendet die entsprechende Variable aus. | HideVariable("BREITE"); |
ShowVariable(string _ep_VarName) |
Blendet die entsprechende Variable ein. | ShowVariable("BREITE"); |
SelectVariable(string _ep_VarName) |
Springt in der Variablenabfrage auf die bestimmte Variable | SelectVariable("M_ZUBEHOER"); |
SetFilter(string _ep_VarName, string _ep_Filter) |
Setzt den Datenbankfilter bei der entsprechenden Variablen. Die Variable muss vom Typ „Datenbankzugriff“ sein.
Parameter: _ep_VarName: Name der Variablen in Doppelhochkomma. _ep_Filter: Der where-Teil einer SQL-Querry in Doppelhochkomma. |
SetFilter("ARTIKEL", "M_MATGRUPPE_ID = 1050 and PD_STATUS_ID = 1 and PD_BEZ like '%schrank%'"); |
Menü Grundfunktionen
Funktion | Beschreibung | Beispiel |
---|---|---|
HideMenu(string _ep_VarName) |
Versteckt das ganze Menü mit den darin enthaltenen Menüs und Variablen | HideMenu("M_ZUBEHOER"); |
ShowMenu(string _ep_VarName) |
Blendet das ganze Menü ein | ShowMenu("M_ZUBEHOER"); |
ExpandMenu(string _ep_VarName) |
Öffnet ein Menü | ExpandMenu("M_ZUBEHOER"); |
CollapseMenu(string _ep_VarName) |
Schliesst ein Menü | CollapseMenu("M_ZUBEHOER"); |
SelectMenu(string _ep_VarName) |
Springt in der Variablenabfrage auf das entsprechende Menü. | SelectMenu("M_ZUBEHOER"); |
Funktionen für Scriptvariablen
Funktion | Beschreibung | Beispiel |
---|---|---|
OnEdit_Variablenname() |
Diese Funktion wird bei Variablen vom Typ Script benötigt. Sie wird ausgeführt, wenn die Variable im Variablendialog aufgerufen wird. | void function OnEdit_BREITE(){ «Script»} |
ShowdetailsOf_Variablenname() |
Die angesprochene Variable sollte vom Typ Scriptabfrage sein, wodurch der rechte Fensterbereich ein Infoview wird. Es können mit der Funktion Daten und Zeichnungen im Infoview angezeigt werden. Zum Beispiel können über Scriptvariablen durch Dialoge mehrere Eingaben/Auswahlen getroffen werden und die Zusammenfassung dazu kann im Infoview angezeigt werden. | bool function OnEdit_BREITE();
void function ShowdetailsOf_BREITE() { SetPosition(5,5); DrawText("TEST",500); } |
Erweiterte Steuerfunktionen
Funktion | Beschreibung | Beispiel |
---|---|---|
SetVariableFromDouble(string __varname, double __val_d); |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen.
Parameter __varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. __val_d: Wert vom Typ double, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVariableFromDouble("BREITE_STD", 300.5); |
SetVariableFromLong(string __varname, long __val_l); |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen.
Parameter __varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. __val_d: Wert vom Typ long, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVariableFromLong("BREITE_STD", 300); |
SetVariableFromString(string __varname, string __val_s); |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen.
Parameter __varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. __val_d: Wert vom Typ string in Doppelhochkomma, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVariableFromString("TABLAR_STD","WERT"); |
Subvariablen-Steuerfunktionen
Funktion | Beschreibung | Beispiel |
---|---|---|
SetSubVariable(string _ep_SubVarName, string _ep_VarName, string _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Subvariablen.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_VarName: Name der Subvariable in Doppelhochkomma _ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. |
SetSubVariable("ZUBEHOER", "BREITE_STD", "200"); |
SetVGRVariable(string _ep_VarName, string _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. _ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. Die Typkonvertierung erfolgt automatisch. |
SetVGRVariable ("ZUBEHOER.BREITE_STD", "300");
Das Ergebnis der obigen Funktion entspricht dem Ergebnis folgender Funktion: SetSubVariable("ZUBEHOER", "BREITE_STD", "300"); |
SetVGRVariableFromString(string _ep_VarName, string _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. _ep_VarValue: Wert vom Typ string, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. |
SetVGRVariableFromString ("ZUBEHOER.BREITE_STD", "300"); |
SetVGRVariableFromLong(string _ep_VarName, long _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. _ep_VarValue: Wert vom Typ long, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVGRVariableFromLong("ZUBEHOER.BREITE_STD", 300); |
SetVGRVariableFromDouble(string _ep_VarName, double _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehreren Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. _ep_VarValue: Wert vom Typ double, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVGRVariableFromDouble("ZUBEHOER.BREITE_STD", 300.5); |
Parent-Steuerfunktionen
Funktion | Beschreibung | Beispiel |
---|---|---|
SetParentVariable(string _ep_VarName, string _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Parent-Variablen.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich der Parent-Variablen, in Doppelhochkomma _ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. |
SetParentVariable("BREITE_STD", "200"); |
Abfragefunktionen
Allgemeine Abfragefunktionen
Funktion | Beschreibung | Beispiel |
---|---|---|
IsVariableVisible(long _ep_idx) |
Zum Abfragen, ob die angesprochene Variable unsichtbar oder sichtbar ist. | MgB( string(IsVariableVisible(0) );
Rückgabewert vom Typ long: 0 = Variable ist unsichtbar 1 = Variable ist sichtbar |
IsVariableLocked(long _ep_idx) |
Zum Abfragen, ob die angesprochene Variable nicht gesperrt oder gesperrt ist. | MgB( string(IsVariableLocked(0) );
Rückgabewert vom Typ long: 0 = Variable ist nicht gesperrt 1 = Variable ist gesperrt |
GetVariableIndex(string _ep_VarName) |
Gibt die Indexnummer der entsprechenden Variablen wieder. | MgB(string( GetVariableIndex("BREITE") ));
Rückgabewert vom Typ long. |
GetVariableCount() |
Gibt die Anzahl der Variablen in der Variablengruppe wieder. | MgB( GetVariableCount() );
Rückgabewert vom Typ long. |
GetVariableName(long _ep_idx) |
Gibt den Namen der Variablen wieder, welche die entsprechende Indexnummer besitzt. Die fortlaufende Indexnummerierung der Variablengruppe beginnt mit 0. |
MgB( GetVariableName(0) ); Rückgabewert vom Typ string. |
GetVariableBez(long _ep_idx) |
Gibt die Bezeichnung der Variablen wieder, welche die entsprechende Indexnummer besitzt. | MgB( GetVariableBez(0) );
|
GetVariableId(long _ep_idx) |
Gibt die ID der Variablen wieder, welche die entsprechende Indexnummer besitzt. | MgB(string( GetVariableId(0) ));
Rückgabewert vom Typ long. |
GetVariableType(long _ep_idx, long _ep_bereich) |
Gibt einen Wert vom Typ long wieder, welcher den Grundtyp der Variable im jeweiligen Werte-Bereich beschreibt.
Parameter _ep_idx : Indexnummer der Variablen _ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: 0 = STD 1 = CAD 2 = PE 3 = AV |
MgB( string(GetVariableType(2, 0) );
Rückgabewert vom Typ long: 0 = keinen Typ definiert 1 = A (alphanummerische Zeichen = string) 2 = I (ganze Zahlen = long) 3 = N (nummerische Zahlen = double)
|
GetVariableTypeDynamic(long _ep_idx, long _ep_bereich) |
Funktioniert wie GetVariableType, nur wenn im angesprochenen Werte-Bereich kein Typ definiert ist, wird der Typ vom STD-Werte-Bereich wiedergegeben. | |
GetVariableTypeDef(long _ep_idx, long _ep_bereich) |
Gibt den genauen Wert wieder, welcher den Typ der Variable im jeweiligen Werte-Bereich beschreibt.
Parameter _ep_idx : Indexnummer der Variablen _ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: 0 = STD 1 = CAD 2 = PE 3 = AV |
MgB( string(GetVariableTypeDef(2, 0) );
Rückgabewert vom Typ string, zum Beispiel: A30 N10.2 I |
GetVariableDBTable(long _ep_idx) |
Gibt den/die Tabellennamen-Feld der Variablen wieder. Die Variable muss vom Typ Datenbankzugriff sein. | MgB( GetVariableDBTable(4) );
Rückgabewert vom Typ string. |
GetVariableDBFilter(long _ep_idx) |
Gibt das Filter-Feld der Variablen wieder. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Filter-Feld der Variablen in der Variablendefinition enthalten ist. Wird ein Filter per Script mit SetFilter gesetzt, wird dieser nicht wiedergegeben. | MgB( GetVariableDBFilter(4) );
Rückgabewert vom Typ string.
|
GetVariableDBSearchField(long _ep_idx) |
Gibt das Suchfeld der Variablen wieder. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Suchfeld der Variablen in der Variablendefinition enthalten ist. | MgB( GetVariableDBSearchField(4) );
Rückgabewert vom Typ string. |
GetVariableAsLong(string __VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als long wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB(string( GetVariableAsLong("BREITE_STD") ));
Rückgabewert vom Typ long. |
GetVariableAsDouble(string __VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als double wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB(string( GetVariableAsDouble("BREITE_STD") ));
Rückgabewert vom Typ double. |
GetVariableAsString(string __VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als string wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB( GetVariableAsString("BREITE_STD") );
Rückgabewert vom Typ string. |
SubVariablen-Abfragefunktionen
Funktion | Beschreibung | Beispiel |
---|---|---|
HasSubVariables(string _ep_SubVarName) |
Überprüft, ob in der angesprochenen Variablen Subvariablen enthalten sind. | MgB(string( HasSubVariables("ZUBEHOER") ));
Rückgabewert vom Typ long: 0 = es sind keine Subvariablen enthalten 1 = es sind Subvariablen enthalten |
GetSubVariableCount(string _ep_SubVarName) |
Gibt die Anzahl der enthaltenen Subvariablen in der angesprochenen Variablen wieder (Anzahl Variablen im angesprochenen Artikel). | MgB(string( GetSubVariableCount("ZUBEHOER") ));
Rückgabewert vom Typ long. |
GetSubVariableName(string _ep_SubVarName, long _ep_idx) |
Gibt den Namen der angesprochenen Subvariablen mit der entsprechenden Indexnummer wieder.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_idx : Indexnummer der Subvariablen |
MgB(string( GetSubVariableName("ZUBEHOER",2) ));
Rückgabewert vom Typ string. |
GetSubVariableBez(string _ep_SubVarName, long _ep_idx) |
Gibt die Bezeichnung der angesprochenen Subvariablen mit der entsprechenden Indexnummer wieder.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_idx : Indexnummer der Subvariablen |
MgB(string( GetSubVariableBez("ZUBEHOER",2) ));
Rückgabewert vom Typ string. |
GetSubVariableId(string _ep_SubVarName, long _ep_idx) |
Gibt die Variablen-ID der angesprochenen Subvariablen mit der entsprechenden Indexnummer wieder.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_idx : Indexnummer der Subvariablen |
MgB(string( GetSubVariableId("ZUBEHOER",2) ));
Rückgabewert vom Typ long. |
GetSubVariableType(string _ep_SubVarName, long _ep_idx, long _ep_bereich) |
Gibt einen Wert vom Typ long wieder, welcher den Grundtyp der Subvariable im jeweiligen Werte-Bereich beschreibt.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_idx : Indexnummer der Subvariablen _ep_bereich: Werte-Bereich der Subvariablen, der angesprochen werden soll: 0 = STD 1 = CAD 2 = PE 3 = AV |
MgB(string( GetSubVariableType("ZUBEHOER", 2, 0) );
Rückgabewert vom Typ long: 0 = keinen Typ definiert 1 = A (alphanummerische Zeichen = string) 2 = I (ganze Zahlen = long) 3 = N (nummerische Zahlen = double) |
GetSubVariableTypeDynamic(string _ep_SubVarName, long _ep_idx, long _ep_bereich) |
Funktioniert wie GetSubVariableType, nur wenn im angesprochenen Werte-Bereich kein Typ definiert ist, wird der Typ vom STD-Werte-Bereich wiedergegeben. | |
GetSubVariableTypeDef(string _ep_SubVarName, long _ep_idx, long _ep_bereich) |
Gibt einen Wert wieder, welcher den Typ der Subvariablen im jeweiligen Werte-Werte-Bereich beschreibt.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_idx : Indexnummer der Subvariablen _ep_bereich: Werte-Bereich der Subvariablen, der angesprochen werden soll: 0 = STD 1 = CAD 2 = PE 3 = AV |
MgB(string( GetSubVariableTypeDef("ZUBEHOER", 2, 0) );
Rückgabewert vom Typ string, zum Beispiel: A30 N10.2 I |
GetSubVariableDBTable(string _ep_SubVarName, long _ep_idx) |
Gibt den/die Tabellennamen der angesprochenen Subvariablen wieder. Die Subvariable muss vom Typ Datenbankzugriff sein.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_idx : Indexnummer der Subvariablen |
MgB(string( GetSubVariableDBTable("ZUBEHOER",4) ));
Rückgabewert vom Typ string. |
GetSubVariableDBFilter(string _ep_SubVarName, long _ep_idx) |
Gibt das Filter-Feld der angesprochenen Subvariablen wieder. Die Subvariable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Filter-Feld der Subvariablen in der Variablendefinition enthalten ist. Wird ein Filter per Script mit SetFilter gesetzt, wird dieser nicht wiedergegeben.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_idx : Indexnummer der Subvariablen |
MgB(string( GetSubVariableDBTable("ZUBEHOER",4) ));
Rückgabewert vom Typ string. |
GetSubVariableDBSearchField(string _ep_SubVarName, long _ep_idx) |
Gibt das Suchfeld der angesprochenen Subvariablen wieder. Die Subvariable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Suchfeld der Subvariablen in der Variablendefinition enthalten ist.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_idx : Indexnummer der Subvariablen |
MgB(string( GetSubVariableDBTable("ZUBEHOER",4) ));
Rückgabewert vom Typ string. |
GetSubVariableIndex(string _ep_SubVarName, string _ep_VarName) |
Gibt die Indexnummer der angesprochenen Subvariablen wieder.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_VarName: Name der Subvariablen in Doppelhochkomma |
MgB(string( GetSubVariableIndex("SUB","HO") ));
Rückgabewert vom Typ long (-1 = keine Subvariable definiert oder keine Variable mit dem entsprechenden Variablennamen vorhanden). |
GetSubVariableAsLong(string _ep_SubVarName, string _ep_VarName) |
Gibt den Wert der Subvariablen im angegebenen Werte-Bereich als long wieder. Der Variablennamen und der Subvariablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB(string( GetSubVariableAsLong("ZUBEHOER", "BREITE_STD") ));
Rückgabewert vom Typ long. |
GetSubVariableAsDouble(string _ep_SubVarName, string _ep_VarName) |
Gibt den Wert der Subvariablen im angegebenen Werte-Bereich als double wieder. Der Variablennamen und der Subvariablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB(string( GetSubVariableAsDouble("ZUBEHOER", "BREITE_STD") ));
Rückgabewert vom Typ double. |
GetSubVariableAsString(string _ep_SubVarName, string _ep_VarName) |
Gibt den Wert der Subvariablen im angegebenen Werte-Bereich als string wieder. Der Variablennamen und der Subvariablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB( GetSubVariableAsString("ZUBEHOER", "BREITE_STD") );
Rückgabewert vom Typ string. |
GetVGRVariableAsLong(string _ep_VarName) |
Gibt einen Wert im angesprochenen Werte-Bereich der Variablen wieder. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) wiedergegeben werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | MgB(string( GetVGRVariableAsLong("ZUBEHOER.BREITE_STD") ));
Rückgabewert vom Typ long. |
GetVGRVariableAsDouble(string _ep_VarName) |
Gibt einen Wert im angesprochenen Werte-Bereich der Variablen wieder. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) wiedergegeben werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | MgB(string( GetVGRVariableAsDouble("ZUBEHOER.BREITE_STD") ));
Rückgabewert vom Typ double. |
GetVGRVariableAsString(string_ep_VarName) |
Gibt einen Wert im angesprochenen Werte-Bereich der Variablen wieder. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) wiedergegeben werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss. | MgB(GetVGRVariableAsString("ZUBEHOER.BREITE_STD") );
Rückgabewert vom Typ string. |
Parent-Abfragefunktionen
Funktion | Beschreibung | Shortcut |
---|---|---|
HasParentVariables() |
Überprüft, ob die aktuelle Variablengruppe eine Subvariablengruppe ist. | MgB(string( HasParentVariables() ));
Rückgabewert vom Typ long: 0 = die Variablengruppe ist keine Subvariablengruppe 1 = die Variablengruppe ist eine Subvariablengruppe |
GetParentVariableCount() |
Gibt die Anzahl der Variablen in der Parent-Variablengruppe wieder. | MgB(string( GetParentVariableCount() ));
Rückgabewert vom Typ long. |
GetParentVariableName(long _ep_idx) |
Gibt den Variablennamen mit der angesprochenen Indexnummer von der Parent-Variablengruppe wieder. | MgB(string( GetParentVariableName(1) ));
Rückgabewert vom Typ string. |
GetParentVariableBez(long _ep_idx) |
Gibt die Variablenbezeichnung mit der angesprochenen Indexnummer von der Parent-Variablengruppe wieder. | MgB(string( GetParentVariableBez(1) ));
Rückgabewert vom Typ string. |
GetParentVariableId(long _ep_idx) |
Gibt die VariablenID von der angesprochenen Indexnummer der Parent-Variablengruppe wieder. | MgB(string( GetParentVariableId(1) ));
Rückgabewert vom Typ long. |
GetParentVariableType(long _ep_idx, long _ep_bereich) |
Gibt einen Wert vom Typ long wieder, welcher den Grundtyp der Variablen im jeweiligen Werte-Bereich von der Parent-Variablengruppe beschreibt.
Parameter _ep_idx : Indexnummer der Variablen von der Parent-Variablengruppe _ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: 0 = STD 1 = CAD 2 = PE 3 = AV |
MgB(string( GetParentVariableType(1, 0) ));
Rückgabewert vom Typ long: 0 = keinen Typ definiert 1 = A (alphanummerische Zeichen = string) 2 = I (ganze Zahlen = long) 3 = N (nummerische Zahlen = double) |
GetParentVariableTypeDynamic(long _ep_idx, long _ep_bereich) |
Funktioniert wie GetParentVariableType, nur wenn im angesprochenen Werte-Bereich kein Typ definiert ist, wird der Typ vom STD-Werte-Bereich wiedergegeben. | |
GetParentVariableTypeDef(long _ep_idx, long _ep_bereich) |
Gibt einen Wert wieder, welcher den Typ der Variable im jeweiligen Werte-Bereich von der Parent-Variablengruppe beschreibt.
Parameter _ep_idx : Indexnummer der Variablen von der Parent-Variablengruppe _ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: 0 = STD 1 = CAD 2 = PE 3 = AV |
MgB( GetParentVariableTypeDef(1, 0) );
Rückgabewert vom Typ string, zum Beispiel: A30 N10.2 I |
GetParentVariableDBTable(long _ep_idx) |
Gibt den/die Tabellennamen der angesprochenen Variablen von der Parent-Variablengruppe wieder. Die Variable muss vom Typ Datenbankzugriff sein. | MgB( GetParentVariableDBTable(5) );
Rückgabewert vom Typ string. |
GetParentVariableDBFilter(long _ep_idx) |
Gibt das Filter-Feld der angesprochenen Variablen von der Parent-Variablengruppe wieder. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Filter-Feld der Variablen in der Variablendefinition enthalten ist. Wird ein Filter per Script mit SetFilter gesetzt, wird dieser nicht wiedergegeben. | MgB( GetParentVariableDBFilter(5) );
Rückgabewert vom Typ string. |
GetParentVariableDBSearchField(long _ep_idx) |
Gibt das Suchfeld der angesprochenen Variablen von der Parent-Variablengruppe wieder. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string wiedergegeben, der im Suchfeld der Variablen in der Variablendefinition enthalten ist. | MgB(string( GetSubVariableDBTable("ZUBEHOER",4) ));
Rückgabewert vom Typ string. |
GetParentVariableIndex(string _ep_VarName) |
Gibt die Indexnummer der angesprochenen Variablen von der Parent-Variablengruppe wieder. | MgB(string( GetParentVariableIndex("ZUBEHOER") ));
Rückgabewert vom Typ long. |
GetParentVariableAsLong(string _ep_VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als long von der Parent-Variablengruppe wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB(string( GetParentVariableAsLong("BREITE_STD") ));
Rückgabewert vom Typ long. |
GetParentVariableAsDouble(string _ep_VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als double von der Parent-Variablengruppe wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB(string( GetParentVariableAsDouble("BREITE_STD") ));
Rückgabewert vom Typ double. |
GetParentVariableAsString(string _ep_VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als string von der Parent-Variablengruppe wieder. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB( GetParentVariableAsString("ZUBEHOER_STD") );
Rückgabewert vom Typ string. |
Globale Variablen für den Variablendialog
Variable | Beschreibung |
---|---|
current_vgr_id |
Gibt die ID der aktuellen Variablengruppe wieder. |
current_variable |
Gibt den Namen der aktuellen Variable wieder. |
vgr_pd_id |
Gibt die PD_ID des aktuellen Artikels zurück dem die Variablengruppe zugeordnet ist. |