IMPOSTAZIONE DELLE APPLICAZIONI

Esempi di agenti da eseguire prima che gli utenti Web aprano o salvino dei documenti
Per eseguire il controllo degli errori, la convalida di un campo e altre elaborazioni necessarie prima che gli utenti Web aprano o salvino dei documenti, creare un agente condiviso da eseguire manualmente. Quindi scrivere una formula che usi il comando @Command([RunAgent]) o @Command([ToolsRunMacro]) per eseguire l'agente e allegarlo agli Eventi del modulo WebQueryOpen o WebQuerySave. Questo simula gli eventi modulo QueryOpen e QuerySave di LotusScript che non sono supportati nel Web.

WebQueryOpen (eventi)

L'evento WebQueryOpen esegue l'agente prima che Domino converta un documento in HTML e lo invii al browser. IBM® Lotus® Domino(TM) ignora qualunque output prodotto dall'agente in questo contesto.

Gli esempi di utilizzo di questo agente comprendono l'esecuzione di grandi calcoli che non sono possibili mediante i comandi @, oppure la raccolta di statistiche su chi ha aperto i documenti e quando.

Nota Gli agenti WebQueryOpen vengono eseguiti quando l'utente apre un modulo o un documento, ma non quando l'utente salva un documento. Ciò significa che i campi calcolati definiti da un agente WebQueryOpen non vengono salvati quando l'utente invia un documento. Per assicurarsi che i campi calcolati siano salvati, è possibile ricalcolarli mediante l'agente WebQuerySave oppure impostare la proprietà di modulo "Genera HTML per tutti i campi".

WebQuerySave (eventi)

L'evento WebQuerySave esegue l'agente dopo il completamento delle formule di convalida dell'immissione nei campi, ma prima che il documento venga salvato su disco o inviato. L'agente può modificare il documento o usarne i dati per eseguire altre operazioni. Il documento viene salvato automaticamente dopo che l'agente è stato eseguito. NON fare in modo che l'agente salvi il documento in maniera esplicita (ad esempio, con il comando NotesDocument.Save), perché questa operazioni può dare luogo a risultati errati.

L'agente WebQuerySave è in grado di produrre informazioni che possono essere inviate all'utente. Ad esempio, è possibile usare il comando Stampa in un agente LotusScript per restituire codice HTML non formattato. Se l'agente produce dell'output, il modulo non dovrebbe contenere un campo $$Return, poiché Domino restituirà solo l'output dell'agente ignorando il campo.

Gli esempi d'uso di questo agente comprendono quanto segue:


Nota Il campo SaveOptions deve essere un campo esistente sul form, che l'agente WebQuerySave modifica il valore. Se l'agente crea il campo SaveOptions, il form sarà salvato indipendentemente dal valore in quel campo.