Rule Manager

Using the Rule Manager

The Rule Manager enables you to build rules, applied to existing Investor relationships, to set profit margins (formerly known as holdbacks) and loan level price adjustments, display qualification notes, and disqualify loans conditionally based on an evaluation of a combination of up to ten (10) of the most commonly tested loan characteristics.

Most existing holdbacks will be imported into the Rule Manager as Profit Margin rules.

The rules are created in the form of conditional statements that can affect pricing and a loan’s eligibility (qualification). The conditional statement is constructed of one Rule Task (the “then” portion of the conditional statement) and up to ten Rule Conditions (the “if” portion of the conditional statement).

Combined with existing ICE PPE functionality, the Rule Manager enables you to customize and self-brand Investor loan programs by referring to an investor’s existing programs and guidelines. The Rule Manager is intended for clients who want to add additional pricing adjustments or qualification criteria to existing investor relationships and clients who want to offer customized self-branded loan programs but do not want to have to maintain their own product guidelines.

ClosedTo a Create Rule

  1. Log into ICE PPE as a Client Admin.
  2. Click on the Admin tab, and then click on the Rule Manager tab.
  1. Click Create New Rule.
  1. In the Rule Header section, which contains general rule information, enter the following required information.
  • Rule Name - A unique client-defined identifier for the rule.
  • Effective Date - The date and time when the rule will become active in ICE PPE.
  1. The remaining fields in this section are optional.
  • Expiration Date - The date and time when the rule will expire in ICE PPE.
  • Profile - The version profile of the rule. The default is “Test” for new rules.
  • Comments - Free form text up to 250 characters. It will be displayed on the Rule Listing page.
  1. In the Rule Task Section, which contains details about the task the rule will be performing, enter the following required information.
  • Task Name - Select a task from the dropdown list. Based on the task selected, additional related fields will be displayed.
  1. Depending on the selected task, the following fields can be required, optional, or disabled.
  • Description - The line item pricing description displayed in ICE PPE on the Qualify tab when clicking on the Details link, on the Summary tab, and on the Secondary Lock Tool in Encompass. Descriptions can be up to 100 characters in length.
  • Program Notes - These notes are displayed in ICE PPE on the Qualify tab, the Summary tab, and on the Secondary Lock Tool in Encompass. Notes can be up to 500 characters in length.
  1. Select the Display Description Only to Users with View Profit Margin Rights check box if you want the description and the itemized effect of the task on pricing to be displayed only to users with the “View Profit Margin & SRPs” right. For users without the “View Profit Margin & SRPs” right, the effect of the task on pricing will be reflected in the base price displayed to these users.
  • If the check box is not selected, the description and the itemized effect of the task on pricing will be displayed to all users.
  • If the Adjust SRP or Adjust SRP by Rate task is selected, the check box label will change to Display Description Only to Users with View SRP or View Profit Margin & SRPs rights.
  1. In the Rule Condition section, which contains the details of the conditions on which the rule execution will be based, select up to a maximum of ten (10) conditions.
  • Conditions are optional.
  • Each condition will be displayed in its own row in the Condition grid.
  • Based on the condition selected, additional related fields will be displayed.
  • To delete a condition, click on the “X” to the left of the row.
  1. Click Save to save the rule.
  • Validation errors will be displayed at the top of the page and must be corrected before the rule can be saved.

ClosedTo Test a Rule

Before promoting your rule to Production, you can test it using a modified Qualify tab. At the bottom of the page, there is a Test button. By clicking the Test button, the loan will be qualified using any effective Test rules.

To verify that your rule is working, compare the qualification results before executing your Test rule to the results with your Test rule applied.

For example, if a Test rule is applied with the task “Display a Program Note” with the program note of “This is a test.”, your initial qualification results should not include “This is a test.”, while the results with your Test rule applied should include “This is a test.”.

ClosedTo Promote a Rule to Production

Once you have created a rule and tested it, you can promote it to a Production version.

  1. Log into ICE PPE as a Client Admin.
  2. Click on the Admin tab, and then click on the Rule Manager tab.
  3. Locate the rule you want to promote in the Rule Manager Listing page.
  4. Click Versions in the Actions column.
  5. Test rules are displayed at the top of the grid.
  6. Click Promote in the Actions column.
  7. When prompted, click OK.
  8. Enter a reason for promoting the rule, and then click OK.
  • Your reason is recorded in the permanent History Log. The log serves as an audit trail for each rule version.
  1. Your Test version rule will be replaced by a new Production version rule.

ClosedTo Edit a Rule

  1. Log into ICE PPE as a Client Admin.
  2. Click on the Admin tab, and then click on the Rule Manager tab.
  3. Locate the rule you want to edit in the Rule Manager Listing page.
  4. Click on the rule.
  5. Click Edit in the Actions column and make your changes.

If there is more than one version of the rule, select the version you want to edit.

  1. When done, click Save.

ClosedTo Delete a Rule

  1. Log into ICE PPE as a Client Admin.
  2. Click on the Admin tab, and then click on the Rule Manager tab.
  3. Locate the rule you want to delete in the Rule Manager Listing page.
  4. Click on the rule.
  5. Click Delete in the Actions column.

If there is more than one version of the rule, select the version you want to delete.

  1. When prompted, click OK.

ClosedRule Filters

To easily locate rules, the Rule Filters at the top of the Rule Manager Listing page enable you to filter which rules are displayed in the list. Up to ten (10) filters can be used at a time. Each filter has multiple selections.

For example, to display rules with a condition where the State is California, New York, or Florida, select the State filter, and then select the three States from the dropdown list.

Filters can be deleted by clicking on the “X” to the left of the filter.

ClosedHidden Check Box

The Hidden check box manages which rules are displayed on the Rule Manager Listing page.

  • If Hidden is selected, only rules marked as Hidden are displayed.
  • To mark a rule as Hidden, click on Hide in the Actions column.
  • Versions and Copy in the Actions column are disabled.
  • Hide in the Actions column is replaced with Unhide.
  • If Hidden is not selected, only rules not marked as Hidden are displayed.

ClosedColumns

The Columns button enables you to select which columns are displayed on the Rule Manager Listing page. Your column selections are specific to you and will be retained until you change your selections.

The Rule Name and Actions columns are always displayed.

Select the columns you want displayed from the dropdown list. Once your selections are made, click the Update button at the bottom of the pop-up window to apply your changes.

The Default button returns the columns to the default selections.

ClosedActions

The Actions column displays the available actions for each rule.

  • View - Opens the Rule Definition page to the current Production version of the rule in read-only mode.
  • Versions - Opens the Rule Versions page. It is disabled for rules marked as Hidden.
  • Copy - Opens the Rule Definition page. It is disabled for rules marked as Hidden.
  • The fields on the Rule Definition page are filled with the values from the current Production version of the original rule, if one exists.
  • The Rule Name is set to “Copy of” plus the name of the original rule.
  • The Version Profile is set to “Test”.
  • Hide - Available for rules not already marked as Hidden.
  • Expires the current Production version of the rule and a History Log entry is created.
  • Retracts the Production version of a rule with a future effective date and a History Log is created.
  • Rule is marked as Hidden.
  • Unhide - Available for rules already marked as Hidden.
  • Rule is no longer marked as Hidden.