Eventos WebQueryOpen

Un evento WebQueryOpen ejecuta el agente antes de que Domino convierta un documento en HTML y lo envíe al navegador. IBM® Lotus® Domino(TM) hace caso omiso del resultado de este agente en este contexto.

Algunos ejemplos del empleo de este agente son la realización de extensos cálculos que no serían posibles con comandos de @Command o la recopilación de estadísticas sobre quién ha abierto ciertos documentos y cuándo lo ha hecho.

Nota Los agentes WebQueryOpen se ejecutan cuando el usuario abre un formulario o un documento, pero no cuando guarda un documento. Esto significa que los campos calculados establecidos por un agente WebQueryOpen no se guardan cuando el usuario envía un documento. Para asegurarse de que los campos calculados se guarden, puede recalcularlos en el agente WebQuerySave o definir el formulario con la propiedad Generar HTML para todos los campos.

Eventos WebQuerySave

Un evento WebQuerySave ejecuta el agente después de que se hayan ejecutado fórmulas de validación de los datos introducidos en un campo y antes de que el documento se guarde en el disco o se envíe por correo. El agente puede modificar el documento o utilizar los datos de éste para realizar otras operaciones. El documento se guarda automáticamente después de la ejecución del agente. No haga que el agente guarde el documento (por ejemplo, ejecutando NotesDocument.Save), dado que ello podría provocar resultados no deseados.

Un agente WebQuerySave puede producir mensajes que devolver al usuario. Por ejemplo, en un agente LotusScript se puede usar el comando Print para devolver HTML sin procesar. Si el agente produce mensajes, el formulario no debe tener un campo $$Return, porque Domino sólo mostrará el mensaje del agente, no el del campo.

Algunos ejemplos del uso de este agente son:

• Realización de validaciones de campo complejas. Si el documento no supera la validación, puede hacer que Domino no guarde el documento cambiando el valor del campo SaveOptions a "0" en el formulario.
• Simulación de programas CGI (del inglés Common Gateway Interface, interfaz común de gateway) que se ejecutan utilizando los datos suministrados por el usuario mediante la programación de un evento WebQuerySave y cambiando el valor del campo SaveOptions a "0" en el formulario. Cuando el agente se ejecute, se podrán recuperar los valores de los campos del formulario rellenado sin necesidad de generar un nuevo documento de Notes.
• Recopilación de estadísticas basadas en los datos enviados por los navegadores, como, por ejemplo, variables CGI, mediante la creación de un programa que emplee variables CGI y que se asocie a un evento WebQuerySave.

Glosario