Users that do not have the APD App can use the following steps to generate
LOB-specific endpoints for products that were not created in APD.
Before you begin
- In PolicyCenter Preferences, set the Product Design Mode to
Developer.
Note: This is
not the recommended Cloud Retrofit
process. Consider provisioning the APD App and then following the process for
Cloud Retrofit with APD App. For more information, see
Cloud Retrofit with APD App.
Warning: You can extract a product template from one instance of
PolicyCenter and then use that template to generate endpoints on a different
instance of PolicyCenter. However, do not generate LOB-specific endpoints for a
product that is not installed on that instance of PolicyCenter. PolicyCenter will
generate the endpoints. But, because the product itself is not installed, the
endpoints will reference other LOB artifacts that do not exist on that instance of
PolicyCenter. This will cause compile errors that prevent PolicyCenter from
starting. (For information on how to remove the installed product endpoints, see
Removing an installed product's endpoints.)
Procedure
-
In Guidewire Studio, update template_gen_config.xml for
each LOB that you want to generate endpoints for.
-
If a
PolicyLine element does not already exist for the
LOB, add a PolicyLine element with a
code attribute set to the pattern code of that
line.
-
For each entity that does not implement either a Coverable or
Modifiable interface, add a
Type element as child of
the PolicyLine. For each Type element
that you add, set the name attribute to the name of the
entity type and the handling attribute to
exposure, coverable, or
location.
For example:
<PolicyLine code="TSTLine">
<Type name="TSTCfgCoverable" handling="coverable"/>
<Type name="TSTConfiguredExposure" handling="exposure"/>
...
</PolicyLine>
-
For each field that has the name of a reserved keyword in APD, add a
Field element as a child of the associated
Type element, set the name
attribute to the name of the field in the current entity model, and set
the templateName attribute to the field name that you
want to use in APD.
For example:
<PolicyLine code="WorkersCompLine">
<Type name="WCWaiverOfSubro" handling="exposure">
<Field name="Type" templateName="WaiverType"/>
</Type>
</PolicyLine>
Note: For each
templateName attribute
that you define in this file, configure the
nameOverride at the field-level in the codegen
config file to map the name you define for the APD template to the
name defined in the installed product. For more information on
working with codegen config files, see
Codegen config files.
-
As needed, add additional configurations or make additional
modifications to the configuration for the product's PolicyLines. For
example, to exclude a field from the APD model, add a
Field element as a child of the associated
Type element and set the ignored
attribute to true.
-
In PolicyCenter, generate a product template for the existing installed
product.
- Navigate to the Product Management screen.
- Click the Externally Managed tab.
- In the list of Installed Products, click the
desired product.
- Click Extract APD Representation. This generates
the XML template and stores it in your
Downloads
directory.
-
In PolicyCenter, import the product template.
- On the Product Management screen, click the
APD Managed tab.
- Click Import From Template.
- Click Browse, then navigate to the template's
location and select the template.
- Click Update. It may take a few seconds for the
template to load. Once it has been loaded, the product is listed on the
APD Managed tab.
-
In PolicyCenter,validate the installed product.
- On the APD Managed tab, select the product.
- On the Details tab below the list, select
Validation Status. The
<ProductName> screen appears.
- If the product has any errors, the screen title also says
"See Errors Highlighted".
-
Fix all validation errors on the <Product Name> screen, and
optionally fix any warnings.
- Errors appear with an "!" in a red triangle. Warnings appear
with an "!" in a yellow triangle.
- For more information on the most common types of errors and how
to fix them, see Fixing product validation errors.
- Guidewire recommends making any required changes to the
visualized product through the Product Management
screen and then extracting an updated version of the product template
from the Product Management screen. To do this,
on the APD Managed tab, select the product from
the product list and then click Extract
Template.
-
In Guidewire Studio, modify the codegen config file, if necessary.
- Navigate to modules > configuration > config > integration >
apis > installedlobs.
- Open the file whose name starts with
<productCode>_codegen. If there is no codegen
config file for your LOB and you need one, you must create one. Then,
edit the codegen config file as needed.
- For more information on working with codegen config files, see Codegen config files.
-
In PolicyCenter, generate endpoints for the installed product.
- On the APD Managed tab, select the product.
- On the Details tab below the list, select
Generate Product Code ->
System APIs -> System APIs
- Code. The Review Product
Elements screen appears.
- Click Complete Generation. In the
confirmation dialog box, click OK.
-
Identify and correct all compile errors in the generated endpoint
files.
-
For a given product, there can only be one set of active endpoints at a time.
By default, the visualized product endpoints are active. If you wish to continue
working with the visualized product, no additional action is needed.
Toggle the installed product endpoints to make them active
-
On the APD Managed tab and select the
product.
-
In the Enabled for REST API field, select
Disabled to enable the installed product's endpoint.
-
Restart PolicyCenter.