Entry points

An entry point takes the form of a URL with a specific syntax. The entry URL specifies a location that a user enters into the browser. If the PolicyCenter server receives a connection request with a specific entry point, PolicyCenter responds by serving the page based on the entry point configuration.

To implement this functionality, you must create an EntryPoint PCF (in the entrypoints folder). The following graphic illustrates an EntryPoint PCF.

The EntryPoint PCF contains the following parameters:

`authenticationRequired`	Specifies that PolicyCenter must authenticate the user before the user can access the URL. If true, PolicyCenter requires that the user already be authenticated to enter. If the user is not already logged in, PolicyCenter presents a login page before rendering the entry point location. The default is `true`. Guidewire strongly recommends that you think carefully before setting this value to `false`.
`clearSession`	If `true`, clears the server session for this user as the user enters this entry point
`desc`	Currently, does nothing.
`failurePage`	Specifies the page to send the user if PolicyCenter cannot display the entry point. Failures typically happen any time that the data specified by the URL does not exist. The default is `Error`.
`id`	Required. The PolicyCenter uniform resource identifier to show, minus its `.do` suffix. Typically, this is the same as the page ID. No two `EntryPoints` can use the same URI. Do not use the main application name, PolicyCenter, as the URI. For example, if the URI is `XXX`, then it is possible to enter the application at `http://myserver/myapp/XXX.do`.
`location`	Required. The ID of the page, Forward, or wizard to which you want to go. Guidewire recommends that if you want the entry point to perform complex logic, use a Forward. See Create a Forwarding EntryPoint PCF for a definition of a forward.

Each EntryPoint PCF can contain one or more EntryPointParameter subelements that specifies additional functionality.

The EntryPointParameter subelement has the following attributes:

`conversionExpression`	Gosu expression that PolicyCenter uses to convert a URL parameter to the value passed to the location parameter.
`desc`	Currently, does nothing.
`locationParam`	Required. The name of the `LocationParameter` on the `EntryPoint` target location that this parameter sets.
`optional`	Specifies whether the parameter is optional. If set to `true`, PolicyCenter does not require this parameter.
`type`	Required. Specifies what type to cast the incoming parameter into, such as `String` or `Integer`.
`urlParam`	The name of the parameter passed with the URL. For example, if the `urlParam` is `Activity` and the entry point URI is `ActivityDetail`,you would pass Activity 3 as: `http://myserver/myapp/Activity.do?`Activity`=3`