Site Validation Guide

The One Model Site Validation tool provides Admin users a way to review the configuration of your company’s One Model instance. Admins, Data Engineers, and One Model teams use the Site Validation page to view the list of errors and warnings in the different components of your site, and find possible solutions to address those warnings and resolve errors. This is an especially useful page to review after making changes to your One Model instance. 

Admins with the permission CanViewSiteValidation will find the Site Validation page under the Admin tab of the main navigation bar. 

Site Validation page

Admins can drill into the Validations for each component, review the messages then click on the Action icon to review next steps. The following table lists all of the components available in Site Validation and the primary manager of that component, whether One Model or your company Admin. 

** Note** if Admins (or one their team members e.g. data analyst) work in their own processing script, the responsibility for these features would be shared between them and their data engineer.

Using Site Validation

To access Site Validation: 

1. Ensure you have the permission  CanViewSiteValidation enabled
2. Click the Admin tab in the top navigation bar to open the dropdown menu, 
3. Scroll down the menu then click on Site Validation to open the Site Validation page. 

Once in the Site Validation page, scroll down to view the list then click on the Validation tab for more information.  A message box will appear with details about any errors or warnings along with options to fix or resolve. 

Clicking this button displays a detailed list of all errors or warnings associated with that feature.

Type:

Errors mean there is an issue that could break functionality, or would likely cause unexpected/wrong results.

Warnings mean there could be an issue that shouldn’t break functionality, but might cause performance problems or similar.

Message:

Messages describe what exactly is causing the error or warning. 

Actions:

Takes you to the specific page where you can make the modification to correct the error or warning.

Takes you to the storyboard where the query needing modification is located.

Provides you with a list of the invalid nodes(s).

If your site is not set up to automatically cache site validation results (confirm this on the Admin > Company page), clicking the refresh button will update the Site Validation page so it shows the most up to date errors and messages. This button should also be clicked after making changes to confirm if the change you made fixed the error or warning. 

Process using a Metrics example

If we look at Metrics, we can see that there are 9 errors and 0 warnings. 

If we click Validations, this opens the messages box.

Next, if we select the following message,

And then click on the icon in the Actions column, it will bring us to the Build/Edit Metric page.

From here, we can review the error and take steps to rectify and resolve. In this case, the suggested action is to save the metric. But, before we do, we should check for invalid filters and review the filters in case something has changed in the underlying dimension. 

Click the save icon in the left hand menu. 

Go back to the Site Validation page. Refresh the Site Validation page by clicking the Refresh icon at the top right of the page. Your resolved error should not be listed.

** Tip ** Ensure the Cache Site Validation Results checkbox is enabled so that the Company cache will automatically refresh in the background to keep your instance up to date with the most recent data. 

Common Messages - for Admins

Metrics:

* When editing a metric in Explore, there may be a message stating ‘Invalid filters were found, and were not included in this Metric. Saving will remove the invalid filters and prevent this message from appearing.’

 Before you hit the save button, we recommend that you review your filters.

Storyboards:

Security Rules:

Drill Through Columns: