List Container Rules

Overview

List Container Rules are implemented in Decisions in the Rule Engine. These Rules are designed to process a list of items and apply desirable conditions to each item in the list. The List Container Rules have three options:

• Contains All – Each item in the list should satisfy the condition for the Rule to evaluate as True.
• Contains Any – At least one item in the list should satisfy the condition for the Rule to evaluate as True.
• Does Not Contain Any – None of the items on the list should satisfy the condition for the Rule to evaluate as True.

Example

In this example, the Rule will take in an array of Accounts. It should evaluate as True if all Accounts in the array have an email address that contains “decisions.” This example requires List Container Rules to test each Account in the array. Below is a downloadable example to import into Decisions.

1. In a Designer Folder, click CREATE RULE, select Statement Rule, and CREATE. Name the Rule (List Container Rule) and click CREATE.
2. Select SETUP INPUT DATA.
   
3. Enter "Accounts" in the Name field. Click the dropdown list under Type and search for "account". Select Account [DecisionsFramework.Service..] and click PICK.
   
4.  Next, check the Is List checkbox, this will enable this data to be an array that will display the Contains All, Contains Any, or Does not Contain Any as options when selecting the condition to check.
   
5. Click CLOSE to close the Data Definitions window. 
6. Click the Select Data Element dropdown. Select Accounts then click NEXT.
   
7. Choose the Contains All option under the List Container Rules category and select NEXT.
   
8. Under the Collection Information category, in the Each List Item Name field, enter "Email" and select DONE. Then, click CLOSE.
   
9. In the new If Statement block, click Add and then choose Add Condition. Each item passed through the Rule will need to pass this condition that will check to see if Account.EmailAddress contains "decisions".
   
10. Click Select Data Element, click Email, then scroll down to select EmailAddress [String]. Click NEXT.
    
11. Select the Contains option under the Text Rules category then click NEXT.
    
12. Under the Inputs category, enter "decisions.com" as the value and select DONE.
    
13. Click CLOSE to save the Rule and return to the Rule Designer. Click Save on the top action bar.
    
    

Debug

1. To ensure the Rule works, select Debug on the top bar of the Rule Designer.
2. To add accounts to test, click Add New under Accounts.
   
3. Enter a name in the Name field. Under the Settings category, enter an email address under the EmailAddress field.
   
4. Click DEFINE to save.
5. After adding the desired number of accounts, click Run Capturing All.
   The Rule runs and stops at the first False result evaluating the entire Rule as False since the Rule was built using the Contains All option and the email that was found did not match the condition.