# Domo

DOMO is business intelligence software that offers a wide range of data analytics capabilities. Using the DOMO Connector, existing Dashboards can be pulled and used as Report Groups in the OvalEdge application.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe8BpdD39yFL6oIROSgw-eHd4AIprHM3Q1d_csjGi-XkI5EsiyFILjyYyhC0Q1mkG09RFXs-LfjX1aQEdWT3azBmdVdsIsoPQeNr32RTsIrG6NBC7nJ5BV7A8p6JIZks17uhRGuu_Qg0NPTe_ZHWib8ul4b?key=eJNF2pM7py_1AVWA5Dm9Gg" alt=""><figcaption></figcaption></figure>

| This connector document should be used along with the [Generic Features of Connectors](https://docs.google.com/document/d/1MEkP-GCznqJHLlV6mxrBd-dOMyBNa5cT_-fHDAglFsc/edit#heading=h.oquwqsluppiz) document which covers the generic features and settings (Establishing Connection, Connector Parameters, Connector Settings, etc.) of the OvalEdge connectors that are common. This document outlines the specific connector information only. |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

### Connector Characteristics

| Connector Category                           | Report      |
| -------------------------------------------- | ----------- |
| Connectivity                                 | <p><br></p> |
| Connector Version                            | <p><br></p> |
| Sisense Versions Supported                   | <p><br></p> |
| OvalEdge Releases Supported (Available from) | <p><br></p> |

### Supported Features

| <p>Crawling</p><p><br></p>                                                                                                                                            | Report Groups, Reports, and Report Columns |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| Lineage                                                                                                                                                               | Not Supported                              |
| Profiling                                                                                                                                                             | Not Supported                              |
| Crawling of Query Logs                                                                                                                                                | Not Supported                              |
| Data Preview                                                                                                                                                          | Supported                                  |
| <p>Data Quality Module</p><p>More info on DQ: <a href="https://docs.google.com/document/u/0/d/1I_F7aKv_QSVw1A1FWvEyMSZADueOVhfCnLAQDfwctGc/edit">Data Quality</a></p> | Supported                                  |
| <p>RDAM (Remote Data Access Management) Support</p><p>More info: <a href="https://support.ovaledge.com/snowflake-rdam">RDAM</a></p>                                   | Not Supported                              |
| Bridge Support                                                                                                                                                        | Supported                                  |
| <p>Query Sheet Support </p><p>(Run simple queries)</p>                                                                                                                | Not Supported                              |
| Crawl of Usage Statistics (Source System)                                                                                                                             | Not Supported                              |
| Certifications at Source (Source System)                                                                                                                              | Not Supported                              |

### Prerequisites (Prepare Sisense Environment)

The following are the prerequisites required for establishing a connection:&#x20;

* #### API Details

The API version used by the connector is given below:&#x20;

| S.No | Version | API Details                        |
| ---- | ------- | ---------------------------------- |
| 1    | v1      | <https://developer.domo.com/login> |

* #### Service Account Minimum Permissions&#x20;

| Operation   | Minimum Access Permission |
| ----------- | ------------------------- |
| <p><br></p> | <p><br></p>               |
| <p><br></p> | <p><br></p>               |
| <p><br></p> | <p><br></p>               |
| <p><br></p> | <p><br></p>               |

#### Configure Environment Variables (Optional)

This section describes the settings or instructions you should know before establishing a connection. If your environments have been configured, skip this step.

For more information, refer to the "[Generic Features of Connectors](https://docs.google.com/document/d/1MEkP-GCznqJHLlV6mxrBd-dOMyBNa5cT_-fHDAglFsc/edit#heading=h.oquwqsluppiz)" document.

### DOMO-Specific Parameters

| Field Name    | Description                                                                                                                                                               |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Client id     | <p>Enter the Client id, which you have copied from the Manage Clients Page.</p><p>Example:</p><p>Client ID</p><p>a4dd7994-a7b3-47d5-xxxx-xxxxxxxxfd7</p>                  |
| Client Secret | <p>Enter the Client Secret, which you have copied from the Manage Clients Page.</p><p>Example:</p><p>Secret</p><p>435d68ee13f3a0a31de4f0exxxxxxxxxxxxxxxxxxxxxxxxxxxx</p> |
| Scopes        | <p>Enter the Scopes, which you have copied from the Manage Clients Page.</p><p>Example:</p><p>Scopes</p><p>Data, workflow, audit, buzz, user, account, dashboard</p>      |
| Base URL      | <p>Enter the instance where the DOMO is running.</p><p>Example: <a href="https://shiva-dev-442568.domo.com/"><https://shiva-dev-442568.domo.com></a></p>                  |
| User Name     | Enter the Name to connect to the DOMO.                                                                                                                                    |
| Password      | Enter the Password to connect to the DOMO.                                                                                                                                |

### Connector Settings

The following are the Sisense Connector settings:

* Crawler
* Access Instruction
* Business Glossary Settings
* Lineage
* Others

### Limitations

| S.No. | Description |
| ----- | ----------- |
| 1     |             |

### Errors & Resolution

| S.No. | Error Message(s)      | Error Description/Resolution                                                                                                                                                                                                                                                                          |
| ----- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1     | Authentication Errors | <p>Error Description: Errors related to invalid credentials or expired tokens.</p><p>Resolution: </p><p>Verify that your credentials (username, password, API key) are correct and up to date. If using OAuth, ensure that the token has not expired and re-authenticate if necessary.</p>            |
| 2     | Data Format Errors    | <p>Error Description: Data retrieved from the source does not match the expected format.</p><p>Resolution: </p><p>Ensure that the data source schema has not changed. Validate the data format and update the connector configuration to handle the new format if necessary.</p>                      |
| 3     | Parsing Errors        | <p>Error Description: Issues with parsing the data retrieved from the source.</p><p>Resolution: </p><p>Ensure the data format is compatible with the connector. Implement error handling to manage unexpected data formats. Update the connector code if necessary to handle new data structures.</p> |

### FAQs

Q1: How much does the driver cost?

A: The JDBC Driver for Sisense is available at no additional charge.

Q2: Can I use the driver to access Sisense from a Linux system?

A: Yes! You can use the driver to access Sisense from Linux, Unix, and other non-Windows platforms.

### Planned upgrades

| S.No.                  | Expected Date | Upgrade Version | Description |
| ---------------------- | ------------- | --------------- | ----------- |
| NONE planned as of now |               |                 |             |

### Client creation process for the DOMO instance

1. Navigate to <https://developer.domo.com/login> website.
2. Enter the Domain mentioned in the above screenshot and click on the Continue button. The Documentation page will then be displayed.
3. On the Documentation page, click on My Account and select the New Client option. The Create New Client page will then be displayed.
4. In the Create new client page, enter the Name and Description and click the Create button. The Manage Clients page is displayed with the Client ID, Secret, and Scopes.

Note: Save the Client ID, Secret, and Scopes details for further use.
