Mediator ermöglicht das Lesen aus und das Schreiben in Microsoft Access und MySQL Datenbanken.
Das Verbindungselement zwischen Mediator und der Datenbank ist die Datenbank Ressource. Am Beispiel einer Microsoft Access Datenbank wird nachfolgend beschrieben, wie man eine Datenbank mit Hilfe der Datenbank Ressource mit Mediator verknüpft und in ihr navigiert.
Erzeugen einer Datenbank Verbindung
Ø Um den Ressourcen Dialog zu öffnen, wählen Sie Ansicht | Interaktivität | Ressourcen.
Ø Ziehen Sie eine Datenbank Ressource ins aktive Feld, um den Datenbank Ressource Dialog zu öffnen.
Dieser Dialog bezieht sich auf eine spezielle DSN Datei, die verschiedene Informationen enthält, u.a. welcher Treiber zu verwenden ist, welche Datenbankdatei verwendet werden soll usw. Es handelt sich um eine ASCII Datei, die Sie mit dem ODBC Manager aus dem Windows Konfigurationsdialog erzeugen können. Allerdings ist diese Vorgehensweise ziemlich komplex; im Normalfall ist es sehr viel einfacher, die DSN Datei mit einem Texteditor (z.B. Notepad) zu erzeugen, entweder ganz neu oder (empfohlen), indem sie eine vorhandene DSN Datei entsprechend anpassen.
Die DSN Datei für den Microsoft Access Treiber sollte etwa so aussehen:
[ODBC]
DRIVER=Microsoft Access Driver (*.mdb)
UID=admin
UserCommitSync=Yes
Threads=3
SafeTransactions=0
PageTimeout=5
MaxScanRows=8
MaxBufferSize=2048
FIL=MS Access
DriverId=25
DefaultDir= (leer lassen)
DBQ=NameDerDatenbank.mdb (Name der Datenbank = der Dateiname Ihrer Datenbank)
Ø Nachdem Sie die DSN Datei erzeugt haben, kopieren Sie diese plus der Datenbank selbst (MDB Datei) in den Projektordner (in dem sich auch die .md8 Datei befindet) und fahren, wie unten beschrieben, fort.
Verbinden von Mediator und der Datenbank
Nachdem sie die DSN Datei erzeugt haben, entweder über den ODBC Manager oder durch Direkteingabe im Texteditor, muss die Datenbank mit Mediator verbunden werden:
Ø Schalten Sie die Option Datei (*.dsn) im Datenbank Ressource Dialog ein.
Ø Geben Sie den Pfad zur DSN Datei im Feld Datenbank ein oder wählen Sie es über die Auswahl-Schaltfläche aus.
Dadurch wird die Verbindung zur Datenbank hergestellt. Im Feld Tabellenstruktur werden jetzt alle Datenbankfelder angezeigt.
Sie können jetzt die einzelnen Datenbankfelder mit Mediator Variables verbinden.
Ø Erzeugen Sie eine Mediator Variable für jedes Feld, dessen Wert Sie im Projekt anzeigen wollen. Achten Sie dabei darauf, dass der Variablentyp dem des verbundenen Feldes entspricht.
Für ein Feld vom Typ VARCHAR muss die variable vom Typ Text sein.
Ø Im Datenbank Ressource Dialog klicken Sie jetzt auf das erste Feld, das Sie mit einer Mediator Variable verbinden wollen und klicken dann auf die Verbinden Schaltfläche.
Ø Wählen Sie im Dialog Neue Verbindung Dialog die Mediator Variable aus, mit der das Feld verbunden werden soll.
Dadurch wird eine Verbindung zwischen dem betreffenden Datenbankfeld und der Mediator Variable hergestellt. Diese Verbindung wird durch einen roten Punkt links neben dem Feld angezeigt. Felder, die nicht verbunden sind, zeigen einen grünen Punkt.
Ø Wiederholen Sie diese Operation für alle Felder, die Sie mit einer Variable verbinden wollen.
Jetzt sind die gewünschten Datenbankfelder mit der entsprechenden Mediator-Variable verbunden, der Wert muss nun nur noch angezeigt werden. Hier eine Möglichkeit, dies zu tun:
Ø Erzeugen Sie ein Eingabeobjekt, um den Inhalt des ersten Datenbankfelds anzuzeigen.
Ø Ziehen Sie ein Wenn Seite bereit Ereignis in den Ereignisdialog der Seite, gefolgt von einer Eigenschaft setzen Aktion.
Ø Füllen Sie den Dialog wie folgt aus:
Objekt = input object
Eigenschaft = Text
Wert als Ausdruck = Name der entsprechenden Variable
Ø Testen Sie die Seite: Der Wert des Feldes im ersten Datensatzes muss durch die entsprechende Variable jetzt im Eingabeobjekt angezeigt werden.
Ø Wiederholen Sie diese Schritte für alle Felder, deren Inhalt Sie in Eingabefeldern anzeigen wollen.
Weitere Infos zu diesem Thema finden Sie unter "Die Datenbank Ressource".
Navigieren in der Datenbank
Die Aktion DB Pointer ermöglicht Ihnen sich durch die Datenbank zu bewegen, wie im Folgenden gezeigt:
Ø Erzeugen Sie eine 'Weiter' Schaltfläche und öffnen deren Ereignisdialog.
Ø Ziehen Sie das Ereignis Mausklick ins aktive Feld, gefolgt von einer DB Pointer Aktion (Karteireiter Datenbank).
Ø Wählen Sie im Feld Name der Datenbank Ressource die gewünschte Ressource aus.
Ø Klicken Sie auf Nächster Datensatz und schließen den Dialog.
Die Variablen werden dadurch upgedatet, allerdings müssen ihre Inhalte noch an die Eingabeobjekte übergeben werden.
Ø Fügen Sie eine Eigenschaft setzen Aktion rechts der DB Pointer Aktion hinzu - für jede Variable bzw. jedes Eingabeobjekt, wie oben beschrieben.
Um sich auf gleiche Weise in der ganzen Datenbank bewegen zu können, erzeugen Sie drei weitere Schaltflächen: Vorheriger, Erster und Letzter und wiederholen die oben gezeigten Schritte entsprechend (Vorheriger Datensatz, Erster Datensatz und Letzter Datensatz.
Suchen in der Datenbank
Der wirkliche Wert beim Arbeiten mit Datenbanken besteht darin, dass einzelne Datensätze sehr schnell gefunden werden können. Die Aktion DB SQL dient u.a. dazu, dies zu realisieren.
Ø Erzeugen Sie ein Eingabeobjekt und nennen Sie es z.B. 'Suchen'.
Dieses soll dazu dienen, nach Inhalten in der Datenbank zu suchen. Die Suche soll immer dann ausgeführt werden, wenn der Anwender die Enter-Taste drückt oder außerhalb des Eingabeobjekts klickt.
Ø Ziehen Sie das Wenn Stop Ereignis ins aktive Feld des Ereignisdialog des Eingabeobjekts, gefolgt von einer DB SQL.
Ø Wählen Sie den Namen der Datenbank Ressource im Feld Datenbank aus.
Ø Geben Sie das gewünschte Statement ins Feld SQL Statement ein.
Beispiel: Wenn Sie nach dem Wort 'Tina' im Feld Vorname einer Tabelle namens DemoTabelle suchen wollen, würde das SQL Statement wie folgt aussehen:
"SELECT * FROM DemoTabelle WHERE Vorname = 'Tina' "
Um nach dem Begriff zu suchen, den der Anwender ins Eingabeobjekt eingegeben hat, müsste Sie 'Tina' durch 'Suchen.Text' ersetzen:
Das SQL Statement wird dabei um spezielle Zeichen ergänzt, die bedeuten, dass mit Mediator Variablen bzw. Ausdrücken gearbeitet wird.
"SELECT * FROM DemoTabelle WHERE Vorname = ' " + Suchen.Text + " ' "
Bitte beachten Sie die Verwendung von Anführungszeichen. Dies kann ein wenig verwirrend sein, da es zwei Typen von Anführungszeichen gibt: Die Mediator Anführungszeichen ( " ) und die SQL Anführungszeichen ( ' ).
Da Leerzeichen in SQL Statements keine Rolle spielen, dass können Sie die beiden Typen von Anführungszeichen dadurch trennen ( " 'Eintrag' "statt "'Eintrag'"), um das ganze übersichtlicher zu machen.
Wenn Sie definieren wollen, dass Mediator in mehr als einem Feld sucht, also z.B. in den Feldern Vorname und Nachname, könnte das SQL Statement wie folgt aussehen:
"SELECT * FROM DemoTabelle WHERE Vorname = ' " + Suchen.Text + " ' " + "OR Nachname=' " + Suchen.Text + " ' "
Kurze Beschreibung der SQL Syntax von Mediator aus
· Das komplette Statement ist in normale Anführungszeichen (") gesetzt.
Beispiel: "SELECT * FROM DemoTabelle"
· Datenbankfelder werden ohne Anführungszeichen oder sonstige Zeichen verwendet.
Beispiel: "SELECT * FROM DemoTabelle WHERE Feldname = … "
· Werte (aller Art), die von Mediator kommen, werden von SQL Anführungszeichen ( ' ) umschlossen.
Beispiel: "SELECT * FROM DemoTabelle WHERE Vorname = 'Tina' "
· Mediator Textvariablen oder Objekt.Eigenschaften vom Typ 'Text' werden von Mediator Anführungszeichen ( " ) umschlossen - zusätzlich zu den SQL Anführungszeichen.
Beispiel: "SELECT * FROM DemoTabelle WHERE Vorname = ' " + Suchen.Text + " ' "
· Mediator Ganzzahl- Fließkomma-Variablen oder Objekt.Eigenschaften dieses Typs werden NICHT von Mediator Anführungszeichen ( " ) umschlossen.
Beispiel: "SELECT * FROM DemoTabelle WHERE Alter = ' + Alter.value + ' "
· Mediator Variablen und Eigenschaften werden grundsätzlich von + Zeichen umschlossen.
Beispiel: "SELECT * FROM DemoTabelle WHERE Vorname = ' " + Suchen.Text + " ' "
Da Sie in SQL Statements selten etwas anderes als Mediator Variablen oder Objekt.Eigenschaften verwenden werden, hier eine Kurzbeschreibung der Vorgehensweise:
Ø Beginnen Sie jede Eingabe, die von Mediator kommt, mit einem SQL Anführungszeichen (').
Ø Fügen Sie Mediator Anführungszeichen ( " ) hinzu, wenn es sich dabei um eine Textvariable oder eine Texteigenschaft handelt. Bei Zahlenwerten ist dies nicht notwendig; fahren Sie direkt mit dem nächsten Punkt fort.
Ø Geben Sie ein + Zeichen und danach den Namen der Variable bzw. der Objekt.Eigenschaft ein.
Jetzt führen Sie diese Schritte in umgekehrter Reihenfolge durch:
Ø Geben Sie wieder das + Zeichen ein (um den Namen der Variable/Eigenschaft "abzuschließen").
Ø Falls Sie Mediator Anführungszeichen ( " ) verwendet haben, "schließen Sie diese ab", indem Sie erneut Mediator Anführungszeichen eingeben.
Schließen Sie die SQL Anführungszeichen ( ' ) indem Sie (') erneut eingeben.
Zurücksetzen der Datenbank
Nachdem Sie eine Suche - wie oben beschrieben - durchgeführt haben, bezieht sich jede weitere Navigation auf den dabei gefunden Suchbereich. Wird nur ein Datensatz gefunden, hätten z.B. die Nächster- und Vorheriger-Schaltflächen keine Funktion mehr.
Um wieder die komplette Datenbank zugänglich zu machen, verwenden Sie folgendes SQL Statement:
"SELECT * FROM DemoTabelle"
Vorbereitung zum Export
Prüfen der DSN Datei
Bevor Sie Ihr Projekt exportieren, müssen Sie sicherstellen, dass die DSN Datei keinen vollständigen Pfad zur Datenbankdatei enthält. Dies ist besonders dann nötig, wenn Sie den Weg über den 'ODBC Manager' (oben beschrieben) gewählt haben.
Ø Verwenden Sie Notepad, um die DSN Datei z.B. wie folgt zu bearbeiten:
[ODBC]
DRIVER=Microsoft Access Driver (*.mdb)
UID=admin
UserCommitSync=Yes
Threads=3
SafeTransactions=0
PageTimeout=5
MaxScanRows=8
MaxBufferSize=512
ImplicitCommitSync=Yes
FIL=MS Access
DriverId=25
DefaultDir=Laufwerk:\Ordner\Unterordner\
DBQ= Laufwerk:\Ordner\Unterordner\Datenbank.mdb
Wie Sie sehen, enthalten die Punkte DefaultDir und DBQ volle Pfadnamen. Ändern Sie die Pfade wie folgt:
DefaultDir=
DBQ=Datenbase.mdb
(wobei Datenbank.mdb der Dateiname der Datenbank ist).
Wenn Ihr Projekt auf einem nicht beschreibbaren Medium, also z.B. einer CD-ROM oder DVD-ROM weitergegeben werden soll, müssen Sie unterhalb des USD-Eintrags folgende Eintrag einfügen.
ReadOnly=1
Hinzufügen wichtiger Dateien
Bevor Sie Ihr Projekt exportieren, müssen Sie sicherstellen, dass Mediator alle benötigten Datenbank- und sonstigen Dateien in die exportierte Version mitnimmt. Bei Verwendung des empfohlenen Microsoft Access Treibers müssen Sie insofern nur die Datenbankdatei (.mdb) einbinden. Andere Datenbanken können allerdings aus mehr als einer Datei bestehen.
Ø Klicken Sie auf die Mediator Schaltfläche.
Ø Wählen Sie Vorbereiten | Zusätzliche Datendateien und fügen alle benötigten Dateien hinzu, im Einzelnen:
· Die DSN Datei und die Datenbankdatei (*.mdb)
· Zusätzliche Dateien, wie Bilder und Sounds, die von der Datenbank aus angesprochen werden
Jetzt können Sie das Projekt auf die übliche Weise exportieren.
