@GetNoteIDsFromView

The NoteID’s the documents in the view to VIEWHANDLE VIEWHANDLE1 are, from of the VIEWPOSITION/VIEWPOS VIEWPOSITION2, as IDList returned.

VIEWPOSITION2 is a FNLIST with 10 entries.
The 1st entry contains the number of categorized columns; the 10th entry contains the number of entries in the category.
In order to point to the first dosument in a not categorized view, VIEWPOSITION3 must have the following form: 0:1:0:0:0:0:0:0:0:0.

When called with the parameters FNCATOFFSET3 and FNDOCSCOUNT4:

FNCATOFFSET3:
This parameter specifies how many documents should be skipped in each category.
If 0 (zero) is specified here, no documents are skipped.

FNDOCSCOUNT4:
This parameter specifies how many documents should be read from the category.
If the category contains fewer documents than specified here, the NoteIDs that are not available are set to 0 (zero).
If 0 (zero) is specified here, all documents are read.

Example: @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);

The operation the database with NotesPath "TEST.NSF" and the view with the names "TEST VIEW" opened, the category "EINS" in the view "TEST VIEW" is searched for and from this category are alle NoteID’s in this view the varifromle IDList assigned.
Finally is the database and the view again closed.

Examplee: @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);

The operation the database with NotesPath "TEST.NSF" and the view with the names "TEST VIEW" opened, the category "EINS" in the view "TEST VIEW" is searched for and from this category are alle NoteID’s of the respective firstn document’s in each category in this view the varifromle IDList assigned.
Finally is the database and the view again closed.

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);

The operation the database with NotesPath "TEST.NSF" and the view with the names "TEST VIEW" opened, the category "EINS" in the view "TEST VIEW" is searched for and from this category are alle NoteID’s of the respective zweiten document’s in each category in this view the varifromle IDList assigned.
Ist in of a category no zweites document vorhanden is in the IDList at this Stelle a (0 Null) set.
Finally is the database and the view again closed.

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);

The operation the database with NotesPath "TEST.NSF" and the view with the names "TEST VIEW" opened, the category "EINS" in the view "TEST VIEW" is searched for and from this category are alle NoteID’s of the respective zweiten and dritten document’s in each category in this view the varifromle IDList assigned.
Ist in of a category no zweites and/or drittes document vorhanden is in the IDList statt the NoteID(’s) a or zwei Null(en) set.
Finally is the database and the view again closed.

Zur Verdeutlichung:

EINS
   Dok1.1 (NoteID 1)
category2
   Dok2.1 (NoteID 2)
   Dok2.2 (NoteID 3)
   Dok2.3 (NoteID 4)
category3
   Dok3.1 (NoteID 5)
category4
   Dok4.1 (NoteID 6)
   Dok4.2 (NoteID 7)
category5
   Dok5.1 (NoteID 8)
   Dok5.2 (NoteID 9)
   Dok5.3 (NoteID 10)

In the first Example (FNCATOFFSET3:=0;FNDOCSCOUNT4:=1;) would be a IDList with folgendem contents returned:
1:2:5:6:8.

In the second Example (FNCATOFFSET3:=1;FNDOCSCOUNT4:=1;) would be a IDList with folgendem contents returned:
0:3:0:7:9.

In the third Example (FNCATOFFSET3:=1;FNDOCSCOUNT4:=2;) would be a IDList with folgendem contents returned:
0:0:3:4:0:0:7:0:9:10.

Note : This text was machine-translated and may contain inaccuracies.