Beschreibung:
Setzt einen Filter anhand eines Feldinhalts. Beachten Sie auch gerne die Informationen zur empfohlenen Vorgehensweise im Kapitel Ausführen eines Filters.
Wichtig: Es sollten zuvor alle etwaig geholten Record-Objekte auf Nothing gesetzt werden, keinesfalls dürfen sie anschließend noch verwendet werden. Werden bei einer Suche über mehrere Felder keine Datensätze gefunden, so wird automatisch eine zweite Suche nach dem kompletten Leerzeichen-separierten Suchwert durchgeführt, jedoch lediglich im ersten Suchfeld.
Parameter:
|
Parametername |
Typ |
Beschreibung |
|
FieldName |
String |
Name des Feldes bzw. mehrere Felder, welche mittels "+" getrennt angegeben werden. Hierbei können auch 1:1-relational oder 1:1:1 relational verknüpfte Felder angegeben werden. Bei 1:1(:1) verknüpften relationalen Feldern muss der vollständige relationale Pfad verwendet werden, z. B. "CompanyID.Firmen.ID.Company". |
|
Contents |
String |
Suchbegriff(e). Suchbegriffe für mehrere Felder werden per Leerzeichen-Separator übergeben. Wenn ein Suchbegriff ein Leerzeichen enthalten soll, dann werden die Suchbegriffe mit einem Komma getrennt. Das Komma kann zudem verwendet werden, um ein Suchfeld (siehe Parameter FieldName) auszulassen. |
|
SearchType |
Long |
0 Normal 1 Exakt 2 Wildcard 3 Phonetisch 4 Enthält |
|
CaseSensitive |
Long |
Gross-/Kleinschreibung beachten: 0 nicht CaseSensitive 1 CaseSensitive |
|
bUseCurrentQuery (Optional) |
Bool |
True: Der Filter basiert auf dem aktuell bestehenden Filter. False (Voreinstellung): Es wird ein neuer Filter erstellt. |
Rückgabewert:
Bool
|
Wert |
Beschreibung |
|
True |
Filter konnte erstellt werden. Alle gefilterten Datensätze sind ab diesem Zeitpunkt im verwendeten RecordSet-Objekt enthalten, der Filter muss aber nicht zwingend Datensätze enthalten. |
|
False |
Filter konnte nicht ausgeführt werden. Prüfen Sie ggf. Debwin auf Fehlerausgaben des Datenbanksystems. |
Beispiel VBScript:
' Dieses Beispiel basiert auf der Kontakte-Ansicht einer combit_Large-Solution
Call cRM.CurrentProject.ActiveViews.ActiveView.CurrentRecordSet.SetFilterByFieldName("ContactID.Kontakte.ID.CompanyID.Firmen.ID.Company" + "ContactID.Kontakte.ID.Name", "Albatros Flug", 0, 0)
Beispiel C#-Script:
// Dieses Beispiel basiert auf der Kontakte-Ansicht einer combit_Large-Solution
cRM.CurrentProject.ActiveViews.ActiveView.CurrentRecordSet.SetFilterByFieldName("ContactID.Kontakte.ID.CompanyID.Firmen.ID.Company" + "ContactID.Kontakte.ID.Name", "Albatros Flug", 0, 0);