Opens the specified database to the specified view, highlighting the first document whose value in the sort column matches the key. You specify a database using its server and file name.

Syntax

@Command( [FileOpenDatabase]; server : database ; viewName ; key ; newinstance ; temporary )

or

@Command( [FileOpenDatabase]; server : database ; navigator ; solo ; newinstance ; temporary )

Parameters

server

Text. The name of the server where the database resides.

Text. Optional. The path and file name (in the appropriate format for the operating system) of the database you want to open. If you omit the name of the database, and one is already open, Notes/Domino displays that database's view in the topmost, or current, window. If no database is open but one is selected on the workspace, the selected database is opened. If no databases are open or selected, Notes/Domino displays the Open Database dialog box, so the user can select a database.

Text. Optional. The name of the view you want to open in the database. If you omit the name of the view, the database opens to its default view; or, if the user has opened the database before, to the last view used by that user.

Text. Optional. Indicates which document you want Notes to scroll to when it opens viewName. The key is a value that appears in the first sorted column of viewName. If you omit the key, no document is selected.

Number. Optional. Specify "1" if you want the view to open in a new window, even if the database is already open in that view. If you omit this parameter, the new window is opened only if the database is opened in a new view.

Number. Optional. Specify "1" if you only want the database opened on a temporary basis for browsing, without adding the database to the user's workspace. If you omit this parameter, the database is added to the user's workspace.

Text. Optional. The name of a navigator defined for the database. On opening the database, Notes displays this navigator.

Number. Optional. A value of "1" instructs Notes/Domino to open the navigator named by navigator in its own window.

If you omit some of the parameters like viewName and key, but still include the parameters that come after it, substitute “” for each parameter that you're skipping, as in:

@Command([FileOpenDatabase]; "Sales":"PROBLEMS.NSF"; ""; ""; ""; "1" )

You can use this command in Web applications, but the server argument must be specified as a null string (""). When using the view argument, you must follow the command with @Command [OpenDocument].

Language cross-reference

GetDatabase method of LotusScript NotesSession class

GetDocumentByKey method of LotusScript NotesView class

OpenDatabase method of LotusScript NotesUIWorkspace class

getDatabase method of Java Session class

getDocumentByKey method of Java View class

Example
See Also

@Commands with ECL security
@Commands

Glossary