Using Domino URL Syntax
Domino URL commands enable designers to manipulate objects, such as forms or images, directly. Designers can provide navigational elements by adding URL commands as HTML on the form or button.
Domino URL syntax is as follows:
http://Host/Database/DominoObject?Action&Arguments
Table 16.4 explains URL syntax by listing its parameters and their descriptions.
URLs cannot contain spaces, so designers need to replace spaces with a plus (+) symbol or the hex ASCII equivalent (%20). You must use the Hex ASCII equivalent if a symbol conflicts with the URL syntax. For example, imagine that a view named Sales&Commission is used in an URL. The Ampersand (&) symbol conflicts with the &Arguments and must be replaced with the HEX ASCII equivalent. Ampersands (&) use %26 and forward slashes use %2F.
To attach URLs to a button or a hotspot Click event, first select the Use JavaScript When Generating Pages option in the Database Properties. If this option isn't checked, the URL will be computed when rendered to the Web.
Table 16.5 shows some examples of DominoObjects and their URLs.
| DominoObject | URL |
|---|---|
| Attachments | http://Host/Database/View/Document$File/InternalFileName?OpenElement |
| Database | http://Host/__DatabaseReplicaID.nsf?OpenDatabase |
| View | http://Host/Database/ViewName?OpenView |
| DefaultView | http://Host/Database/$defaultview?OpenView |
| View data in XML form without attributes | This command returns only the documents a user is allowed to access. http://Host/Database/ViewName? |
| About This Database | http://Host/Database/$about?OpenAbout |
| Using This Database | http://Host/Database/$help?OpenHelp |
| Access Database Icon | http://Host/Database/$icon?OpenIcon |
| FrameSet | http://Host/Database/FramesetName?OpenFrameset |
| Agents | http://Host/Database/AgentName?OpenAgent |
| Form
Default Form Read Form | http://Host/Database/FormName?OpenForm
http://Host/Database/$defaultform?OpenForm http://Host/Database/FormName?ReadForm |
| Navigator Default Navigator | http://Host/Database/NavigatorName?OpenNavigator
http://host/database.nsf/$DefaultNav?OpenNavigator The above displays all non-hidden views to the Web. Enclose View Names in parens to block this. |
| Pages | http://Host/Database/PageName?OpenPage |
| Document | http://Host/Database/FormName?CreateDocument
http://Host/Database/View/Document?OpenDocument http://Host/Database/View/Document?EditDocument http://Host/Database/View/Document?DeleteDocument http://Host/Database/View/Document?SaveDocument |
| SearchView | Limits search to one database view. http://Host/Database/ViewName/[$SearchForm]? SearchView[ArgumentList] |
| Image Resources | http://Host/Database/ ImageResourceName?OpenImageResource |
| File Resources | http://Host/Database/ FileResourceName?OpenFileResource |
| Web Preferences | http://Host/$Preferences.nsf?OpenPreferences&Argument Allows users to set time zone and regional settings such as date/time formats. These settings are stored in a cookie in the user's browser. Web preferences need to be enabled through Internet Site documents. $Preferences.nsf is a virtual database that resides at the root of the Domino 6 server. |
Designers can also restrict users from opening forms or views with URL commands by setting the Don't Allow URL Open property in the Basics tab of the Database.