FileOpenDBRepID @Command (Formula Language)

Syntax

@Command( [FileOpenDBRepID] ; replicaID ; serverHint ; viewName ; key ; newInstance ; temporary )

or

@Command( [FileOpenDBRepID] ; replicaID ; serverHint ; navigator ; solo ; newInstance ; temporary )

Parameters

replicaID

Text. The replica ID of the database you want to open. You can see the replica ID for a database in its InfoBox.

serverHint

Text. Optional. The name of a server where the database might reside. Notes/Domino checks this server for the replica before checking other servers only if the database was not accessible from a workspace icon.

viewName

Text. Optional. The name of the view that 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 person.

key

Text. Optional. Indicates which document you want Notes/Domino 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 always open in a new window, even if there's already a window open for the database. Specify an empty string ("") if you want the new window opened only when it's actually needed.

temporary

Number. Optional. Specify "1" if you want the database opened on a temporary basis for browsing, without adding the database to the user's workspace. Specify an empty string ("") if you want to add the database 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® to open the navigator named by navigator in its own window.

Usage

FileOpenDBRepID is useful whenever you want to write a formula for users working on several different replicas of the same database. Libraries, for example, use this command to open a database from the library.

FileOpenDBRepID looks for the replica in the following order:

• Checks the user's workspace for an icon with the specified replica ID.
• Checks the server indicated in the serverHint for the specified replica ID.
• Checks other home/mail servers specified in the location document for the specified replica ID.
• Presents the user with a list of servers to choose from.

This command does not work on the Web.

Examples

@Command( [FileOpenDBRepID] ; "85255F1E:004F2CEB";
   ""; "All by Category" )