Para crear un programa relacionado con un evento, es posible utilizar:

• Fórmulas
• Acciones simples
• LotusScript
• JavaScript
• JavaScript común (funciona tanto en Internet como en el cliente IBM® Lotus® Notes®)

Utilice la programación de eventos para ejecutar tareas muy concretas que no deban activar los usuarios. La programación de eventos es especialmente útil cuando el momento de ejecución del programa deba ser preciso o cuando las tareas estén relacionadas con un elemento de diseño específico.

Para ver una tabla con los eventos que pueden automatizarse, consulte Event descriptions en el manual Domino Designer Programming Guide.

Ejemplos de programación de eventos

• Detección de errores al rellenar un campo o cerrar un documento
• Actualización de campos al guardar un documento
• Prohibición de ciertas acciones en un documento
• Petición de información al usuario
• Aparición de información al hacer clic en un botón

Todos los elementos de diseño tienen eventos que se pueden programar, aunque no son los mismos para todos los elementos de diseño. En el panel de programación, haga clic en la ficha Objetos para examinar los eventos que es posible programar.

Eventos de bases de datos

Los eventos de bases de datos se refieren a actividades que afectan al conjunto de una base de datos, como son la apertura y cierre de la base de datos o la eliminación de documentos.

Ejemplos:

• PostOpen: Abre una vista específica para llevar a los usuarios a asuntos pendientes.
• QueryDocumentDelete: Impide que los usuarios puedan borrar un determinado documento, por ejemplo, si el valor del campo de estado del documento es Pendiente.
• PostDocumentDelete: Archiva un documento borrado.
• QueryClose: Impide que los usuarios cierren una base de datos si quedan todavía asuntos pendientes asignados a dichos usuarios.

Los eventos de vistas tienen lugar cuando los usuarios trabajan en una vista o carpeta específica. Incluyen la apertura y el cierre de una vista, la adición de documentos a una vista Agenda o la adición de documentos a una carpeta.

Ejemplos de eventos de vistas y de carpetas

• QueryOpen: Impide que los usuarios abran una vista en determinadas circunstancias; por ejemplo, que abran una vista "Final de mes" antes del día 20 de cada mes.
• PostOpen: Crea un documento nuevo o abre un documento.
• QueryRecalc: Informa a los usuarios antes de que una vista grande se actualice de que la actualización podría durar demasiado y les pregunta si desean continuar o dejarlo para otro momento.
• QueryPaste: Impide que los usuarios peguen documentos en una base de datos.
• PostPaste: Cambia el valor de StartDateTime y EndDateTime en un documento al pegar una cita en una fecha e intervalo horario determinado.
• QueryClose: Impide que los usuarios cierren una vista si quedan todavía asuntos pendientes asignados a dichos usuarios.
• QueryAddToFolder: Le permite evitar que un usuario arrastre un documento de una carpeta o vista a otra. Por ejemplo, puede evitar que se muevan documentos a la carpeta Finalizados si el estado de dichos documentos es Pendiente. Tenga en cuenta que el desencadenante para este evento se encuentra en la vista o carpeta desde la que se ha movido el documento.

Ejemplos de eventos de vistas de agenda

• RegionDoubleClick: Crea un documento nuevo cuando los usuarios hagan clic en un área determinada dentro de una vista Agenda.
• QueryDragDrop: Impide que algún usuario arrastre una cita a un día o fecha no apropiados, como, por ejemplo, a un sábado o domingo, o a una hora posterior a las 5 p.m.
• PostDragDrop: Cambia el valor de StartDateTime y EndDateTime en el documento después de arrastrar una cita a una fecha e intervalo horario determinados.

Los eventos de formularios tienen lugar al nivel de los documentos, por ejemplo cuando un usuario abre o cierra un documento. Resultan útiles para reducir el tiempo de visualización de los documentos, debido a que sólo se ejecutan cuando tiene lugar el evento, a diferencia de los procesos de cálculo de campos, que se llevan a cabo cada vez que un documento se guarda, se abre o se actualiza.

Ejemplos

• Initialize: Carga un programa adicional antes de que se muestre un documento.
• QueryClose: Detecta posibles errores y verifica la validez de los campos antes de cerrar un documento.
• QuerySave: Define el valor de un campo cuando los usuarios guarden el documento, en lugar de incluir una fórmula condicional. Por ejemplo, para definir el campo de estado cuando el documento se guarde, puede crear un script para el evento QuerySave, en lugar de incluir una fórmula que emplee @If(@IsDocBeingSaved;"x";"y").

  Con QuerySave también puede ejecutar lógicas de procesamiento y evitar las actualizaciones innecesarias inherentes al uso de campos calculados. Por ejemplo, imagine que tiene un formulario con un campo calculado oculto denominado "Estado" que determina la etapa del flujo de trabajo en la que se encuentran los documentos y el lugar al que han de enviarse. Si reemplaza el campo por un script que asigne un valor durante el evento de formulario QuerySave, podrá definir el valor del campo en el documento sólo al guardarlo, pero no al abrirlo ni al actualizarlo.

Los eventos de campo se desencadenan cuando el usuario entra en un campo o sale de él.

Ejemplos

• Entering: Actualiza las fórmulas de ocultación.
• Exiting: Guía al usuario a determinado campo.
• Exiting: Verifica que la información introducida por el usuario es válida.

Los eventos Click tienen lugar cuando los usuarios hacen clic en acciones o zonas activas, o seleccionan tareas en el menú Acciones. Otros eventos de acciones, botones y zonas activas permiten añadir programación a otros eventos. Después de que el objeto se haya cargado, se ejecuta el evento Initialize y luego el evento Click.

Ejemplos

• Crear un documento nuevo
• Guardar un formulario
• Hacer un cálculo

El evento Initialize almacena toda la programación relacionada con el agente. Añada siempre al evento Initialize a la programación asociada al agente.

Véase también

Automatización de aplicaciones
Creación del programa de un evento

Glosario