Versions Compared

Old Version 70

changes.mady.by.user Adrian adrianc

Saved on

compared with

New Version Current

changes.mady.by.user Dennis Balkir

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: edited the attributes of <make-value> because the map is optional (seen in different minilang scripts in OFBiz)
Alert
titleMini Lang Deprecated
typeWarning

According to the proposal thread in [1] we decided to deprecate mini lang. For additional information please refer to the corresponding issue [2].


[1] https://s.apache.org/iS8W

[2]

Jira
serverASF JIRA
serverId5aa69414-a9e9-3523-82ec-879b028fb15b
keyOFBIZ-9350

Current Mini Language (minilang) Reference Guide (Version 3)

Mini-language Reference

The Apache Open For Business Project

Note

This is a draft document. It can be modified at any time by any committer. Comments on the draft should be made on the dev mailing list.

Grammar version 2 (http://ofbiz.apache.org/dtds/simple-methods-v2.xsd

...

)

...

Info

...

titleOlder versions

There are 2 older versions that you can find respectively at

Mini-Language Guide (Version 1 - Deprecated)

Mini-Language Guide (Version 2 - Deprecated)

 

Attributes

Attribute Types

Type

Description

Type

Description

Example

constant

A string constant. The string may not include an expression.

name="fooMethod"

constant+expr

A string constant. The string may include an expression, but an expression-only string is not allowed.

default="${foo}Method"

expression

A UEL expression without enclosing brackets.

from="item.quantity * item.priceEach"

${expression}

A UEL expression with enclosing brackets.

default="${parameters.itemId}"

script

A short script ("scriptlet").

script="groovy:foo.bar();"

 

The <simple-method> element

Section
Column
width20%
<simple-method>
Final draft.
Column
Contains a block of code.

A simple method can be called in either an event context from the Control
Servlet (or another event) or in a service context through the Service
Engine, or any other component that has access to a service dispatcher.

Code Block
xml
xml

<simple-method method-name="fooMethod">
  <!-- some mini-language code goes here -->
</simple-method>
Attributes

Name

Type

Requirements

Description

Note

method-name

constant

required

A name (preferably a legal Java identifier) for this method.

Each simple method in a file must have a unique name.

short-description

constant

optional

A short description of the method.

Used for documentation.

login-required

constant

optional

Require a user login to run this method.

Defaults to "true".

use-transaction

constant

optional

Create a transaction if none exists for this thread.

Defaults to "true".

default-error-code

constant

optional

The default error return code.

Defaults to "error".

default-success-code

constant

optional

The default success return code.

Defaults to "success".

event-request-object-name

constant

optional

The name of the field containing the javax.servlet.ServletRequest object.

Defaults to "request".

event-response-object-name

constant

optional

The name of the field containing the javax.servlet.ServletResponse object.

Defaults to "response".

event-session-object-name

constant

optional

The name of the field containing the javax.servlet.http.HttpSession object.

Defaults to "session".

event-response-code-name

constant

optional

The name of the field containing the event response code.

Defaults to "_response_code_".

event-error-message-name

constant

optional

The name of the field containing the event error message.

Defaults to "_error_message_".

event-error-message-list-name

constant

optional

The name of the field containing the event message list.

Defaults to "_error_message_list_".

event-event-message-name

constant

optional

The name of the field containing the event message.

Defaults to "_event_message_".

event-event-message-list-name

constant

optional

The name of the field containing the event message list.

Defaults to "_event_message_list_".

service-response-message-name

constant

optional

The name of the field containing the service response message.

Defaults to "responseMessage".

service-error-message-name

constant

optional

The name of the field containing the service error message.

Defaults to "errorMessage".

service-error-message-list-name

constant

optional

The name of the field containing the service error message list.

Defaults to "errorMessageList".

service-error-message-map-name

constant

optional

The name of the field containing the service error message map.

Defaults to "errorMessageMap".

service-success-message-name

constant

optional

The name of the field containing the service success message.

Defaults to "successMessage".

service-success-message-list-name

constant

optional

The name of the field containing the service success message list.

Defaults to "successMessageList".

Note
titleDraft Status

 

Child Elements

Name

Requirements

 

(Any block of code)

optional

 

 

Assignment Operations

Assignment operations modify the script's state.

Section
Column
width20%
<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.

Defaults to "error_list".

 

Child Elements

One of the following child elements is required:

Final draft.

Name

 

<fail-message>(question)

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

<fail-property>

(question)

Note
titleDraft Status

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

Section
Column
width20%
<clear
<alt-
field>
permission>
Attributes
Column
Declares an alternate permission (<check-permission> sub-element).

Alternate permissions are checked when the primary permission check fails.

Sets the value of the specified field to null.
Code Block
xmlxml

<clear-field field="foo" />

Name

Type

Requirements

Description

Note

fieldpermission

constant, ${expression}

required

The name of the field to removepermission to check.

 

Note
titleDraft Status

Final draft.

Section
Column
width20%
<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.

Code Blockxmlxml

<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

required

The name of the field for the new object.

 

class-name

constant

required

The Java class name.

 

Child Elements

Name

Requirements

 

<field>

optional

(question)

<string>

optional

(question)

Warning

Deprecated - use the <script> element.

Note
titleDraft Status

Final draft.

Section
Column
width20%
<fail-message>
Column
Declares an error message.
Code Blockxmlxml

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

Attributes

Name

Type

Requirements

Description

Note

message

constant+expr

required

The message text.

 

Note
titleDraft Status

Final draft.

Section

action

constant, ${expression}

optional

The action to be performed (permission scope).

Examples: "_ADMIN", "_CREATE", "_UPDATE".

Section
Column
width20%
<assert>
Column
Adds an error message to the error message list for each condition that evaluates to false.
Attributes

Name

Type

Requirements

Description

Note

title

constant, ${expression}

optional

The title of the assert operation.

The title is used in test reports.

error-list-name

constant

optional

The name of a list that will contain the message.

Defaults to "error_list".

 

Child Elements

Name

 

Any <condition> child element

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

Section
Column
width20%
<check-id>
Column
Evaluates the specified field, and adds an error message to the error message list if the field's value is not a valid data source ID value.

Valid IDs can be any sequence of characters or digits, but they must not contain the following characters: space [ ], double quote ["], single quote ['], ampersand [&], question mark [?], less-than sign [<]\, greater-than sign [>], forward-slash [/], back-slash [\ ].

Attributes

Name

Type

Requirements

Description

Note

field

expression

optional

The name of the field to test.

 

error-list-name

constant

optional

The name of a list that will contain the message.

Defaults to "error_list".

 

Child Elements

One of the following child elements is required:

Name

 

<fail-message>

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

<fail-property>

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

Section
Column
width20%
<check-permission>
Column
Checks if the user has the specified permission, and adds an error message to the error message list if the user does not have the specified permission.

Note that this element must be followed by the <check-errors> element for it to do anything meaningful.

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

Attributes
Column
Declares an error message found in a properties file.
Code Block
xmlxml

Name

Type

Requirements

Description

Note

resourcepermission

constant, ${expression}

required

The name of the resource where the message can be foundpermission to check.

 

propertyaction

constant, ${expression}

required

The message property key.

 

Note
titleDraft Status

Final draft.

Section

optional

The action to be performed (permission scope).

Examples: "_ADMIN", "_CREATE", "_UPDATE".

error-list-name

Column
width20%
<field>
Child Elements

One or more of the following child element is optional:

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 argumentname of a list that will contain the message.

Defaults to "java.lang.Stringerror_list".

note

 

titleDraft Status

Final draft.

Name

 

<alt-permission>

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

One of the following child elements is required:

Name

 

<fail-message>

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

<fail-property>

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

Final draft.
Section
Column
width20%
<clear-field>
Column
Sets the value of the specified field to null.
Code Block
xml
xml
<clear-field field="foo" />
Attributes

Name

Type

Requirements

Description

Note

field

expression

required

The name of the field to remove.

 

Section
Column
width20%
<field-to-list>

Attributes

Column
Appends an object to the specified list.
Code Block
xmlxml

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

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

Name of the list.

If the list does not exist, one is created.

Warning

Deprecated - use the <set> element.

Note
titleDraft Status

Section
Column
width20%
<field
<create-
to-request>
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

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<create-object field="foo" requestclass-name="com.acme.FooClass">
  <string value="bar" />
  <field field="fooAttributefoo" />
</create-object>
Attributes

Name

Type

Requirements

Description

Note

field

expression

required

The name of the field to copy.

If the field does not exist, the operation does nothing.

for the new object.

 

classrequest-name

constant, ${expression}

optionalrequired

The servlet request attribute Java class name.

Defaults to the value of field attribute.

 

 

Child Elements

Name

Requirements

 

<field>

optional

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

<string>

optional

(?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})

Warning

Deprecated - use the <script> element

Note
titleDraft Status

Final draft.

Section
Column
width20%
<field
<fail-
to-result>
message>
Column
Copies a field to a service OUT attribute
Declares an error message.
Code Block
xml
xml

<field-to-result field="foo" result-name="fooAttribute" /><add-error>
  <fail-message message="There was an error." />
</add-error>
Attributes

Name

Type

Requirements

Description

Note

fieldmessageexpression

constant+expr

required

The name of the field to copy from, the source of the assignmentmessage text.

 

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
titleDraft Status

Final draft.

Section
Column
width20%
<field
<fail-
to-session>
property>
Column
Copies a field to a servlet session attribute.
Valid only when the simple-method is called as an event, it is ignored otherwise
Declares an error message found in a properties file.
Code Block
xml
xml

<field-to-session field="foo" session-name="fooAttribute<add-error>
  <fail-property resource="ErrorMessages" property="FooError" />
</add-error>
Attributes

Name

Type

Requirements

Description

Note

fieldresource

expressionconstant

required

The name of the field to copy.

If the field does not exist, the operation does nothing.

session-name

constant, ${expression}

optional

The servlet session attribute name.

Defaults to the value of field attribute.

resource where the message can be found.

 

property

constant

required

The message property key.

 

Section
Column
width20%
<field>
Final draft
Column
Declares 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
titleDraft Status

.

Section
Column
width20%
<first
<field-
from
to-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
Appends an object to the specified list.
Code Block
xml
xml

<first<field-fromto-list entry-namelist="foobarList" list-namefield="fooListfoo" />
Attributes

Name

Type

Requirements

Description

Note

field

expression

required

The field to add to the list.

The operation does nothing if the field does not exist.

list

expression

required

Name of the list.

If the list does not exist, one is created.

Warning

Deprecated - use the <set> element

entry-name

optional

The name of the field to copy to

list-name

optional

The name of the list to copy from

Info
titleProposed Changes
  • Currently, both attributes are optional. Require both attributes.
    • Deprecate and replace with a UEL expression

    .

    Section
    Column
    width20%
    <list
    <field-to-
    list>
    request>
    Column
    Copies
    list elements to another list. If the target list is not found, a new list is created
    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
    
<list<field-to-listrequest list-namefield="foo" torequest-list-name="fooListfooAttribute" />
    Attributes

    Name

    Type

    Requirements

    Description

    Note

    field

    expression

    required

    list-name

    optional

    The name of the list field to copy from. The source of the assignment.

    The operation does nothing if the field does not exist.

    requestto-list-name

    constant, ${expression}

    optional

    The servlet request attribute name. The target of the list to copy to

    Info
    titleProposed Changes
    • Currently, both attributes are optional. Require both attributes.
    • Rename the list-name attribute to from-field or from-list to make the syntax similar to other operators.
    Section

    assignment.

    Defaults to the value of field attribute.

    Section
    Column
    width20%
    <field-to-result>
    Column
    Copies a field to a service OUT attribute
    Column
    width20%
    <map-to-map>
    Column
    Copies map entries to another map. If the target map is not found, a new map is created
    .
    Code Block
    xml
    xml
    
<map<field-to-mapresult map-namefield="foo" to-mapresult-name="fooMapfooAttribute" />
    Attributes

    Name

    Type

    Requirements

    Description

    Note

    field

    expression

    required

    map-name

    optional

    The name of the map field to copy from. The source of the assignment.

    The operation does nothing if the field does not exist.

    resultto-map-name

    expression

    optional

    The name of the map to copy to

    Info
    titleProposed Changes
    • Currently, both attributes are optional. Require both attributes.
    • Rename the map-name attribute to from-field or from-map to make the syntax similar to other operators.

    result field to set. The target of the assignment.

    Defaults to the value of field attribute.

    Section
    Column
    width20%
    <field-to-session>
    Column
    Copies a field to a servlet session attribute.

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

    Section
    Column
    width20%
    <now>
    Column
    Sets a field to the current system time

    .

    Code Block
    xml
    xml
    
<now<field-to-session field="foo" session-name="fooNowfooAttribute" />
    Attributes

    Name

    Type

    Requirements

    Description

    Note

    field

    expression

    required

    The name of the field to set, the target copy from. The source of the assignment

     

    .

    The operation does nothing if the field does not exist.

    session-name

    constant, ${expression}

    type

    constant

    optional

    The Java data type of fieldservlet session attribute name. The target of the assignment.

    Defaults to "java.sql.Timestamp"

    Note
    titleDraft Status

    Final draft.

    Section

    the value of field attribute.

    Section
    Deprecated - use <now>.
    Column
    width20%
    <now-date-to-env>
    Column
    Note
    titleDraft Status

    Final draft.

    Section
    Column
    width20%
    <now-timestamp>
    Column
    Deprecated - use <now>.
    Note
    titleDraft Status

    Final draft.

    Section
    <first-from-list>
    Column
    Assigns the first (lowest order) entry in a list to a field
    Column
    width20%
    <order-by>

    Child element of <order-map-list>

    Column
    Defines a map key to sort on
    .
    Code Block
    xml
    xml
    
<order<first-mapfrom-list listentry-name="fooListfoo">
    <order-by field list="fooKeyfooList" />
</order-map-list>

    Attributes

    Attributes
    Name
    Type
    Requirements
    Description
    Note
    entry-name
    expression
    required
    The name of the field to set.
     
    list
    expression
    required
    field
    optional
    The name of the key to sort onlist that contains the object to copy.
    Defaults to a null value if the list does not exist or is empty.
     Warning
    Deprecated - use the <set> element.
     Section
     Column
    width20%
    <order
    <list-
    map
    to-list>
  • Currently, the list attribute is optional. Require the attribute.
    • Currently, the child elements are optional, and the operator throws an exception at run time when none are found. Require at least one child element
     Column
    Sorts a list of maps
    Copies list elements to another list.
     Code Block
    xml
    xml
    
<order<list-mapto-list list="fooListfoo">
    <order-by field="fooKey to-list-name="fooList" />
</order-map-list>

    Attributes
    Name
    Type
    Requirements
    Description
    Note
    list
    expression
    requiredoptional
    The name of the list to be sorted
    Child Elements
    <order-by>
    optional
    Defines a map key to sort on
     Info
    titleProposed Changes
    copy from.
    Operation does nothing if the list does not exist.
    to-list-name
    expression
    required
    Name of the list to copy to.
    If the list does not exist, one will be created.
     Section
     Column
    width20%
    <property
    <map-to-
    field>
    map>
    Currently, all attributes are optional. Require the field, resource, and property attributes
     Column
    Assigns 
    Copies a 
     resource property to a field
    map to another map.
     Code Block
    xml
    xml
    
<property<map-to-fieldmap fieldmap="foooldMap" resourceto-map="fooResource.properties" property="fooKey"newMap" />

    Attributes
    field
    Name
    optional
    The name of the field
     
    resource
    optional
    The resource that contains the property
     
    property
    optional
    The property key
     
    default
    optional
    A default value to be used when the property is not found
     
    no-locale
    optional
    If "true" no localization will be performed on the property's value
    Default is "false"
    arg-list-name
    optional
    The name of a field that contains a list of arguments to be used in formatted property values
     
     Info
    titleProposed Changes
    Type
    Requirements
    Description
    Note
    map
    expression
    required
    The name of the map to copy from.
    Operation does nothing if the map does not exist.
    to-map
    expression
    optional
    The name of the map to copy to.
    If this attribute is empty, the source map will be copied to the current environment.
     Section
     Column
    width20%
    <request-parameters-to-list>
    <now>
     Column
    Copies request parameters to a list.
    Sets a field to the current system time.
     Code Block
    xml
    xml
    
<request-parameters-to-list list-name="fooList" request-name="fooParameter<now field="fooNow" />

    Attributes

    Name
    Type
    Requirements
    Description
    Note
    field
    expression
    required
    list-name
    optional
    Name of the list. If the list does not exist, one is created.
    request-name
    optional
    The name of the request parameter. All parameter values will be added to the list
     Info
    titleProposed Changes
    field to set, the target of the assignment.
     
    type
    constant
    optional
    The field data type.
    Defaults to "java.sql.Timestamp"
  • Currently, both attributes are optional. Require both attributes.
  • Rename the list-name attribute to list - to make the syntax similar to other operators.
    • Rename the request-name attribute to parameter-name - to make the syntax clearer
    .
     Section
     Column
    width20%
    <request
    <now-date-to-
    field>
    env>
     java.sql.Date object initialized to the current system time.
    Attributes
     Column
    Copies 
    Sets a 
     Servlet request attribute 
    field to a 
     field.
     Code Block
    xmlxml
    
<request-to-field field="foo" request-name="fooAttribute" />

    Name
    Type
    Requirements
    Description
    Note
    field
    expression
    required
    Attributes
    field
    optional
    The name of the field for the new object
    request-name
    optional
    The name of the request attribute
    default
    optional
    A default constant value - used if the request attribute does not exist
    map-name
    optional
    The name of the map containing field
    to set, the target of the assignment.
     
     Warning
    Deprecated - use the <now> element.
     Section
     Column
    width20%
    <now-timestamp>
     Column
    Sets a field to a java.sql.Timestamp object initialized to the current system time.
    Attributes
    Name
    Type
    Requirements
    Description
    Note
    field
    expression
    required
    The name of the field to set, the target of the assignment.
     
     Warning
    Deprecated - use the <now> element
     Info
    titleProposed Changes
  • Currently, the field and request-name attributes are optional. Require both attributes.
  • Eliminate the map-name attribute.
    • Rename the request-name attribute to attribute-name - to make the syntax clearer
    .
     Section
     Column
    width20%
    <session
    <order-
    to-field>
    by>
     Column
    Copies a Servlet session attribute to a field
    Declares a field or map key to sort on.
     Code Block
    xml
    xml
    
<session<order-tomap-fieldlist fieldlist="foofooList">
    session<order-nameby field="fooAttributefooKey" />
</order-map-list>

    Attributes
    Name
    Type
    Requirements
    Description
    Note
    field
    expression
    requiredoptional
    The name of the field for the new object
    session-name
    optional
    The name of the session attribute
    default
    optional
    A default constant value - used if the session attribute does not exist
    map-name
    optional
    The name of the map containing field
     Info
    titleProposed Changes
    • Currently, the field and session-name attributes are optional. Require both attributes.
    • Eliminate the map-name attribute.
    • Rename the session-name attribute to attribute-name - to make the syntax clearer.
    or map key to sort on.
     
     Section
     Column
    width20%
    <order-map-list>
     Column
    Sorts a list of maps.
    Maps are sorted by the keys specified in the <order-by> sub-elements
     Section
     Column
    width20%
    <set>
     Column
    Assigns a field from an expression or script, or from a constant value
    .
     Code Block
    xml
    xml
    
<set field<order-map-list list="foofooList" value="bar" />
<set>
    <order-by field="baz" from="foofooKey" />
<!/order-- Field "baz" contains the string "bar" -->map-list>

    Attributes
    Name
    Type
    Requirements
    Description
    NotesNote
    fieldlist
    expression
    required
    The name of the field to set, the target of the assignmentlist to be sorted.
    The operation does nothing if the list is not found.
     
    from
    expression, script
    required if value is empty
    An expression or script that returns an object or null
    The script must be prefixed with the script language followed by a colon (":")
    value
    constant+expr
    required if from is empty
    A constant value
    Default type = "java.lang.String"
    default
    constant+expr, expression
    optional
    A default value - used if from evaluates to null
    Expressions must be enclosed in ${} 
    type
    constant
    optional
    The Java data type of field
    "NewList" will create a new java.util.List, "NewMap" will create a new java.util.Map
    set-if-null
    constant
    optional
    Controls if field can be set to null.
    Defaults to "false"
    set-if-empty
    constant
    optional
    Controls if field can be set to an empty value. The meaning of "empty" depends on the Java data type.
    Defaults to "true"
     Note
    titleDraft Status
    Final draft.
    Child Elements
    One or more of the following child element is required:
    Name
     
    <order-by>
    (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}})
     Section
     Column
    width20%
    <property-to-field>
     Column
    Assigns a resource property value to a field.
     Code Block
    xml
    xml
    <property-to-field field="foo" resource="fooResource.properties" property="fooKey" />

    Attributes
    Name
    Type
    Requirements
    Description
    Note
    field
    expression
    required
    The name of the field to set, the target of the assignment.
     
    resource
    constant, ${expression}
    required
    The name of a properties resource. Can be a file on the classpath or a resource defined in the SystemProperty entity.
     
    property
    constant, ${expression}
    required
    The property key.
     
    default
    constant, ${expression}
    optional
    The default value to use if the property value is null or empty.
     
    no-locale
    constant
    optional
    Suppress property value localization. The user's/system locale will be ignored when retrieving the property value.
    Default is "false".
    arg-list
    expression
    optional
    The name of an argument list to be used with a formatting string. The argument list is applied to the property value.
    The attribute does nothing if the argument list is not found. See the java.text.MessageFormat class for more information.
     Section
     Column
    width20%
    <request-parameters-to-list>
     Column
    Appends a servlet request parameter list to a list.
    Valid only when the simple-method is called as an event, it is ignored otherwise.
     Code Block
    xml
    xml
    <request-parameters-to-list list="fooList" request-name="fooParameter" />

    Attributes
    Name
    Type
    Requirements
    Description
    Note
    request-name
    constant, ${expression}
    required
    The name of the servlet request parameter. All matching parameter values will be added to the list.
     
    list
    expression
    optional
    The name of the list.
    If the list does not exist, one will be created. Defaults to the request-name attribute value.
  • Currently, the field attribute is optional. Require the field attribute.
  • Currently, the from-field and value attributes are optional. Require one of the two attributes.
  • Rename the from-field attribute to from. The attribute will be used exclusively for UEL expressions.
  • Change the behavior of the value attribute: The attribute will be used exclusively for string constants.
    • Remove the default-value attribute. The value attribute will be used for default constant values.
     Section
     Column
    width20%
    <request-to-field>
     Column
    Copies a servlet request attribute to a field.
    Valid only when the simple-method is called as an event, it is ignored otherwise.
     Code Block
    xml
    xml
    <request-to-field field="foo" request-name="fooAttribute" />

    Attributes
    Name
    Type
    Requirements
    Description
    Note
    field
    expression
    required
    The name of the field to set, the target of the assignment.
     
    request-name
    constant, ${expression}
    optional
    The servlet request attribute name.
    Defaults to the value of field attribute.
    default
    constant, ${expression}
    optional
    A default value to use if the request attribute does not exist.
     
     Section
     Column
    width20%
    <set-calendar>
    Attributes
     Column
    Performs a Timestamp adjustment operation.
     Code Block
    xmlxml
    
<set-calendar field="tomorrowStamp" from-field="nowTimestamp" day="1" />
<set-calendar field="yesterdayStamp" from-field="nowTimestamp" day="-1" />

    field
    optional
    The name of the field to set (the l-value)
    from-field
    optional
    The name of a field to copy from (the r-value)
    value
    optional
    A constant value
    default-value
    optional
    A default constant value - used if from-field evaluates to null
    type
    optional
    The Java data type of field
    years
    optional
    A signed integer adjustment amount
    months
    optional
    A signed integer adjustment amount
    days
    optional
    A signed integer adjustment amount
    hours
    optional
    A signed integer adjustment amount
    minutes
    optional
    A signed integer adjustment amount
    seconds
    optional
    A signed integer adjustment amount
    millis
    optional
    A signed integer adjustment amount
    period-align-start
    optional
    Set the adjusted Timestamp to period start: "day", "week", "month", "year"
    period-align-end
    optional
    Set the adjusted Timestamp to period end: "day", "week", "month", "year"
    locale
    optional
    The locale (calendar) to be used for the operation
    time-zone
    optional
    The time zone to be used for the operation
     Info
    titleProposed Changes