lock (NotesView - JavaScript)

Locks a view.

Defined in

NotesView

Syntax

lock() : boolean

lock(provisionalock:boolean) : boolean

lock(name:string) : boolean

lock(name:string, provisionalock:boolean) : boolean

lock(names:java.util.Vector) : boolean

lock(names:java.util.Vector, provisionalock:boolean) : boolean

Parameter	Description
`name` or `names`	The names of the lock holders. Each lock holder must be a user or group. Defaults to one lock holder: the effective user. The empty string ("") is not permitted.
`provisionalock`	true to permit the placement of a provisional lock false (default) to not permit a provisional lock

Return value	Description
`boolean`	true if the lock is placed false if the lock is not placed

Usage

IsDesignLockingEnabled in NotesDatabase must be true or this method throws an exception.

This method:

Places a persistent lock if the administration (master lock) server is available.
Places a provisional lock if the administration server is not available and the second parameter is true.
Throws an exception if the administration server is not available and the second parameter is false.

The following actions occur depending on the current lock status: If the view is not locked, this method places the lock and returns true.

If the view is locked and the current user is one of the lock holders, this method returns true.
If the view is locked and the current user is not one of the lock holders, this method returns false.
If the view is modified by another user before the lock can be placed, this method throws an exception.

Examples

This button locks a view.

database.setDesignLockingEnabled(true);
var v:NotesView = database.getView("main");
try {
	if (v.lock(true)) {
		requestScope.status = v.getName() + " locked";
	} else {
		requestScope.status = v.getName() + " not locked";
	}
} catch(e) {
	requestScope.status = v.getName() + " not locked";
}
var lh:java.util.Vector = v.getLockHolders();
requestScope.status += "\n" +
(lh.isEmpty() ? "No lock holder" : "\Current lock holder: " + lh.firstElement());
database.setDesignLockingEnabled(false);

Language cross-reference

Lock method in LotusScript® NotesView class

lock method in Java™ View class

Additional Documentation | Trademarks |