Nota Un comando URL de Domino no es lo mismo que un comando URL de IBM® Lotus® Notes®. Los comandos URL de Domino utilizan una interfaz de navegador de Web para acceder a las aplicaciones y navegar por ellas, mientras que los comandos URL de Notes utilizan la estructura de la URL para acceder a las aplicaciones y navegar por ellas desde un cliente Notes.

La sintaxis de los comandos URL de Domino

Los comandos URL de Domino tienen la siguiente sintaxis:

http://Host/ObjetodeDomino?Acción&Argumentos

donde

• Host = una entrada del DNS o una dirección IP.
• ObjetodeDomino = un componente de Domino (por ejemplo, una base de datos, una vista, un documento, un formulario, un guía, un agente, etc.) Los comandos URL para acceder a objetos de Domino utilizan la siguiente sintaxis: http://Host/Basededatos/ObjetodeDomino?Acción&Argumentos donde Basededatos = la base de datos en la que residen los objetos de Domino.
• Acción = la operación que desea que se realice en el objeto de Domino especificado (por ejemplo, ?OpenDatabase, ?OpenView, ?OpenDocument, ?EditDocument, ?OpenForm, etc.)
• Argumentos = un calificador de la acción (por ejemplo, Count = 10 combinado con la acción ?OpenView limitará a 10 el número de filas mostradas en una vista).

• El nombre del servidor Domino no se utiliza en las URL de Domino. Host identifica al servidor.
• Puede especificar el tamaño máximo y otros límites de un comando URL en el documento de servidor, en los campos que aparecen debajo de la ficha Protocolos de Internet > HTTP.
• Algunos de los identificadores especiales que se utilizan en los comandos URL de Domino son: $defaultView, $defaultForm, $searchForm, $file, $icon, $help, $about y $first.
• ObjetodeDomino puede tomar cualquiera de los siguientes valores: para una base de datos, el nombre de esta o el ID de réplica; para otros objetos, el nombre de dicho objeto, el ID universal o un identificador especial. Por ejemplo, para especificar una vista en una URL, puede utilizar cualquiera de los valores siguientes: el nombre de la vista, el ID universal de la vista o $defaultView.
• Se puede especificar una base de datos de IBM® Lotus® Notes® por su nombre de archivo, como, por ejemplo, pedidos.nsf o colocando dos signos de subrayado antes del ID de la réplica y agregando el sufijo .nsf al final. Por ejemplo, __852562F3007ABFD6.nsf.
• El nombre de un objeto de Domino y su ID universal son idénticos en todas las réplicas de una base de datos. Un nombre o alias puede hacer referencia a dos objetos (por ejemplo, dos formularios con el mismo nombre cuando uno de ellos está oculto para los usuarios de Notes y el otro está oculto para los usuarios de Web).
• Acción puede ser una acción explícita o implícita. Algunos ejemplos de acciones explícitas son ?OpenDatabase, ?OpenView, ?OpenDocument, ?OpenForm, ?EditDocument. Algunos ejemplos de acciones implícitas son ?Open, ?Edit y ?Delete. Si no se especifica ninguna acción, Domino utilizará ?Open como acción predeterminada.
• Incluya el argumento Login en las URL de Domino si desea autentificar al usuario.
• Puesto que las URL no pueden incluir espacios, utilice el signo + (más) o el valor hexadecimal %20 para representar un espacio. Por ejemplo:

  http://www.mercurio.com/debates.nsf/Por+autores

  Http://www.mercurio.com/debates.nsf/Por%20Autores

• Si un nombre contiene una combinación de espacios y el carácter "+", es posible que sea necesario utilizar %20 para indicar el espacio. Por ejemplo, si la clave del documento es "Salgado + Juncal", entonces

  http://www.mercurio.com/clientes.nsf/Porempresas/Salgado%20%2B%20Juncal?OpenDocument

  y

  http://www.mercurio.com/clientes.nsf/Porempresas/Salgado%20+%20Juncal?OpenDocument

  son válidas, pero

  http://www.mercurio.com/clientes.nsf/Porempresas/Salgado+++Juncal?OpenDocument

  no lo es.

• Cuando los nombres o argumentos contengan símbolos que no puedan formar parte de la sintaxis de la URL o puedan ocasionar conflictos con esta, como, por ejemplo, signos más (+), barras inclinadas (\ o /) o ampersands (&), use los caracteres de escape con formato %xx (donde xx es el valor ascii hexadecimal) para representar el símbolo. Por ejemplo, la siguiente URL abre el documento cuyo valor clave es "Salgado&Juncal, S.A.":

  Http://www.mercurio.com/clientes.nsf/Por%20empresas/Salgado%26Juncal,%20S.A.?OpenDocument

• Las barras inclinadas y las barras invertidas en los componentes de ruta de acceso a la URL no se distinguen, aunque se utilicen caracteres de escape. (Esto es debido a que el primer paso al procesar la URL consiste en eliminar todas las secuencias de escape y cambiar '\' por '/'.) El resultado es que algunos nombres serán ambiguos o no se podrán resolver. Por ejemplo, mientras dos vistas, una denominada "a/b\c/d" y la otra "a\b/c\d" son distintas en el diseñador, no se les puede asignar un nombre exclusivo con una URL.
• Las claves de documento que contengan barras inclinadas y/o barras invertidas se podrán resolver con las siguientes restricciones:
  • Es necesario proporcionar el argumento de comando ?OpenDocument en la URL. Por ejemplo, si la clave del documento es "Salgado/Juncal", la URL siguiente encontrará el documento:
  
  http://www.mercurio.com/clientes.nsf/Porempresas/Salgado/Juncal?OpenDocument

  pero esta otra producirá el siguiente mensaje de error "Error 404 - La entrada no se ha hallado en el índice":

  http://www.mercurio.com/clientes.nsf/Porempresas/Salgado/Juncal

  • El título del documento tal y como se almacena en la base de datos debe usar siempre "/" o "\". Si utiliza una combinación de ellas, no se localizará el documento.
  • El uso de barras inclinadas (de ambos tipos) en los nombres de las vistas junto con barras inclinadas en los títulos de los documentos puede dar como resultado ambigüedades y documentos "ilocalizables". Si tiene una vista denominada "a" que contiene un documento titulado "b/c", y otra vista denominada "a\b" que contiene un documento "c", la URL /basededatos.nsf/a/b/c?OpenDocument abrirá el documento en la vista a/b.
  • Los títulos de documento que comienzan o terminan con el carácter "/" o "\" no se localizarán.
• El uso del carácter de porcentaje ("%") no está permitido en una URL, aunque se introduzca con una secuencia de escape. Esto ayudará a evitar los ataques que intenten enmascarar su propósito añadiendo un secuencia de escape al carácter de escape.
• Separe los argumentos mediante ampersands (&). Por ejemplo:

  http://www.mercurio.com/clientes.nsf/Por+vendedores?OpenView&ExpandView

• Separe los nombres jerárquicos mediante barras inclinadas (/). Por ejemplo, para abrir una vista denominada Docs\Por autores en la base de datos de debates, introduzca la siguiente URL:

  http://www.mercurio.com/debates.nsf/Docs/Por+autores

• Si está generando sus propias URL para alguna parte de una aplicación, utilice alias sencillos siempre que sea posible para evitar las URL con caracteres no permitidos.
• Los comandos URL también se pueden referir a bases de datos con sufijos .nsf4, .nsf5, .nsf6 o .box. También lo pueden hacer con archivos de plantillas (.ntf), pero esas bases de datos sólo se podrán abrir en el modo de vista previa.
• La selección de Acceso Web: Usar JavaScript al generar páginas en las propiedades de la base de datos le permitirá calcular las URL anexadas a botones y zonas activas en el evento Click. Si no se selecciona esta opción, las URL anexadas a botones y zonas activas se calcularán mientras se genera la página. La activación de esta propiedad puede ser útil si está utilizando campos editables en un formulario.

Comandos URL para abrir servidores, bases de datos y vistas
Comandos URL para abrir conjuntos de marcos
Comandos URL para abrir agentes, formularios y guías
Comandos URL para crear, eliminar, editar, abrir y guardar documentos
Comandos URL para abrir documentos según la clave
Comandos URL para abrir páginas
Comandos URL para abrir anexos, archivos de imagen y objetos OLE
Comandos URL para buscar texto
Uso de botones o zonas activas "Siguiente" y "Atrás" con parámetros Start y Count
Comandos URL para autentificación obligatoria
Comandos URL para procesar los certificados de SSL

Glosario