THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
now-timestamp-to-env
now-date-to-env
The nowsequenced-dateid-to-env tag creates a java.sql.Date object with the current date in it and puts it in a field in the method environment.
Attribute Name | Required? | Description |
|---|---|---|
env-name | Y | The name of the method environment field the date will be put in. |
sequenced-id-to-env
The sequenced-id-to-env tag gets a sequenced ID from the Entity Engine (through the delegator) and puts it in the specified method environment field. The object will be a java.lang.Long, but can of course be converted to a String.
Attribute Name | Required? | Description |
|---|---|---|
sequence-name | Y | The name of the sequence to pass to the delegator. The same name must always be used for sequenced IDs that will be used for a certain entity field otherwise non-unique keys may result. |
env-name | Y | The name of the method environment field the sequenced ID will be put in. |
set-current-user-login
The set-current-user-login tag sets the UserLogin GenericValue object to be used for authentication for the rest of the method. This is mostly used for calling services, etc.
Attribute Name | Required? | Description |
|---|---|---|
value-name | Y | The name of the method environment field that contains the UserLogin GenericValue object. |
Entity Engine Find Operations
find-by-primary-key
The find-by-primary-key tag uses the delegator to find an entity value by its primary key. The resulting GenericValue object will be placed in the method environment using the specified value-name.
Attribute Name | Required? | Description |
|---|---|---|
value-name | Y | The name of the method environment field that contains the GenericValue object. |
entity-name | Y | The name of the entity to find an instance of. |
map-name | Y | The name of a map in the method environment that will be used for the entity fields. |
delegator-name | N | By default this operation is done using the delegator that is part of the simple-method calling context. This allows you to override the default delegator by naming an alternate delegator. |
use-cache | N | Specifies whether or not the delegator's cache should be searched before going to the database. This results in much faster retrieval times, but can return stale data that is not the most current in the database. Must be "true" or "false", defaults to "false". |
find-by-and
The find-by-and tag uses the delegator to find entity values by anding the fields passed in the map. The resulting GenericValue objects will be placed in the method environment using the specified list-name.
Attribute Name | Required? | Description |
|---|---|---|
list-name | Y | The name of the method environment field that contains the list of GenericValue objects. |
entity-name | Y | The name of the entity to find instances of. |
map-name | Y | The name of a map in the method environment that will be used for the entity fields. |
order-by-list-name | Y | The name of a list in the method environment that contains a list of strings specifying fields to order the results by. |
delegator-name | N | By default this operation is done using the delegator that is part of the simple-method calling context. This allows you to override the default delegator by naming an alternate delegator. |
use-cache | N | Specifies whether or not the delegator's cache should be searched before going to the database. This results in much faster retrieval times, but can return stale data that is not the most current in the database. Must be "true" or "false", defaults to "false". |
use-iterator | N | Specifies whether or not to 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. Note that when using this the use-cache setting will be ignored. Also note that an EntityListIterator must be closed when you are finished, but this is done automatically by the iterate operation. Must be "true" or "false", defaults to "false". |
filter-list-by-and
The filter-list-by-and tag filters the given list by the fields in the specified map.
...
Attribute Name
...
Required?
...
Description
...
list-name
...
Y
...
The name of the method environment field that contains the list of GenericValue objects.
...
to-list-name
...
N
...
The name of the method environment field the filtered list will be put into. Defaults to the value of the list-name attribute (ie goes to the same place it came from, replacing the old list).
...
map-name
...
N
...
set-current-user-login
Entity Engine Find Operations
find-by-primary-key
find-by-and
filter-list-by-and
filter-list-by-date
The filter-list-by-date tag filters the given list by the valid date using the from and thru dates in each value object.
...