FileOpenDatabase @Command (Formula Language)

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.

database

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 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.

viewName

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.

key

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.

newinstance

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.

temporary

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.

navigator

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

solo

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

Usage

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].