Rule Groups - Best Practices
Choosing a set number of Rule Group Responses
Rule Groups can return the number of results requested by a calling system.
Alterian are working on future functionality that will allow Alterian CX users to more accurately generate history on the rules that have run, and the results generated. We'll also measure whether the results used helped to meet the business goals of our customers.
When called, Rule Groups currently provide back all the possible results generated in a prioritized list. If the calling system is only able to effectively consume one result, we are providing back multiple results that will not be used. This makes attributing history difficult. It's hard for CX to know what was used by each system.
In preparation for this new functionality Rule Groups have a new attribute that allows the calling system to request back a specific number of results This attribute is added to the Delivery group URL string for example
https://dde.alterian.net/invoke/dev/testclient/testdeliverygroup?top=1
?top=1 will return the top prioritized result
?top=5 will return the top 5 prioritized results
?top=20 will return the top 20 prioritized results
no attribute will return all results
If the new attribute is not used the Delivery Group will continue to return all results providing full backwards compatibility.
An example call requesting the top two Rules by priority would look like the below https://localhost:8443/invoke/dev/test/groupstestrulefailure?top=2