context

Description

Ensures that a calendar context is present within the current pageContext. This tag must appear, at least once, before all other tags within the Calendar taglib. If config is not specified, then a search for a useable configuration name is performed in the following fashion: Attempt to retrieve the current calendar configuration name from the page context.  If that succeeds, use it.  If the retrieval fails... Attempt to retrieve the current calendar configuration name from the session.  If that succeeds, store it on the page context and use it.  If the retrieval fails... From the list of all SSOAdapter configuration names, try to find the first useable calendar configuration name.  If that succeeds, store it in the session and page context and use it.  If it is not possible to find a useable calendar configuration name, the context tag will fail. Once a configuration name has been determined, an attempt is made to acquire an appropriate calendar context object.  This is done in the following fashion: Attempt to retrieve a calendar context from the page context, and verify it matches the configuration (using the previously acquired configuration name).  If that succeeds, use it.  If that fails... Attempt to retrieve a calendar context from the user's cache of mail contexts. If that succeeds, store it on the page context and use it.  If the retrieval fails.. Create an SSOAdapter object using the previously acquired configuration name.  Create a calendar context, and bind it with the SSOAdapter object.  Store the calendar context in the context cache as well as the page context. In this way, if a calendar context has been previously referenced on a page, or within the session, then the config attribute may be omitted,and the most recently referenced context will be retrieved.

Tag Body

JSP or Empty.

Restrictions

Since the calendar context is saved across requests the properties are also available for use across requests.

Attributes

This tag has the following attributes for which the Required value is “No”:

config

Specifies the "configuration" for which a calendar context should be retrieved.

test

Permits testing of service availability. Operates according to the following table:

Properties

This tag provides access to the following properties for which the Type values are “String”, “Integer”, and “Boolean” and the Access value is “Get”:

errorCode

Returns errors status of failed command tags.

• CAL_001: Invalid date format.

errorCount

The size of the current event list.

eventSize

Same as eventCount.

taskCount

The size of the current task list.

calendarID

The current calendar ID.

eventsEmpty

Indicates status of the events list.

tasksEmpty

Indicates status of the tasks list.

userTheOwner

Indicates whether the user is the owner of the current calendar.

Example(s)

<%-- calendar context --%>
<Cal:context/>