Comandos URL de Domino

La sintaxis de los comandos URL de Domino

Los comandos URL de Domino tienen la siguiente sintaxis:

http://Host/DominoObject?Action&Arguments

donde

• Host = una entrada del DNS o una dirección IP.
• DominoObject = una construcción de Domino (por ejemplo, una base de datos, vista, documento, formulario, navegador, agente, etc.).Los mandatos URL para acceder a DominoObjects utilizan la siguiente sintaxis: http://Host/Database/DominoObject?Action&Arguments donde Database = es la base de datos en la que reside DominoObject.
• Action = la operación que desea que se realice en el objeto de Domino especificado (por ejemplo, ?OpenDatabase, ?OpenView, ?OpenDocument, ?EditDocument, ?OpenForm, etc.)
• Arguments = 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).

Utilice las siguientes directrices cuando trabaje con las URL de Domino

• El nombre del servidor Domino no se utiliza en las URL de Domino. Host identifica el 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 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, especificar __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).
• Action puede ser 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.lotus-10.com/discussion.nsf/By+Author

  Http://www.lotus-10.com/discussion.nsf/By%20Author

• 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.lotus-10.com/leads.nsf/ByCompany/Smith%20%2B%20Jones?OpenDocument

  y

  http://www.lotus-10.com/leads.nsf/ByCompany/Smith%20+%20Jones?OpenDocument

  son válidas, pero

  http://www.lotus-10.com/leads.nsf/ByCompany/Smith+++Jones?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 "Smith&Jones, Inc.".:

  Http://www.lotus-10.com/leads.nsf/By%20Company/Smith%26Jones,%20Inc.?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.lotus-10.com/leads.nsf/ByCompany/Smith/Jones?OpenDocument

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

    http://www.lotus-10.com/leads.nsf/ByCompany/Smith/Jones

  • 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.lotus-10.com/leads.nsf/By+Salesperson?OpenView&ExpandView

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

  http://www.lotus-10.com/discussion.nsf/Docs/By+Author

• 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.