Conditional tag. In the context of action, form, or view tags, enables you to conditionally evaluate the content of the ifserverevent tag based on the current state of the page. When you trigger a server-side event, which means you evaluate the body of the ifserverevent tag, a context object of type lotus.domino.taglib.EventContext is created and remains valid for the duration of the body of the tag. This tag is evaluated based on the following page states:

Tag this tag is working in the context of	Event	State of the page that triggers the event
form	QueryClose	If the form is closing.
form	QuerySave	If the form is being saved.
action	OnAction	If the name (of either the action in the context action tag or the value specified in the for attribute of this tag) is present in the das_op page parameter.

Contexts
Valid in:

action, form, view

setitem

<domino:ifserverevent
id="name of object variable"
event="QuerySave|QueryClose|OnAction"
for="name of the action initiator"
debug="true|false"
onfailure="inline|exception"
time="true|false">

event

Name of the event. Must be one of the following: QuerySave, QueryClose, or OnAction. If you specify QueryClose, the event will be triggered before the current document is saved. Required.

Name of the action initiator to check for in the das_op page parameter. If not specified, defaults to the context action tag's name. Optional.

If specified, overrides the default name of the object variable of type lotus.domino.taglib.EventContext that is created when this tag is evaluated. Default name is eventContext. Optional.

Interfaces

You can use the following interfaces to determine the current event state:

public interface EventContext {

//Get the name of the current event type

public String getName();

//Get the name of the control that triggered this event.

//This is only valid for the OnAction event.

//Null will be returned for all other event types.

public String getFor();

//Get a Vector of documents that contains all

//the documents that have been "selected" in the view.

public Vector getSelectedDocuments();

//Get a vector that contains the UNIDs of all the

//documents that have been "selected" in the view.

public Vector getSelectedUNIDs();

Example
See Also

The Domtags tag library

Glossary