@FindDocumentsByKey

Sucht in der Ansicht mit dem VIEWHANDLE VIEWHANDLE1 die Kategorie(n) mit dem Namen TEXT/TEXTLIST NAME2 und liefert eine VIEWPOS im Erfolgsfall zurück.
Ist NAME2 eine TEXTLIST, werden die Elemente nach einander in den sortierten Spalten gesucht.
Beispiel:
Eine Ansicht mit 3 sortierten Spalten Name, Ort, Str (zwischen diesen Spalten können auch noch weitere Spalten in der Ansicht entahlten sein, die nicht sortiert sind).
NAME2:="Meier":"Mainz":"Hauptstr";
So wird erst in der Spalte Name nach "Meier" gesucht, danach in der Spalte Ort nach "Mainz" und schließlich in der Spalte Str nach "Hauptstr".
Es wird, im Erfolgsfall, eine VIEWPOS auf das erste Dokument zurückgegeben, das diese Bedingungen erfüllt.

Beispiel: @FindDocumentsByKey(VIEWHANDLE1;NAME2);

DBHANDLE:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE;"TEST VIEW");
NAME2:="EINS";
VIEWPOS:=@FindDocumentsByKey(VIEWHANDLE1;NAME2);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE:=@CloseDB(DBHANDLE);

Es wird die Datenbank mit NotesPath "TEST.NSF" und die Ansicht mit dem Namen "TEST VIEW" geöffnet , der Key "EINS" in der Ansicht "TEST VIEW" wird gesucht und die VIEWPOS des ersten Dokuments ausgegeben.
Schließlich wird die Datenbank und die Ansicht wieder geschlossen.