Sun Java System Portal Server Mobile Access 7.1 Tag Library Reference

Chapter 1 TagLib: AddressBook

This chapter describes the Tag Library Address Book. This tag library implements a collection of tags that enable address book access to any class of device that utilizes a markup style presentation system.

The Address Book Tag Libraries consists of the following tags:

`add`

Description

Adds an address book entry. If an error occurs during processing, the tag body will be evaluated and the remainder of the page will be skipped.

Tag Body

JSP

Tag Parent

n/a

Restrictions

n/a

Attributes

This tag has a single attribute for which the value of the Required section is Yes:

name: Name of a contact or group bean which has been previously stored on the page context.

Properties

n/a

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>
<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>
<ab:context/>
<ab:entry id="addentry">
	<ab:set property="fn" value="$(fn)"/><br>
	<ab:set property="ln" value="$(ln)"/><br>
	<ab:set property="em" value="$(em)"/><br>
</ab:entry>
<ab:add name="addentry">
		Problem adding Entry
</ab:add>
		Entry added successfully
<ab:fetch>
		Error in Looking up address book.
</ab:fetch>
		Number of Address Book entries:
<ab:context>
	<ab:get property="numEntries"/>
</ab:context>
<ab:entries>
	<ab:entry>
		Entry Id: <ab:get property="entryid"/>
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
	</ab:entry>
</ab:entries>

`addgroupmembers`

Description

Sets the list of members in a group bean. If the resulting group bean is later used in conjunction with the <ab:modify> tag, the specified group's contents are augmented by those of the group bean.

Tag Body

JSP or Empty

Tag Parent

n/a

Restrictions

n/a

Attributes

This tag has the following attributes, which are all not required:

name: The name of the group bean, stored on the page context, in which a list of members is being set.
edit: The name of the edit bean, whose actions will be applied to the value specified in the members attribute.
members: A comma separated list of entry ids, taken from the memberchoices collection.

Properties

n/a

Example(s)

n/a

`contact`

Description

This tag denotes a reference to the current contact bean within an enclosing collection tag, for example, <ab:contacts>. The body of this tag may contain get or set tags that will generate output derived from the contents of this bean tag.

Tag Body

JSP

Tag Parent

<abPrefix:contacts>

Restrictions

Only one of id, name, or entryid should be used at a time. If no attributes are specified, the current entry in the parent collection is used.

Attributes

This tag has the following attributes, which are not required:

id: Specifies the bean id of the bean to create.
name: Specifies the bean id of the bean to use.
entryid: Specifies the address book entry id to use.

Properties

This tag provides the following bean properties, which have the Type, String and Access, Get/Set:

fn: First name.
ln: last name.
em: Email address.
bp: Business phone.
hp: Home phone.
fp: Fax phone.
mp: Mobile phone.
pp: Pager phone.
entryid: Id of address book entry.
cn: Type of entry bean. May be contact or group.

Example(s)

<%-- Example 1 Current contact in the contacts collection --%>

<%@ page errorPage="/jsp/errorpage.jsp" %>

<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>
<ab:fetch ln="$(ln)" fn="$(fn)" bp="$(bp)" em="$(em)" hp="$(
hp)" fp="$(fp)" mp="$(mp)" pp="$(pp)" sb="ln" sd="up">
		Error in Looking up address book.
</ab:fetch>

		Number of Address Book entries:

<ab:context>
	<ab:get property="numEntries"/>
</ab:context>

<ab:contacts iterate="true">
	<ab:contact>
		Entry Id: <ab:get property="entryid"/>
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
	</ab:contact>
</ab:contacts>


<%-- Example 2 Retrieve a contact by entryid --%>

<ab:contact entryid="$(entryid)">
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
</ab:contact>

`contacts`

Description

This tag denotes a reference to the "contacts" collection, as constructed by an appropriate fetch tag. This tag will iterate upon its body until the collection is exhausted, or as constrained by the start and count properties. The start and count properties should only be set when the iterate attribute is set to "false".

Tag Body

JSP

Tag Parent

n/a

Restrictions

Address Book fetch should have happened prior to the invocation of this tag.

Attributes

This tag has the following attributes, which are not required:

id: Name of the contacts collection to create.
name: Name of the contacts collection to use.
iterate: A boolean that selects iteration. Default is "false"; the collection will not iterate.
beanid: During iteration, specifies a name by which the current bean may be retrieved from the PageContext.

Properties

This tag provides the following bean properties, which have the Type as Integer and Access as Get. The count and start attributes has Access as Get/Set:

index: Index of the current bean in the collection.
count: The number of iterations the collection should perform.
start: The zero based index from which to begin iteration.
end: The zero based index that denotes the item upon which iteration will terminate.
startOne: One-based start; suitable for presentation.
endOne: One-based end; suitable for presentation.
size: The size of the collection being paged.
nextPage: Whether or not there are more items in the collection, beyond the current iterations.
prevPage: Whether there are items in the collection preceding the current iterations.

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>
<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>
<ab:fetch collection="contacts" elementType="all" groupid="${gid}">

		Error in Looking up address book.

</ab:fetch>

		Number of Address Book entries:

<ab:contacts iterate="true">
	<ab:contact>
		Name: <ab:get property="cn"/>
	</ab:contact>
/ab:contacts>

context
Description	Ensures that an address book context is present within the current pageContext. This tag must appear, at least once, before all other tags within the AddressBook 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 addressbook configuration name from the page context. If that succeeds, use it. If the retrieval fails... Attempt to retrieve the current addressbook 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 addressbook 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 addressbook configuration name, the context tag will fail. Once a configuration name has been determined, an attempt is made to acquire an appropriate addressbook context object. This is done in the following fashion: Attempt to retrieve an addressbook context from the page context, and verify that it matches the configuration (using the previously acquired configuration name). If that succeeds, use it. If that fails... Attempt to retrieve an addressbook context from the user's cache of addressbook 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 an addressbook context, and bind it with the SSOAdapter object. Store the addressbook context in the context cache as well as the page context. This way, if an addressbook 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
Tag Parent	n/a
Restrictions	n/a
Attributes	This tag has the following attributes:	No

Property	Description	Type	Access
errorCode	Returns error status of a failed command tag. Empty error code indicates a generic tag execution failed error. AB_001 - Add/Modify failed because last name not entered.	String
numEntries	Number of items in the entries collection.	Integer	Get
entriesEmpty	Whether or not the entries collection is empty.	Boolean	Get
numGroupmembers	Number of items in the groupmembers collection.	Integer	Get
groupmembersEmpty	Whether or not the groupmembers collection is empty.	Boolean	Get
numMemberchoices	Number of items in the memberchoices collection.	Integer	Get
memberchoicesEmpty	Whether or not the memberchoices collection is empty.	Boolean	Get
numContacts	Number of items in the contacts collection.	Integer	Get
contactsEmpty	Whether or not the contacts collection is empty.	Boolean	Get

`delete`

Description

Deletes an address book entry. If an error occurs during processing, the tag body will be evaluated and the remainder of the page will be skipped.

Tag Body

JSP

Tag Parent

n/a

Restrictions

n/a

Attributes

This tag has a single attribute for which the value of Required field is Yes:

entryid: The id of an entry bean within the entries collection.

Properties

n/a

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>

<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

		<ab:context/>

		<ab:delete entryid="$(entryid)">
			Problem deleting Entry
		</ab:delete>
		Entry deleted successfully

		<ab:fetch>
			Error in Looking up address book.
		</ab:fetch>
		Number of Address Book entries:
		<ab:context>
			<ab:get property="numEntries"/>
		</ab:context>
 		<ab:entries>
			<ab:entry>
				Entry Id: <ab:get property="entryid"/>
				First Name: <ab:get property="fn"/>
				Last Name: <ab:get property="ln"/>
				Email: <ab:get property="em"/>
			</ab:entry>
		</ab:entries>

`deletegroupmembers`

Description

Deletes entries from a specified group.

Tag Body

JSP or Empty

Tag Parent

n/a

Restrictions

n/a

Attributes

This tag has the following attributes in which the Required value for groupid is Yes:

groupid: The id of a group bean within the entries collection.
edit: The name of the edit bean, whose actions will be applied to the value specified in the members attribute.
members: A comma separated list of entry ids, taken from the groupmembers collection.

Properties

n/a

Example(s)

n/a

`entries`

Description

This tag denotes a reference to the "entries" collection, as constructed by an appropriate fetch tag. This tag will iterate upon its body until the collection is exhausted, or as constrained by the start and count properties. The start and count properties should only be set when the iterate attribute is set to "false". This collection is typically used to contain the entries from the top level of an addressbook, which may contain contacts and groups.

Tag Body

JSP

Tag Parent

n/a

Restrictions

Address Book fetch should have happened prior to the invocation of this tag.

Attributes

This tag has the following attributes for which the required values are No:

id: Name of the entries collection to create.
name: Name of the entries collection to use.
iterate: A boolean that selects iteration. Default is "false", the collection will not iterate.
beanid: During iteration, specifies a name by which the current bean may be retrieved from the PageContext.

Properties

This tag provides the following bean properties, which has Integer value for Type and Get/Set for Access:

index: Index of the current bean in the collection.
count: The number of iterations the collection should perform.
start: The zero-based index from which to begin iteration.
end: The zero-based index that denotes the item upon which iteration will terminate.
startOne: One-based start; suitable for presentation.
endOne: One-based end; suitable for presentation.
size: The size of the collection being paged.
nextPage: Whether or not there are more items in the collection, beyond the current iterations.
prevPage: Whether there are items in the collection preceding the current iterations.

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>
<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>
<ab:fetch ln="$(ln)" fn="$(fn)" bp="$(bp)" em="$(em)" hp="$(
hp)" fp="$(fp)" mp="$(mp)" pp="$(pp)" sb="ln" sd="up">

		Error in Looking up address book.

</ab:fetch>

		Number of Address Book entries:

<ab:context>
	<ab:get property="numEntries"/>
</ab:context>

	<ab:entries iterate="true">
	<ab:entry>
		Entry Id: <ab:get property="entryid"/>
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
	</ab:entry>
/ab:entries>

`entry`

Description

This tag denotes a reference to the current entry bean within an enclosing collection tag. For example, <ab:entries>. The body of this tag may contain get/set tags that generates output derived from the contents of this bean tag.

Tag Body

JSP

Tag Parent

<abPrefix:entries>

Restrictions

Only one of the id, name, or the entryid should be used at a time. If no attributes are specified then the current entry in the parent collection is used.

Attributes

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

id: Specifies the bean id of the bean to create.
name: Specifies the bean id of the bean to use.
entryid: Specifies the address book entry id to use.
elementType: When used in conjunction with id, specifies what type of entry bean to create. It can be "contact" or "group".

Properties

The tag provides the following bean properties for which the Defined for Enter Type is “Contact”, Type is “String”, and Access is “Get/Set”:

fn: First name.
ln: Last name.
em: Email address.
bp: Business phone.
hp: Home phone.
fp: Fax phone.
mp: Mobile phone.
pp: Pager phone.
cn: Entry CN.
entryid: id of address book entry.
elementType: Type of entry bean. It can be "contact" or "group".

Example(s)

<%-- Example 1 Current entry in the entries collection --%>

<%@ page errorPage="/jsp/errorpage.jsp" %>

<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>
<ab:fetch ln="$(ln)" fn="$(fn)" bp="$(bp)" em="$(em)" hp="$(
hp)" fp="$(fp)" mp="$(mp)" pp="$(pp)" sb="ln" sd="up">
		Error in Looking up address book.
</ab:fetch>
		Number of Address Book entries:
<ab:context>
	<ab:get property="numEntries"/>
</ab:context>

<ab:entries iterate="true">
	<ab:entry>
		Entry Id: <ab:get property="entryid"/>
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
	</ab:entry>
</ab:entries>

<%-- Example 2 Retrieve an entry by entryid --%>

<ab:entry entryid="$(entryid)">
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
</ab:entry>

`fetch`

Description

The fetch tag loads the specified collection within the current addressbook context. If no attributes are specified, the entire addressbook will be returned within the entries collection. All of the search attributes support simple wildcard expressions, using the '*' character. If no wildcard is specified, the '*' character is prepended and appended to the search expression, thus yielding a search pattern that produces results matching any entry that at least contains the requested string. If an error occurs during processing, the tag body will be evaluated, and the remainder of the page will be skipped.

Tag Body

JSP

Tag Parent

n/a

Restrictions

If the fetch tag uses the 'any' attribute, then no other attribute other than 'sb' and 'sd' can be used.

Attributes

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

sb: "Sort By" attribute. Can have the search attribute names, for example 'ln' etc. as values, except for 'any'.
sd: "Sort Direction" attribute. Can have values - 'up', 'down'.
fn: Search for "First Name"
ln: Search for "Last Name"
em: Search for "Email Address"
bp: Search for "Business Phone"
hp: Search for "Home Phone"
fp: Search for "Fax Phone"
mp: Search for "Mobile Phone"
pp: Search for "Pager Phone"
any: Search all fields for any match.
elementType: Specifies the type of element (entry) to fetch. May be "contact", "group", or "all". Default is "contact".
groupid: The id of a group bean within the entries collection that identifies from which group entries are to be fetched.
collection: Specifies to which collection the results of this fetch operation should be stored. May be "contacts", "groupmembers", "memberchoices", or "entries". Default is "entries". If "contacts" is specified, groups are expanded to their constituent contacts.
exact: A boolean that indicates the following: when false, implicitly append and prepend a "*" to the search patterns. When true, use the pattern explicitly specified. Default is "false".

Properties

n/a

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>
<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>
<ab:fetch ln="$(ln)" fn="$(fn)" bp="$(bp)" em="$(em)" hp="$(
hp)" fp="$(fp)" mp="$(mp)" pp="$(pp)" sb="ln" sd="up">

		Error in Looking up address book.

</ab:fetch>

Number of Address Book entries:

<ab:context>
	<ab:get property="numEntries"/>
</ab:context>

<ab:entries>

	<ab:entry>
		Entry Id: <ab:get property="entryid"/>
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
	</ab:entry>
</ab:entries>

`get`

Description

The get tag retrieves the specified property. This tag operates exactly like the <util:get> tag and is imported into the ab taglib for convenience. See the util:get tag description for usage details.

Tag Body

util:get

Restrictions

util:get

Attributes

util:get

Properties

util:get

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>
<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

		<ab:context/>
		<ab:fetch ln="$(ln)" fn="$(fn)" bp="$(bp)" em="$(em)" hp="$(
hp)" fp="$(fp)" mp="$(mp)" pp="$(pp)" sb="ln" sd="up">
		Error in Looking up address book.
		</ab:fetch>
		Number of Address Book entries:
		<ab:context>
			<ab:get property="numEntries"/>
		</ab:context>
		<ab:entries>

			<ab:entry>
				Entry Id:<ab:get property="entryid"/>
				First Name:<ab:get property="fn"/>
				Last Name:<ab:get property="ln"/>
				Email:<ab:get property="em"/>
			</ab:entry>
		</ab:entries>

`groupmember`

Description

This tag denotes a reference to the current groupmember bean within an enclosing collection tag. For example, <ab:groupmembers>. The body of this tag may contain get/set tags that will generate output derived from the contents of this bean tag.

Tag Body

JSP

Tag Parent

<abPrefix:groupmembers>

Restrictions

Only one of the id, name, or the entryid should be used at a time. If no attributes are specified then the current entry in the parent collection is used.

Attributes

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

id: Specifies the bean id of the bean to create.
name: Specifies the bean id of the bean to use.
entryid: Specifies the address book entry id to use.

Properties

<abPrefix:entry>

Example(s)

<%-- Example 1  Current groupmember in the groupmembers collection --%>

<%@ page errorPage="/jsp/errorpage.jsp" %>

<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>
<ab:fetch collection="groupmembers", groupid="$(gid)">
		Error in Looking up address book.
</ab:fetch>

		Number of Address Book entries:

<ab:context>
	<ab:get property="numGroupmembers"/>
</ab:context>

<ab:groupmembers iterate="true">
	<ab:groupmember>
			Entry Id: <ab:get property="entryid"/>
			First Name: <ab:get property="fn"/>
			Last Name: <ab:get property="ln"/>
			Email: <ab:get property="em"/>
	</ab:groupmember>
</ab:groupmembers>

`groupmembers`

Description

This tag denotes a reference to the groupmembers collection, as constructed by an appropriate fetch tag. This tag will iterate upon its body until the collection is exhausted, or as constrained by the start and count properties. The start and count properties should only be set when the iterate attribute is set to "false".

Tag Body

JSP

Tag Parent

n/a

Restrictions

Address Book fetch should have happened prior to the invocation of this tag.

Attributes

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

id: Name of the groupmembers collection to create.
name: Name of the groupmembers collection to use.
iterate: A boolean that selects iteration. Default is "false", the collection will not iterate.
beanid: During iteration, specifies a name by which the current bean may be retrieved from the PageContext.

Properties

The tag provides the following bean properties for which the Type value is “Integer” and the Access value is “Get/Set”:

index: Index of the current bean in the collection.
count: The number of iterations the collection should perform.
start: The zero-based index from which to begin iteration.
end: The zero-based index that denotes the item upon which iteration will terminate.
startOne: One-based start; suitable for presentation.
endOne: One-based end; suitable for presentation.
size: The size of the collection being paged.
nextPage: Whether or not there are more items in the collection, beyond the current iterations.
prevPage: Whether there are items in the collection preceding the current iterations.

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>
<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>

<ab:fetch collection="groupmembers" elementType="all" groupid="$(gid)">

		Error in Looking up address book.

</ab:fetch>

Number of Address Book entries:

<ab:groupmembers iterate="true">
	<ab:groupmember>
		Name: <ab:get property="cn"/>
	</ab:groupmember>
</ab:groupmembers>

`memberchoice`

Description

This tag denotes a reference to the current memberchoice bean within an enclosing collection tag. For example, <ab:memberchoices>. The body of this tag may contain get/set tags that will generate output derived from the contents of this bean tag.

Tag Body

JSP

Tag Parent

<abPrefix:memberchoices>

Restrictions

Only one of id, name, or entryid should be used at a time. If no attributes are specified, the current entry in the parent collection is used.

Attributes

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

id: Specifies the bean id of the bean to create.
name: Specifies the bean id of the bean to use.
entryid: Specifies the address book entry id to use.

Properties

<abPrefix:entry>

Example(s)

<%-- Example 1  Current entry in the entries collection --%>

<%@ page errorPage="/jsp/errorpage.jsp" %>

<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>

<ab:fetch collection="memberchoices">
		Error in Looking up address book.
</ab:fetch>

Number of Address Book entries:

<ab:context>
	<ab:get property="numMemberchoices"/>
</ab:context>

<ab:memberchoices iterate="true">
	<ab:memberchoice>
		Entry Id: <ab:get property="entryid"/>
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
	</ab:memberchoice>
</ab:memberchoices>

`memberchoices`

Description

This tag denotes a reference to the memberchoices collection, as constructed by an appropriate fetch tag. This tag will iterate upon its body until the collection is exhausted, or as constrained by the start and count properties. The start and count properties should only be set when the iterate attribute is set to "false".

Tag Body

JSP

Tag Parent

n/a

Restrictions

Address Book fetch should have happened prior to the invocation of this tag.

Attributes

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

id: Name of the memberchoices collection to create.
name: Name of the memberchoices collection to use.
iterate: A boolean that selects iteration. Default is "false", the collection will not iterate.
beanid: During iteration, specifies a name by which the current bean may be retrieved from the PageContext.

Properties

This tag provides the following bean properties for which the Type values are “Integer” and “Boolean”, and the Access values are “Get/Set”:

index: Index of the current bean in the collection.
count: The number of iterations the collection should perform.
start: The zero-based index from which to begin iteration.
end: The zero-based index that denotes the item upon which iteration will terminate.
startOne: One-based start; suitable for presentation.
endOne: One-based end; suitable for presentation.
size: The size of the collection being paged.
nextPage: Whether or not there are more items in the collection, beyond the current iterations.
prevPage: Whether there are items in the collection preceding the current iterations.

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>
<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>

<ab:fetch collection="memberchoices" elementType="all" groupid="$(gid)">

		Error in Looking up address book.

</ab:fetch>

Number of Address Book entries:

<ab:memberchoices iterate="true">
	<ab:memberchoice>
		Name: <ab:get property="cn"/>
	</ab:memberchoice>
</ab:memberchoices>

`modify`

Description

Modifies an address book entry. If an error occurs during processing, the tag body will be evaluated and the remainder of the page will be skipped.

Tag Body

JSP

Tag Parent

n/a

Restrictions

The use of this tag should precede any use of a "fetch" or "collection" tag.

Attributes

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

name: Name of the entry bean, stored on the page context, that contains the modifications.
entryid: The id of an entry bean (within the entries collection) identifying which address book entry is to be modified.

Properties

n/a

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>

<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>

<ab:entry id="modentry">
	<ab:set property="fn" value="$(fn)"/><br>
	<ab:set property="em" value="$(em)"/><br>
	<ab:set property="ln" value="$(ln)"/><br>
</ab:entry>

<ab:modify name="modentry" entryid="$(entryid)">
		Problem modifying Entry
</ab:modify>

Entry modified successfully

<ab:fetch>
		Error in Looking up address book.
</ab:fetch>

		Number of Address Book entries:

<ab:context>
	<ab:get property="numEntries"/>
</ab:context>

<ab:entries>
	<ab:entry>
		Entry Id: <ab:get property="entryid"/>
		First Name: <ab:get property="fn"/>
		Last Name: <ab:get property="ln"/>
		Email: <ab:get property="em"/>
	</ab:entry>
</ab:entries>

`set`

Description

The set tag updates the specified property. This tag operates exactly like the <util:set> tag and is imported into the ab taglib for convenience. See the util:set tag description for usage details.

Tag Body

util:set

Restrictions

util:set

Attributes

util:set

Properties

util:set

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>

<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

		<ab:context/>
			<ab:entry id="addentry">
				<ab:set property="fn" value="$(fn)"/><br>
				<ab:set property="ln" value="$(ln)"/><br>
				<ab:set property="em" value="$(em)"/><br>
			</ab:entry>
			<ab:add name="addentry">
				Problem saving Entry
			</ab:add>
			Entry saved successfully

			<ab:fetch>
				Error in Looking up address book.
			</ab:fetch>
			Number of Address Book entries:
			<ab:context>
				<ab:get property="numEntries"/>
			</ab:context>
			<ab:entries>
				<ab:entry>
					Entry Id: <ab:get property="entryid"/>
					First Name: <ab:get property="fn"/>
					Last Name: <ab:get property="ln"/>
					Email: <ab:get property="em"/>
			</ab:entries>

`setgroupmembers`

Description

Sets the list of members in a group bean. If the resulting group bean is later used in conjunction with the <ab:modify> tag, the specified group's contents are replaced by those of the group bean.

Tag Body

JSP or Empty

Tag Parent

n/a

Restrictions

n/a

Attributes

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

name: The name of the group bean, stored on the page context, in which a list of members is being set.
edit: The name of the edit bean, whose actions will be applied to the value specified in the members attribute.
members: A comma separated list of entry ids, taken from the memberchoices collection.

Properties

n/a

Example(s)

n/a