getPosition (NotesViewEntry - JavaScript™)

Returns the position of the entry in the view hierarchy, for example, 2.3 for the third document of the second category.

Defined in

NotesViewEntry

Syntax

getPosition(separator:char) : string


Parameter	Description
`separator`	The separator to be used in the return value.


Return value	Description
`string`	A series of integers (in string format) and separators. The integers indicate the positions of the view entry at each level, where 1 is the first position. The first integer indicates the first level and so on.

Examples

This button gets the position, first-column value, and child count for the top-level entries in a view excluding the total.

var nav:NotesViewNavigator = database.getView("By category").createViewNav();
var entry:NotesViewEntry = nav.getFirst();
while (entry != null && !entry.isTotal()) {
	requestScope.status += "\n" +
	entry.getPosition(".") + " " +
	entry.getColumnValues().firstElement().toString() + " has" +
	entry.getChildCount().toFixed() + " immediate entries";
	var tmpentry:NotesViewEntry = nav.getNextSibling(entry);
	entry.recycle();
	entry = tmpentry;
}