Konfiguration - Produktgenerator

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.

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.

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.

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.

Button 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.

Zurück

Schließt das Fenster des Produktgenerator-Editorfensters.

Button 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, größer, gleich oder ungleich dem Inhalt von Check(Wert) ist; wenn Bedingung erfüllt ist, Sprung zu angegebener Marke

?CHECK>

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

?CHECK=

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

?CHECK<>

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.

?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, 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.

?MARKE

Definiert eine Marke, diese kann für bedingte und unbedingte Sprünge verwendet werden.

?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 ein (sowohl Nicht-Variantenartikel als auch Variantenartikel mgl.).

?INSERT VARIANTE

Fügt einen Variantenartikel in die Stückliste ein, Benutzer kann die Variante über einen Dialog wählen.

?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 Variablen 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 mit einem konkreten Wert vorbelegt werden kann.

?VARIABLE SHOW

Zeigt einen Eingabedialog an, der den aktuellen Wert einer Variable anzeigt und der innerhalb des Dialoges verändert werden kann.

?YES NO

Zeigt einen Dialog mit den Buttons Ja und Nein an. Klickt der Benutzer auf Ja, dann Sprung zu angegebener Marke.

?EXEC_HTTP

Zu verwenden für einen HTTP-Aufruf.

?vdebug

Zu verwenden um zur Laufzeit in einer Entwicklungsumgebung den Ablauf der Formel zu verfolgen.