Upgrading to Multi-Structure Support

Version 2.0.0 of the Hover Salesforce integration adds multi-structure support. A single Hover job can hold several structures, such as a house plus a detached garage. Salesforce now tracks each structure separately, with its own deliverable, reconstruction state, measurements, and estimates.

This article covers what changes, what to check before you upgrade, and the steps to finish after you install.

What changes

• New Hover Model object. Each structure on a Hover job is saved as a Hover Model record (Hover_Model__c) related to its Hover Job. Hover Models are created and updated automatically from Hover's model webhooks.
• Measurements move to Hover Model. When a structure finishes reconstructing, its roof and siding measurements are written to that structure's Hover Model record. The legacy measurement fields on Hover Job are still present but are no longer updated.
• Estimates are linked to structures. Hover Estimates, Hover Estimate Line Items, and Adjustments now include a Hover Model lookup alongside the Hover Job lookup.
• The HOVER_Job_Complete__e platform event has been removed. Anything listening for it will stop receiving it.

For the full list of changes, see the v2.0.0 entry in the Release Notes.

Before you upgrade

1. Find anything that reads job-level measurements. Check reports, dashboards, flows, page layouts, and any external integrations that use the roof or siding measurement fields on Hover Job. After the upgrade, point them at the matching fields on Hover Model instead.
2. Find anything that listens for HOVER_Job_Complete__e. Check flows, triggers, and external subscribers. Rebuild them to use Hover Model state changes instead.
3. Write down your current Hover Config settings. Go to Setup → Custom Settings → Hover Config → Manage, and record the Default Organization Level Value for each setting. You'll check them again after the upgrade.
4. Upgrade a sandbox first. Work through this whole article in a sandbox before you upgrade production.

Install the upgrade

Install Hover 2.0.0 using the package installation link from the Installation Instructions article. Your existing Hover Jobs and Hover Estimates are kept.

After you upgrade

Work through each step below in every org you upgrade.

Step 1: Grant Apex class access

Confirm that every Apex class whose name starts with Hover can be accessed from both of these:

• The Hover permission set: Setup → Permission Sets → Hover → Apex Class Access.
• The guest user of the Salesforce Site that receives Hover webhooks: Setup → Sites → your site → Public Access Settings → Enabled Apex Class Access.

Make sure both include these classes, which are new in 2.0.0:

Step 2: Check external credential access for estimates

Confirm that the Hover permission set can reach the Hover GraphQL external credential. Estimates can't sync without it.

1. Go to Setup → Permission Sets → Hover → External Credential Principal Access.
2. Confirm that the principal for the Hover GraphQL external credential (usually HoverGraphql) is enabled.
3. If it isn't listed, click Edit, add it, and save.

Step 3: Confirm your custom settings

Go to Setup → Custom Settings → Hover Config → Manage. Check that each setting in the Default Organization Level Value matches the values you wrote down before the upgrade.

For more detail on each setting, see the Custom Settings article.

Step 4: Add the new components to your pages (optional)

The upgrade adds a default Hover Model record page and adds a Hover Models related list to the Hover Job record page. If you use your own custom record pages, add these components in Lightning App Builder:

• Hover Model Measurements (hoverModelMeasurements): roof and siding measurements for one structure. Add it to the Hover Model record page.
• Hover PDF Link (hoverPDFLink): now also works on Hover Model records and opens that structure's measurements PDF.

Step 5: Verify with a test job

1. Open the Hover Jobs tab, go to a list view, and click Create Test Job. This creates a Hover test job with three structures and links it to a new Hover Job record.
2. After a short wait, confirm that the new Hover Job has three Hover Model records in its Hover Models related list.
3. Open each Hover Model and confirm its measurements have filled in once its state is complete.

Note: You can only create multi-structure test jobs from the parent (authenticated) Hover org, meaning the org whose Hover user authorized the Salesforce connection. Test jobs can't be created at the suborg level.

Troubleshooting