Other special transitions
HCL UX Screen Flow Manager supports several more special transitions, or more precisely, transition endpoints.
- If the target of an end transition points to the special transition endpoint
DEFAULT_RETURN
, the screen flow manager redirects the user. The user is redirected to the resource referenced by the unique name that is specified for the configuration optioncom.ibm.wps.pcm.dialog.default.return.uniquename
. For more details, go to Configuration options. The event that is associated with this target is transmitted to the referenced resource.<transition type="end"> <source> <transition-endpoint nameref="portlet1"> <event qname="e1"/> </transition-endpoint> </source> <target> <transition-endpoint nameref="DEFAULT_RETURN"> <event qname="e2"/> </transition-endpoint> </target> </transition>
- If the target of an end transition points to the special transition endpoint
PAGE_ORIGIN
, the user is redirected to the page from which the dialog is triggered.The event that is associated with this target is transmitted to all portlets on that page. This transmission is also called broadcasting.
<transition type="end"> <source> <transition-endpoint nameref="portlet1"> <event qname="e1"/> </transition-endpoint> </source> <target> <transition-endpoint nameref="PAGE_ORIGIN"> <event qname="e2"/> </transition-endpoint> </target> </transition>
- If the target of an end transition points to the special transition endpoint
PORTLET_ORIGIN
, the user is redirected to the page that contains the portlet from which the dialog is triggered.The event that is associated with this target is transmitted to that specific portlet.
<transition type="end"> <source> <transition-endpoint nameref="portlet1"> <event qname="e1"/> </transition-endpoint> </source> <target> <transition-endpoint nameref="PORTLET_ORIGIN"> <event qname="e2"/> </transition-endpoint> </target> </transition>
Another special transition is available for standard transitions that are not end
transitions. In this context, dialog modelers sometimes want to define a dialog as
follows: after a specific source portlet emitted a specific event, the user is returned
to the resource or portlet. This resource or portlet redirects the user to the resource
that emitted the event. Therefore, you can reference the special transition endpoint
named CALLER
.
For example in the code, the first transition is triggered after portlet1
emits event e1
. Event e1
causes the user to be redirected to portlet2
. Then, after portlet2
emits event e2-2
, the user is
redirected back to portlet1
, which previously called
portlet2
.
<transition>
<source>
<transition-endpoint nameref="portlet1">
<event qname="e1"/>
</transition-endpoint>
</source>
<target>
<transition-endpoint nameref="portlet2">
<event qname="e2-1"/>
</transition-endpoint>
</target>
</transition>
<transition>
<source>
<transition-endpoint nameref="portlet2">
<event qname="e2-2"/>
</transition-endpoint>
</source>
<target>
<transition-endpoint nameref="CALLER">
<event qname="e3"/>
</transition-endpoint>
</target>
</transition>