Conversion on renewal plugin

To configure actions to perform if a renewal fails during converting, implement the ConversionOnRenewal plugin. There is only a single method, called conversionOnRenewalFailed. Before calling this plugin method, PolicyCenter unlocks the PolicyPeriod and sets its status to draft so that it is editable.

The plugin can perform actions that improve the chances of the renewal conversion succeeding.

PolicyCenter provides a default plugin implementation called gw.plugin.job.impl.ConversionOnRenewalPluginImpl. The class implements the following default behavior.

• Set the policy period status to TC_NEW, which allows eventual purging.
• Reassign a new policy number to each policy period, to reduce chance of conflict with existing policies.

If you want a different behavior, re-implement this plugin interface.

The conversionOnRenewalFailed method has two parameters: A renewal period (Renewal) and the original policy period for the renewal (PolicyPeriod).

The method must return the original Renewal object passed to the method. Do not create and return a new Renewal object.