Scripting Timestamp Rules

Optimal Blue configuration site users can script eligibility or adjustment rules based on timestamps.


1. From the Website Selection screen, click the Configuration button.

2. Select the investor you want to configure pricing for, then select the Manage Products activity.

3. Select the desired product set or product from within the investor’s product tree. Click the Eligibility or Adjustment activity.

Reminder: Investor product trees are in a hierarchical format, so if you script your rule at the All Products set, the rule will flow down and be applied to all products. By contrast, if you script the rule at the
Conforming Fixed set, for example, then only conforming fixed products will have the rule applied.

4. Click Add New Grid Set. The best practice is to name your grid set to include the investor, product/set and whether the rule relates to adjustments or eligibility (Ex. FNMA All Product Elig). Click Add to save name.

5. The new grid set should be selected automatically. Click Add Scripted Rule.

6.  Name your rule so it will make sense to you. Click Save.

7. In the Condition window, click the Edit button. Locate the variable Search Timestamp Hour, change the Operator to Greater Than or Equal To and enter the desired time to expire pricing. Click Update. You can add as many conditions as necessary. For example, if you need the time to expire at the half hour mark, you can add the variable Search Timestamp Minute (see screen shot below).

NOTE: All scripted timestamps are Central Standard Time

When scripting Timestamp rules in the Configuration Site, you will script by hour and by minute.  You should always have a start time and end time, or the rule will not fire.  Timestamp rules are scripted in Military Time (no AM or PM).  Timestamp rules are scripted off Central Time Zone in the Configuration Site.

8. Under the Action Type menu, click Edit and locate the appropriate action. Click Update to save. In the example below, pricing will expire for the selected investor at 6:30 P.M.

Example:  -1.00 Incentive for Lock Early:  8:00 AM to 1:30 PM CST, you will add the conditions below:

  • ‘Search Timestamp Hour (24hr) >=8’
  • ‘Search Timestamp Hour (24hr) <=13’
  • ‘Search Timestamp Minute >0’
  • ‘Search Timestamp minute <=30’

*If you choose not to add minutes, the system will fire the rule until the end of that hour.  In the example above the ‘Search Timestamp Hour (24hr) <=13’.  If the minutes were not defined, the rule would fire until 1:59 because the system looks at the Search Timestamp Hour, which is defined as 13 (or 1 PM).

Leave a Reply