PolicyPeriod producer code handler elements

<PolicyPeriodProducerCodeHandler> elements in security-config.xml determine access to policy information and restrict the actions available on a policy. There is no limit to the number of <PolicyPeriodProducerCodeHandler> elements that can exist in security-config.xml. Each <PolicyPeriodProducerCodeHandler> element can contain zero to many <SystemPermType> and <ProducerStatus> elements.

This element has the following syntax.

<PolicyPeriodProducerCodeHandler permKey="perm" desc="..." 
      isAllowedForPCOfRecord="true|false" noPermissionDisplayKey="...">
  <SystemPermType code="code" />
  <ProducerStatus code="status" />
  ...
</PolicyPeriodProducerCodeHandler>

The attributes on the various elements have the following meanings.

Element	Attribute	Required	Description
`PolicyPeriodProducerCodeHandler`	`permkey`	Yes	The application permission to grant. The `permkey` attribute becomes a property on the PolicyPeriod entity. To access the entity property, use the following notation: `perm.PolicyPeriod.permkey`
	`desc`	No	A human-readable description of the permission.
	`isAllowedForPCOfRecord`	No	A Boolean value which, if `true`, grants this permission to a produce whose producer code matches that of the policy. The default is `false`. In the base configuration, Guidewire sets this attribute value to `true` for the `viewpolicyfile` permission only. Thus, only a producer with the correct producer code can see the information in the policy file.
	`noPermissionDisplayKey`	No	A display key that provides the text to show if the user does not have a required permission.
`SystemPermType`	`code`	Yes	A `code` value defined in the `SystemPermissionType` typelist.
`ProducerStatus`	`code`	Yes	The status of the producer associated with the policy. This must be a value defined in the `ProducerStatus` typelist.

The following example illustrates an <PolicyPeriodProducerCodeHandler> element that contains multiple producer status codes.

<PolicyPeriodProducerCodeHandler permKey="view" desc="Permission to view the policy file"
      isAllowedForPCOfRecord="true">
  <SystemPermType code="viewpolicyfile"/>
  <ProducerStatus code="Limited"/>
  <ProducerStatus code="Suspended"/>
  <ProducerStatus code="Terminating"/>
</PolicyPeriodProducerCodeHandler>

Notice that:

The application permission key is view.
The value of isAllowedForPCOfRecord is true. Thus, only a producer whose producer code matches the producer code on the policy can see the policy file.
The system permission type is viewpolicyfiles.
The element explicitly grants permission to view a policy file to producers with a status of Limited. PolicyCenter gives any producer with a status of Active this permission automatically. Thus, only producers with a status of Active or Limited can view the details of policy file. As indicated by the isAllowedForPCOfRecord element a producer can only view a policy file associated with its producer code.