Page History

...

Section

Column

width	20%

`<add-error>`

Column

Adds a message to the error message list.

Code Block

	xml
	xml

<add-error>
  <fail-message message="There was an error" />
</add-error>

Attributes

Name	Type	Requirements	Description	Note
error-list-name	constant	optional	The name of a list that will contain the message.	Default is Defaults to "error_list".

Child Elements
One of the following child elements is required:

Name
`<fail-message>`	optional
`<fail-property>`	optional

Infonote

title	Proposed Changes	Draft Status

Final draftCurrently, child elements are optional. Require one child element.

Section

Column

width	20%

`<clear-field>`

Column

Removes a field from memory

Sets the value of the specified field to null.

Code Block

	xml
	xml

<clear-field field="foo" />

Attributes

Name	Type	Requirements
field	expression	required
field	optional	The name of the field to remove
map-name	optional	The name of the map field to remove.

Noteinfo

title	Proposed Changes	Draft Status

Final draft.

Currently, the field attribute is optional. Require the field attribute.

Eliminate the map-name attribute.

Section

Column

width	20%

`<create-object>`

Column

Creates an instance of the specified class.

The string and field sub-elements are passed to the constructor method as arguments in the order they are specified.
A runtime exception will be thrown if the sub-elements do not match the constructor method arguments

Create a new Java object

.

Code Block

	xml
	xml

<create-object field="foo" class-name="com.acme.FooClass">
  <string value="bar" />
  <field field="foo" />
</create-object>

Attributes

Name	Type	Requirements	Description	Note
field	expression	optionalrequired	The name of the field for the new object.
class-name	constant	requiredoptional	The Java class name.

Child Elements

Name	Requirements
`<field>`	optional
`<string>`	optional

info

title	Proposed Changes

Currently, both attributes are optional. Require both attributes.
Deprecate and replace with scriptlet

Warning
Deprecated - use the `<script>` element.

Note

title	Draft Status

Final draft.

Section

Column

width	20%

`<fail-message>`

Column

Declares

a message to be added to a message list

an error message.

Code Block

	xml
	xml

<add-error>
  <fail-message message="There was an error." />
</add-error>

Attributes

Name	Type	Requirements	Description	Note
message	constant+expr	optionalrequired	The message text.

Infonote

title	Proposed Changes	Draft Status

Final draft.

Currently, the message attribute is optional. Require the message attribute.

Section

Column

width	20%

`<fail-property>`

Column

Declares

a property key that is used to add a message to a message list

an error message found in a properties file.

Code Block

	xml
	xml

<add-error>
  <fail-property resource="ErrorMessages" property="FooError" />
</add-error>

Attributes

Name	Type	Requirements	Description	Note
resource	optional	constant	required	The name Name of the resource where the message can be found.
property	constant	requiredoptional	The message property key.

Note

title	Draft Status

Final draft.

Section

Column

width	20%

`<field>`

Column

Specifies an environment field to be passed as an argument to an object method call.

Attributes

Name	Type	Requirements	Description	Note
field	expression	required	The name of the environment field to use.
type	constant	optional	The Java class of the argument.	Defaults to "java.lang.String".

Note

title	Draft Status

Final draft

Info

title	Proposed Changes

Currently, both attributes are optional. Require both attributes

.

Section

Column

width	20%

`<field-to-list>`

Column

Copies a field to a

Appends an object to the specified list.

Code Block

	xml
	xml

<field-to-list list="barList" field="foo" />

Attributes

foo" />

Attributes

Name	Type	Requirements	Description	Note
field	expression	required	The field to add to the list.	If the field does not exist, the operation does nothing.
list	expression	required	list	optional	Name of the list.	If the list does not exist, one is created.
field	optional	The field to add to the list

Warning
Deprecated - use the `<set>` element.

Noteinfo

title	Proposed Changes	Draft Status

Final draft

Currently, both attributes are optional. Require both attributes.

Deprecate and replace with UEL expression

.

Section

Column

width	20%

`<field-to-request>`

Column

Copies a field to a servlet request attribute.

Valid only when the simple-method is called as an event, it is ignored otherwise.

Code Block

	xml
	xml

<field-to-request field="foo" request-name="fooAttribute" />

Attributes

Name	Type	Requirements	Description	Note
field	expression	required
field	optional	The name of the field to copy from
request-name	optional	The name of the request attribute field to copy to.	If the field does not exist, the operation does nothing.
requestmap-name	constant, ${expression}	optional	The servlet request attribute name of the map containing field.	Defaults to the value of field attribute.

Noteinfo

title	Proposed Changes	Draft Status

Final draft

Currently, all attributes are optional. Require the field and request-name attributes.

Eliminate the map-name attribute.

Deprecate and replace with a UEL expression

.

Section

Column

width	20%

`<field-to-result>`

Column

Copies a field to a service OUT attribute.

Code Block

	xml
	xml

<field-to-result field="foo" result-name="fooAttribute" />

Attributes

Name	Type	Requirements	Description	Note
field	expression	required	The name of the field to copy from, the source of the assignment.
result-name	expression	optional	The name of the result field to set, the target of the assignment.	Defaults to the value of field attribute.

Note

title	Draft Status

Final draft.

Section

Column

width	20%

`<field-to-session>`

Column

Copies a field to a servlet session attributeto a servlet session attribute.

Valid only when the simple-method is called as an event, it is ignored otherwise.

Code Block

	xml
	xml

<field-to-session field="foo" session-name="fooAttribute" />

Attributes

Name	Type	Requirements	Description	Note
field	expression	optionalrequired	The name of the field to copy from.	If the field does not exist, the operation does nothing.
session-name	constant, ${expression}	optional	The name of the servlet session attribute to copy tomap- name	optional	The name of the map containing field	.	Defaults to the value of field attribute.

Noteinfo

title	Proposed Changes	Draft Status

Final draft

Currently, all attributes are optional. Require the field and session-name attributes.

Eliminate the map-name attribute.

Deprecate and replace with a UEL expression

.

Section

Column

width	20%

`<first-from-list>`

Column

Copies the first element in a list to a field. If the list is empty or not found, sets the field to `null`.

Code Block

	xml
	xml

<first-from-list entry-name="foo" list-name="fooList" />

Attributes

entry-name	optional	The name of the field to copy to
list-name	optional	The name of the list to copy from

Info

title	Proposed Changes

Currently, both attributes are optional. Require both attributes.
Deprecate and replace with a UEL expression.

...

Space shortcuts

Child pages

Versions Compared

Old Version 69

New Version 70

Key

`<add-error>`

Adds a message to the error message list.

`<clear-field>`

Sets the value of the specified field to null.

`<create-object>`

Creates an instance of the specified class.

`<fail-message>`

Declares

an error message.

`<fail-property>`

Declares

an error message found in a properties file.

`<field>`

Specifies an environment field to be passed as an argument to an object method call.

`<field-to-list>`

Appends an object to the specified list.

`<field-to-request>`

Copies a field to a servlet request attribute.

`<field-to-result>`

Copies a field to a service OUT attribute.

`<field-to-session>`

Copies a field to a servlet session attributeto a servlet session attribute.

`<first-from-list>`

Copies the first element in a list to a field. If the list is empty or not found, sets the field to `null`.

Space shortcuts

Child pages

Page History

Versions Compared

Old Version 69

New Version 70

Key

<add-error>

Adds a message to the error message list.

<clear-field>

Sets the value of the specified field to null.

<create-object>

Creates an instance of the specified class.

<fail-message>

Declares

an error message.

<fail-property>

Declares

an error message found in a properties file.

<field>

Specifies an environment field to be passed as an argument to an object method call.

<field-to-list>

Appends an object to the specified list.

<field-to-request>

Copies a field to a servlet request attribute.

<field-to-result>

Copies a field to a service OUT attribute.

<field-to-session>

Copies a field to a servlet session attributeto a servlet session attribute.

<first-from-list>

Copies the first element in a list to a field. If the list is empty or not found, sets the field to null.

`<add-error>`

`<clear-field>`

`<create-object>`

`<fail-message>`

`<fail-property>`

`<field>`

`<field-to-list>`

`<field-to-request>`

`<field-to-result>`

`<field-to-session>`

`<first-from-list>`

Copies the first element in a list to a field. If the list is empty or not found, sets the field to `null`.