Recupera una página World Wide Web especificada por su URL.

Sintaxis

@URLOpen

@URLOpen( cadena-URL )

@URLOpen( cadena-URL ; [ cargar-de-nuevo ] )

@URLOpen( cadena-URL ; [URLLIST] )

@URLOpen( cadena-URL ; [ cargar-de-nuevo ]:[URLLIST] )

@URLOpen( cadena-URL ; [ cargar-de-nuevo ]:[URLLIST] ; juego-caracteres )

@URLOpen( cadena-URL ; [ cargar-de-nuevo ]:[URLLIST] ; juego-caracteres; nombre-usuario-Web )

@URLOpen( cadena-URL ; [ cargar-de-nuevo ]:[URLLIST] ; juego-caracteres ; nombre-usuario-Web; contraseña-Web )

@URLOpen( cadena-URL ; [ cargar-de-nuevo ]:[URLLIST] ; juego-caracteres ; nombre-usuario-Web ; contraseña-Web ; nombre-usuario-proxy )

@URLOpen( cadena-URL ; [ cargar-de-nuevo ]:[URLLIST] ; juego-caracteres ; nombre-usuario-Web ; contraseña-Web ; nombre-usuario-proxy ; contraseña-proxy )

Parámetros

cadena-URL

Texto. Opcional. La URL de la página Web que desea abrir, por ejemplo, http://www.hyd.com.

Palabra clave. Opcional.

RELOAD. Carga de nuevo la página desde el servidor de Internet.

RELOADIFMODIFIED. Carga de nuevo la página únicamente si ha sido modificada en el servidor Internet.

Palabra clave. Opcional. Las páginas Web pueden contener vínculos URL a otras páginas Web. Esta palabra clave indica que Web Navigator debe guardar las URL en un campo denominado $URLLinksn en el documento de Notes/Domino. (Web Navigator crea un nuevo campo $URLLinksn siempre que el tamaño de éste alcance los 64 kB. Por ejemplo, el primer campo $URLLinks creado será $URLLinks1, el segundo será $URLLinks2, y así sucesivamente).

Si guarda las URL, puede utilizarlas en los agentes; por ejemplo, podría crear un agente que abra páginas Web en la base de datos Web Navigator, y, a continuación, cargue todas las páginas Web almacenadas en cada uno de los campos $URLLinksn.

Cuidado Si guarda las URL en campos $URLLinksn, las prestaciones pueden verse afectadas.

Palabras clave. Opcional. Especifique ambas para volver a cargar la página Web y guardar las URL en el campo $URLLinksn del documento de Notes/Domino.

Texto. Opcional. Introduzca el juego de caracteres MIME (por ejemplo, ISO-2022-JP para Japón o ISO-8859-1 para Estados Unidos) que debe utilizar Web Navigator al procesar la página Web. Use este parámetro solamente cuando Web Navigator sea incapaz de identificar correctamente el juego de caracteres MIME empleado por la página Web.

Texto. Opcional. Algunos servidores de Internet requieren un nombre de usuario poder acceder a sus páginas. Este parámetro le permitirá especificar el nombre de usuario previamente obtenido del servidor de Internet.

Texto. Opcional. Algunos servidores de Internet requieren una contraseña para poder acceder a sus páginas. Este parámetro le permitirá especificar la contraseña previamente obtenida del servidor de Internet.

Texto. Opcional. Algunos servidores proxy requieren un nombre de usuario para poder realizar la conexión a través de ellos. Este parámetro le permitirá especificar el nombre de usuario para el servidor proxy. Póngase en contacto con el administrador para que le suministre el nombre de usuario requerido por el servidor proxy.

Texto. Opcional. Algunos servidores proxy requieren una contraseña para poder realizar la conexión a través de ellos. Este parámetro le permitirá especificar la contraseña para el servidor proxy. Póngase en contacto con el administrador para que le suministre dicha contraseña.

La función @URLOpen puede utilizarse tanto desde la estación de trabajo Notes como desde el servidor Domino.

El nombre de usuario y la contraseña únicamente deben usarse en el contexto de la base de datos Web Navigator. Los demás navegadores siempre solicitan la autentificación.

Si la utiliza en el servidor, necesita especificar al menos un parámetro con la función; si usa la función sin incluir ningún parámetro, Notes intentará mostrar el cuadro de diálogo URL Open, lo cual no puede hacerse desde el servidor. Si desea utilizar cualquiera de los parámetros que vienen a continuación de las palabras clave Reload y URLList sin tener que especificar valores para alguna de estas palabras, introduzca un cero (0) como valor para dichas palabras. Por ejemplo, @URLOpen("http://www.ibm.com";0;"mi-nombre-de-usuario";"mi-contraseña").

Cuando un navegador de Notes ejecuta la función @URLOpen, muestra la página Web recuperada en una nueva ventana. Si desea programar una función @URLOpen que se utiliza en un formulario o página a la que sólo se va a acceder mediante un navegador distinto de Notes para que muestre la página Web recuperada en una nueva ventana, cree una zona activa con acción y agregue target=\" " a la cadena URL en su evento Click. Por ejemplo, @URLOpen("http:\\www.ibm.com" target=\" "). Asegúrese de dejar un espacio entre las comillas que vienen a continuación de target=\.

Para abrir otro elemento de diseño de la base de datos de Notes actual en una aplicación de Web, utilice la función @WebDbName para codificar correctamente el nombre de la base de datos.

Consulte Comandos URL de Domino si desea acceder a una lista con los comandos URL que puede utilizar para abrir elementos de diseño en un navegador.

Equivalencias en otros lenguajes

Método URLOpen de la clase NotesUIWorkspace de LotusScript

Método GetDocumentByURL de la clase NotesDatabase de LotusScript

Método getDocumentByURL de la clase Database de Java

Ejemplo
Véase también

@URLGetHeader
@URLHistory
Funciones @ afectadas por la Lista de control de ejecución
"Taking your Domino applications to the Web" en Lotus Developer Domain
"Combining forms and views for friendlier Web applications (Part 2)" en Lotus Developer Domain
"Mapping it out: Generated maps for your Web application" en Lotus Developer Domain
"Creating a Web community" en Lotus Developer Domain
"Scrolling to the end of a view with one click" en Tips de Lotus Developer Domain