@GetNoteIDsFromView

Die NoteID’s der Dokumente in der Ansicht zu dem VIEWHANDLE VIEWHANDLE1 werden, ab der VIEWPOSITION/VIEWPOS VIEWPOSITION2, als IDList zurückgegeben.

VIEWPOSITION2 ist eine FNLIST mit 10 Einträgen.
Im 1.Eintrag steht die Anzahl der kategorisierten Spalten, im 10.Eintrag die Anzahl der Einträge in der Kategorie.
Um auf das erste Dokument einer nicht kategorisierten Ansicht zu zeigen muß VIEWPOSITION2 folgende Gestalt haben: 0:1:0:0:0:0:0:0:0:0.

Bei einem Aufruf mit den Parametern FNCATOFFSET3 und FNDOCSCOUNT4:

FNCATOFFSET3:
Mit diesem Parameter wird bestimmt wieviele Dokumente in jeder Kategorie übersprungen werden sollen.
Wird hier 0 (Null) übergeben werden keine Dokumente übersprungen.

FNDOCSCOUNT4:
Mit diesem Parameter wird bestimmt wieviele Dokumente in der Kategorie gelesen werden sollen.
Sind weniger als die hier angegebenen Dokumente in der Kategorie werden die nicht vorhandenen NoteID’s auf 0 (Null) gesetzt.
Wird hier 0 (Null) übergeben werden alle Dokumente gelesen.

Beispiel: @GetNoteIDsFromView(VIEWHANDLE1;VIEWPOSITION2)

DBHANDLE1:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE1;"TEST VIEW");
VIEWPOSITION2:=0:0:0:0:0:0:0:0:0:0;
VIEWPOSITION2:=@FindCategoryByName(VIEWHANDLE1;"EINS";VIEWPOSITION2);
IDList:=@GetNoteIDsFromView(VIEWHANDLE1;VIEWPOSITION2);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE1:=@CloseDB(DBHANDLE1);

Es wird die Datenbank mit NotesPath "TEST.NSF" und die Ansicht mit dem Namen "TEST VIEW" geöffnet , die Kategorie "EINS" in der Ansicht "TEST VIEW" wird gesucht und ab dieser Kategorie werden alle NoteID’s in dieser Ansicht der Variable IDList zugewiesen.
Schließlich wird die Datenbank und die Ansicht wieder geschlossen.

Beispiele: @GetNoteIDsFromView(VIEWHANDLE1;VIEWPOSITION2;FNCATOFFSET3;FNDOCSCOUNT4)

DBHANDLE1:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE1;"TEST VIEW");
VIEWPOSITION2:=0:0:0:0:0:0:0:0:0:0;
VIEWPOSITION2:=@FindCategoryByName(VIEWHANDLE1;"EINS";VIEWPOSITION2);
FNCATOFFSET3:=0;
FNDOCSCOUNT4:=1;
IDList:=@GetNoteIDsFromView(VIEWHANDLE1;VIEWPOSITION2;FNCATOFFSET3;FNDOCSCOUNT4);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE1:=@CloseDB(DBHANDLE1);

Es wird die Datenbank mit NotesPath "TEST.NSF" und die Ansicht mit dem Namen "TEST VIEW" geöffnet , die Kategorie "EINS" in der Ansicht "TEST VIEW" wird gesucht und ab dieser Kategorie werden alle NoteID’s des jeweils ersten Dokument’s in jeder Kategorie in dieser Ansicht der Variable IDList zugewiesen.
Schließlich wird die Datenbank und die Ansicht wieder geschlossen.

DBHANDLE1:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE1;"TEST VIEW");
VIEWPOSITION2:=0:0:0:0:0:0:0:0:0:0;
VIEWPOSITION2:=@FindCategoryByName(VIEWHANDLE1;"EINS";VIEWPOSITION2);
FNCATOFFSET3:=1;
FNDOCSCOUNT4:=1;
IDList:=@GetNoteIDsFromView(VIEWHANDLE1;VIEWPOSITION2;FNCATOFFSET3;FNDOCSCOUNT4);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE1:=@CloseDB(DBHANDLE1);

Es wird die Datenbank mit NotesPath "TEST.NSF" und die Ansicht mit dem Namen "TEST VIEW" geöffnet , die Kategorie "EINS" in der Ansicht "TEST VIEW" wird gesucht und ab dieser Kategorie werden alle NoteID’s des jeweils zweiten Dokument’s in jeder Kategorie in dieser Ansicht der Variable IDList zugewiesen.
Ist in einer Kategorie kein zweites Dokument vorhanden wird in der IDList an dieser Stelle eine (0 Null) gesetzt.
Schließlich wird die Datenbank und die Ansicht wieder geschlossen.

DBHANDLE1:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE1;"TEST VIEW");
VIEWPOSITION2:=0:0:0:0:0:0:0:0:0:0;
VIEWPOSITION2:=@FindCategoryByName(VIEWHANDLE1;"EINS";VIEWPOSITION2);
FNCATOFFSET3:=1;
FNDOCSCOUNT4:=2;
IDList:=@GetNoteIDsFromView(VIEWHANDLE1;VIEWPOSITION2;FNCATOFFSET3;FNDOCSCOUNT4);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE1:=@CloseDB(DBHANDLE1);

Es wird die Datenbank mit NotesPath "TEST.NSF" und die Ansicht mit dem Namen "TEST VIEW" geöffnet , die Kategorie "EINS" in der Ansicht "TEST VIEW" wird gesucht und ab dieser Kategorie werden alle NoteID’s des jeweils zweiten und dritten Dokument’s in jeder Kategorie in dieser Ansicht der Variable IDList zugewiesen.
Ist in einer Kategorie kein zweites und/oder drittes Dokument vorhanden wird in der IDList statt der NoteID(’s) eine bzw. zwei Null(en) gesetzt.
Schließlich wird die Datenbank und die Ansicht wieder geschlossen.

Zur Verdeutlichung:

EINS
   Dok1.1 (NoteID 1)
Kategorie2
   Dok2.1 (NoteID 2)
   Dok2.2 (NoteID 3)
   Dok2.3 (NoteID 4)
Kategorie3
   Dok3.1 (NoteID 5)
Kategorie4
   Dok4.1 (NoteID 6)
   Dok4.2 (NoteID 7)
Kategorie5
   Dok5.1 (NoteID 8)
   Dok5.2 (NoteID 9)
   Dok5.3 (NoteID 10)

Bei dem ersten Beispiel (FNCATOFFSET3:=0;FNDOCSCOUNT4:=1;) würde eine IDList mit folgendem Inhalt zurückgegeben:
1:2:5:6:8.

Bei dem zweiten Beispiel (FNCATOFFSET3:=1;FNDOCSCOUNT4:=1;) würde eine IDList mit folgendem Inhalt zurückgegeben:
0:3:0:7:9.

Bei dem dritten Beispiel (FNCATOFFSET3:=1;FNDOCSCOUNT4:=2;) würde eine IDList mit folgendem Inhalt zurückgegeben:
0:0:3:4:0:0:7:0:9:10.