| Alert |
|---|
| title | Mini Lang Deprecated |
|---|
| type | Warning |
|---|
|
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 |
|---|
| server | ASF JIRA |
|---|
| serverId | 5aa69414-a9e9-3523-82ec-879b028fb15b |
|---|
| key | OFBIZ-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
...
)
...
...
Attributes
Attribute Types
Type | Description | Example |
|---|
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 |
|---|
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 |
|---|
|
<simple-method method-name="fooMethod">
<!-- some mini-language code goes here -->
</simple-method>
|
AttributesName | 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". |
|
|
...
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | |
|
|
Assignment Operations
Assignment operations modify the script's state.
| Section |
|---|
| Column |
|---|
Adds a message to the error message list.| Code Block |
|---|
|
<add-error>
<fail-message message="There was an error" />
</add-error>
|
AttributesName | Type | Requirements | Description | Note |
|---|
error-list-name | constant | optional | The name of a list that will contain the message. | Defaults to "error_list". |
Child ElementsOne of the following child elements is required: Final draft.Name | |
|---|
<fail-message>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <fail-property>
|
|
| Note |
|---|
| | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
| Section |
|---|
| Column |
|---|
| <clear<alt-
field>permission>
|
| 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 |
|---|
| xml | xml |
<clear-field field="foo" />
| AttributesName | Type | Requirements | Description | Note |
|---|
fieldpermission | constant, ${expression} | required | The name of the field to removepermission to check. | |
| Note |
|---|
| action | constant, ${expression} | optional | The action to be performed (permission scope). | Examples: "_ADMIN", "_CREATE", "_UPDATE" |
|
| Section |
|---|
| Column |
|---|
| <create-object><assert>
|
| Column |
|---|
Adds an error message to the error message list for each condition that evaluates to false.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 Block |
|---|
| xml | xml |
<create-object field="foo" class-name="com.acme.FooClass">
<string value="bar" />
<field field="foo" />
</create-object>
| AttributesName | Type | Requirements | Description | Note |
|---|
fieldtitle | constant, ${expression} | requiredoptional | The name of the field for the new object. | | title of the assert operation. | The title is used in test reports. | error-listclass-name | constant | requiredoptional | The Java class namename of a list that will contain the message. | Defaults to "error_list". |
Child ElementsName | Requirements | |
|---|
<field>
| optional |
| <string>
| optional |
|
| Warning |
|---|
Deprecated - use the <script> element. |
| Note |
|---|
| Final draft.Any <condition> child element | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
| Section |
|---|
| Column |
|---|
| <fail<check-
message>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 [\ ]. Declares an error message.| Code Block |
|---|
| xml | xml |
<add-error>
<fail-message message="There was an error." />
</add-error>
AttributesName | Type | Requirements | Description | Note |
|---|
messagefield | constant+exprexpression | requiredoptional | The message textname of the field to test. | |
|
| Section |
|---|
error-list-name | constant | optional | The name of a list that will contain the message. | Defaults to "error_list". |
Child ElementsOne 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 |
|---|
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 |
|---|
Declares 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 | constant | required | The name of the resource where the message can be found. | |
property | constant | required | The message property key. | |
| Section |
|---|
| Column |
|---|
| Specifies an environment field to be passed as an argument to an object method call . AttributesName | Type | Requirements | Description | Note |
|---|
fieldpermission | constant, ${expression} | required | The name of the environment field to usepermission to check. | | typeaction | constant, ${expression} | optional | The Java class of the argument. | Defaults to "java.lang.String". |
|
|
| Section |
|---|
action to be performed (permission scope). | Examples: "_ADMIN", "_CREATE", "_UPDATE". | error-list-name | constant | optional | The name of a list that will contain the message. | Defaults to "error_list". |
Child ElementsOne or more of the following child element is optional: 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-{{}}) |
|
| Column |
|---|
Appends an object to the specified list.| Code Block |
|---|
| xml | xml |
<field-to-list list="barList" field="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 | Name of the list. | If the list does not exist, one is created. |
| Warning |
|---|
Deprecated - use the <set> element. |
| Note |
|---|
| Final draft.
|
| Section |
|---|
| Column |
|---|
| <field<clear-
to-request>field>
|
| Column |
|---|
Copies a field to a servlet request attribute.Valid only when the simple-method is called as an event, it is ignored otherwiseSets the value of the specified field to null.| Code Block |
|---|
|
<field-to-request<clear-field field="foo" request-name="fooAttribute" />
|
AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to copyremove. | If the field does not exist, the operation does nothing. | request-name | constant, ${expression} | optional | The servlet request attribute name. | Defaults to the value of field attribute. |
|
|
| Section |
|---|
| Column |
|---|
| <field<create-
to-result>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 service OUT attribute.| Code Block |
|---|
| xml | xml |
<field-to-result field="foo" resultclass-name="com.acme.FooClass">
<string value="bar" />
<field field="fooAttributefoo" />
</create-object>
|
AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to copy from, the source of the assignmentfor the new object. | | resultclass-name | expressionconstant | optionalrequired | The name of the result field to set, the target of the assignment. | Defaults to the value of field attribute. |
Child ElementsName | 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. |
|
|
| Section |
|---|
| Column |
|---|
Declares an error message |
|
| Section |
|---|
| Column |
|---|
Copies a field to a servlet session attribute.Valid only when the simple-method is called as an event, it is ignored otherwise.| Code Block |
|---|
|
<field-to-session field="foo" session-name="fooAttribute" /><add-error>
<fail-message message="There was an error." />
</add-error>
|
AttributesName | Type | Requirements | Description | Note |
|---|
fieldmessageexpression | constant+expr | 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. |
| Note |
|---|
| | Final draft.
|
| Section |
|---|
| Column |
|---|
| <first<fail-
from-list>property>
|
| Column |
|---|
Assigns the first (lowest order) entry in a list to a fieldDeclares an error message found in a properties file.| Code Block |
|---|
|
<first-from-list entry-name="foo" list-name="fooList<add-error>
<fail-property resource="ErrorMessages" property="FooError" />
</add-error>
|
AttributesName | Type | Requirements | Description | Note |
|---|
entry-nameresource | expressionconstant | required | The name of the field to setresource where the message can be found. | | list-nameproperty | expressionconstant | required | The name of the list 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 |
|---|
Declares an environment field to be passed as an argument to an object method call.AttributesName | 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 |
|---|
| | Final draft
|
| Section |
|---|
| Column |
|---|
| <list<field-to-list>
|
| Column |
|---|
Copies list elements to another Appends an object to the specified list.| Code Block |
|---|
|
<list<field-to-list list-name="foobarList" to-list-namefield="fooListfoo" />
|
AttributesName | Type | Requirements | Description | Note |
|---|
list-namefield | expression | required | The name of field to add to the list to copy from. | Operation The operation does nothing if the list field does not exist. | to-list-name | expression | required | Name of the list to copy to. | If the list does not exist, one will be is created. |
| Warning |
|---|
Deprecated - use the <set> element | | Note |
|---|
| Final draft. |
|
|
| Section |
|---|
| Column |
|---|
| <map<field-to-
map>request>
|
| Column |
|---|
Copies a map to another mapfield to a servlet request attribute.Valid only when the simple-method is called as an event, it is ignored otherwise. | Code Block |
|---|
|
<map<field-to-maprequest mapfield="oldMapfoo" torequest-mapname="newMapfooAttribute" />
|
AttributesName | Type | Requirements | Description | Note |
|---|
mapfield | expression | required | The name of the map field to copy from. The source of the assignment. | Operation The operation does nothing if the map field does not exist. | torequest-mapname | constant, ${expression} | optional | The servlet request attribute name. The target of the map to copy to. | If this attribute is empty, the source map will be copied to the current environment. |
assignment. | Defaults to the value of field attribute. |
|
|
| Section |
|---|
| Column |
|---|
Copies a field to a service OUT attribute |
|
| Section |
|---|
| Column |
|---|
Sets a field to the current system time.| Code Block |
|---|
|
<now<field-to-result field="foo" result-name="fooNowfooAttribute" />
|
AttributesName | 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. | result-name | expression | type | constant | optional | The field data typename of the result field to set. The target of the assignment. | Defaults to "java.sql.Timestamp". |
| Note |
|---|
| | Final draftthe value of field attribute. |
|
| Section |
|---|
| Column |
|---|
| <now<field-
date-to-
env>session>
|
| Column |
|---|
Sets Copies a field to a java.sql.Date object initialized to the current system time.servlet session attribute.Valid only when the simple-method is called as an event, it is ignored otherwise. | Code Block |
|---|
| <field-to-session field="foo" session-name="fooAttribute" />
|
AttributesAttributes
Name | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to set, the target copy from. The source of the assignment. | |
| Warning |
|---|
Deprecated - use the <now> element. |
| Note |
|---|
| | The operation does nothing if the field does not exist. | session-name | constant, ${expression} | optional | The servlet session attribute name. The target of the assignment. | Defaults to the value of field attribute |
|
| Section |
|---|
| Column |
|---|
| <now<first-from-
timestamp>list>
|
| Column |
|---|
Sets a field Assigns the first (lowest order) entry in a list to a java.sql.Timestamp object initialized to the current system time.field.| Code Block |
|---|
| <first-from-list entry-name="foo" list="fooList" />
|
AttributesName | Type | Requirements | Description | Note |
|---|
entry-name |
Attributes
Name | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to set, the target of the assignment.. | | list | expression | required | The name of the list that contains the object to copy. | Defaults to a null value if the list does not exist or is empty. |
| Warning |
|---|
Deprecated - use the <now> element. | | Note |
|---|
| Final draft<set> element. |
|
|
| Section |
|---|
| Column |
|---|
| <order<list-to-
by>list>
|
| Column |
|---|
Defines a field or map key to sort onCopies list elements to another list.| Code Block |
|---|
|
<order<list-mapto-list list="fooListfoo">
<order-by field="fooKey to-list-name="fooList" />
</order-map-list>
|
AttributesName | Type | Requirements | Description | Note |
|---|
fieldlist | expression | required | The name of the field or map key to sort on. | |
| Note |
|---|
| | list to 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 |
|---|
| <order<map-
mapto-
list>map>
|
| Column |
|---|
Copies a map to another map.Sorts a list of maps.Maps are sorted by the keys specified in the order-by sub-elements. | Code Block |
|---|
|
<order<map-to-map-list listmap="fooListoldMap">
<order-by field to-map="fooKeynewMap" />
</order-map-list>
|
AttributesName | Type | Requirements | Description | Note |
|---|
listmap | expression | required | The name of the list map to be sortedcopy from. | Operation does nothing if the list is map does not foundexist. |
Child Elements
Name | Requirements | |
|---|
<order-by>
| required |
|
| Note |
|---|
| | 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 |
|---|
| <property-to-field><now>
|
| Column |
|---|
Assigns Sets a resource property value to a fieldfield to the current system time.| Code Block |
|---|
|
<property-to-field<now field="foo" resource="fooResource.properties" property="fooKey" fooNow" />
|
AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to set, the target of the assignment. | | resourcetype | 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 retriving the property value. | Default is "false". | arg-list | expression | optional | An argument list to be used with a formatting string. The argument list is applied to the property value. | Does nothing if the argument list is not found. See the java.text.MessageFormat class for more information. | optional | The field data type. | Defaults to "java.sql.Timestamp". |
|
|
| Section |
|---|
| Column |
|---|
Sets a field to a java.sql.Date object initialized to the current system time.AttributesName | 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 | | Note |
|---|
| Final draft. |
|
|
| Section |
|---|
| Column |
|---|
| <request-parameters-to-list><now-timestamp>
|
| Column |
|---|
Sets a field to a java.sql.Timestamp object initialized to the current system time.AttributesName | 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. |
|
|
| Section |
|---|
| Column |
|---|
Declares a field or map key to sort onAppends 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 |
|---|
|
<request-parameters-to<order-map-list list-name="fooList" request-name>
<order-by field="fooParameterfooKey" />
</order-map-list>
|
AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | request-name | constant, ${expression} | required | The name of the servlet request parameter. All matching parameter values will be added to the list. | | list-name | expression | optional | Name of the list. If the list does not exist, one is created. | Defaults to the request-name attribute value. |
field or map key to sort on. | |
|
|
| Section |
|---|
| Column |
|---|
| <request<order-
tomap-
field>list>
|
| Column |
|---|
Sorts a list of maps.Maps are sorted by the keys specified in the <order-by> sub-elements 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 |
|---|
|
<request<order-tomap-fieldlist fieldlist="foofooList" request-name>
<order-by field="fooAttributefooKey" />
|
AttributesAttributesName | Type | Requirements | Description | Note |
|---|
fieldlist | 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. | |
| Note |
|---|
| | list to be sorted. | The operation does nothing if the list is not found. |
Child ElementsOne 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 |
|---|
| <session<property-to-field>
|
| Column |
|---|
Copies a servlet session attribute Assigns a resource property value to a field.Valid only when the simple-method is called as an HTTP event, it is ignored otherwise. | Code Block |
|---|
|
<session<property-to-field field="foo" resource=" session-namefooResource.properties" property="fooAttributefooKey" />
|
AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to set, the target of the assignment. | | session-nameresource | constant, ${expression} | optionalrequired | The servlet session attribute name.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. | Defaults to the value of field attribute. | default | constant, ${expression} | optional | A The default value to use if the session attribute does not existproperty value is null or empty. | |
| Draft Status | Final draft. |
|
| Section |
|---|
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 |
|---|
| <set><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 Assigns a field from an expression or script, or from a constant value. | Code Block |
|---|
|
<set field<request-parameters-to-list list="foofooList" valuerequest-name="barfooParameter" />
<set field="baz" from="foo" />
<!-- Field "baz" contains the string "bar" -->
|
Attributes
AttributesName | Type | Requirements | Description | Note |
|---|
request-name | constant, ${expression} | Name | Type | Requirements | Description | Notes |
|---|
field | expression | required | The name of the field to set, the target of the assignmentservlet request parameter. All matching parameter values will be added to the list. | | fromlist | 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, ${expression} | optional | A default value - used if from evaluates to null. | | 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". |
| optional | The name of the list. | If the list does not exist, one will be created. Defaults to the request-name attribute value. |
|
|
| Section |
|---|
| 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 |
|---|
| <request-to-field field="foo" request-name="fooAttribute" />
|
AttributesName | 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 |
|---|
| <set<session-to-
calendar>field>
|
| Column |
|---|
Copies a servlet session attribute to a field.Valid only when the simple-method is called as an HTTP event, it is ignored otherwise. | Code Block |
|---|
| <session-to-field field="foo" session-name="fooAttribute |
Adjusts a Timestamp by a specified time duration.| Code Block |
|---|
| xml | xml |
<set-calendar field="tomorrowStamp" from-field="nowTimestamp" day="1" />
<set-calendar field="yesterdayStamp" from-field="nowTimestamp" day="-1" />
|
AttributesName | Type | Requirements | Description | NotesNote |
|---|
field | expression | required | The name of the field to set, the target of the assignment. | | session-name | constant, ${expression} | optional | The servlet session attribute name. | Defaults to the value of the field attribute. | default | constant, ${expression} | optional | A default value to use if the session attribute does not exist. | |
|
|
| Section |
|---|
| Column |
|---|
Assigns a field from an expression or script, or from a constant value.| Code Block |
|---|
| <set field="foo" value="bar" />
<set field="baz" from="foo" />
<!-- Field "baz" contains the string "bar" -->
|
AttributesName | Type | Requirements | Description | Notes |
|---|
field | expression | required | The name of the field to set, the target of the assignment. | | 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 | 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, ${expression} | optional | A default value - used if from evaluates to null. | | 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". | years | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of year(s). | If an expression is used, it should evaluate to an integer. | months | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of month(s). | If an expression is used, it should evaluate to an integer. | days | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of days(s). | If an expression is used, it should evaluate to an integer. | hours | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of hour(s). | If an expression is used, it should evaluate to an integer. | A default value that is used when the from attribute evaluates to null or empty. | | 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. Otherwise, the attribute must contain a valid Java class name. | localeminutes | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of minute(s). | If an expression is used, it should evaluate to an integer. | seconds | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of second(s). | If an expression is used, it should evaluate to an integer. | millis | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of milli-second(s). | If an expression is used, it should evaluate to an integer. | period-align-start | constant, ${expression} | optional | Align the adjusted date to the start of a period: "day", "week", "month", "year" | | period-align-end | constant, ${expression} | optional | Align the adjusted date to the start of a period: "day", "week", "month", "year" | | locale | constant, ${expression} | optional | The locale (calendar) to be used for the operation | | time-zone | constant, ${expression} | optional | The time zone to be used for the operation | |
|
|
| Section |
|---|
| Column |
|---|
|
<set-service-fields>
|
| Column |
|---|
Copies elements from a source map that match a service's IN attributes to a target map.
If a locale dependent type is passed allows to i18n the value. | Defaults to environment locale. | 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". |
|
|
| Section |
|---|
| Column |
|---|
Adjusts a Timestamp by a specified time duration.| Code Block |
|---|
| <set-calendar field="tomorrowStamp" from-field="nowTimestamp" day="1" />
<set-calendar field="yesterdayStamp" from-field="nowTimestamp" day="-1" />
|
AttributesName | Type | Requirements | Description | Notes |
|---|
field | expression | required | The name of the field to set, the target of the assignment. | | 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, ${expression} | optional | A default value that is used when the from attribute evaluates to null or empty. | | set-if-null | constant | optional | Controls if field can be set to null. | Defaults to "false". | years | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of year(s). | If an expression is used, it should evaluate to an integer. | months | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of month(s). | If an expression is used, it should evaluate to an integer. | days | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of days(s). | If an expression is used, it should evaluate to an integer. | hours | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of hour(s). | If an expression is used, it should evaluate to an integer. | minutes | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of minute(s). | If an expression is used, it should evaluate to an integer. | seconds | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of second(s). | If an expression is used, it should evaluate to an integer. | millis | constant, ${expression} | optional | Add (optionally using +) or subtract (using -) a number of milli-second(s). | If an expression is used, it should evaluate to an integer. | period-align-start | constant, ${expression} | optional | Align the adjusted date to the start of a period: "day", "week", "month", "year" | | period-align-end | constant, ${expression} | optional | Align the adjusted date to the end of a period: "day", "week", "month", "year" | | locale | constant, ${expression} | optional | The locale (calendar) to be used for the operation | Defaults to the environment locale. | time-zone | constant, ${expression} | optional | The time zone to be used for the operation | Defaults to the environment time zone |
|
|
| Code Block |
|---|
xml | xml |
<set-service-fields service-name="fooService" map="barMap" to-map="fooServiceAttributes" />
|
Attributes
Name | Type | Requirements | Description | Notes |
|---|
service-name | constant, ${expression} | required | The name of the service. | |
map | expression | required | The name of the map to copy the matching IN attributes from. | The operation does nothing if the map does not exist. |
to-map | expression | required | The name of the map to copy the matching IN attributes to. | If the map does not exist, a new one is created. |
| Section |
|---|
| Column |
|---|
The operation starts by applying an argument list (if found) to the string attribute value, the result is prepended by the prefix attribute value, and the suffix attribute value is appended to the result. If the string specified in the field attribute exists, the final result is appended to it, else the field is set to the final result.
Attributes
Name | Type | Requirements | Description | Notes |
|---|
field | expression | required | The name of the field to set, the target of the assignment. | | string | constant, ${expression} | required | The string to append to the field named in the field attribute. | This can be a formatting string that is used with the argument list specified in the arg-list attribute. | arg-list | expression | optional | An argument list to be used with a formatting string. The argument list is applied to the string attribute value. | Does nothing if the argument list is not found. See the java.text.MessageFormat class for more information. | prefix | constant, ${expression} | optional | A string that will be prepended to the string attribute value. | | suffix | constant, ${expression} | optional | A string that will be appended to the string attribute value. | |
| Note |
|---|
| | Final draft
|
| Section |
|---|
| Column |
|---|
| <string<set-current-
touser-
list>login>
|
| Column |
|---|
Adds a string to a list of stringsSets the UserLogin entity value to be used for authentication for the rest of the method.AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | string | constant, ${expression} | required | The string to add to the list specified in the list attribute. | | list | expression | required | List to add the string to. | If the list does not exist, one will be created. | arg-list | expression | optional | An argument list to be used with a formatting string. The argument list is applied to the string attribute value. | Does nothing if the argument list is not found. See the java.text.MessageFormat class for more information. | message-field | constant | optional | Inserts a message above a field (used in conjunction with @fieldErrors FTL macro). | |
| Warning |
|---|
Deprecated - use the <set> element. |
name of the field that contains the UserLogin entity value. | A runtime exception will be thrown if the entity value does not exist. |
| Warning |
|---|
Deprecated - you can pass an alternate UserLogin entity value to the called service's IN attributes. |
|
|
| Section |
|---|
| Column |
|---|
| <to<set-
string>service-fields>
|
| Column |
|---|
Copies map elements that match a service's IN attributes from a source map to a target map.| Code Block |
|---|
| <set-service-fields service-name="fooService" map="barMap" to-map="fooServiceAttributes" />
|
Converts an object to a string.AttributesName | Type | Requirements | Description | Notes |
|---|
service-name | constant, ${expression} | field | expression | required | The name of the field containing the object to convertservice. | | map | expression | required | The name of the map to copy the matching IN attributes from. | The operation does nothing if the object is map does not foundexist. | formatto-map | constantexpression | optional | Format to use for the conversion. | | numeric-padding | constant | optional | Left-pad the string with the specified number of zeroes. | | required | The name of the map to copy the matching IN attributes to. | If the map does not exist, a new one is created. |
|
|
| Section |
|---|
| Column |
|---|
Declares a java.lang.String to be passed as an argument to a method call.The String can be contained in the value attribute and/or in the element body. The element body text is appended to the value attribute text. AttributesName | Type | Requirements | Description | Note |
|---|
value | constant, ${expression} | optional | The String text. | |
| Warning |
|---|
Deprecated - use the <set> element. |
| Note |
|---|
| | Final draft.
|
| Section |
|---|
| Column |
|---|
| <webapp-property-to-field>
| | Column |
|---|
<string-append>
|
| Column |
|---|
The operation starts by applying an argument list (if found) to the string attribute value, the result is prepended by the prefix attribute value, and the suffix attribute value is appended to the result. If the string specified in the field attribute exists, the final result is appended to it, else the field is set to the final result. Copies a property value from a properties file in a ServletContext resource to a field.| Code Block |
|---|
| xml | xml |
<webapp-property-to-field field="foo" resource="/WEB-INF/foo.properties" property="fooKey" />
AttributesName | Type | Requirements | Description | Notes |
|---|
field | expression | required | The name of the field to set, the target of the assignment. | | resourcestring | constant, ${expression} | required | The resource location of the properties file inside the webapp, and relative to the root of the webapp (can be inside a war file). | Example: "/WEB-INF/myprops.properties". | string to append to the field named in the field attribute. | This can be a formatting string that is used with the argument list specified in the arg-list attribute. | arg-list | expression | optional | The name of an argument list to be used with a formatting string. | The argument list is applied to the string attribute value. The attribute does nothing if the argument list is not found. See the java.text.MessageFormat class for more information. | prefixproperty | constant, ${expression} | required | optional | A string that will be prepended to the string attribute valueThe property key. | | defaultsuffix | constant, ${expression} | optional | A default value to use if the property value is null or emptystring that will be appended to the string attribute value. | |
| Note |
|---|
titleDraft Status | Final draft. |
|
Conditional/Looping Statements
| Section |
|---|
| Column |
|---|
| <and><string-to-list>
|
| Column |
|---|
Combines conditional elements using a boolean AND.| Code Block |
|---|
xml | xml |
<if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
| Adds a string to a list of strings.AttributesName | Type | Requirements | Description | Notes |
|---|
string | constant, ${expression} | required | The string to add to the list specified in the list attribute. | | list | expression | required | List to add the string to. | If the list does not exist, one will be created. | arg-list | expression | optional | The name of an argument list to be used with a formatting string. | The argument list is applied to the string attribute value. The attribute does nothing if the argument list is not found. See the java.text.MessageFormat class for more information. | message-field | constant | optional | Inserts a message above a field (used in conjunction with @fieldErrors FTL macro). | |
| Warning |
|---|
Deprecated - use the <set> element. |
|
|
| Section |
|---|
| Column |
|---|
Converts an object to a string.AttributesName | Type | Requirements | Description | Notes |
|---|
field | expression | required | The name of the field containing the object to convert. | The operation does nothing if the object is not found. | format | constant | optional | The format to use for the conversion. | | numeric-padding | constant | optional | Left-pad the string with the specified number of zeroes. | |
| Warning |
|---|
Deprecated - use the <set> |
|
|
| Section |
|---|
| Column |
|---|
Evaluates each contained condition independently, and adds an error message to the error message list for each condition that does not evaluate to true.Attributes
title | optional | The assertion title - used in error messages to identify the assertion | | error-list-name | optional | The name of the error list | Defaults to "error_list" |
Child Elements
Any <condition> child element | optional | A condition to test |
| Info |
|---|
| | Currently, the title attribute is optional. Keep the title attribute optional but have it default to the file location and line number.Eliminate the error-list-name attribute.Currently, the child element is optional. Require at least one child element. |
|
|
| Section |
|---|
| Column |
|---|
| <break><webapp-property-to-field>
|
| Column |
|---|
Causes script execution to exit the nearest loop element. |
|
| Section |
|---|
Copies a property value from a properties file in a ServletContext resource to a field.Valid only when the simple-method is called as an event, it is ignored otherwise. | Code Block |
|---|
| <webapp-property-to-field field="foo" resource="/WEB-INF/foo.properties" property="fooKey" />
|
AttributesName | Type | Requirements | Description | Notes |
|---|
field | expression | required |
|
| Column |
|---|
Evaluates the specified field, and adds an error message to the error message list if the field's value is not a valid database ID value.Attributes
field | optional | The name of the field to validate | | map-name | optional | The name of the map containing field | | error-list-name | optional | The name of the error list | Defaults to "error_list" |
Child Elements
<fail-message> | optional | <fail-property> | optional |
| Info |
|---|
| | Currently, the field attribute is optional. Require the field attribute.Eliminate the map-name and error-list-name attributes.Currently, the child elements are optional. Require one child element.set, the target of the assignment. | | resource | constant, ${expression} | required | The resource location of the properties file inside the webapp, and relative to the root of the webapp (can be inside a war file). | Example: "/WEB-INF/myprops.properties". | property | constant, ${expression} | required | The property key. | | default | constant, ${expression} | optional | A default value to use if the property value is null or empty. | |
|
Conditional/Looping Statements
Conditional/looping statements control the script execution path.
| Section |
|---|
| Column |
|---|
| <check-errors><and>
|
| Column |
|---|
Halts script execution if the error message list contains any messages. The error message list is returned to the calling process.Attributes
error-code | optional | The error code to return | Defaults to "error" | error-list-name | optional | The name of the error list | Defaults to "error_list" |
| Info |
|---|
| - Eliminate the error-list-name attribute.
|
|
| Section |
|---|
| 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.
Attributes
permission | optional | The permission to check | |
action | optional | The action to be performed (permission scope) | |
error-list-name | optional | The name of the error list | Defaults to "error_list" |
Child Elements
Combines conditional elements using a boolean AND.Evaluates to true if all sub-elements evaluate to true. | Code Block |
|---|
| <if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
|
|
|
<accept-userlogin-party> | optional |
<alt-permission> | optional |
<fail-message> | optional |
<fail-property> | optional |
| Info |
|---|
|
- Currently, the permission and action attributes are optional. Require the permission and action attributes.
- Eliminate the error-list-name attribute.
|
| Section |
|---|
| Column |
|---|
Combines a group of conditional elements into a single logical (true/false) expression.| Code Block |
|---|
| xml | xml |
<if>
<condition>
<and>
<if-compare field="colorModelcolor" operator="equals" value="RYByellow" />
<or>
<if-compare field="color" operator="equals" value="redblue" />
</or>
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
|
|
| Section |
|---|
| Column |
|---|
Causes script execution to return to the beginning of the nearest enclosing loop element. |
|
Child ElementsOne or more of the following child elements is required: Name | |
|---|
<and>
| | <if-validate-method>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare-field>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-regexp>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-empty>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-has-permission>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <or>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <not>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <xor>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Causes script execution to exit the nearest looping element.The operation will throw an exception if there is no enclosing looping element. Enclosing Looping ElementsName | |
|---|
<iterate>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <iterate-map>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <loop>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <while>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Halts script execution if the error message list contains any messages.The error message list is returned to the calling process. AttributesName | Type | Requirements | Description | Note |
|---|
error-code | constant, ${expression} | optional | The error code to return to the calling process. | Defaults to value of the containing <simple-method> element "default-error-code" attribute. | error-list-name | constant, ${expression} | optional | The name of a list that will contain the message. | Defaults to "error_list". |
|
|
| Section |
|---|
| Column |
|---|
Combines a group of conditional elements into a single logical (true/false) expression. |
|
| Section |
|---|
| Column |
|---|
Contains a block of code to be executed when a condition evaluates to false.
| Code Block |
|---|
xml | xml |
<if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
| Section |
|---|
| Column |
|---|
Contains a block of code to be executed when a condition evaluates to false.| Code Block |
|---|
| xml | xml |
<if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else-if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="CYMRYB" />
<or>
<if-compare field="color" operator="equals" value="cyanred" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="magentablue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
</else-if>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
|
|
| Section |
|---|
| Column |
|---|
Contains blocks of code that are executed based on a logical (true/false) condition.
| Code Block |
|---|
xml | xml |
<if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else-if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="CYM" />
<or>
<if-compare field="color" operator="equals" value="cyan" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="magenta" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
</else-if>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
Child Elements
<condition> | optional |
<then> | optional |
<else> | optional |
<else-if> | optional |
| Info |
|---|
|
- Currently, the
<condition> and <then> child elements are optional. Require the <condition> and <then> child elements.
|
Child ElementsOne of the following child elements is required: Name | |
|---|
<and>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-validate-method>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare-field>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-regexp>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-empty>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-has-permission>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <or>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <not>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <xor>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Causes script execution to return to the beginning of the nearest enclosing loop element.The operation will throw an exception if there is no enclosing looping element. Enclosing Looping ElementsName | |
|---|
<iterate>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <iterate-map>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <loop>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <while>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Contains a block of code to be executed when a condition evaluates to false.| Code Block |
|---|
| <if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | |
|
|
| Section |
|---|
| Column |
|---|
Compares a field to a constant value.
Attributes
field | optional | The name of the field to test | |
operator | optional | The comparison operator | |
value | optional | A constant value | |
type | optional | The Java data type of field | Defaults to "String" |
format | optional | Object type conversion format | |
map-name | optional | The name of the map containing field | |
| Info |
|---|
|
- Currently, the field and operator attributes are optional. Require the field and operator attributes.
- Eliminate the map-name attribute.
|
| Section |
|---|
| Column |
|---|
Compares a field to another field.Attributes
field | optional | The name of the field to test (the l-value) | | operator | optional | The comparison operator | | to-field | optional | The name of the field to test (the r-value) | Defaults to field | type | optional | The Java data type of field | Defaults to "String" | format | optional | Object type conversion format | | map-name | optional | The name of the map containing field | | to-map-name | optional | The name of the map containing to-field | |
| Info |
|---|
| | Currently, the field, operator, and to-field attributes are optional. Require the field, operator and to-field attributes.Eliminate the map-name and to-map-name attributes.
|
| Section |
|---|
| Column |
|---|
Contains blocks a condition and a block of code that are executed based on the size of a collection.Attributes
field | optional | The name of the field to test | map-name | optional | The name of the map containing field |
Child Elements
| Info |
|---|
| - Currently, the field attribute is optional. Require the field attribute.
- Eliminate the map-name attribute.
|
|
|
| Section |
|---|
| Column |
|---|
|
<if-has-permission>
|
| Column |
|---|
Contains blocks of code that are executed based on the user's permissions.
Attributes
permission | optional | The permission to check | |
action | optional | The action to be performed (permission scope) | |
Child Elements
| Info |
|---|
|
- Currently, the permission and action attributes are optional. Require the permission and action attributes.
|
to be evaluated/executed when a parent condition evaluates to false.If the condition of the parent element evaluates to false, then this element's condition will be evaluated, and if that condition evaluates to true, then the operations under the then element will be run. | Code Block |
|---|
| <if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else-if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="CYM" />
<or>
<if-compare field="color" operator="equals" value="cyan" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="magenta" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
</else-if>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
Child ElementsThe following child elements are required: Name | |
|---|
<condition>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <then>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Contains blocks of code that are executed based on a field's class.
Attributes
field | optional | The name of the field to test |
class | optional | The name of the class |
map-name | optional | The name of the map containing field |
Child Elements
| Info |
|---|
|
- Deprecate and replace with scriptlet.
|
| Section |
|---|
| Column |
|---|
Contains blocks of code that are executed based on the size of a collection.
Attributes
field | optional | The name of the field to test |
map-name | optional | The name of the map containing field |
Child Elements
| Info |
|---|
|
- Currently, the field attribute is optional. Require the field attribute.
- Eliminate the map-name attribute.
|
| Section |
|---|
| Column |
|---|
Contains blocks of code that are executed based on matching a regular expression to a field.
Attributes
field | optional | The name of the field to test |
expr | optional | The regular expression to match |
map-name | optional | The name of the map containing field |
Child Elements
| Info |
|---|
|
- Currently, the field and expr attributes are optional. Require the field and expr attributes.
- Eliminate the map-name attribute.
|
| Section |
|---|
| Column |
|---|
| <if-validate-method>
|
| Column |
|---|
Invokes a Java class method that returns a boolean value. Blocks of code are executed based on the boolean value.Attributes
field | optional | The name of the field to use as a method argument | class | optional | The name of the Java class | method | optional | The name of the class method | map-name | optional | The name of the map containing field |
Child Elements
| Info |
|---|
| | Deprecate and replace with simple method call.
|
| Section |
|---|
| Column |
|---|
Contains a block of code that is executed once for each entry in a specified collection.Attributes
list | optional | The name of the field containing the collection to iterate | entry | optional | The name of the field that will contain the collection entry |
| Info |
|---|
| - Currently, both attributes are optional. Require both attributes.
|
|
| Section |
|---|
| Column |
|---|
Contains a block of code that is executed once for each entry in a MapEntry set.
Attributes
map | optional | The name of the field containing the Map |
key | optional | The name of the field that will contain the MapEntry key |
value | optional | The name of the field that will contain the MapEntry value |
| Info |
|---|
|
- Currently, all attributes are optional. Require the map attribute and one of the key or value attributes.
|
| Section |
|---|
| Column |
|---|
Contains a block of code that is executed repeatedly until a maximum count is reached.
Attributes
field | optional | The name of the field containing the current count value | |
count | optional | A maximum count expression | Defaults to "0" (zero) |
| Info |
|---|
|
- Currently, all attributes are optional. Require all attributes.
|
| Section |
|---|
| Column |
|---|
Inverts a conditional element using a boolean NOT. |
|
This operation specifies combinations of conditions, alternate conditions, and operations to run based on the evaluation of condition expressions. | Code Block |
|---|
| <if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
|
|
|
| Section |
|---|
| Column |
|---|
Combines conditional elements using a boolean OR.| Code Block |
|---|
| xml | xml |
<if>
<condition>
<and>
<if-compare<set field="colorModelisPrimaryColor" operatorvalue="equalstrue" valuetype="RYBBoolean" />
</then>
<or><else-if>
<condition>
<if-compare field="color" operator="equals" value="red" /> <and>
<if-compare field="colorcolorModel" operator="equals" value="yellowCYM" />
<or>
<if-compare field="color" operator="equals" value="cyan" />
<if-compare field="color" operator="equals" value="blueyellow" />
<if-compare field="color" operator="equals" value="magenta" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
|
|
| Section |
|---|
| Column |
|---|
Returns control (execution) to the calling process.
Attributes
response-code | optional | A response code to return to the calling process |
| Section |
|---|
| Column |
|---|
Contains a block of code to be executed when a <condition> element evaluates to true.
| Code Block |
|---|
xml | xml |
<if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
| Section |
|---|
| Column |
|---|
Contains a block of code that is executed repeatedly while a <condition> element evaluates to true.
Child Elements
<condition> | optional |
<then> | optional |
| Info |
|---|
|
- Currently, the
<condition> and <then> child elements are optional. Require the <condition> and <then> child elements.
|
| Section |
|---|
| Column |
|---|
Combines conditional elements using a boolean XOR. |
|
Call Operations
| Section |
|---|
| Column |
|---|
Executes a BSH script.| Info |
|---|
| - Deprecate and replace with
<script>.
|
|
|
| Section |
|---|
| Column |
|---|
| <call-class-method>
|
| Column |
|---|
Calls a Java class method using the given fields as parameters.| Info |
|---|
| - Deprecate and replace with
<script>.
|
|
|
...
| Column |
|---|
|
<call-map-processor>
|
...
Invokes a Map processing element.
Attributes
xml-resource | optional | The location of the Map processor file |
processor-name | optional | The name of the Map processor element |
in-map-name | optional | The name of the field that contains the Map to be processed |
out-map-name | optional | The name of the field that will receive the processed Map |
error-list-name | optional | The name of the field that will contain a list of error messages generated by the processor |
Child Elements
<simple-map-processor> | optional |
| Info |
|---|
|
- Deprecate and replace with a
<call-simple-method> element.
|
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
</else-if>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
Child ElementsName | Requirements | |
|---|
<condition>
| required | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <then>
| required | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <else-if>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <else>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Compares a field to a constant value.There are two versions of this element - one that contains sub-elements and can be used by itself, and another that does not contain sub-elements and is a sub-element of the <condition> element. The stand-alone version will execute its contained block of code if the condition evaluates to true, otherwise it will execute the block of code in its <else> sub-element (if one exists). AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field that will be compared. The l-value. | | operator | constant | required | The comparison operator. The operator describes the l-value compared to the r-value. | Valid values are: "equals", "not-equals", "less", "less-equals", "greater", "greater-equals", "contains", "is-null", "is-not-null", "is-empty".
The "contains" operator returns true if the l-value contains the r-value. That operator does not perform type conversions. The l-value must be a collection type or a String. A null l-value evaluates to false.
The "is-null", "is-not-null", and "is-empty" operators do not require an r-value. Any r-values will be ignored. | value | constant+expr | ignored when operator attribute equals "is-null", "is-not-null", or "is-empty" - required otherwise | The value that the field will be compared to. The r-value. | | type | constant | optional | The Java data type. Both values will be converted to this type before comparison. | Attribute must contain a valid Java class name. Invalid when the operator attribute value equals "contains". | format | constant, ${expression} | optional | Format used for type conversions. | Valid only when the type attribute is not empty. |
Child Elements (stand-alone version only)Name | Requirements | |
|---|
(Any block of code) | optional | | <else>
| optional | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Compares a field to another field.There are two versions of this element - one that contains sub-elements and can be used by itself, and another that does not contain sub-elements and is a sub-element of the <condition> element. The stand-alone version will execute its contained block of code if the condition evaluates to true, otherwise it will execute the block of code in its <else> sub-element (if one exists). AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field that will be compared. The l-value. | | operator | constant | required | The comparison operator. The operator describes the l-value compared to the r-value. | Valid values are: "equals", "not-equals", "less", "less-equals", "greater", "greater-equals", "contains".
The "contains" operator returns true if the l-value contains the r-value. That operator does not perform type conversions. The l-value must be a collection type or a String. A null l-value evaluates to false. | to-field | expression | required | The name of the field that field will be compared to. The r-value. | | type | constant | optional | The Java data type. Both values will be converted to this type before comparison. | Attribute must contain a valid Java class name. Invalid when the operator attribute value equals "contains". | format | constant, ${expression} | optional | Format used for type conversions. | Valid only when the type attribute is not empty. |
Child Elements (stand-alone version only)Name | Requirements | |
|---|
(Any block of code) | optional | | <else>
| optional | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Tests if a field is null or empty.There are two versions of this element - one that contains sub-elements and can be used by itself, and another that does not contain sub-elements and is a sub-element of the <condition> element. The stand-alone version will execute its contained block of code if the condition evaluates to true, otherwise it will execute the block of code in its <else> sub-element (if one exists). Name | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to test. | Object to test must be a collection, string, or a class that implements org.ofbiz.base.lang.IsEmpty. |
Child Elements (stand-alone version only)Name | Requirements | |
|---|
(Any block of code) | optional | | <else>
| optional | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
| <if-has-permission>
|
| Column |
|---|
Tests if the current user has the specified permission.There are two versions of this element - one that contains sub-elements and can be used by itself, and another that does not contain sub-elements and is a sub-element of the <condition> element. The stand-alone version will execute its contained block of code if the condition evaluates to true, otherwise it will execute the block of code in its <else> sub-element (if one exists). AttributesName | Type | Requirements | Description | Note |
|---|
permission | constant, ${expression} | required | The permission to check. | | action | constant, ${expression} | optional | The action to be performed (permission scope). | Examples: "_ADMIN", "_CREATE", "_UPDATE". |
Child Elements (stand-alone version only)Name | Requirements | |
|---|
(Any block of code) | optional | | <else>
| optional | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Tests if a field is an instance of a Java class.The operation will execute its contained block of code if the condition evaluates to true, otherwise it will execute the block of code in its <else> sub-element (if one exists). AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to test. | Test evaluates to false if the field does not exist. | class | constant | required | The name of the class to test for. | Attribute must contain a valid Java class name. |
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | | <else>
| optional | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Tests if a field is not null and not empty.The operation will execute its contained block of code if the condition evaluates to true, otherwise it will execute the block of code in its <else> sub-element (if one exists). AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to test. | Object to test must be a collection, string, or a class that implements org.ofbiz.base.lang.IsEmpty. |
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | | <else>
| optional | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Tests if a field matches a regular expression.There are two versions of this element - one that contains sub-elements and can be used by itself, and another that does not contain sub-elements and is a sub-element of the <condition> element. The stand-alone version will execute its contained block of code if the condition evaluates to true, otherwise it will execute the block of code in its <else> sub-element (if one exists). AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to test. | The field object will be converted to a string before the test. An empty string will be used if the field object is not found. | expr | constant, ${expression} | required | The regular expression to test for. | |
Child Elements (stand-alone version only)Name | Requirements | |
|---|
(Any block of code) | optional | | <else>
| optional | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
| <if-validate-method>
|
| Column |
|---|
Invokes a Java class static method that returns a boolean value.There are two versions of this element - one that contains sub-elements and can be used by itself, and another that does not contain sub-elements and is a sub-element of the <condition> element. The stand-alone version will execute its contained block of code if the static method returns true, otherwise it will execute the block of code in its <else> sub-element (if one exists). AttributesName | Type | Requirements | Description | Note |
|---|
field | expression | required | The name of the field to use as the method argument. | The field object will be converted to a string before the method call. An empty string will be used if the field object is not found. | method | constant | required | The name of the static method that will be called to validate the field. | Must be a static method that takes a single java.lang.String parameter and return a boolean. | class | constant | optional | The name of the Java class that contains the validation method. | Defaults to "org.ofbiz.base.util.UtilValidate". |
Child Elements (stand-alone version only)Name | Requirements | |
|---|
(Any block of code) | optional | | <else>
| optional | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Contains a block of code that is executed once for each entry in a collection.AttributesName | Type | Requirements | Description | Note |
|---|
list | expression | required | The name of the field that contains the collection to iterate over. | The operation does nothing if the field is not found. | entry | expression | required | The name of the field that will contain the current collection entry. | |
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | |
|
|
| Section |
|---|
| Column |
|---|
Contains a block of code that is executed once for each entry in a map.AttributesName | Type | Requirements | Description | Note |
|---|
map | expression | required | The name of the field that contains the map to iterate over. | The operation does nothing if the field is not found. | key | expression | required | The name of the field that will contain the current map entry key. | | value | expression | required | The name of the field that will contain the current map entry value. | |
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | |
|
|
| Section |
|---|
| Column |
|---|
Contains a block of code that is executed repeatedly until a maximum count is reached.AttributesName | Type | Requirements | Description | Note |
|---|
count | constant, ${expression} | required | A maximum count expression. | Must evaluate to a positive integer. Defaults to "0" (zero) | field | expression | optional | The name of the field that will contain the current count value. | |
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | |
|
|
| Section |
|---|
| Column |
|---|
Inverts a conditional element using a boolean NOT.Evaluates to true if the sub-element evaluates to false. Child ElementsOne of the following child elements is required: Name | |
|---|
<and>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-validate-method>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare-field>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-regexp>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-empty>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-has-permission>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <or>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <not>
| | <xor>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Combines conditional elements using a boolean OR.Evaluates to true if any sub-element evaluates to true. | Code Block |
|---|
| <if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
Child ElementsOne or more of the following child elements is required: Name | |
|---|
<and>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-validate-method>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare-field>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-regexp>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-empty>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-has-permission>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <or>
| | <not>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <xor>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Returns control (execution) to the calling process.AttributesName | Type | Requirements | Description | Note |
|---|
response-code | constant, ${expression} | optional | A response code to return to the calling process. | Defaults to the value of the containing <simple-method> element "default-success-code" attribute. |
|
|
| Section |
|---|
| Column |
|---|
Contains a block of code to be executed when a <condition> element evaluates to true.| Code Block |
|---|
| <if>
<condition>
<and>
<if-compare field="colorModel" operator="equals" value="RYB" />
<or>
<if-compare field="color" operator="equals" value="red" />
<if-compare field="color" operator="equals" value="yellow" />
<if-compare field="color" operator="equals" value="blue" />
</or>
</and>
</condition>
<then>
<set field="isPrimaryColor" value="true" type="Boolean" />
</then>
<else>
<set field="isPrimaryColor" value="false" type="Boolean" />
</else>
</if>
|
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | |
|
|
| Section |
|---|
| Column |
|---|
Contains a block of code that is executed repeatedly while a <condition> element evaluates to true.Child ElementsThe following child elements are required: Name | |
|---|
<condition>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <then>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Combines conditional elements using a boolean XOR.Evaluates to true if only one sub-element evaluates to true. Child ElementsOne or more of the following child elements is required: Name | |
|---|
<and>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-validate-method>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-compare-field>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-regexp>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-empty>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <if-has-permission>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <or>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <not>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <xor>
| |
|
|
Call Operations
Operations that transfer control to another process. Note that some of these operations behave like assignment operators - since they modify the script's state, but they are listed separately for clarity.
| Section |
|---|
| Column |
|---|
Executes a BSH script.The script can be contained in a Java resource, and/or a short script can be included in the element body.
If a Java resource is specified, and the element body contains a script, the element body script will be executed after the Java resource script is executed. AttributesName | Type | Requirements | Description | Note |
|---|
resource | constant | required if the element body is empty | A Java resource that contains the script. | |
| Warning |
|---|
Deprecated - use the <script> element. |
|
|
| Section |
|---|
| Column |
|---|
| <call-class-method>
|
| Column |
|---|
Calls a Java class method using the given fields as parameters.The <string> and <field> sub-elements are passed to the method as arguments in the order they are specified. If the method returns a value, the value will be put in the named field. AttributesName | Type | Requirements | Description | Note |
|---|
class-name | constant | required | The name of the class containing the static method. | | method-name | constant | required | The name of the static method to call. | | ret-field | expression | optional | The name of the field to put the method return value in. | |
Child ElementsOne or more of the following child elements is optional: Name | |
|---|
<string>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <field>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
| Warning |
|---|
Deprecated - use the <script> element. |
|
|
| Section |
|---|
| Column |
|---|
| <call-map-processor>
|
| Column |
|---|
Invokes a <simple-map-processor> element.The map processor can be contained in another file, and/or a <simple-map-processor> element can be included in the element body.
If an XML resource is specified, and the element body contains a <simple-map-processor> element, the contained map processor will be executed after the external map processor is executed. AttributesName | Type | Requirements | Description | Note |
|---|
in-map-name | expression | required | The name of the field that contains the map to be processed. | If the map does not exist, one will be created. | out-map-name | expression | required | The name of the field that will receive the processed map. | If the map does not exist, one will be created. | xml-resource | constant | optional | The location of the map processor file. | | processor-name | constant | optional | The name of the <simple-map-processor> element. | | error-list-name | expression | optional | The name of the field that will contain a list of error messages generated by the processor. | Defaults to "error_list". |
Child ElementsThe following child element is optional: Name | |
|---|
<simple-map-processor>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
| <call-object-method>
|
| Column |
|---|
Calls a method on an existing Java object.The <string> and <field> sub-elements are passed to the method as arguments in the order they are specified. If the method returns a value, the value will be put in the named field. AttributesName | Type | Requirements | Description | Note |
|---|
obj-field | expression | required | The name of the field containing the object to be called. | A runtime exception is thrown if the object is not found. | method-name | constant | required | The name of the method to call. | | ret-field | expression | optional | The name of the field to put the method return value in. | |
Child ElementsOne or more of the following child elements is optional: Name | |
|---|
<string>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <field>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
| Warning |
|---|
Deprecated - use the <script> element. |
|
|
| Section |
|---|
| Column |
|---|
Invokes a service through the Service Engine.AttributesName | Type | Requirements | Description | Note |
|---|
service-name | constant, ${expression} | required | The name of the service to invoke. | | in-map-name | expression | optional | The name of a field containing a map that will be used for the service's IN parameters. | | include-user-login | constant | optional | Include the current UserLogin entity value in the called service IN parameters. | Defaults to "true". | break-on-error | constant | optional | Halt script execution if the called service returns an error. | Defaults to "true". | error-code | constant | optional | The error code returned by the called service. | Defaults to the enclosing <simple-method> "default-error-code" attribute value. | success-code | constant | optional | The success code returned by the called service. | Defaults to the enclosing <simple-method> "default-success-code" attribute value. | require-new-transaction | constant | optional | Require a new transaction for the called service. | Defaults to "false". | transaction-timeout | constant | optional | The timeout for the new transaction, in seconds. | Defaults to the value set in the called service's definition. |
Child ElementsName | Requirements | |
|---|
<results-to-map>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <result-to-field>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <result-to-request>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <result-to-session>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <result-to-result>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <error-prefix>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <error-suffix>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <success-prefix>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <success-suffix>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <message-prefix>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <message-suffix>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <default-message>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
| <call-service-asynch>
|
| Column |
|---|
Invokes an OFBiz service asynchronously.AttributesName | Type | Requirements | Description | Note |
|---|
service-name | constant, ${expression} | required | The name of the service to invoke. | | in-map-name | expression | optional | The name of a field containing a map that will be used for the service's IN parameters. | | include-user-login | constant | optional | Include the current UserLogin entity value in the called service IN parameters. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
| <call-simple-method>
|
| Column |
|---|
Invokes a Mini-language simple method.AttributesName | Type | Requirements | Description | Notes |
|---|
method-name | constant | required | The name of the <simple-method> element. | | xml-resource | constant | optional | The location of the <simple-method> file. | Defaults to current file. | scope | constant | optional | The memory scope to use: "inline" or "function". | When set to "inline", existing variables can be modified by the called script. When set to "function", existing variables are protected from modification, and the called script returns values via the <field-to-result> element. Defaults to "inline". |
Child ElementsName | Requirements | |
|---|
<result-to-field>
| optional (one or more), used when scope="function" | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Declares a message to be used when the called service does not return a message.The message can be included in the element body or in a Java resource. AttributesName | Type | Requirements | Description | Notes |
|---|
resource | constant | optional | The name of a properties file on the classpath. | | property | constant | optional | The property key. | |
|
|
| Section |
|---|
| Column |
|---|
Declares a message to prepend to the error message.The message can be included in the element body or in a Java resource. AttributesName | Type | Requirements | Description | Notes |
|---|
resource | constant | optional | The name of a properties file on the classpath. | | property | constant | optional | The property key. | |
|
|
| Section |
|---|
| Column |
|---|
Declares a message to append to the error message.The message can be included in the element body or in a Java resource. AttributesName | Type | Requirements | Description | Notes |
|---|
resource | constant | optional | The name of a properties file on the classpath. | | property | constant | optional | The property key. | |
|
|
| Section |
|---|
| Column |
|---|
Declares a message to prepend to any kind of message.The message can be included in the element body or in a Java resource. AttributesName | Type | Requirements | Description | Notes |
|---|
resource | constant | optional | The name of a properties file on the classpath. | | property | constant | optional | The property key. | |
|
|
| Section |
|---|
| Column |
|---|
Declares a message to append to any kind of message.The message can be included in the element body or in a Java resource. AttributesName | Type | Requirements | Description | Notes |
|---|
resource | constant | optional | The name of a properties file on the classpath. | | property | constant | optional | The property key. | |
|
|
| Section |
|---|
| Column |
|---|
Copies the called service's result map to the specified field.AttributesName | Type | Requirements | Description | Notes |
|---|
map-name | expression | required | The name of the target field. | |
|
|
| Section |
|---|
| Column |
|---|
Copies the called service's OUT attribute to the specified field.AttributesName | Type | Requirements | Description | Notes |
|---|
result-name | expression | required | The name of the called service's OUT attribute. | | field | expression | optional | The name of target field. | Defaults to the result-name attribute value. |
|
|
| Section |
|---|
| Column |
|---|
| <result-to-request>
|
| Column |
|---|
Copies the called service's OUT attribute to the specified request attribute.Valid only when the script is run in an event. AttributesName | Type | Requirements | Description | Notes |
|---|
result-name | expression | required | The name of the called service's OUT attribute. | | request-name | expression | optional | The name of the target request attribute. | Defaults to the result-name attribute value. |
|
|
| Section |
|---|
| Column |
|---|
| <result-to-session>
|
| Column |
|---|
Copies the called service's OUT attribute to the specified session attribute.Valid only when the script is run in an event. AttributesName | Type | Requirements | Description | Notes |
|---|
result-name | expression | required | The name of the called service's OUT attribute. | | session-name | expression | optional | The name of the target session attribute. | Defaults to the result-name attribute value. |
|
|
| Section |
|---|
| Column |
|---|
Copies service OUT attributes from a called service to the calling service's OUT attributes.This element can also be used to copy the called service OUT attributes to the return result of a simple-method called as a function. AttributesName | Type | Requirements | Description | Notes |
|---|
result-name | expression | required | The name of the called service's OUT attribute. | | service-result-name | expression | optional | The name of the calling service's OUT attribute (or function return result). | Defaults to the result-name attribute value. |
|
|
| Section |
|---|
| Column |
|---|
Executes a script.The script can be contained in a Java resource, and/or a short inline script can be included in the element body or in the script attribute.
If a Java resource is specified in addition to an inline script, the inline script will be executed after the Java resource script is executed. AttributesName | Type | Requirements | Description | Notes |
|---|
location | constant | required if script is empty | The location of the script file. | Script functions/methods can be invoked by appending a hash (#) and the function/method name. | script | script | required if location and element body are empty | A short script (scriptlet). Can be used instead of a file. | |
|
|
| Section |
|---|
| Column |
|---|
Declares a message to prepend to the success message.The message can be included in the element body or in a Java resource. AttributesName | Type | Requirements | Description | Notes |
|---|
resource | constant | optional | The name of a properties file on the classpath. | | property | constant | optional | The property key. | |
|
|
| Section |
|---|
| Column |
|---|
Declares a message to append to the success message.The message can be included in the element body or in a Java resource. AttributesName | Type | Requirements | Description | Notes |
|---|
resource | constant | optional | The name of a properties file on the classpath. | | property | constant | optional | The property key. | |
|
|
Entity Operations
Operations that interact with a data source. Note that many of these operations behave like assignment operators - since they modify the script's state, but they are listed separately for clarity.
| Section |
|---|
| Column |
|---|
Clears entity values from the cache.| Code Block |
|---|
| <clear-cache-line entity-name="Party" />
|
AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | required | The name of the entity. | | map | expression | optional | The name of a field containing a map that will be used to find matching entity values. | If the fields in the map form the full primary key the entry will be removed from the byPrimaryKey cache. If the map exists but the fields do not include a full primary key the entry will be removed from the byAnd cache. If no map name is specified the entry will be removed from the all caches. |
|
|
| Section |
|---|
| Column |
|---|
| <clear-entity-caches>
|
| Column |
|---|
Removes all entity values from the cache.This element should be used sparingly because of the performance impact. |
|
| Section |
|---|
| Column |
|---|
Creates a copy of an entity value.AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field that contains the entity value to be copied. | The operation does nothing if the entity value is not found. | new-value-field | expression | required | The name of the field that will contain the new entity value. | |
|
|
| Section |
|---|
| Column |
|---|
Uses an SQL operator to compare an entity field to a variable or constant value.AttributesName | Type | Requirements | Description | Notes |
|---|
field-name | constant | required | The name of the entity field that will be compared. The l-value. | | operator | constant | required | The SQL operator. | If set to "between" then the r-value must be a collection that has two entries in it. If set to "in" or "not-in" then the r-value must be a collection. Defaults to "equals". | from-field | expression | required if the value attribute is empty | The name of an environment field that the entity field will be compared to. The r-value. | | value | constant, ${expression} | required if the from-field attribute is empty | A constant value that the entity field will be compared to. The r-value. | | ignore-if-null | constant | optional | Ignore the condition if the r-value is null. | Defaults to "false". | ignore-if-empty | constant | optional | Ignore the condition if the r-value is empty. | Defaults to "false". | ignore-case | constant | optional | Perform a case-insensitive comparison. | Defaults to "false". | ignore | constant, ${expression} | optional | Ignore the condition if the r-value evaluates to "true". | Defaults to "false". |
|
|
| Section |
|---|
| Column |
|---|
Uses an SQL operator to combine entity find conditions into a single expression.AttributesName | Type | Requirements | Description | Notes |
|---|
combine | constant | required | The SQL operator. | Defaults to "and". |
Child ElementsOne or more of the following child elements is required: Name | |
|---|
<condition-expr>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <condition-list>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <condition-object>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Declares an environment field (variable) that contains an entity find condition expression object.AttributesName | Type | Requirements | Description | Notes |
|---|
field | expression | required | The name of the field that contains an entity find condition expression object | |
|
|
| Section |
|---|
| Column |
|---|
Creates a new entity value in the data source.AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field that contains the entity value to be created. | The operation generates an error and halts script execution if the entity value is not found. | do-cache-clear | constant | optional | Clear the cache. | Defaults to "true". | or-store | constant | optional | Store the entity value if it already exists. | Defaults to "false". If set to "false", an error will result if an instance of the entity value exists in the data source with the same primary key. |
|
|
| Section |
|---|
| Column |
|---|
Finds a group of entity values by using a set of entity field name/value pairs that are ANDed together.The name/value pairs used for the search are defined in child elements. AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | required | The name of the entity to search in. | A runtime exception will be thrown if the entity does not exist. | list | expression | required | The name of the field that will contain the result list. | | filter-by-date | constant, ${expression} | optional | Filter the result list by the current date. | The entity must have "fromDate" and "thruDate" fields. Defaults to "false". | distinct | constant, ${expression} | optional | Filter the results so that all of them are unique. | Defaults to "false". | use-cache | constant, ${expression} | optional | Use the entity cache. | Defaults to "false". | delegator-name | constant, ${expression} | optional | Overrides the current delegator by specifying a delegator name. | |
Child ElementsName | Requirements | |
|---|
<field-map>
| required (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <select-field>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <order-by>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <limit-range>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <limit-view>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <use-iterator>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Finds a group of entity values by using a condition expression.AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | required | The name of the entity to search in. | A runtime exception will be thrown if the entity does not exist. | list | expression | required | The name of the field that will contain the result list. | | filter-by-date | constant, ${expression} | optional | Filter the result list by the current date. | The entity must have "fromDate" and "thruDate" fields. Defaults to "false". | distinct | constant, ${expression} | optional | Filter the results so that all of them are unique. | Defaults to "false". | use-cache | constant, ${expression} | optional | Use the entity cache. | Defaults to "false". | delegator-name | constant, ${expression} | optional | Overrides the current delegator by specifying a delegator name. | |
Child ElementsOne of the following child elements is required: Name | |
|---|
<condition-expr>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <condition-list>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <condition-object>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
The following child elements are optional: Name | Requirements | |
|---|
<having-condition-list>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <select-field>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <order-by>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <limit-range>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <limit-view>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <use-iterator>
| optional (only one) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Counts a group of entity values that match a condition expression.AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | required | The name of the entity to count in. | A runtime exception will be thrown if the entity does not exist. | count-field | expression | required | Name of the field that will contain the count result. | | delegator-name | constant, ${expression} | optional | Overrides the current delegator by specifying a delegator name. | |
Child ElementsOne of the following child elements is required: Name | |
|---|
<condition-expr>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <condition-list>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <condition-object>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
The following child element is optional: Name | |
|---|
<having-condition-list>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Load or assert an entity data XML file.The operation can be used in two modes: "load" or "assert". The "load" mode will load the XML entity data into the data source. The "assert" mode will compare the XML entity data with the data source - any mismatched or missing data will be logged in the error message list. AttributesName | Type | Requirements | Description | Notes |
|---|
location | constant, ${expression} | required | The location of an XML file to load in data source mode or to verify in assert mode. | A message will be added to the error message list if the file is not found. | mode | constant | optional | Operation mode: "load" or "assert". | Defaults to "load". | timeout | constant | optional | Override the current transaction to start a new transaction and load the data with a different timeout. | Valid only when mode="load". | error-list-name | constant, ${expression} | optional | The name of the error message list. | Defaults to "error_list". It will be created if it does not exist. | delegator-name | constant, ${expression} | optional | Overrides the current delegator by specifying a delegator name. | |
|
|
| Section |
|---|
| Column |
|---|
Finds a single entity value by using the primary key.The primary key can be specified in the <field-map> child elements, or if they are absent, the primary key will be constructed from matching environment fields. AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | required | The name of the entity to search in. | A runtime exception will be thrown if the entity does not exist. | value-field | expression | required | The name of the field that will contain the entity value. | | use-cache | constant, ${expression} | optional | Use the entity cache. | Defaults to "false". | auto-field-map | constant, ${expression} | optional | Look for all primary key field names in the current context as well as in the parameters map. | Defaults to "true". |
Child ElementsName | Requirements | |
|---|
<field-map>
| optional(one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <select-field>
| optional (one or more) | (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Declares an entity field name/value pair.AttributesName | Type | Requirements | Description | Note |
|---|
field-name | expression | required | The name of the entity field. | Defaults to from-field attribute value. | from-field | expression | required if the value attribute is empty. | The name of an environment field that contains the entity field value. | | value | constant+expr | required if the from-field attribute is empty. | A constant entity field value. | |
|
|
| Section |
|---|
| Column |
|---|
| <filter-list-by-and>
|
| Column |
|---|
Filters a list of entity values by the fields in the specified map.Each entity value in the list will be compared to the specified map, and if the entity value's fields match the map, the entity value will be copied to the target list. AttributesName | Type | Requirements | Description | Note |
|---|
list | expression | required | The name of the field that contains the list of entity values. | | map | expression | required | The name of the field that contains the map that will be used for the entity field comparison. | | to-list | expression | optional | The name of the field the filtered list will be put into. | Defaults to the value of the list attribute (operation replaces the old list). |
|
|
| Section |
|---|
| Column |
|---|
| <filter-list-by-date>
|
| Column |
|---|
Filters a list of entity values by their date-range fields.Each entity value in the list will be compared to the specified date, and if the entity value's date-range fields include the date, the entity value will be copied to the target list. AttributesName | Type | Requirements | Description | Note |
|---|
list | expression | required | The name of the field that contains the list of entity values. | | to-list | expression | optional | The name of the field the filtered list will be put into. | Defaults to the value of the list attribute (operation replaces the old list). | valid-date | expression | optional | The name of a field that contains the date object to filter by. | The date object must be a java.sql.Timestamp data type. Defaults to now. | from-field-name | constant | optional | The name of the entity field to use as the beginning date. | Defaults to "fromDate". | thru-field-name | constant | optional | The name of the entity field to use as the ending date. | Defaults to "thruDate". |
|
|
| Section |
|---|
| Column |
|---|
Finds a group of entity values by using a set of entity field name/value pairs that are ANDed together.The name/value pairs used for the search are contained in a map. AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | required | The name of the entity to search in. | A runtime exception will be thrown if the entity does not exist. | list | expression | required | The name of the field that will contain the result list. | | map | expression | required | The name of the field containing a map that will be used for the search. | The map name/value pairs will be combined using a boolean AND. | order-by-list | expression | optional | The name of the field containing a list that contains field names that you want the operation to order the results by. | Each entry in the list is a field name. The field name can be preceded by a plus or a minus sign to specify an ascending or descending sort for that field. The default is ascending sort. | fields-to-select-list | expression | optional | The name of a list or set in the method environment that contains field names to select. | | use-cache | constant, ${expression} | optional | Use the entity cache. | Defaults to "false". | use-iterator | constant, ${expression} | optional | Use the EntityListIterator when doing the query. | This is much more efficient for large data sets because the results are read incrementaly instead of all at once. The EntityListIterator must be closed when you are finished, but this is done automatically by the iterate operation. Defaults to "false". | delegator-name | constant, ${expression} | optional | Overrides the current delegator by specifying a delegator name. | |
|
|
| Section |
|---|
| Column |
|---|
| <find-by-primary-key>
|
| Column |
|---|
Returns a single entity value that is retrieved from the data source by using the primary key.The primary key used for the search is contained in a map. AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | optional if the entity name comes from the primary key map | The name of the entity to search in. | If the primary key map is an entity value, then the value's entity name can be used instead of this attribute. A runtime exception will be thrown if the entity does not exist. | value-field | expression | required | The name of the field that will contain the entity value. | | map | expression | required | The name of the field containing a map that will be used for the search. | | fields-to-select-list | expression | optional | The name of a list or set in the method environment that contains field names to select. | | use-cache | constant, ${expression} | optional | Use the entity cache. | Defaults to "false". | delegator-name | constant, ${expression} | optional | Overrides the current delegator by specifying a delegator name. | |
|
|
| Section |
|---|
| Column |
|---|
AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. | relation-name | constant, ${expression} | required | The name of the entity value relation to use. | Script execution will halt if the relation does not exist. | list | expression | required | The name of the field that will contain the result list. | | map | expression | required | The name of the field containing a map that will be used for the search. | The map name/value pairs will be combined using a boolean AND. All entity values will be found if this attribute is empty. | order-by-list | expression | optional | The name of the field containing a list that contains field names that you want the operation to order the results by. | Each entry in the list is a field name. The field name can be preceded by a plus or a minus sign to specify an ascending or descending sort for that field. The default is ascending sort. | use-cache | constant, ${expression} | optional | Use the entity cache. | Defaults to "false". |
|
|
| Section |
|---|
| Column |
|---|
AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. | relation-name | constant, ${expression} | required | The name of the entity value relation to use. | Script execution will halt if the relation does not exist. | to-value-field | expression | required | The name of the field that will contain the related entity value. | | use-cache | constant, ${expression} | optional | Use the entity cache. | Defaults to "false". |
|
|
| Section |
|---|
| Column |
|---|
| <having-condition-list>
|
| Column |
|---|
A list of conditions that are combined with a boolean AND or OR that are applied to an entity value group.This element implements the SQL HAVING clause. AttributesName | Type | Requirements | Description | Notes |
|---|
combine | constant, ${expression} | optional | The boolean operator used to combine conditions. | Defaults to "and". |
Child ElementsOne of the following child elements is required: Name | |
|---|
<condition-expr>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <condition-list>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <condition-object>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
|
|
| Section |
|---|
| Column |
|---|
Constrains an entity find result by specifying a starting index and the number of results to include.AttributesName | Type | Requirements | Description | Notes |
|---|
start | constant, ${expression} | required | A zero-based starting index. | The attribute value must resolve to a non-negative integer. | size | constant, ${expression} | required | The number of results to include. | The attribute value must resolve to a non-negative integer. |
|
|
| Section |
|---|
| Column |
|---|
Constrains an entity find result by specifying a view index and a view size.Example: view-index="3" and view-size="10" returns results 21 to 30. AttributesName | Type | Requirements | Description | Notes |
|---|
view-index | constant, ${expression} | required | A one-based view index. | The attribute value must resolve to a non-negative integer. | size | constant, ${expression} | required | The number of results to view. | The attribute value must resolve to a non-negative integer. |
|
|
| Section |
|---|
| Column |
|---|
Generates a sequence string and uses it to update an entity value field.The sequence string is generated by scanning all similar values in the entity and adding an increment amount to the highest sequence value found. AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. | seq-field-name | constant, ${expression} | required | The name of the entity value field that will receive the sequence string. | | numeric-padding | constant, ${expression} | optional | Left-pad the sequence string with the specified number of zeros. | Defaults to "5". | increment-by | constant, ${expression} | optional | Sequence increment amount. | Defaults to "1". |
|
|
| Section |
|---|
| Column |
|---|
Creates a new entity value.The new entity value exists only in memory - it is not persisted in the data source until it is stored. AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | required | The name of the entity. | A runtime exception will be thrown if the entity does not exist. | value-field | expression | required | The name of the field that will contain the new entity value. | | map | expression | optional | The name of the field that contains a map that is used to initialize the entity value fields. | Map values whose key matches one of the entity value fields will be copied to the corresponding entity value field. Defaults to parameters. |
|
|
| Section |
|---|
| Column |
|---|
AttributesName | Type | Requirements | Description | Notes |
|---|
list | expression | required | The name of the field that contains the list of entity values. | The target field will be set to null if the list is not found. | order-by-list | expression | required | The name of the field that contains the list of field names to sort on. | Field names can be preceded by a plus symbol  or a minus symbol  to specify an ascending or descending sort for that field. The default is ascending sort. If the order-by-list is not found the target field will be set to a copy of the source list. | to-list | expression | optional | The name of the field that will contain the sorted list. | Defaults to the field specified in the list attribute. |
|
|
| Section |
|---|
| Column |
|---|
Refresh an entity value from the data source.AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. | do-cache-clear | constant, ${expression} | optional | Clear the cache. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
Removes entity values from the data source.Uses a map of name/value pairs that will be combined using a boolean AND to constrain the removal. AttributesName | Type | Requirements | Description | Notes |
|---|
entity-name | constant, ${expression} | required | The name of the entity to search in. | A runtime exception will be thrown if the entity does not exist. | map | expression | required | The name of the field containing a map that will be used for the constraint. | The map name/value pairs will be combined using a boolean AND. If the map is missing or empty, then all entity values will be removed. | do-cache-clear | constant, ${expression} | optional | Clear the cache. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
Removes from the data source all entity values in a list.If an entity value in the list is a complete primary key, then just that entity value will be removed from the data source.
If an entity value in the list is not a complete primary key, then all matching entity values will be removed from the data source. AttributesName | Type | Requirements | Description | Notes |
|---|
list | expression | required | The name of the field that contains the list of entity values. | A runtime exception will be thrown if the list does not exist. | do-cache-clear | constant, ${expression} | optional | Clear the cache. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
For a one-to-one relationship it will remove a single entity value if it exists, and for a one-to-many relationship it will remove all related entity values. AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. | relation-name | constant, ${expression} | required | The name of the entity value relation to use. | Script execution will halt if the relation does not exist. | do-cache-clear | constant, ${expression} | optional | Clear the cache. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
Removes an entity value from the data source.AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. | do-cache-clear | constant, ${expression} | optional | Clear the cache. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
Declares an entity field to include in the entity operation.AttributesName | Type | Requirements | Description | Notes |
|---|
field-name | constant, ${expression} | required | The entity field name. | |
|
|
| Section |
|---|
| Column |
|---|
Generates a unique numeric sequence value.Sequence values are unique per sequence name. AttributesName | Type | Requirements | Description | Notes |
|---|
sequence-name | constant, ${expression} | required | The sequence name. | In most cases, this is the name of the entity the sequence value will be used in, but any name can be used. | field | expression | required | The name of the field to set, the target of the assignment. | | stagger-max | constant | optional | Sequence stagger maximum. | If set to "1" the sequence value will be incremented by 1, otherwise the sequence value will be incremented by an amount between 1 and the stagger maximum. Defaults to "1". | get-long-only | constant | optional | Preserve the sequence type - a numeric long. | If set to "false" the sequence value will be converted to a string. Defaults to "false". |
|
|
| Section |
|---|
| Column |
|---|
Copies non-PK fields from a map to an entity value.AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. | map | expression | required | The name of the field that contains a map that is used to initialize the entity value non-pk fields. | Map values whose key matches one of the entity value fields will be copied to the entity value. A runtime exception will be thrown if the map does not exist. | set-if-null | constant, ${expression} | optional | Set entity value fields that are null or empty. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
Copies PK fields from a map to an entity value.AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. | map | expression | required | The name of the field that contains a map that is used to initialize the entity value pk fields. | Map values whose key matches one of the entity value fields will be copied to the entity value. A runtime exception will be thrown if the map does not exist. | set-if-null | constant, ${expression} | optional | Set entity value fields that are null or empty. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
Stores in the data source all entity values in a list.Entity values that do not exist in the data source will be added to the data source. AttributesName | Type | Requirements | Description | Notes |
|---|
list | expression | required | The name of the field that contains the list of entity values. | A runtime exception will be thrown if the list does not exist. | do-cache-clear | constant, ${expression} | optional | Clear the cache. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
Stores an entity value in the data source.AttributesName | Type | Requirements | Description | Notes |
|---|
value-field | expression | required | The name of the field containing the entity value. | A runtime exception will be thrown if the entity value does not exist. Script execution will halt if the entity value does not exist in the data source. | do-cache-clear | constant, ${expression} | optional | Clear the cache. | Defaults to "true". |
|
|
| Section |
|---|
| Column |
|---|
| <transaction-begin>
|
| Column |
|---|
Begins a transaction if one is not already in place.Note that all simple-methods are executed inside a transaction unless the simple-method is flagged to not use a transaction. AttributesName | Type | Requirements | Description | Notes |
|---|
began-transaction-name | expression | optional | The name of the field that contains a Boolean value specifying whether or not a transaction was begun in the current transaction demarcation. | Defaults to "beganTransaction". |
|
|
| Section |
|---|
| Column |
|---|
| <transaction-commit>
|
| Column |
|---|
Commits a transaction that was begun with the <transaction-begin> element.Operation does nothing if no transaction was begun |
|
| Section |
|---|
| Column |
|---|
| <call-object-method>
|
| Column |
|---|
Calls a Java object method using the given fields as parameters.| Info |
|---|
| - Deprecate and replace with
<script>.
|
|
|
| Section |
|---|
| Column |
|---|
Invokes an OFBiz service.
Attributes
service-name | optional | The name of the service to invoke |
in-map-name | optional | The name of the field that contains the service IN attributes |
include-user-login | optional | If "true" the current UserLogin GenericValue is copied to the service IN attributes |
break-on-error | optional | If "true" script execution stops if the called service returns an error |
error-code | optional | |
require-new-transaction | optional | |
transaction-timeout | optional | |
success-code | optional | |
Child Elements
<error-prefix> | optional |
<error-suffix> | optional |
<success-prefix> | optional |
<success-suffix> | optional |
<message-prefix> | optional |
<message-suffix> | optional |
<default-message> | optional |
<results-to-map> | optional |
<result-to-field> | optional |
<result-to-request> | optional |
<result-to-session> | optional |
<result-to-result> | optional |
| Info |
|---|
|
- Currently, the service-name attribute is optional. Require the service-name attribute.
- Currently, the in-map-name
Map is passed directly to the service. Have the in-map-name attribute behave like the <set-service-fields> map attribute.
|
| Section |
|---|
| Column |
|---|
|
<call-service-asynch>
|
| Column |
|---|
Invokes an OFBiz service asynchronously.
Attributes
service-name | optional | The name of the service to invoke |
in-map-name | optional | The name of the field that contains the service IN attributes |
include-user-login | optional | If "true" the current UserLogin GenericValue is copied to the service IN attributes |
| Info |
|---|
|
- Deprecate and replace with
<call-service> element. Add an async attribute ("true"/"false") to the <call-service> element.
|
| Section |
|---|
| Column |
|---|
| <call-simple-method>
|
| Column |
|---|
| Invokes a Mini-language simple method . AttributesName | Type | Requirements | Description | Notes |
|---|
methodbegan-transaction-name | constantexpression | requiredoptional | The name of the <simple-method> element | | xml-resource | constant | optional | The location of the <simple-method> file | Defaults to current file | scope | constant | optional | The memory scope to use | Defaults to "inline" |
| Note |
|---|
| | field that contains a Boolean value specifying whether or not a transaction was begun in the current transaction demarcation. | Defaults to "beganTransaction" |
|
| Section |
|---|
| Column |
|---|
| <script><transaction-rollback>
|
| Column |
|---|
Executes a script.Attributes
Name | Type | Requirements | Description | Notes |
|---|
location | constant | required if script is empty | The location of the script file | Script functions/methods can be invoked by appending a hash (#) and the function/method name | script | script | required if location is empty | A short script (scriptlet). Can be used instead of a file | |
|
Entity Operations
Rolls back a transaction that was begun with the <transaction-begin> element.If no transaction was begun with the transaction-begin element, a "set rollback only" operation will be performed - which will force the transaction to rollback regardless of which method or object is responsible for beginning and ending the transaction. AttributesName | Type | Requirements | Description | Notes |
|---|
began-transaction-name | expression | optional | The name of the field that contains a Boolean value specifying whether or not a transaction was begun in the current transaction demarcation. | Defaults to "beganTransaction" |
|
|
| Section |
|---|
| Column |
|---|
Removes an entity from the cache.| Code Block |
|---|
| xml | xml |
<clear-cache-line entity-name="Party" />
| Attributes
entity-name | optional | The name of the entity to remove | map-name | optional | The name of the map that contains entity-name |
| Info |
|---|
| Currently, the entity-name attribute is optional. Require the entity-name attribute.Eliminate the map-name attribute
|
| Section |
|---|
| Column |
|---|
| <clear<use-
entity-caches>iterator>
|
| Column |
|---|
Removes all entities from the cacheUse the EntityListIterator for the entity find operation.| Code Block |
|---|
| xml | xml |
<clear-entity-caches />
|
Logging
| Section |
|---|
| Column |
|---|
Copies Outputs a field containing a GenericValue to a new GenericValuelog a message.Attributes
value-field | optional | The name of the field containing the existing GenericValue | new-value-field | optional | The name of the field that will contain the new GenericValue |
| Info |
|---|
| | Deprecate and replace with the <make-value> element.Name | Type | Requirements | Description | Notes |
|---|
level | constant | required | The logging level to use. | Must be one of the following: "verbose", "timing", "info", "important", "warning", "error", "fatal", "always". Defaults to "info". | message | constant+expr | required | The message to log. | |
|
| Section |
|---|
| Column |
|---|
| <condition> <trace>
|
| Column |
|---|
Contains an entity find condition.Child Elements
<condition-expr> | optional | <condition-list> | optional | <condition-object> | optional | <having-condition-list> | optional |
| Info |
|---|
| Currently, the child elements are optional. Require one child element.AttributesName | Type | Requirements | Description | Notes |
|---|
level | constant | required | The logging level to use. | Must be one of the following: "verbose", "timing", "info", "important", "warning", "error", "fatal", "always". Defaults to "info". |
Child ElementsName | Requirements | |
|---|
(Any block of code) | optional | |
|
|
Calculate Operations
| Section |
|---|
| Column |
|---|
| <condition-expr><calculate>
|
| Column |
|---|
Declares an entity find condition expressionAttributesfield-nameName | optional | The entity field name (comparison l-value) | operator | optional | The condition comparison operator | Type | Requirements | Description | Notes |
|---|
field | expression | required | from-field | optional | The name of the environment field (variable) to compare to (comparison r-value) | value | optional | A string constant to compare to (comparison r-value) | ignore-if-null | optional | When set to "true" ignores the expression if the r-value evaluates to null | ignore-if-empty | optional | When set to "true" ignores the expression if the r-value is empty | ignore-case | optional | When set to "true" ignores case in string comparisons | ignore | optional | When set to "true" ignores the expression |
| Info |
|---|
| - Currently, the field-name and operator attributes are optional. Require the field-name and operator attributes.
|
|
|
| Section |
|---|
| Column |
|---|
Combines entity find conditions into a single expression.
Attributes
combine | optional | The operator used to combine the expressions |
Child Elements
to set, the target of the assignment. | | rounding-mode | constant, ${expression} | optional | Rounding mode for the calculation, primarily for divide operation. | Defaults to "HalfEven". | decimal-scale | constant, ${expression} | optional | Initial scale (decimals) to use. | Defaults to "2". | decimal-format | constant, ${expression} | optional | Decimal format to use for conversion to string. | | type | constant | optional | Data type of the calculation result. | Defaults to "BigDecimal". |
Child ElementsOne or more of the following child elements is optional: Name | |
|---|
<calcop>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) | <number>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
| Warning |
|---|
Deprecated - use the <set> element. |
|
|
<condition-expr> | optional |
<condition-list> | optional |
<condition-object> | optional |
| Section |
|---|
| Column |
|---|
| <condition-object><calcop>
|
| Column |
|---|
Declares an environment field (variable) that contains an entity find condition expression objectA basic arithmetic operation.AttributesfieldName | optional | The name of the field that contains an entity find condition expression object |
| Info |
|---|
| - Currently, the field attribute is optional. Require the field attribute.
|
|
|
<create-value>
<entity-and>
<entity-condition>
<entity-count>
<entity-data>
<entity-one>
<field-map>
<filter-list-by-and>
<filter-list-by-date>
<find-by-and>
<find-by-primary-key>
<get-related>
<get-related-one>
<having-condition-list>
<make-next-seq-id>
<make-value>
<order-by>
<order-value-list>
<refresh-value>
<remove-by-and>
<remove-list>
<remove-related>
<remove-value>
<select-field>
<sequenced-id-to-env>
<set-current-user-login>
<set-nonpk-fields>
<set-pk-fields>
<store-list>
<store-value>
<transaction-begin>
<transaction-commit>
<transaction-rollback>
Calculate Operations
| Info |
|---|
|
Deprecate and replace with UEL expression. |
<calcop>
<calculate>
Type | Requirements | Description | Notes |
|---|
operator | constant | required | The arithmetic operator. | Defaults to "add". | field | expression | optional | The name of the field to use. | |
Child ElementsOne or more of the following child elements is optional: Name | |
|---|
<calcop>
| | <number>
| (?) (https://cwiki.apache.org/OFBADMIN/mini-language-reference.html#Mini-languageReference-{{}}) |
| Warning |
|---|
Deprecated - use the <set> element. |
|
|
| Section |
|---|
| Column |
|---|
Declares a numeric constant to be used in the calculation.AttributesName | Type | Requirements | Description | Notes |
|---|
value | constant, ${expression} | required | A numeric constant. | |
| Warning |
|---|
Deprecated - use the <set> element. |
|
|
...
Map Processor
<compare>
<compare-field>
<convert>
<copy>
<fail-message>
<fail-property>
<make-in-string>
<not-empty>
<process>
<regexp>
<simple-map-processor>
<validate-method>
Logging
...
Mini-language Reference