Using Custom Fields
LoanPro lets you create custom fields to keep track of things that the system doesn’t track by default. Custom fields are also commonly used on custom forms. You can add custom fields in five specific areas of a loan:
You may also create custom fields in other areas such as customer, payment, and source company. This article will first explore how to create custom fields, and then cover the different ways that these they can be used throughout the software.
Adding Custom Fields
Custom fields are created at the tenant-level, meaning that they'll show up on all of your loans, customers, or whatever else you create custom fields for. All the loan custom fields are adding in Settings > Loan > Custom Fields.
When you first open that page, you'll see all the custom fields for Setup Terms, but clicking the tabs across the top will take you to the custom fields for Loan Settings, Collateral, Insurance, and Bankruptcy. Each page lists the custom fields, and each entry in those lists includes their ID (used in rules and custom forms), the name and type, whether it's required, active, searchable, and other useful information.
Our article Loan Custom Fields, gives more detail about creating and editing custom fields for loans. Other types of custom fields are covered in their own articles: Payment Custom Fields, Customer Custom Fields, and Source Company Tenant-level Settings.
Using Custom Fields in the Software
In addition to just storing data, custom fields can be put to use in several areas of the software: Custom field variables can be included in custom forms, notifications, and rules applied.
To add a custom field to a custom form, navigate to Settings > Loan > Custom Forms > Form Management and select the edit button (the pencil icon) next to the form on which you would like to display the custom field.
Once you are in the form editor, select 'Help variables' on right-hand side of the screen. Then, using the search bar, search for "Custom Fields". Now, select the section containing the custom field that you would like to add to the form (e.g. Collateral, Setup, Settings, etc.). Once you have selected the section, you will see a list of custom fields contained in that section. If you are editing an HTML form, make sure your cursor is positioned on the form where you would like the custom field variable to show and then select the hyperlink for the field you would like to add from the Expected Values list.
Notice that after selecting the hyperlink, the correct variable will be added to the form with the correct custom field ID. However, the word “PROPERTY” will need to be replaced by “value” as shown above.
Select Save to finish editing the form.
If the updated form is now generated inside of a loan, the value that has been entered in the selected custom field for the specific loan will be displayed where the variable has been added on the form.
Because loan specific variables are generated using the Context Engine, the process of adding custom field variables to an email is similar to the process of adding them to a custom form.
To add a custom field to an Event Based Notification, navigate to Settings > Company > Notifications > Event Based Notifications and select the edit button (the pencil icon) next to the notification on which you would like to display the custom field.
You may add a custom field to the content of the Email, System, Mail House, or Web Hook notifications. SMS templates and variables will need to be configured with Solutions by Text.
Here are the steps for adding a custom field to Email, System and Mail House notifications:
1. Scroll down and place your cursor in the content box where you would like the custom field to appear
2. Select Help Variables
3. Search "Custom Fields"
4. Select the section in which the desired custom field is found
5. Select the custom field from the Expected Values hyperlinks
6. Inside of the custom field variable in the content box, change "PROPERTY" to "value"
7. Select Save
Follow this same process to add a custom field to a trigger based or manually sent notification.
LoanPro gives you the ability to complete certain actions or processes on an account automatically based off of certain criteria being met. You may create this criteria using rules. Using a custom field in a rule is similar to using any other variable that is native to the system. However, a very specific formatting is required.
For example, if you click the Expected Values hyperlink for a custom field with an ID number of 31 found in Loan Settings, you would see that (-> settings-custom-fields (get :31) :PROPERTY) has been added to the rule. All of the formatting is correct, except similar to the custom forms and notifications, you will need to change "PROPERTY" to say "value".
Example Rules with Custom Fields:
Here's an example rule that would give True/False output for custom fields that hold currency or other numbers:
(> (Double/valueOf(-> settings-custom-fields (get :31) :value)) 0)
This rule would evaluate whether or not a currency type custom field with ID 31 has a value greater than $0.
And here's an example rule that would give a True/False output for fields that hold text rather than numbers:
(= (-> settings-custom-fields (get :19) :value) "This value") "This value"
This rule would evaluate whether or not a select type custom field with ID 19 has a specific value selected. "This value" would need to be replaced by the ID of the select value that you would like to run the rule off of.
You may also be interested in Computation Fields and the Associated Company Directory.
Similar to how custom fields let you create an area on loans where users can input data, Computation fields create an area on the loan where the system will automatically calculate and display a value based on your own Clojure Rules. These can be used to customize the system, displaying information that's pertinent to the specifics of your lending model, servicing operations, and collection strategy.
The Associated Company Directory, on the other hand, are custom fields built to display information about companies you partner with, buy from, or sell to. At the tenant level, you can create a list of the organizations you work with (anyone from auto lots to attorneys to repo companies). Then, within a loan, agents can select those companies from custom fields.