Mit dem FilterForm-Assistenten wird Code zum Filtern von Daten in einem Suchformular eingefügt.

Download

ACLibFilterFormWizard.zip

Änderungsprotokoll

Version 1.6.0: Lokalisierung/Spracheinstellung ergänzt

Version 1.5.1: Filter-Klassen aus Web-Repository aktualisieren + Auswahl trunk oder draft-Zweig

Version 1.5.0: Filter-Klassen aus Web-Repository aktualisieren

Version 1.4.0: Filtereinträge aus gebundenem Formular erzeugen

Bedienung

Installation

1. Download der Zip-Datei ACLibFilterFormWizard.zip
2. Entpacken in ein beliebiges Verzeichnis
   Die Zip-Datei einhält ein VB-Script Install.vbs zum Kopieren der Datei in das Access-Add-In-Verzeichnis.
3. Access-Add-In installieren
   • Allgemeine Variante
     1. Access starten
     2. Access-Add-In-Manager öffnen
     3. Entpackte Datei ACLibFilterFormWizard.mda auswählen. Die Datei wird von Access ins Verzeichnis '%appdata%\Microsoft\AddIns' kopiert.
   • Install/Update-Variante mit Install.vbs
     1. Install.vbs ausführen
     2. Auswählen ob das Add-In als mde oder mdb verwendet werden soll (Empfehlung: mde)
        Add-In wird ins Verzeichnis '%appdata%\Microsoft\AddIns' kopiert.
     3. Bei einem Update ist Installation abgeschlossen
        Für eine Erst-Installation sind noch folgende Schritte notwendig:
        1. Access starten
        2. Access-Add-In-Manager öffnen
        3. ACLib FilterForm Wizard auswählen und auf "Installieren" klicken
4. Die ursprünglich entpackten Dateien können gelöscht werden.

Verwendung des Assistenten für den Import des Filter-Codes

Den FilterForm-Assistenten über das Add-In-Menü öffnen. Anschließend folgende Schritte in der Maske ausführen:

1. Formular auswählen
2. Optional: Steuerelemente zum Anwenden der Filterbedingungen und Löschen der Filterwerte auswählen
3. Gewünschte Filter in der Maske eintragen oder aus Datenquelle des zu filternden Formulars eintragen lassen Video)
   • Datenfeld: das zu filternde Datenfeld
   • Datentyp: der Datentyp des Datenfeldes
   • Vergleichsoperator: Wie soll der Datenfeldinhalt mit dem Filterwert verglichen werden (>, >=, <, ...)
   • Steuerelement(e) auswählen
     • Steuerelement: das Steuerelement mit dem Filterwert
     • Weitere Steuerelemente: falls für den Filterausdruck mehr als ein Steuerelement benötigt wird (z. B. für Between), die Namen der Steuerelemente mit "," getrennt in dieses Feld eintragen
     • Falls das Steuerelement noch nicht im Suchformular enthalten ist, kann dieses durch aktivieren von "Neu" unterhalb der Steuerelementauswahl erstellt werden
4. ApplyFilter-Methode wählen
   • auskommentierter Beispiel-Code: Es wird im Formular-Codemodul die Methode ApplyFilter erstellt, deren Inhalt auskommentiert ist und manuell angepasst werden muss
   • aktuelles Formular filtern: Der Code in der ApplyFilter-Methode bezieht sich auf das aktuelle Formular unter Verwendung der Eigenschaft Form.Filter
   • Unterformular: das Unterformularsteuerelement im Dropdown auswählen, die ApplyFilter-Methode wird die Eigenschaft Form.Filter des Unterformulars verwenden
5. Filter-Variante auswählen
   • FilterControlManager-Methoden: Die Filterung erfolgt über die Klasse FilterControlManager - dabei werden Änderungen in den Filter-Steuerelementen von der Klasse erfasst und entsprechend der Einstellung/Konfiguaration die Filterung der Daten ausgeführt
   • FilterStringBuilder-Methoden: Zum Filtern wird mittels Klasse FilterStringBuilder der Filterstring erzeugt, die Filterung erfolgt mittels Code innerhalb des Filter-Formulars
6. benötigten SQL-Dialekt auswählen (Standard: Jet/DAO)
7. Schaltfläche Formular-Code einfügen betätigen
8. Den eingefügten Code an die eigenen Bedürfnisse anpassen.

Video: Filter-Formular mit der Unterstützung des FilterForm-Assistenten erstellen

Video: Filterelemente vom FilterForm-Assistenten aus Datenquelle des Formulars erzeugen lassen

Filter-Codes aus Repository aktualisieren

Mittels Mausklick auf Klassen installieren und Auswahl von Codemodule in Add-In aus SNV-Repository aktualisieren können die im Add-In enthaltenen Codemodule (Klassen) können über das ACLib-SVN-Repository aktualisiert werden.

Weiterführende Links: SQL-Text für Filterbedingung