Wiki der Access Code Library

Gemeinsam zu mehr Effizienz in der Anwendungserstellung

ACLib-FilterForm-Wizard

Aus Access Code Library
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
K
K
(Der Versionsvergleich bezieht 29 dazwischenliegende Versionen mit ein.)
Zeile 2: Zeile 2:
[[Kategorie:Hilfe]]
[[Kategorie:Hilfe]]
{{TOCright}}
{{TOCright}}
-
Mit dem FilterForm-Assistenten wird Code zum Filtern von Daten in einem Formular eingefügt.  
+
Mit dem FilterForm-Assistenten wird Code zum Filtern von Daten in einem Suchformular eingefügt.  
=== Download ===
=== Download ===
[http://access-codelib.net/download/addins/ACLibFilterFormWizard.zip ACLibFilterFormWizard.zip]
[http://access-codelib.net/download/addins/ACLibFilterFormWizard.zip ACLibFilterFormWizard.zip]
 +
 +
=== Änderungsprotokoll ===
 +
:Version 1.6.3: Lokalisierung/Spracheinstellung - Bugfix für 64-Bit-Access
 +
: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 ===
=== Bedienung ===
Zeile 11: Zeile 18:
# Download der Zip-Datei [http://access-codelib.net/download/addins/ACLibFilterFormWizard.zip ACLibFilterFormWizard.zip]
# Download der Zip-Datei [http://access-codelib.net/download/addins/ACLibFilterFormWizard.zip ACLibFilterFormWizard.zip]
-
# Entpacken in ein beliebiges Verzeichnis
+
# Entpacken in ein beliebiges Verzeichnis <br />Die Zip-Datei einhält ein VB-Script ''Install.vbs'' zum Kopieren der Datei in das Access-Add-In-Verzeichnis.
-
# Access-Add-In installieren
+
# Access-Add-In installieren  
-
#*Access starten
+
#*Allgemeine Variante
-
#*Access-Add-In-Manager öffnen
+
#*#Access starten
-
#*Entpackte Datei ''ACLibFilterFormWizard.mda'' auswählen. Die Datei wird von Access ins Verzeichnis '%appdata%\Microsoft\AddIns' kopiert.
+
#*#Access-Add-In-Manager öffnen
-
#*Die ursprünglich entpackte Datei kann gelöscht werden.
+
#*#Entpackte Datei ''ACLibFilterFormWizard.mda'' auswählen. Die Datei wird von Access ins Verzeichnis '%appdata%\Microsoft\AddIns' kopiert.
 +
#* Install/Update-Variante mit ''Install.vbs''
 +
#*#''Install.vbs'' ausführen
 +
#*#Auswählen ob das Add-In als mde oder mdb verwendet werden soll (Empfehlung: mde)<br />Add-In wird ins Verzeichnis '%appdata%\Microsoft\AddIns' kopiert.
 +
#*# Bei einem ''Update'' ist Installation abgeschlossen<br />Für eine Erst-Installation sind noch folgende Schritte notwendig:
 +
#*##Access starten
 +
#*##Access-Add-In-Manager öffnen
 +
#*##''ACLib FilterForm Wizard'' auswählen und auf "Installieren" klicken
 +
# Die ursprünglich entpackten Dateien können gelöscht werden.
{{info|text=
{{info|text=
Der FilterForm-Assistent ist ein Access Menü-Add-In und kann über das Add-In-Menü in der Menüleiste oder in der Multifunktionsleiste geöffnet werden.
Der FilterForm-Assistent ist ein Access Menü-Add-In und kann über das Add-In-Menü in der Menüleiste oder in der Multifunktionsleiste geöffnet werden.
}}
}}
-
 
==== Verwendung des Assistenten für den Import des Filter-Codes ====
==== Verwendung des Assistenten für den Import des Filter-Codes ====
Zeile 26: Zeile 40:
Den FilterForm-Assistenten über das Add-In-Menü öffnen. Anschließend folgende Schritte in der Maske ausführen:
Den FilterForm-Assistenten über das Add-In-Menü öffnen. Anschließend folgende Schritte in der Maske ausführen:
#Formular auswählen
#Formular auswählen
-
#Gewünschte Filter in der Maske eintragen
+
#Optional: Steuerelemente zum Anwenden der Filterbedingungen und Löschen der Filterwerte auswählen
 +
#Gewünschte Filter in der Maske eintragen oder aus Datenquelle des zu filternden Formulars eintragen lassen [http://access-codelib.net/videos/ACLib-FilterForm-Wizard/filter-formular-aus-datenquelle/ Video])
#*Datenfeld: das zu filternde Datenfeld
#*Datenfeld: das zu filternde Datenfeld
-
#*Datenyp: der Datenyp des Datenfeldes
+
#*Datentyp: der Datentyp des Datenfeldes
#*Vergleichsoperator: Wie soll der Datenfeldinhalt mit dem Filterwert verglichen werden (>, >=, <, ...)
#*Vergleichsoperator: Wie soll der Datenfeldinhalt mit dem Filterwert verglichen werden (>, >=, <, ...)
#*Steuerelement(e) auswählen
#*Steuerelement(e) auswählen
#**Steuerelement: das Steuerelement mit dem Filterwert
#**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
#**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 Formular enthalten ist, kann dieses durch aktivieren von "Neu" unterhalb der Steuerelementauswahl erstellt werden
+
#**Falls das Steuerelement noch nicht im Suchformular enthalten ist, kann dieses durch aktivieren von "Neu" unterhalb der Steuerelementauswahl erstellt werden
-
#UseFilter-Methode wählen
+
#ApplyFilter-Methode wählen
-
#*auskommentierter Beispiel-Code: Es wird im formular-Codemodul die Methode UseFilter erstellt, deren INhalt auskommentiert ist und manuell angepasst werden muss
+
#*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 UseFilter-Methode bezieht sich auf das aktuelle Formular unter Verwendung der Eigenschaft Form.Filter
+
#*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 UseFilter-Methode wird die Eigenschaft Form.Filter des Unterformulars verwenden
+
#*Unterformular: das Unterformularsteuerelement im Dropdown auswählen, die ApplyFilter-Methode wird die Eigenschaft Form.Filter des Unterformulars verwenden
#Filter-Variante auswählen
#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
#*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
#*FilterStringBuilder-Methoden: Zum Filtern wird mittels Klasse FilterStringBuilder der Filterstring erzeugt, die Filterung erfolgt mittels Code innerhalb des Filter-Formulars
 +
#benötigten SQL-Dialekt auswählen (Standard: Jet/DAO)
#Schaltfläche '''Formular-Code einfügen''' betätigen
#Schaltfläche '''Formular-Code einfügen''' betätigen
#Den eingefügten Code an die eigenen Bedürfnisse anpassen.
#Den eingefügten Code an die eigenen Bedürfnisse anpassen.
{{info|text=
{{info|text=
-
Mittels Mausklick auf '''Module installieren''' können bereits vorhandene Module auf den im FilterForm-Wizard enthaltene Version aktualisiert werden.
+
Alle mit dem Wizard verwendeten Steuerelemente benötigen einen Namen ohne Leerzeichen, damit dieser 1:1 im VBA-Code verwendet werden kann.
 +
}}
 +
 
 +
{{info|text=
 +
Mittels Mausklick auf '''Klassen installieren''' können bereits vorhandene Codemodule (Klassen, Standardmodule) auf die im FilterForm-Wizard enthaltene Version aktualisiert werden.
 +
}}
 +
 
 +
[http://access-codelib.net/videos/ACLib-FilterForm-Wizard/filter-formular-erstellen/ Video: Filter-Formular mit der Unterstützung des FilterForm-Assistenten erstellen]
 +
 
 +
[http://access-codelib.net/videos/ACLib-FilterForm-Wizard/filter-formular-aus-datenquelle/ 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.
 +
 
 +
 
 +
 
 +
{{related links|links=
 +
[[SQL-Text für Filterbedingung]]
}}
}}

Version vom 21:08, 18. Feb. 2017

Inhaltsverzeichnis

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

Download

ACLibFilterFormWizard.zip

Änderungsprotokoll

Version 1.6.3: Lokalisierung/Spracheinstellung - Bugfix für 64-Bit-Access
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.

Der FilterForm-Assistent ist ein Access Menü-Add-In und kann über das Add-In-Menü in der Menüleiste oder in der Multifunktionsleiste geöffnet werden.

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

Datei:ACL-FilterForm-Wizard_Filter_einstellen.png

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.

Alle mit dem Wizard verwendeten Steuerelemente benötigen einen Namen ohne Leerzeichen, damit dieser 1:1 im VBA-Code verwendet werden kann.

Mittels Mausklick auf Klassen installieren können bereits vorhandene Codemodule (Klassen, Standardmodule) auf die im FilterForm-Wizard enthaltene Version aktualisiert werden.

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