Konfiguration - Produktgenerator: Unterschied zwischen den Versionen

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche
Zeile 165: Zeile 165:
  
 
;<tt>?ARTNR GET EK</tt>
 
;<tt>?ARTNR GET EK</tt>
:Legt den EK-Preis eines Artikels in einer Variablen ab (Varianten mgl.).
+
:Legt den EK-Preis eines Artikels in einer Variablen ab (Varianten mgl.)
  
 
;<tt>?ARTNR GET GEWICHT</tt>
 
;<tt>?ARTNR GET GEWICHT</tt>
Zeile 171: Zeile 171:
  
 
;<tt>?ARTNR GET BESTAND</tt>
 
;<tt>?ARTNR GET BESTAND</tt>
:liest den verfügbaren Lagerbestand eines Artikels aus und legt ihn in einer Variablen ab
+
:Liest den verfügbaren Lagerbestand eines Artikels aus und legt ihn in einer Variablen ab.
  
 
;<tt>?ARTNR GET PARAM</tt>
 
;<tt>?ARTNR GET PARAM</tt>
:legt einen benutzerdefinierten Parameter in einer Variablen ab
+
:Legt einen benutzerdefinierten Parameter in einer Variablen ab.
  
 
;<tt>?ARTNR GET VK</tt>
 
;<tt>?ARTNR GET VK</tt>
:legt den VK-Preis einer VK-Gruppe eines Artikels in einer Variablen ab (Varianten mgl.)
+
:Legt den VK-Preis einer VK-Gruppe eines Artikels in einer Variablen ab (Varianten mgl.)
  
 
;<tt>?ARTNR GET VARIANTENNR</tt>
 
;<tt>?ARTNR GET VARIANTENNR</tt>
:zeigt einen Dialog zur Variantenauswahl an, Variantennummer und –bezeichnung der gewählten Variante werden in zwei vorgegebenen Variablen abgelegt
+
:Zeigt einen Dialog zur Variantenauswahl an, Variantennummer und –bezeichnung der gewählten Variante werden in zwei vorgegebenen Variablen abgelegt.
  
 
;<tt>?CALC</tt>
 
;<tt>?CALC</tt>
:berechnet einen Wert über eine vorgegebene Formel, legt das Ergebnis in der angegebenen Variable ab
+
:Berechnet einen Wert über eine vorgegebene Formel, legt das Ergebnis in der angegebenen Variable ab.
  
 
;<tt>?CHECK<</tt>
 
;<tt>?CHECK<</tt>
:prüft, ob die angegebene Dialogvariable kleiner, größer, gleich oder ungleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke
+
:Prüft, ob die angegebene Dialogvariable kleiner als der Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
  
 
;<tt>?CHECK></tt>
 
;<tt>?CHECK></tt>
:prüft, ob die angegebene Dialogvariable kleiner, größer, gleich oder ungleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke
+
:Prüft, ob die angegebene Dialogvariable größer als der Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
  
 
;<tt>?CHECK=</tt>
 
;<tt>?CHECK=</tt>
:prüft, ob die angegebene Dialogvariable kleiner, größer, gleich oder ungleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke
+
:Prüft, ob die angegebene Dialogvariable gleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
  
 
;<tt>?CHECK<></tt>
 
;<tt>?CHECK<></tt>
:prüft, ob die angegebene Dialogvariable kleiner, größer, gleich oder ungleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
+
:Prüft, ob die angegebene Dialogvariable ungleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
  
 
;<tt>?CHECK#</tt>
 
;<tt>?CHECK#</tt>
Zeile 201: Zeile 201:
  
 
;<tt>?EXEC SQL</tt>
 
;<tt>?EXEC SQL</tt>
:Führt eine SQL-Anweisung aus, dadurch ist eine Manipulation der Datenbank möglich.
+
:Führt eine SQL-Anweisung aus. Achtung: dadurch ist eine Manipulation der Datenbank möglich.
  
 
;<tt>?EXEC SHOW SQL</tt>
 
;<tt>?EXEC SHOW SQL</tt>
Zeile 219: Zeile 219:
 
;<tt>?MARKE</tt>
 
;<tt>?MARKE</tt>
 
:Definiert eine Marke, diese kann für bedingte und unbedingte Sprünge verwendet werden.
 
:Definiert eine Marke, diese kann für bedingte und unbedingte Sprünge verwendet werden.
 +
 +
;<tt>?YES NO</tt>
 +
:Zeigt einen Dialog mit den Buttons Ja und Nein an. Klickt der Benutzer auf Ja, dann Sprung zu angegebener Marke.
  
 
;<tt>?NO YES</tt>
 
;<tt>?NO YES</tt>
Zeile 224: Zeile 227:
  
 
;<tt>?INSERT</tt>
 
;<tt>?INSERT</tt>
:Fügt einen Artikel in die Stückliste oder als separate Position ein (sowohl Nicht-Variantenartikel als auch Variantenartikel mgl.).
+
:Fügt einen Artikel in die Stückliste oder als separate Position ein (sowohl Nicht-Variantenartikel als auch Variantenartikel mgl.)
  
 
;<tt>?INSERT VARIANTE</tt>
 
;<tt>?INSERT VARIANTE</tt>
Zeile 263: Zeile 266:
  
 
;<tt>?VARIABLE ISBLANK</tt>
 
;<tt>?VARIABLE ISBLANK</tt>
:Prüft, ob die angegebene Variablen leer ist; wenn Ja, Sprung zu angegebener Marke.
+
:Prüft, ob die angegebene Variable leer ist; wenn Ja, Sprung zu angegebener Marke.
  
 
;<tt>?VARIABLE ISCALC</tt>
 
;<tt>?VARIABLE ISCALC</tt>
Zeile 269: Zeile 272:
  
 
;<tt>?VARIABLE SET</tt>
 
;<tt>?VARIABLE SET</tt>
:Definiert eine Variable, die mit einem konkreten Wert vorbelegt werden kann.
+
:Definiert eine Variable, die so mit einem konkreten Wert vorbelegt werden kann.
  
 
;<tt>?VARIABLE SHOW</tt>
 
;<tt>?VARIABLE SHOW</tt>
:Zeigt einen Eingabedialog an, der den aktuellen Wert einer Variable anzeigt und der innerhalb des Dialoges verändert werden kann.
+
:Zeigt einen Eingabedialog an, der den aktuellen Wert einer Variable anzeigt und der über diesen Dialog verändert werden kann.
 
 
;<tt>?YES NO</tt>
 
:Zeigt einen Dialog mit den Buttons Ja und Nein an. Klickt der Benutzer auf Ja, dann Sprung zu angegebener Marke.
 
  
 
;<tt>?EXEC_HTTP</tt>
 
;<tt>?EXEC_HTTP</tt>

Version vom 1. September 2021, 14:39 Uhr

Templ loc-blk.png
erreichbar über:
System
Bread2.png
Konfiguration
Bread2.png
System


Konfig system produktgenerator.png


Durch das Definieren von Stücklistenformeln und dem anschließenden Zuweisen einer Formel zu einem Stücklistenartikel innerhalb der Artikelverwaltung können Sie während der Fakturierung interaktiv variable Stücklisten erzeugen.


Bereiche des Editorfensters

Produktgeneratorliste

In diesem Bereich werden alle gespeicherten Formeln namentlich und alphabetisch sortiert aufgelistet. Die Tabelle enthält folgende Spalten:

Nummer
Nummer der Formel. Die Nummer wird vom System automatisch vergeben und ist nicht veränderbar.
Bezeichnung
Die Bezeichung der Formeln, die Sie für die einzelnen Formeln festgelegt haben.


Liste der Anweisungen

Innerhalb der Tabelle werden alle Anweisungen der Formel sowie zugewiesene Werte und Parameter tabellarisch dargestellt.


Befehlsbeschreibung

Abhängig davon, welche Befehlsart Sie in der aktuellen Zeile der Formel verwenden, werden Ihnen im Bereich Befehlsbeschreibung unterschiedliche Felder zur Eingabe von Parametern angeboten. An Hand von vier Befehlen soll nachfolgend das Prinzip erläutert werden, wie eine Formel für den Produktgenerator zu erstellen ist. Bei der Erstellung und Bearbeitung der Formeln wird generell zuerst in der DropDown-Liste des Feldes Befehlsart der gewünschte Befehl ausgewählt und anschließend die angezeigten Parameter bearbeitet.

Templ info-blk.png
Für die fehlerfreie Funktion eines Produktgenerator-Scriptes beachten Sie bitte, dass alle Variablen die Sie einem Scrip verwenden, vor Aufruf eines Befehles zuerst deklariert werden müssen. Die Deaklaration von Variablen erfolgt durch den Befehl ?VARIABLE_SET.


Befehlsart ?VARIABLE_SET

Wird diese Befelsart verwendet, erscheinen folgende Felder zur Eingabe eines Parameters:

Befehlsart
Zeigt den ausgewählten Befehl an.
Vorbelegung
Eine Variable, die Sie hier deklarieren, kann hier bereits mit einem Wert (wie Z.B. einer Artikel-Nr A1001) vorbelegt werden.
Dialogvariable
Vergeben Sie in diesem Feld der Variablen einen eindeutigen Namen.
Templ info-blk.png
Die Namen der Variablen müssen grundsätzlich mit den Zeichen ?v beginnen. Wenn die Formel auch im Onlineshop verwendet werden soll, beachten Sie bitte auch unbedingt die Kleinschreibung des Buchstabens "v" nach dem Fragenzeichen, da alle mit ?V... deklarierten Variablen im Onlineshop nicht verwendet werden und zu Fehlern führen.


Positionstext
Hier können Sie einen Positionstext hinterlgen, der z.B. später beim Einfügen eines Artikels in die Stückliste als Text mit eingefügt wird.
Template
Dieser Parmeter wird nur verwendet, wenn Sie durch entsprechende Programmierung des Onlineshops ein anderes als das im Standard vorgesehene Template nutzen möchten.
Bemerkung
Hinterlegen Sie in diesem Feld eine interne Bemerkung zur Verwendung des aktuellen Befehls.<>Das Feld Bemerkung ist kein Pflichtfeld und muss daher von Ihnen nicht zwingend ausgefüllt werden.


Befehlsart ?SET_DEFAULT_ARTIKELNR

Befehlsart
Hier Befehlsart ?SET_DEFAULT_ARTIKELNR
Dialogvariable
Legen Sie hier die Variable fest, die verwedndet werden soll.


Befehlsart ?EXEC_SHOW_SQL

Befehlsart
Hier Befehlsart ?EXEC_SHOW_SQL
SQL-Statement
Setzen Sie in diesem Feld eine SQL-Anweisung ein, deren Suchergebnis dem Benutzerangezeigt werden soll.
Wenn Sie den Benutzer bestimmte Artikel auswählen lassen möchten, so beachten Sie, dass die Artikelnummer an 2. Position der selektierten Datenmenge stehen muss. Dass trifft auch dann zu, wenn Sie mehr als zwei Datenbankfelder selektieren.
Templ bsp-blk.png
select A.BezeichnungKurz, AR.ArtikelNr from ARTIKEL where ARTIKELNR="?vArtikelNr"


Dialogvariable
Legen Sie in diesem Feld fest, in welcher bereits deklarierten Variablen der Rückgabewert des Auswahldialoges gespeichert werden soll.
Positionstext
Hier können Sie einen Positionstext hinterlgen, der z.B. später beim Einfügen eines Artikels in die Stückliste als Text mit eingefügt wird.
Dialogtitel
Legen Sie in diesem Feld den Titel des Fensters für den Auswahldialog fest.


Befehlsart ?CHECK=

Befehlsart
Hier ?CHECK=
Dialogvariable
Namen der Variablen, deren Wert geprüft werden soll.
Check (Wert)
Der von Ihnen anzugebende Wert, der mit dem Inhalt der festzulegenden Variablen verglichen werden soll.
Sprung (intern)
Name der Marke, zu der gesprungen werden soll, wenn die Bedingung (hier =) erfüllt ist.


Buttons im Sicht-Modus

Neu

Betätigen Sie diesen Button, um eine neue Formel für den Produktgenerator anzulegen. Nahc dem Betätigen der Schaltfläche werden Sie in einem Benutzerdialog nach einer Formelbezeichnung gefragt. Geben Sie hier eine beliebige Bezeichung an.

Bearbeiten

Durch das Betätigen dieser Schaltfläche gelangen Sie in den Editiermodus, um eine bereits vorhandene Formel zu bearbeiten.

Löschen

Durch das Betätigen der Schaltfläche wird die aktuell ausgewählte Formel aus der Datenbank dauerhaft gelöscht. Vor dem Löschvorgang werden Sie in einer Sicherheitsabfrage zum Bestätigen des Löschvorganges aufgefordert.

Kopieren

Durch das Betätigen der Schaltfläche wird der Inhalt der aktuell ausgewählten Formel in einem Zwischenspeicher abgelegt. Betätigen Sie danach die Schaltfläche Neu, so wird die zwischengespeicherte Formel in der neuen leeren Formel eingefügt.

Drucken

Durch das Betätigen der Schaltfläche könne Sie sich die aktuelle Befehlsliste der Formwel wahlweise auf den Bildschirm oder einen Drucker ausgeben lassen.

Sichern

Mit Hilfe dieser Funktion könne Sie den Inhalt der aktuellen Formel in einer externen Textdatei ablegen. Legen Sie in dem darauf folgenden Datei-Dialog den Pfad und den Namen der Datei fest, in der der Formelinhalt gespeichert werden soll.

Rücksichern

Mit Hilfe dieser Funktion können Sie eine Produktgenerator-Fomel, die Sie in einer externen Datei gesichert haben, einlesen und in die Datenbank übernehmen.

Kreuztabelle

Durch das Betätigen der Schaltfläche gelangen Sie in das Dialogfenster zur Verwaltung und Bearbeitung von Kreuztabellen.

Parameter-Tabelle

Durch das Betätigen der Schaltfläche gelangen Sie in das Dialogfenster zur Verwaltung und Bearbeitung der Parametertabellen.
Eine solche Parameterliste kann beim Befehl ?LIST hinterlegt werden.

Zurück

Schließt das Fenster des Produktgenerator-Editorfensters.


Buttons im Bearbeiten-Modus

Bezeichnung

Durch das Betätigen der Schaltfläche gelangen in einen Benutzerdialog, in welchem Sie eine neue Bezeichnung für die die aktuelle Produktgeneratorformel festlegen können.

Löschen

Durch das Betätigen der Schaltfläche wird die Anweisung gelöscht, die Sie aktuell in der Tabelle Liste der Anweisungen markiert haben. Vor dem Löschen werden Sie in einer Sicherheitsabfrage zum Bestätigen des Löschens aufgefordert.

Einfügen

Durch das Betätigen der Schaltfläche wird oberhalb der aktuelle markierten Anweisung ein leerer Datenmsatz eingefügt.

alles Prüfen

Betätigen Sie diese Schaltfläche, wenn Sie den Inhalt der Formel auf Ausführbarkeit überprüfen möchten. Häufig gemachte Fehler wie z.B. das Vergessen von Variablen-Deklarationen können hier ausfindig gemacht werden.

Schritt

Durch das Betätigen der Schaltfläche können Sie die Liste der Anweisungen im Schritt-Betrieb testen.

Drucken

Mit Hilfe dieser Funktion können Sie die Anweisungen der Formel wahlweise auf den Bildschirm oder einen Drucker ausgeben.

Speichern

Durch das Betätigen der Schaltfläche werden alle Eingaben und Änderungen dauerhaft gespeichert.

Abbrechen

Durch das Betätigen der Schaltfläche werden alle Eingaben und Änderungen verworfen.

Kreuztabelle

Durch das Betätigen der Schaltfläche gelangen Sie in das Dialogfenster zur Verwaltung und Bearbeitung von Kreuztabellen.

Parameter-Tabelle

Durch das Betätigen der Schaltfläche gelangen Sie in das Dialogfenster zur Verwaltung und Bearbeitung der Parametertabellen.


Der Befehlssatz des Produktgenerators

?ARTNR GET BEZ
Legt die Kurzbezeichnung eines Artikels in einer Variablen ab.
?ARTNR GET EK
Legt den EK-Preis eines Artikels in einer Variablen ab (Varianten mgl.)
?ARTNR GET GEWICHT
Legt das Gewicht eines Artikels in einer Variablen ab (Varianten mgl.)
?ARTNR GET BESTAND
Liest den verfügbaren Lagerbestand eines Artikels aus und legt ihn in einer Variablen ab.
?ARTNR GET PARAM
Legt einen benutzerdefinierten Parameter in einer Variablen ab.
?ARTNR GET VK
Legt den VK-Preis einer VK-Gruppe eines Artikels in einer Variablen ab (Varianten mgl.)
?ARTNR GET VARIANTENNR
Zeigt einen Dialog zur Variantenauswahl an, Variantennummer und –bezeichnung der gewählten Variante werden in zwei vorgegebenen Variablen abgelegt.
?CALC
Berechnet einen Wert über eine vorgegebene Formel, legt das Ergebnis in der angegebenen Variable ab.
?CHECK<
Prüft, ob die angegebene Dialogvariable kleiner als der Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
?CHECK>
Prüft, ob die angegebene Dialogvariable größer als der Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
?CHECK=
Prüft, ob die angegebene Dialogvariable gleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
?CHECK<>
Prüft, ob die angegebene Dialogvariable ungleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke.
?CHECK#
Prüft, ob die angegebene Dialogvariable zwischen dem Wert im Feld Vorbelegung und dem Wert im Feld Check(Wert) liegt; wenn Bedingung erfüllt ist, dann Sprung zu angegebener Marke (Sprung(intern)).
?EXEC SQL
Führt eine SQL-Anweisung aus. Achtung: dadurch ist eine Manipulation der Datenbank möglich.
?EXEC SHOW SQL
Führt eine SQL-Anweisung aus und zeigt das Ergebnis der Abfrage in einem Dialog an; der Inhalt der letzten Spalte der durch den Benutzer gewählten Zeile wird in einer Variable abgelegt.
?KREUZTBL GET
Liest aus einer Kreuztabelle einen Wert aus und legt ihn in einer Variablen ab.
?KREUZTBL GET RASTER
Liest aus einer Kreuztabelle einen Wert aus und legt ihn in einer Variablen ab; ist in dem Feld kein Wert enthalten, so wird der nächste Wert verwendet.
?LIST
Zeigt eine Auswahlliste an, je nach Auswahl durch Benutzer wird ein Ergebnis geliefert, welches in einer Variablen abgelegt wird.
Als Auswahl-Nr. muss hier eine Parameter-Tabelle hinterlegt werden. Zusätzlich wird hier eine Dialogvariable benötigt.
Je nach Auswahl wird dann das entsprechende Ergebnis der Liste in die festgelegte Dialogvariable eingetragen.
?MARKE
Definiert eine Marke, diese kann für bedingte und unbedingte Sprünge verwendet werden.
?YES NO
Zeigt einen Dialog mit den Buttons Ja und Nein an. Klickt der Benutzer auf Ja, dann Sprung zu angegebener Marke.
?NO YES
Zeigt einen Dialog mit den Buttons Nein und Ja an; klickt der Benutzer auf Nein, dann Sprung zu angegebener Marke.
?INSERT
Fügt einen Artikel in die Stückliste oder als separate Position ein (sowohl Nicht-Variantenartikel als auch Variantenartikel mgl.)
?INSERT VARIANTE
Fügt einen Variantenartikel als separate Position in den Beleg ein, der Benutzer kann die Variante über einen Dialog wählen. Nur mit dem Einfügetyp "A"=Artikelposition nutzbar.
?JUMP INT
Dies ist die Anweisung für einen Sprung zur angegebenen Marke.
?JUMP EXT
Sprung in eine andere Formel, danach Rücksprung ans Ende der aktuellen Formel.
?JUMP EXT RET
Sprung in eine andere Formel, danach Rücksprung in die nächste Zeile der aktuellen Formel.
?SHOW MESSAGE
Anweisung für die Anzeige eines Dialogfensters, in dem eine Nachricht angezeigt wird.
REM
Kommentar, kein Einfluss auf die Abarbeitung der Formel.
?ROUND
Rundet den Wert einer Variablen auf die angegebene Anzahl von Dezimalstellen.
?ROUND RASTER
Rundet den Wert einer Variablen auf entsprechend des vorgegebenen Rasters.
?SET GESAMTANZAHL
Legt die Anzahl für die Belegposition fest.
?SET GESAMTPREIS
Ändert den Gesamtpreis der Stückliste auf den Inhalt der angegebenen Variable.
?SNR ZAEHLER GET
Liest einen Zählerstand für einen Seriennummernartikel aus der Artikelverwaltung aus (konkrete Seriennummer angeben!).
?SNR ZAEHLER SET
Ändert einen Zählerstand für den Artikel mit der angegebenen Seriennummer.
?VARIABLE ISBLANK
Prüft, ob die angegebene Variable leer ist; wenn Ja, Sprung zu angegebener Marke.
?VARIABLE ISCALC
Prüft, ob der Inhalt der angegebenen Variablen eine Zahl ist; wenn Nein, Sprung zu angegebener Marke.
?VARIABLE SET
Definiert eine Variable, die so mit einem konkreten Wert vorbelegt werden kann.
?VARIABLE SHOW
Zeigt einen Eingabedialog an, der den aktuellen Wert einer Variable anzeigt und der über diesen Dialog verändert werden kann.
?EXEC_HTTP
Zu verwenden für einen HTTP-Aufruf.
?vdebug
Zu verwenden um zur Laufzeit in einer Entwicklungsumgebung den Ablauf der Formel zu verfolgen.
zum Anfang der Seite
Navigation
Konfiguration