Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Okay, enough of the general stuff, here is a catalog and description of the available operations.

Call Operations

call-map-processor

The call-map-processor tag invokes a simple map processor from an existing map, creating a new map or adding to an existing one if the named out-map already exists. Resulting messages are added to the named list, and a new list is created if a list with the given name does not yet exist. Note that all lists and maps exist in the same context and must have unique names.

An inline simple-map-processor can be used by putting a simple-map-processor tag under the call-map-processor tag. If both an external and an inline map-processor are specified, the external one will be called first, allowing the inline one to override its behavior.

Attribute NameRequired?Description
xml-resourceNThe full path and filename on the classpath of the XML file which contains an external map processor to execute. This is only required if an external map processor is desired.
processor-nameNThe name of the external map processor to execute in the specified xml-resource. This is only required if an external map processor is desired.
in-map-nameYThe name of a map in the method environment to use as the input map.
out-map-nameYThe name of a map in the method environment to use as the output map. Will be created if it does not exist already. If already exists will be added to in place.
error-list-nameNThe name of a list in the method environment that the error messages will be added to. Will be created if it does not exist. Defaults to "error_list".
Sub-Element NameHow ManyDescription
simple-map-processor0 or 1Uses the same definition as the simple-map-processor in the context of a simple-map-processors XML file. Allows for an inlined simple-map-processor.

call-service

The call-service tag invokes a service through the Service Engine. If the specified error code is returned from the service, the event is aborted and the transaction in the current thread is rolled back. Otherwise, the remaining operations are invoked.

The result-to-request and result-to-session elements will be IGNORED when called in a service context. So, they are ONLY used when called in an event context.

Attribute NameRequired?Description
service-nameY 
in-map-nameY 
include-user-loginNDefaults to "true".
error-codeNDefaults to "error".
success-codeNDefaults to "success".
Sub-Element NameHow ManyDescription
error-prefix0 or 1 
error-suffix0 or 1 
success-prefix0 or 1 
success-suffix0 or 1 
message-prefix0 or 1 
message-suffix0 or 1 
default-message0 or 1 
results-to-map0 to many 
result-to-field0 to many 
result-to-request0 to many 
result-to-session0 to many 
result-to-result0 to many 

call-service-asynch

Calls a service asynchronously and ignores the result, so no return messages are used; that doesn't mean no errors will result, but they would just be system errors like database failures, etc which all have system error messages.