Updates to Features and Enhancements for 19.2 Major Release
Plugins
A new Plugins enhancement has been added to Encompass LO Connect. Plugins are extensions — managed as JavaScript files and hosted in the Encompass Admin Portal’s Plugins page — to be launched directly from within Encompass LO Connect.
Plugins are automatically launched at the point of sign-in, after a user has been authenticated during the process of logging into Encompass LO Connect. As soon as a user logs in, Plugins are loaded within an iFrame for the entire duration of the session. Based on the user’s actions (e.g., opening a loan, saving a loan, etc.), loan-specific events are raised to each Plugin, and every Plugin is allowed to respond accordingly.
The Ellie Mae Scripting Framework allows for two-way communication between the Plugin and LO Connect. The Scripting Framework is the mechanism for LO Connect to publish loan-specific events, for Plugins to subscribe and respond to these events, and for LO Connect to take the feedback and perform necessary action. For information on which Scripting Objects are available for Plugins, refer to theEncompass Web Customization Developer's Guide. (An Encompass Developer Connect user account is required to access this guide in the LO Connect Developer Portal.)
Process Overview
The overall process for implementing a Plugin in Encompass LO Connect involves the following high-level tasks.
- Develop the Plugin - The client developer creates the Plugin.
- Upload the Plugin- The Encompass LO Connect administrator uploads the Plugin to the Encompass Admin Portal.
- Manage the Plugin - The Encompass LO Connect administrator manages the Plugin from the Encompass Admin Portal.
Sample Plugin
You can view a sample Custom Tool in the following link: https://github.com/EllieMae/exp19-custom-plugins
Managing Plugins
The Encompass Admin Portal allows you to upload a new Plugin, delete an existing Plugin, edit an existing Plugin’s description, or export a list of all Plugins to a CSV file.
- To manage your Plugins, log in to the Encompass Admin Portal and select Customization, and then select Plugins.
To Upload a Plugin:
- From the Plugins page, select Upload.
- Select Browse to browse to and select the Plugin (JavaScript file), or drag and drop the Plugin to the file drop area.
-
The file is uploaded to the Plugins page.
To Delete a Plugin:
- From the Plugins page, select the Plugin you wish to delete.
- Select the Delete (trash) icon.
To Edit a Plugin’s Description:
- From the Plugins page, in the Description column, hover over the description of the Plugin.
- Select the Edit (pencil) icon, and then enter a new description.
- Press the Enter key, or click away from the description, to save.
To Export a List of All Plugins to CSV:
- From the Plugins page, select Export to CSV.
- When asked to save the CSV file, select Yes.
The CSV file is downloaded to your local harddrive.
Service Management
This release introduces system administration controls and templates to easily manage when and how services are ordered. This is the first phase towards the vision for a fully automated service ordering experience within Encompass LO Connect that will be delivered in 2019. With Service Management, administrators can now configure each service in Encompass LO Connect, including which vendors are available for your users to order services from. These controls also enable the administrator to control the user names and passwords (or other applicable login credentials) that Encompass LO Connect users can use when ordering services.
To Add a New Manual Service Setup
- Log into Encompass LO Connect as an Administrator.
- From the Encompass Admin Portal, select COMPANY/USER SETUP.
- Select Services Management, and then select Services Overview.
- Select a service category on the Services Overview page, and then select New Manual Setup.
-
On the Add New Manual Setup window, select a provider.
Note:The evaluation level does not impact manual setup and will be removed in a future release.
- Select Create. The New Service Setup page displays.
- Enter a unique name for this setup in the Service Setup Name field.
- Enter a description in the Description field.
-
In the Users section navigate through the Organization hierarchy or the users list to select the Users who will use this setup. To move to a folder in the Organization, select the Down Arrow icon. To move a folder in the hierarchy, or an individual user to the Added Users column, select the Move Arrow icon. To search for a specific user, select the Search icon.
-
To activate the new services setup, select the Activate toggle.
Note: Only one manual service setup can be activated for each service provider. If you try to activate a second manual service setup for the same provider, an error message displays. All users for that service provider must be included in one manual service setup
-
When you have selected all of the users who will use this service setup, select Save.
Note: Product and Pricing is configured in Encompass Smart Client under Settings > Secondary Setup > Product and Pricing.
Credentials
Some provider categories require that credentials are set up in the Encompass Admin Portal. The Credentials section enables admins to specify credentials for specific vendors to be used by authorized Encompass LO Connect users.
Note: When setting up credentials, each credential setting provides a single credential set that all users in that credential setting will share. Credentials that are different for each user are set up using a separate credential setting for each user.
To Add a New Credentials For a Manual Service Setup
- Log into Encompass LO Connect as an Administrator.
- From the Encompass Admin Portal, select COMPANY/USER SETUP.
- Select Services Management, and then select Services Overview.
- Select a service category on the Services Overview page.
- Select the Menu icon in the actions column for a Manual Service, and then select Edit.
-
On the Edit Service Setup page, select New Credentials.
Note: To edit an existing credential setup, select the check box for the credential setup and then select the Edit icon. To delete an existing credential setup, select the checkbox for the credential setup and then select the Delete icon.
-
On the Credentials page, select New Credentials.
- Enter a unique name in the Credential Name field.
- Enter a description in the Description field.
-
In the Users section Navigate through the organization hierarchy or the Users list to select the users who will use the credentials in this setup. To move to a folder in the Organization, select the Down Arrow icon. To move a folder in the hierarchy, or an individual user to the Added Users column, select the Move Arrow icon. To search for a specific user, select the Search icon.
-
In the Credentials section, enter the credentials provided by the service vendor, and then select Save.
Note: To add another set of credentials, select New Credentials and repeat steps 8 - 11.
- Select Continue.
Note: Credentials for the Automated Underwriting System, Credit, and Product and Pricing categories are configured in the Encompass Smart Client.
Optimal Blue Credentials
Optimal Blue Credentials are still managed in the Encompass Admin portal but the location for the Optimal Blue Credential Management page has changed.
To Update Optimal Blue Credentials
- Log into Encompass LO Connect as an Administrator.
- From the Encompass Admin Portal, select COMPANY/USER SETUP.
- Select Services Management, and then select Services Overview.
-
Select Product and Pricing. The following statement displays:
- Click here in the message to view the Credential Management page.
Scenario Comparison Tools Enhancements
A new Opportunities Setup section has been added to the Encompass Admin Portal which enables administrators to configure some of the settings for the Scenario Comparison Tools
-
Affordability Management - The Affordability Management page enables admins to configure the housing and debt ratio limitations based on the product type. When an opportunity is created and the income and liabilities sections for the borrowers have been entered, the scenario reflects if the current data is within the defined limitations set. These limitations can be set for the following product types: Conventional, FHA, VA, USDA.
-
Eligibility Letter Management - The Eligibility Letter Management page enables admins create or edit the template that is used to generate Eligibility Letters within an opportunity.
- Email Templates - The Email Templates page enables admins to configure the email template for when the user emails the generated Scenarios or Eligibility letter to a borrower.
To Enable and Configure Affordability Controls:
- From the Encompass Admin Portal, select Opportunities Setup.
- Select Affordability Management.
-
On the Affordability Controls page, set the toggle to On to enable these controls or Off to disable them.
Note: This option controls the availability of the Check Eliigibility button, Cash-to-Close tab, and Affordability tab for all Encompass LO Connect users.
- Set the maximum Housing Ratio and Debt Ratio limitations for each product type. The selection is saved after you enter the value.
To Enable and Configure Eligibility Letter:
- From the Encompass Admin Portal, select Opportunities Setup.
- Select Eligibility Letter Management.
- On the Eligibility Letter Management page, set the toggle to On to enable these controls or Off to disable them.
- In the Type field, enter a title for the Eligibility Letter.
-
Use the editor to create an eligibility letter that is used when an LO Connect user sends an eligibility letter.
- To add a custom field to the letter, select Insert Custom Field <>. This option is used to automatically populate the message with specific fields from the scenario data.
- Select a field name to insert into the letter, and then select Add. When the letter is sent, these fields display the details from the specific scenario.
- When you are finished editing the letter, select Save.
To Edit Eligibility Letter and Scenarios Comparison Email Templates
- From the Encompass Admin Portal, select Opportunities Setup.
- Select Email Templates.
- On the Email Templates page, select the Eligibility Letter tab to edit the eligibility letter template or the Scenarios Comparison tab to edit the scenarios comparison template.
- In the Subject field, enter the subject for your letter.
- Use the editor to create an email for the Eligibility Letter or Scenarios Comparison that is emailed to borrowers when an eligibility letter or scenario comparison is sent from the Scenario Comparison Tool.
- To add a custom field to the letter, select Insert Custom Field <>. This option is used to automatically populate the message with specific fields from the scenario data.
- Select a field name to insert into the letter, and then select Add. When the letter is sent, these fields display the details from the specific scenario.
- When you are finished editing the letter. Select Save.
Encompass LO Connect Users can now check a borrower's eligibility for a specific loan scenario. When a user has selected one or more scenarios and is on the Scenario Comparison page, they can now select the Check Eligibility button to determine if the borrower is eligible for the scenario. The user can then provide additional information about the borrower which is then used to check the borrower's eligibility based on the Affordability settings that the administrator has defined.
To Check Eligibility on a Scenario
-
From the Scenario Comparison page, select Check Eligibility on a scenario card.
-
The Check Eligibility window displays.
- Select Costs to enter loan costs information, and then select Update.
- Select Income to enter the borrower's monthly income details, and then select Update.
- Select Assets to enter the borrower's assent details, and then select Update.
- Select Liabilities to enter the borrower's monthly liability details, and then select Update.
-
Once all four section are updated, the Check Eligibility window indicates whether or not the borrower is eligible for this scenario.
- To send an eligibility letter to a borrower for a specific scenario, select Issue Eligibility Letter.
If the borrower is ineligible for a scenario you can use the new Cash-To-Close and Affordability tabs discussed below to identify the reason the borrower is ineligible.
Two new tabs have been added to the Scenario Comparison page in the Scenario Comparison Tool. These tabs provide more detailed information about the scenario as it relates to the cash to close required for the scenario and the housing and total debt ratios of the scenario.
Cash-To-Close
The Cash-To-Close tab displays the required funds to close the loan, the total cost of the loan compared to the loan amount, and available funds. If the total costs is less than the sum of the loan amount and the available funds, the card displays the surplus amount. If the total cost amount exceeds the sum of the loan amount and available funds, the card displays the shortage amount. This tab enables users to view the cash-to-close details for several scenarios at a glance.
Affordability
The Affordability tab displays the Housing Ratio (front-end debt to income) and the Total Debt Ratio (back-end debt to income) and compares that to the maximum allowed ratio as defined by the administrator. This tab enables users to clearly identify if a scenario is eligible based on the criteria defined by the administrator.
Note: A scenario is determined to be eligible when the affordability ratios are within the limits set by the administrator and the Cash-To-Close tab does not reflect a shortage.
Encompass LO Connect users can now create an opportunity from a loan file. If the loan is not already linked to an existing opportunity the user can create an opportunity that will use the information already entered in the loan.
To Create an Opportunity From a Loan File
- From the Encompass LO Connect Pipeline, select a loan.
-
On the Loan Summary bar, select the ... menu.
- Select Create Opportunity.
-
On the confirmation message, select Yes.
-
The Create Opportunity window displays.
Note: The Total Bank Deposits field (Encompass field 979) and the Other Income section on the 4. Monthly Income & Combined Housing Expenses page are not carried over to an opportunity that is created from a loan.
A new Opportunity Dashboard is available for individual opportunities in the Scenario Comparison Tool. When a user selects an opportunity from the Opportunities page, the new dashboard displays information about the scenario so that the user can review the opportunity details at a glance.
The Opportunity Dashboard groups information in several sections and provides quick actions to evaluate and adjust scenarios.
Personal Info
The Personal Info section displays the following:
- Primary borrower's email address
- Primary borrower's mobile phone number
- Credit Score
Property Info
The Property Info section displays the following:
- Property Address
- Loan Purpose
- Purchase Price
- Down Payment
- Loan Amount
- Property Value
Loan Info
The Loan Info section displays the following:
- Lien Position Type
- Occupancy Type
- Property Type
Editing and Deleting an Opportunity
Users can edit or delete an opportunity from the Opportunity dashboard. To edit the opportunity, select the Edit icon. To delete the opportunity, select the Delete icon.
Additional Actions
The right panel on the Opportunity Dashboard provides additional actions for the user to interact with the scenario.
Add New Scenario - Select the Add New Scenario button to return to the Product and Pricing results page and add new scenarios to the opportunity.
Compare & Check Eligibility - This action displays the number of scenarios attached to the opportunity. Select the Compare & Check Eligibility button to open the Scenario Comparison page. A green check mark indicates that the income information has been entered.
Income - This action opens the Borrower Monthly Income window which enables the user to enter the borrower's income information to determine eligibility. A green check mark indicates that the income information has been entered.
Liabilities - This action opens the Monthly Liabilities window which enables the user to enter the borrower's monthly liability information to determine eligibility. A green check mark indicates that the income information has been entered.
Assets - This action opens the Assets window which enables the user to enter the borrower's cash deposits, bank accounts, and stocks and bonds information to determine eligibility.
Documents - The documents action displays the number of letters sent for this opportunity. Select the Documents button to view the letters associated with this opportunity.
Features and Enhancements
Two new scripting objects have been exposed in the Ellie Mae Scripting Framework and are available for Custom Forms, Custom Tools, and Plugins.
Available for Custom Forms, Custom Tools, and Plugins:
-
Http Object - The Http object provides APIs to make call-outs to external systems via HTTPS. By exposing this object from the host, it ensures that the call will bear the "Origin" header of the host application. This is critical for situations where the guest's code is running in a strict-mode sandbox (where the "allowSameOrigin" flag is false).
Available for Custom Forms and Plugins:
-
Session Object - The Session object provides session-level state storage for a guest application. Each guest's state is isolated from all others based on a unique identifier for the guest (e.g. an extension ID or Form ID). This object is provided in contexts where sandboxing will not allow the guest app to access the sessionStorage of the browser.
For a reference on all available Ellie Mae Scripting Objects, refer to the Encompass Web Customization Developer's Guide. (An Encompass Developer Connect user account is required to access this guide in the LO Connect Developer Portal.)
Three Loan Object methods are now available for Custom Forms and Plugins in Ellie Mae Scripting Framework. Previously, these methods were only available for Custom Tools:
-
merge()
- Syncs the loan workspace with any changes made by other users. -
isReadOnly()
- Indicates if the loan is editable or in a read-only state. -
calculate()
- Executes calculations and business rules.
For a reference on all available Ellie Mae Scripting Objects, refer to the Encompass Web Customization Developer's Guide. (An Encompass Developer Connect user account is required to access this guide in the LO Connect Developer Portal.)
The navigation panel has been updated to replace the previous Input Forms section with the new Customization section. The new Customization section is comprised of the following three LO Connect extensions:
- Custom Forms
- Custom Tools
- Plugins
A new Subordinate Mortgage Loan Amounts window is available in Encompass LO Connect. This new window serves as a centralized dashboard that provides a comprehensive view of all financing associated with the subject property and easy access to the component subordinate financing fields. The window is accessed by clicking the Sub. Financing button on forms such as the Borrower Summary Origination, Borrower Summary Processing, and the Loan Application (2. Mortgage Type, Loan Terms, Property & Title).
The new Subordinate Mortgage Loan Amounts window contains the following sections, which enable users to track subordinate financing data related to the current loan.
-
Mortgage and HELOC Liabilities
-
Loan linked to current transaction
-
New Financing not Linked to Current Transaction
-
Total Financing for Subject Property
-
Total Ratios for Subject Property
This section displays existing mortgages and liabilities associated with the subject property. The columns in the table provide quick access to detailed information from the Liability records. Liabilities display in this section when they have an Account Type of Mortgage or HELOC and when the Subject Property check box is selected in the VOL record.
This section enables a user to view any loans that have been linked to the current transaction in Encompass Smart Client. The section lists the loan’s Encompass Loan Number, the Total Loan Amount (Encompass field 2), the Initial Draw (Encompass field 1888) if the loan is a HELOC loan, The Lien Position Type (Encompass field 420) and the Lien Position (Encompass field 4494). These fields are read-only and are populated from the linked loan file.
This section enables manual entry of loans that are in process with another lender during the origination of the current loan, including new closed end primary and subordinate mortgage amounts, and new HELOC draw and limit amounts.
-
Record first lien mortgages in the New Closed End Primary Mortgage amount (Encompass field 4487). These amounts are included in the Closed End Primary Mortgage amount (Encompass field 427) listed in the Total Financing for Subject Property section. An example of this use case would be a lender who is issuing a simultaneous second to be closed with a first lien from another lender. The other lender’s first lien, which is not yet a liability, is documented in New Closed End Primary Mortgage.
-
Record second through fourth lien mortgages in the New Closed End Subordinate Mortgage (Encompass field 4488). These amounts are included in the Closed End Subordinate Mortgage amount (Encompass field 428) listed in the Total Financing for Subject Property section. An example of this use case would be a lender who is issuing a first lien with a simultaneous second to be closed from another lender. The other lender’s lien, which is not yet a liability, is documented in New Closed End Subordinate Mortgage.
-
Record HELOC draws and credit limits in the New HELOC Draw / Credit Limit amounts (Encompass fields 4489 and 4490). The draw amount should be entered in the first box, and the total credit line should be entered in the credit limit box. These amounts are included in the appropriate Total Open End (HELOC) Draw Amount (Encompass field CASASRN.X167) and Total Open End (HELOC) Credit Limit (Encompass field CASASRN.X168) fields in the Total Financing for Subject Property section.
This section includes the following calculated totals for subject property financing:
-
Existing Liens Paid Off (Encompass field 26)
- First Mortgage Total (Encompass field 427)
-
Closed End Second Mortgage Total (Encompass field 428)
-
Total Open End (HELOC) Drawn Amounts (Encompass field CASASRSN.X167)
-
Total Open End (HELOC) Credit Limit (Encompass field CASASRSN.X168) – The total of the credit limit from liabilities, the HELOC Credit Limit for loans not linked (field ID 4490), and the loan amount for any Piggyback loans.
This section displays the total LTV, LTV, and HCLTV ratios for the subject property.
- LTV (Encompass field 353) –With the exception of USDA or refinance loans, the LTV (Loan-To-Value) ratio is calculated by dividing the total loan amount (Encompass field 2) by the purchase price (Encompass field 136) or appraised value (Encompass field 356), whichever is lower. For USDA or refinance loans, the LTV (Loan-To-Value) ratio is calculated by dividing the loan amount by the appraised value (Encompass field 356). For 203(K) loans, the LTV (Loan-To-Value) ratio is representative of the Case LTV. See the FHA 203(K) worksheet for details.
-
CLTV (Encompass field 976).
- HCLTV (Encompass field 1540).
In 19.1, a new Services Landing page was introduced for Encompass LO Connect desktop and tablet users. With this release, the cards that were added for each category now present more data to users.
Service Order Cards
The Services landing page displays service order cards that represent the different services that can be ordered from within Encompass LO Connect. With the 19.2 release, cards exist for services can be currently ordered by users. These services include Credit, Automated Underwriting System, and Product and Pricing. Service order cards also exist for services which have providers that will be available in the upcoming months. Currently these service cards include Appraisal and Verification. When new providers are available, they will not be accessible by users until they have been configured in the Services Management settings in the Encompass Admin Portal. Additional information on service order cards will be provided as service providers become available in the future.
Current Loan Data Tab
The Current Loan Data tab displays data that comes from fields on the loan. For example, the Credit service card displays the credit scores for Experian, TransUnion, Equifax, and the Middle FICO Score if they are available. By default, if a user launches the Services landing page and no orders are recorded for a service, the Current Loan Data tab displays.
If a user launches the Services landing page and there are orders for a service category, the Orders tab displays.
Orders Tab
The Orders tab displays information about any orders that are pending or processed. If documents are returned from the vendor, the user can select the Document icon. The user can also select the Menu icon to view additional actions. For example, on the Credit service card the user can select the Menu icon and view details of the order and import liabilities from the report.
Note: When there are multiple credit or AUS orders, all orders will provide the ability to view the document returned from the vendor, but only the most recent orders provide the ability to view report details and, for credit, import liabilities.
To provide similar functionality to Encompass Smart Client, a new Apply Loan Templates menu is available. After you start a loan, use the Apply Loan Template menu to change the loan template set or the closing cost template for the loan.
To Use The Apply Loan Template Set Option on Desktop And Tablet
-
From an existing loan, select the ... menu.
-
Select Apply Loan Templates, and then select Apply Loan Template Set.
-
On the Select Loan Template Set window, select the new template that you want to apply.
-
To append the data from that template, and overwrite existing data in those fields, select Options and then select the Append template data check box.
Note: This option is enabled by default.
- Select Apply.
To Use The Apply Loan Template Set Option on Mobile
-
From an existing loan, select the menu and then select Apply Loan Templates.
-
On the Apply Loan Templates menu, select Loan Template Set.
-
On the Select Loan Template Set window, select the new template that you want to apply.
-
To append the data from that template, and overwrite existing data in those fields, select Options and then select the Append template data check box.
Note: This option is enabled by default.
- Select Apply.
To Use The Apply Closing Cost Template Option on Desktop And Tablet
-
From an existing loan, select the ... menu.
-
Select Apply Loan Templates, and then select Apply Closing Cost Template.
-
On the Select Closing Cost Template window, select the new template that you want to apply.
-
To apply only template fields which contain values, select Options and then select the Only apply template fields which contain values check box.
Note: This option is enabled by default.
- Select Apply.
To Use The Closing Cost Template Option on Mobile
-
From an existing loan, select the menu and then select Apply Loan Templates.
-
On the Apply Loan Templates menu, select Closing Cost Template.
-
On the Select Closing Cost Template window, select the new template that you want to apply.
-
To apply only template fields which contain values, select Options and then select the Only apply template fields which contain values check box.
Note: This option is enabled by default.
- Select Apply.
Closing Cost Template Limitation
Users can only apply Closing Cost Templates that apply to the 2015 Itemization.
Fixed Issue
Why we made these updates: The following issue was fixed to improve usability and to help ensure Encompass LO Connect is operating as expected. The issues that are chosen to be fixed are based on the severity of their impact to clients and client feedback.
An issue was discovered where Field Data Entry business rules that run advanced coding with a "Fail" message, would display the following error:
One or more prerequisite fields are missing. See prerequisite fields property in response. Advanced Code Definition execution failed.
Users who received this error message were unable to make any changes to the missing fields and could not move ahead with the loan. This issue has been resolved and now when a user is missing required fields they can enter data in those fields in a pop up window.
An issue was discovered with field data entry business rules that triggered from the Subject Property State field (Encompass field 14) which prevented the user from entering the required data if the Subject Property State field was auto-populated. For example, if the administrator had a business rule that required that the user enter data in one or more fields once they have entered the subject property state, and the user entered the zip code for the subject property and then selected the city details from the Select a City pop-up, the user was unable to fill in the required fields as the Business Rules Requirements window did not display. This issue prevented the user from entering data in the required fields. This issue has been fixed and now users can fill in the required fields as expected.
An issue was discovered where administrators were sometimes unable to enter, edit, and save credentials for Optimal Blue in the Encompass Admin Portal. This has been fixed and now administrators can save Optimal Blue credentials as expected.
An issue was discovered where the password field would clear when the user selected Remember Me after the user had entered their credentials for some services. This has been fixed, and now when a user enters their credentials and selects Remember Me, the user's credentials are saved.