diff --git a/src/reference/views.xml b/src/reference/views.xml
index 008777dd..8e343ce5 100644
--- a/src/reference/views.xml
+++ b/src/reference/views.xml
@@ -694,11 +694,15 @@ public class BookingValidator {
Transition actions
A view-state transition can execute one or more actions before executing.
- These actions may return an error result to prevent the transition from exiting the current view-state.
- If an error result occurs, the view will re-render and should display an appropriate message to the user.
+ These actions may return an error result to prevent the transition from exiting the
+ current view-state. If an error result occurs, the view will re-render and should display
+ an appropriate message to the user.
- If the transition action invokes a plain Java method, the invoked method may return false to prevent the transition from executing.
+ If the transition action invokes a plain Java method, the invoked method may return a boolean
+ whose value, true or false, indicates whether the transition should take place or be prevented
+ from executing. A method may also return a String where the literal values "success", "yes", or
+ "true" indicate the transition should occur, and any other value means the opposite.
This technique can be used to handle exceptions thrown by service-layer methods.
The example below invokes an action that calls a service and handles an exceptional situation:
@@ -721,12 +725,12 @@ public class BookingAction {
}
}]]>
-
-
- When there is more than one action defined on a transition, if one returns an error result the remaining actions in the set will not be executed.
- If you need to ensure one transition action's result cannot impact the execution of another, define a single transition action that invokes a method that encapsulates all the action logic.
-
-
+
+ When there is more than one action defined on a transition, if one returns an error result the
+ remaining actions in the set will not be executed. If you need to ensure one
+ transition action's result cannot impact the execution of another, define a single transition
+ action that invokes a method that encapsulates all the action logic.
+
Global transitions