Skip to main content
The Omni integration connects Validio to your Omni dashboards, workbooks, and queries for catalog and lineage tracking. The integration does not perform any updates or edits to Omni.
An Omni dashboard with the Validio browser extension panel open beside it

Omni Dashboard with Validio Browser Extension Panel

​
Prerequisites for integrating with Omni

To connect Validio with your Omni instance, create an API key. You have two authorization options: Organization keys or Personal tokens.

​
Omni organization keys

Organization keys require Omni Admin permissions to create and access the API keys. The organization keys provide access to the full Omni catalog, including workbooks and dashboards. Refer to Omni documentation for creating organization keys.
You can scope down which resources are ingested into Validio by using the User field in the Validio credentials configuration. Set the field to the email of a user in Omni, and then only resources that the user has access to will be ingested.

​
Omni personal tokens

Personal tokens are API keys tied a single Omni user and only provides access to Omni resources that the specific user has access to.
When using personal tokens, the User field in the Validio credential configuration must be left empty.

​
Add an Omni credential

To add a Omni credential in Validio,
  1. Navigate to Credentials, and click + New credential.
  2. Under Namespace, select a namespace to define where resources will be created and who can access it.
  3. Under Credential Type, select Omni.
  4. Fill in the Configuration parameters for the credential. For more information, see Omni Credential Parameters.
  5. (Optional) Click Test credential to validate that Validio can successfully access the Omni account. If validation fails, check that you provided the correct parameter values.
  6. Click Create credential.
Validio automatically starts fetching data. BI tool credentials are always enabled for catalog, so there is no catalog option to configure. You can view Omni assets and their relationships on the Catalog and Lineage pages.

​
Omni credential parameters

​
View Omni assets in Catalog and Lineage

Validio adds the discovered Omni assets to Data Catalog and Data Lineage. To find your Omni assets, navigate to Catalog > Assets and apply the Type filter for the Omni asset types:
  • Omni Dashboard
  • Omni Workbook
  • Omni Query
Click an asset row to open the information sidebar, or click the asset name to open the asset details page. To open the lineage graph anchored on that asset, click View asset lineage in the sidebar.
The Validio lineage graph showing Omni dashboard, workbook, and query assets and their upstream tables

Omni Assets in Validio Lineage

BI Tool Assets and SourcesValidio BI tool integrations are only credentials, and you cannot use them to create sources or convert their assets to sources.
For more information, see Catalog Assets and Using Lineage.

​
Browser extension support

If you have the Validio Browser Extension installed, you can easily access data quality and lineage information directly from within your Omni workflow. The extension will automatically detect when you are in an Omni dashboard and provide a link to the corresponding entry in Validio’s Data Catalog page.