AddBookmark @Command (Formula Language)

Adds a bookmark with the specified URL or current object.

Note: This @command is new with Release 5.

Syntax

@Command( [AddBookmark] ; urlstring )

@Command( [AddBookmark] ; urlstring ; title )

@Command( [AddBookmark] ; urlstring ; title ; folder )

Parameters

urlstring

Text. Optional. The URL string for the database that you would like to bookmark. If you specify a null ("") string, this function takes the current object using the Domino® URL scheme as the object to be bookmarked. You can specify the url string for a database by specifying its replica id, without the colon, and preceding it with the "Notes®:///" prefix. The Notes® URL for a database displays in the Address bar at the beginning of the Notes® client window if you click the down arrow button.

title

Text. Optional. The title that you would like to specify for the bookmark. If you specify a null ("") string, you get a default title.

folder

Text. The name of the folder where you would like to place the bookmark. If you specify a null ("") string, this function will select either an open bookmark page, or a default bookmark folder.

Usage

This command does not work on the Web.

Examples

  1. This example, when triggered from a hotspot button on a form, creates a bookmark, named "User Log," for the application whose replica ID is 873476CD:0070A010. The bookmark appears in the "Logs" folder on the current user's bookmark bar. Because no server name was specified, the user may be prompted to select a server, if the application is not already in their workspace.
    @Command([AddBookmark];"Notes:///873476CD0070A010";"User Log";"Logs")
  2. This example, when triggered from a hotspot button on a form, creates a bookmark, named "Feedback1," for the application whose replica ID is 641599CD:0030C007. If they don't already have the application on their workspace, the replica on server Acme is used by default. The bookmark appears in the "ProductOne Customers" folder on the current user's bookmark bar.
    @Command([AddBookmark];"Notes://Acme/641599CD0030C007";"Feedback1";"ProductOneCustomers")
  3. This example, when triggered from a hotspot button on a form, creates a bookmark to the application on server Cyclone whose path on that server is sales\reports.nsf. The bookmark is named "Sales Reports" and appears in the first level of the current user's bookmark bar.
    @Command([AddBookmark];"Notes://Cyclone/sales/reports.nsf"; "Sales Reports")