URLOpen (NotesUIWorkspace - LotusScript®)

Retrieves a World Wide Web page specified by its URL.

Defined in

NotesUIWorkspace

Syntax

Call notesUIWorkspace .URLOpen( Url$ , reload% , urlList% , charset$ , webusername$ , webpassword$ , proxywebusername$ , proxywebpassword$, notesRetriever )

Parameters

Url$

String. Optional. The URL for the Web page you want to open, for example, http://www.acme.com/. If you omit this parameter, you see the Open URL dialog box where the user can enter the URL for the Web page.

reload%

Integer. Optional. Enter 1 (True) to reload the page from its Internet server. Enter 0 (False) to load the page from the Internet only if it is not already in the Web Navigator database. Enter 2 to reload the page only if it has been modified on its Internet server. The default value is 0.

urlList%

Integer. Optional. Web pages can contain URL links to other Web pages. This value specifies that the Web Navigator should save the URLs in a field called URLLinksn in the document. (The Web Navigator creates a new URLLinksn field each time the field size reaches 64K. For example, the first URLLinks field would be URLLinks1, the second would be URLLinks2, and so on.)

If you save the URLs, you can use them in agents; for example, you could create an agent that opens Web pages in the Web Navigator database and then loads all the Web pages saved in each of the URLLinksn field(s).

charset$

String. Optional. Enter the MIME character set (for example, ISO-2022-JP for Japanese or ISO-8859-1 for United States) that you want the Web Navigator to use when processing the Web page. Use this parameter only when the Web Navigator misdetects the correct MIME character set of the URL contents.

webusername$

String. Optional. Some Internet servers require you to obtain a username before you can access their pages. This parameter allows you to enter the username that you previously obtained from the Internet server.

webpassword$

String. Optional. Some Internet servers require you to obtain a password before you can access their pages. This parameter allows you to enter the password that you previously obtained from the Internet server.

proxywebusername$

String. Optional. Some proxy servers require that you specify a user name in order to connect through them. This parameter allows you to enter the user name for the proxy server. See your administrator for the user name required by the proxy.

proxywebpassword$

String. Optional. Some proxy servers require that you specify a password in order to connect through them. This parameter allows you to enter the password for the proxy server. See your administrator for the password required by the proxy.

notesRetriever

Boolean. Optional. If set to False or omitted, the default browser opens the URL. If present, or set to True, the Notes® Web Navigator opens the URL.

Example