Create a Forwarding EntryPoint PCF

About this task

A forward is a top-level PCF location element similar to a page or wizard. However, it has no screen. It merely forwards you to another location.You define a forward separately from the EntryPoint PCF. However, you set the forward for a PCF in the EntryPoint PCF location attribute.

Suppose that there are several destinations to which you wish the user to go. In this case, consider passing a parameter to the entry point forward, so you can have the seamless login logic all in that one place.

Procedure

  1. Define a separate entry point (PCF) with authenticationRequired property set to false. This PCF is effectively a forwarding page to handle the seamless login.
  2. Set the location attribute of the entry point to use a Forward to call the AuthenticationServicePlugin.
  3. Do one of the following:
    • If the plugin login is successful, forward the user onto the actual page (the desktop, for example) to which you intended to send the user in the first place. (This is the page to which the user would have gone if authenticationRequired had been set to true.)
    • If the plugin login is not successful, redirect the user to an error page or an alternate login page.

Example

For an example of how to define a forward, see ActivityForward in Guidewire Studio at pcf > activity > ActivityForward.