Im Falle der Neueingabe müssen Sie in dem nachfolgendem Formular die Datenquelle auswählen und die Art der Prüfung festlegen.

Transkript

1 Ereignismanager

2 Ereignismanager Ereignismanager - Grundsätzliches Allgemeines Mit Hilfe des Ereignismanagers können Sie Feldeingaben (bei Neueingaben oder Änderungen) überprüfen lassen. Sie können für Felder Standardwerte vorgeben, bei Fehleingaben einen Hinweis ausgeben lassen oder es unmöglich machen, die entsprechende Eingabemaske ohne korrekte Eingabe zu schließen. Weiterhin können Ereignisse aufgerufen und durchgeführt werden (Aufruf von Excel-Datenübertragungen, Aufruf von DLL s). Auch das Einfügen von Daten aus einer anderen Datenquellen über "CalcFields" in eine Tabelle ist möglich. Servicefunktion - Ereignismanager ausschalten Falls im Programm unerwartete Fehler oder lange Wartezeiten auftreten, so kann dies ggf. an selbst erstellen DLL s liegen, die über den Ereignismanager gesteuert werden. Um einen evt. Fehler in der eigenen Zusatzprogrammierung auszuschließen, können mit dem Aktivieren des Kontrollkästchens Ereignismanager ausschalten - Achtung - Program muss neu gestartet werden in der Konfiguration, Register System, Register Allgemein sämtliche Funktionen aus dem Ereignismanger abgeschaltet werden. Bevor der Test durchgeführt wird, muss metropolis beendet und dann erneut gestartet werden. Beispiele - siehe ->Ereignisse festlegen. Ereignisse festlegen Datenquelle anlegen Der Ereignismanager wird über das Menü Dienste/Ereignismanager aufgerufen. Klicken Sie auf Neueingabe, um eine neue Datenquelle für den Ereignismanager anzulegen. Klicken Sie auf Öffnen, um weitere Daten für die markierte Datenquelle anzulegen oder neu einzugeben. Im Falle der Neueingabe müssen Sie in dem nachfolgendem Formular die Datenquelle auswählen und die Art der Prüfung festlegen. metropolis-warenwirtschaft - 960

3 Entsprechend wählen Sie eines der Register: OnNewRecord OnCalcFields/Lookup FieldChange Validate/BeforePost, AfterPost BeforeScroll, AfterScroll Ereignis bei Neueingabe Ereignis auslösen bei Datensatzneueingabe - (Ereignismanager-Register: OnNew Record) Beispiel: Sie wollen bei einer Adressneueingabe einen automatischen Eintrag in das Feld Anrede. 1. Sie klicken neben dem Feldnamen auf den Button Öffnen und wählen das Feld Anrede aus. 2. Jetzt haben Sie zwei Möglichkeiten: entweder geben Sie die Datenquelle und das Feld vor, dessen Inhalt in das Feld Anrede übertragen werden soll oder Sie geben direkt den Eintrag vor. In diesem Beispiel wurde für das Feld Anrede der direkte Eintrag "Firma" gewählt. (In die Felder Inhalt und laufende Nr. können Sie auch einen automatischen Zähler für ein Feld einbauen - siehe dazu das Beispiel in dem Formular.) metropolis-warenwirtschaft - 961

4 Felder aus anderer Datenquelle Feld aus anderer Datenquelle in Tabelle einbringen - (Ereignismanager-Register: On- CalcFields/Lookup Beispiel 1: In der Tabelle im Formular Suchen Aufträge (Menü Verkauf/Auftrag/Suchen) soll das Kreditlimit als "Calc- Field" in die Tabelle aufgenommen und angezeigt werden. Sie klicken im Register OnCalcFields/Lookup auf den Button Feld einfügen. metropolis-warenwirtschaft - 962

5 In dem Formular Ereignismanager berechnetes Feld geben Sie die Daten ein. Feldname, Feldtyp, Feldbreite In Feldname geben Sie die Bezeichnung für die Spalte ein. Wählen Sie dann den Feldtyp und geben Sie die gewünschte Feldbreite ein. metropolis-warenwirtschaft - 963

6 Aktivieren Sie das Kontrollkästchen Feld ist in Grids automatisch sichtbar (sonst über Designer einblenden). Betriebsart Als Betriebsart wählen Sie Lookup in anderer Datenquelle. Vergleichsfeld, Lookup-Datenquelle, Schlüsselfeld, Ergebnisfeld Als Vergleichsfeld muss ein Feld aus der Datenquelle gewählt werden, dass die gleichen Daten enthält, wie ein Feld aus der Lookup-Datenquelle. (Beispiel: In einer Datenquelle "A" wird die AdressNr. im Feld AdrNr verwaltet, in der Lookup-Datenquelle "B" wird die AdressNr. im Feld LiefAdrNr verwaltet - dementsprechend müsste also in das Vergleichsfeld: "AdrNr" eingetragen werden und im Schlüsselfeld: "LiefAdrNr".). Hier im Beispiel der Grafik sind allerdings bei Felder gleichlautend. Die Lookup-Datenquelle (hier "Adressdaten.SuchAdresseSource") ist die Tabelle, aus das Feld gezogen wird. Schlüsselfeld - siehe weiter oben "Vergleichsfeld" Als Ergebnisfeld muss der Name des Feldes (aus der Lookup-Datenquelle), dessen Inhalt in die Tabelle aufgenommen werden soll, eingetragen werden. Ergebnis aus dem Beispiel 1 im Ereignismanager Beispiel 2: In der Tabelle im Formular Suchen Bestellungen (Menü Einkauf/Bestellung/Suchen) soll zusätzlich die Faxnummer jeder Adresse angezeigt werden. In der Datei KomArt sind die Kommunikationsarten gespeichert, wobei z.b. der Bezeichnung "Telefon" die KomArt = 1 fest zugewiesen ist, der Bezeichnung Fax ist die KomArt = 2 fest zugewiesen, danach folgen Internet mit 3, mit 4, usw. In der Datei KomVb ist die AdrNr mit dem Feld KomArt verbunden. D. h. in metropolis-warenwirtschaft - 964

7 dieser Datei gibt es mehrere Einträge für die gleiche Adresse (AdrNr) - jedoch jeweils mit unterschiedlicher KomArt - je nachdem, welche Kommunikationsart(en) der Adresse zugewiesen wurden. Damit im Formular Suchen Bestellungen die Faxnummer angezeigt wird, muss u.a. der Festwert (für die KomArt) definiert sein. Sie klicken im Register OnCalcFields/Lookup auf den Button Feld einfügen. und geben zuerst die Daten für den Festwert ein. Festwert definieren Sie wählen die Option Festwert und tragen in das Feld Festwert: 2 ein. In Feldname bestimmen Sie die Definition für den Festwert. Diese Bezeichnung wird später für den Eintrag in das Vergleichsfeld benötigt. Als Feldtyp muss "TFloatField" gewählt werden. Nachdem Sie den Festwert eingetragen haben, schließen Sie das Formular Ereignismanager berechnetes Feld. Lookup in anderer Datenquelle definieren Sie klicken wieder auf den Button Feld einfügen um ein weiteres Feld zu übernehmen (nämlich das Feld für die Faxnummer). Jetzt wählen Sie die Option Lookup in anderer Datenquelle. Sie geben den gewünschten Feldnamen, den Feldtyp usw. ein. Dann wählen Sie die Lookup-Datenquelle. Im unteren Bereich wählen Sie das Vergleichsfeld "AdrNr" und ergänzen die Zeile mit der Bezeichnung, die Sie für den Festwert vergeben haben. Die Felder müssen durch ein Semikolon getrennt werden. Dann muss das Schlüsselfeld angegeben werden. In diesem Fall sind es zwei: AdrNr und KomArt. Auch diese Felder sind durch Semikolon zu trennen. Das Ergebnisfeld muss KomNr lauten (hier sind die eigentlichen Fax- und Telefonnummern, sowie auch Internetadressen, usw. der Adressen gespeichert.) metropolis-warenwirtschaft - 965

8 Nachdem Sie die Daten für den Festwert und für das Lookup in anderer Datenquelle eingegeben haben sieht das Register OnCalcFields/Lookup z.b. folgendermaßen aus. Ergebnis aus dem Beispiel 2 im Ereignismanager metropolis-warenwirtschaft - 966

9 Da für den Festwert (hier FestW) das Kontrollkästchen Feld in Grids automatisch sichtbar... nicht aktiviert war, wird es auch nicht in der Tabelle angezeigt. Beispiel 3 Es sollen nur Bestände von bestimmten Lagerorten für die Bestandssummierung herangezogen und in einem gesonderten Feld ausgegeben werden. Beispiel: Nur die Bestände von Lagerort 1 und 3 sollen summiert und ausgegeben werden. 1. Legen Sie die Datenquelle "Artikeldaten.Artikelsource" fest. 2. Wählen Sie das Register OnCalcFields/Lookup und klicken Sie dort auf den Button Neueingabe. 3. Geben Sie in Feldname: "SummeVielLager" ein und wählen Sie als Feldtyp: "TFloatField". 4. Wählen Sie im Bereich Betriebsart: "SQL-Statement" und geben Sie dort die entsprechende Anweisung (siehe nachfolgende Grafik) ein: metropolis-warenwirtschaft - 967

10 5. Schließen Sie nun die Formulare des Ereignismanagers. 6. Rufen Sie die Artikelstammdaten auf und fügen Sie über den Designer das Feld "SummeVielLager" aus der Datenquelle "Artikeldaten.ArtikelSource" ein. Beispiel - Ausschnitt aus den Artikelstammdaten, Register Lager. Die Summenzeile zeigt den Bestand aller Lagerorte. Das Feld SummeVielLager jedoch nur die Bestände aus den Lagerorten Ereignis bei Feldänderung Ereignis auslösen bei Feldänderung - (Ereignismanager-Register: Field-OnChange) Beispiel: Wird in der Adresse das Feld Entfernung verändert, soll eine DLL, die eine Berechnung durchführt, aufgerufen werden. metropolis-warenwirtschaft - 968

11 1. Sie wählen das Feld (in diesem Beispiel Entfernung) über den Button Öffnen aus. 2. Wählen Sie die Ereignisart: EXCEL- oder DLL-Aufruf. (Wenn Sie EXCEL auswählen, müssen Sie die Bezeichnung für die Excel-Dateiübertragung auswählen. Wenn Sie DLL auswählen, müssen Sie unter DLL-Dateiname die DLL und unter DLL-Pfadname den Pfadnamen eintragen (Pfadnamenfestlegung: Menü Dienste/System/Pfade). 3. In welcher Reihenfolge die Ereignisse ausgeführt werden sollen, wird über die Optionsfelder im Bereich Reihenfolge der Ereignisse ausgewählt. 4. Soll das Ereignis nur unter bestimmten Bedingungen ausgeführt werden, tragen Sie im Bereich (optional) Ereignis nur ausführen, wenn... die einschränkenden Bedingungen ein. Ereignis bei Speicherung Ereignis auslösen vor Speicherung eines Datensatzes - (Ereignismanager-Register: BeforePost) Beispiel - Pflichtfeld: In die Adress-Stammdaten soll immer ein Frachtbetrag von mindestens 10 und höchstens 50 eingetragen werden. Damit die Mitarbeiter dies nicht vergessen wird, soll für das Feld eine Eingabeprüfung stattfinden. Diese Prüfung findet statt, wenn die Adress-Stammdaten verlassen werden sollen, bzw. wenn die Adress-Stammdaten gespeichert werden sollen. 1. Sie wählen das Feld (in diesem Beispiel Frachtbetrag) über den Button Öffnen aus. 2. Danach legen Sie die Bedingungen fest - Beispiel - siehe Einträge in der nachfolgenden Grafik im Bereich Bedingung. 3. Bei Zeichenfeldern können Sie bestimmen, ob ein Wandlung in Großbuchstaben oder Kleinbuchstaben stattfinden soll. 4. Im Bereich Art der Meldung, wenn Bedingung nicht erfüllt ist, wählen Sie Fehlermeldung... oder als Hinweis... aus. metropolis-warenwirtschaft - 969

12 Zu Definition von Pflichtfeldern und Farben der Felder - siehe auch im Designer. Ereignis auslösen nach Speicherung eines Datensatzes - (Ereignismanager-Register: AfterPost) Hier haben Sie die Möglichkeit eine DLL ausführen zu lassen, nach ein Datensatz in der ausgewählten Datenquelle gespeichert wurde. Sie geben den DLL-Dateinamen, -Pfadnamen und ggf. ein DLL-Parameter an. Ereignis bei Datensatzbewegung Ereignis auslösen bei Datensatzbewegung (Ereignismanager-Register: BeforeScroll und After Scroll) BeforeScroll: DLL wird aufgerufen, bevor der Datensatz verlassen wird. AfterScroll: DLL wird aufgerufen, wenn der nächste Datensatz erreicht ist. 1. Sie geben den DLL-Dateinamen sowie den DLL-Pfadnamen an. (In diesem Fall wird die DLL aufgerufen, bevor der aktuelle Datensatz verlassen wird. 2. Ein DLL-Parameter kann, muss jedoch nicht angegeben werden. Der DLL-Parameter kann in der DLL mit der Variablen _DLLParameter.Uebergabewert abgefragt werden. Somit ist es möglich, eine einzige DLL für verschiedene Aufgabe zu programmieren. Der Übergabeparameter steuert die DLL entsprechend. Beispiel: BeforeScroll metropolis-warenwirtschaft - 970

13 metropolis-warenwirtschaft - 971