Process time-varying data in a web service call

What do you want to do?

Supply attribute data that varies over time

Obtain and process a time-varying answer

 

Supply attribute data that varies over time

Determinations Server

You can use the Determinations Server to get answers on data that may vary over time. The value of an attribute may vary over time, and any determinations that are inferred based on that attribute may also vary over time.

The Determinations Server allows you to provide the values of an attribute for a period of time. You can use the change-point XML element to do this in an Determinations Server Assess request operation that uses session data, such as an Assess operation.

Example

In the example below we are trying to determine if a claimant is eligible for the low income allowance, and the amount of that allowance. The claimants income has varied over time. Initially, their declared annual income was $13,000, but on 3 June 2009 due to a change in circumstances, it changed to $18,000. It changed again on 15 September 2009 to $35,000.

To provide all this information in a single request to the Determinations Server, we need to set change points in the attribute, and provide the new value that applies on and after the date specified in the change point.

So, the intial value of the attribute claimant_income is 13000.00, but after the change-point dated 2009-06-03 it becomes 18000.00 and again after 2009-09-15 it becomes 35000.00

 

Generic

 

Specific


Obtain and process a time-varying answer

Determinations Server

Just as you can set data that changes over time, you can also received answers (based on that data, that changes over time. Just as data going into the Determinations Server might vary over time, so can attribute outcomes returned in the response.

In the section above on Supply attribute data that varies over time we saw an example of setting attribute data in a request that changed over time. Now we can see how the returning result containing this sort of data might look.

Example

In the example below we are trying to determine two things: if the claimant is eligible for low income allowance, and what the value of that allowance might be. We can formulate our request with the claimants income which has changed over time:

Initially: 13000, after 2009-06-04: 18000, after 2009-09-15: 35000

We specify two outcomes: eligible_low_income_allowance and low_income_allowance_payment

If you look at the reponse you can see the outcomes varying over time.

eligible_low_income_allowance. Initially: true, after 2009-09-15: false. This is because a claimant must have an income less than 25000 to be eligible for low income allowance.

low_income_allowance_payment. Initially 70.00, after 2009-06-03: 20.00, after 2009-09-15: 0.00/ This is because the payment amount is calculated off the claimants income (which changed on 2009-06-03 and 2009-09-15. After 2009-09-15 the claimant no longer qualifies, so the amount changes to 0.

 

Request (generic)

 

Response (generic)