Example: Checkpoints-Only Web Service Connector

A checkpoints-only web service example is provided so that you can use it as an application with a Policy Modeling project to help understand how to develop web service connectors with the checkpoints feature. Note that in this example, the checkpoint data is stored in memory with the Java application. If you need to store the checkpoint data in a database, you will need to modify the sample to do this.

The checkpoint web service connector example is a web service which has been built upon the WSDL provided by Intelligent Advisor Hub.

To build an end-to-end working example of a Policy Modeling project connected to a web service application with checkpoints, follow these steps:

  1. Ensure that you meet the system requirements for running the web service connector example:
    • Java: JDK 8.x or higher
  2. Get the Checkpoint Web Service Connector Example Source Files.
  3. Get the required libraries.
  4. Configure the Web Service Connector Example.
  5. Build the Web Service Connector Example.
  6. Deploy the web service connector example to:
  7. Establish a connection to the web service connector example in Intelligent Advisor Hub. Note that the example web service connector was built with the 12.2.9 WSDL, so when creating the connection select "12.2.9" for the version. You can update the service’s supported version by following the instructions in Build the Connector Source Files From the WSDL and updating class references to the later version interfaces.
  8. Using Policy Modeling, create a new policy model (or use an example model that does not already have any data mappings), and set up data mappings for the project. Note that the example connector does not demonstrate loading or saving, you just need it to be connected using the new connection from Step 7.

  9. Ensure there are at least two interview screens, then Select the Screens That Will Create Checkpoints.

  10. Deploy and activate the Policy Modeling project.
  11. Launch the interview from a URL. Note that this example requires 'user' and 'resume-id' parameters with values to be supplied on the start session URL. For example, /startsession/[deployment-name]?user=john&resume-id=38av72ty. For more information, see Start an Interview Using a URL.
  12. Continue the interview up to the first screen that creates a checkpoint. Close the browser window.
  13. Resume the interview. Note that the same user and resume-id must be used to retrieve the checkpoint. For example, /resumesession/[deployment-name]?user=john&resume-id=38av72ty. For more information, see Resume an Interview Using a URL.

Tip: You can use the Message log in Intelligent Advisor Hub to troubleshoot problems with the interview or the connector. For more information, see Troubleshoot the Checkpoint Web Service Connector Example and Troubleshoot Connector Framework Web Service Connection Interviews.