# DVRS - Dataverse

The DVRS data source in SCA provides access to contacts stored by **apps built on Microsoft Dataverse**, for example apps developed on **Microsoft Power Platform**. Contacts are queried via the **Dataverse API**, and are managed in your **Dataverse environment**.

#### App Configuration Parameters

**Defaults (**[**`SecContacts.Defaults`**](/documentation/app-configuration-policy-name-values-for-sca/sca-configuration-seccontacts.defaults.md)**):**

* [**DVRS\_Enabled**](/documentation/app-configuration-policy-name-values-for-sca/sca-configuration-seccontacts.defaults.md#enable-or-disable-features) → Enables or disables the DVRS data source.
* [**DVRS\_InitValue**](/documentation/app-configuration-policy-name-values-for-sca/sca-configuration-seccontacts.defaults.md#initial-value-set-by-default) → Defines the default state of the user’s switch in the app (on/off). This controls whether the data source is visible or hidden when the user first launches SCA.

**Service URLs (**[**`SecContacts.ServiceUrls`**](https://docs.secure-contacts.com/documentation/data-sources/pages/bf6qlzjqFL3ODEf6GONt#seccontacts.serviceurls)**):**

* [**SecContacts.ServiceUrls**](https://docs.secure-contacts.com/documentation/data-sources/pages/bf6qlzjqFL3ODEf6GONt#seccontacts.serviceurls) → Set this parameter to add the URL of your Dataverse environment.
* Using `ServiceUrls`, administrators can also configure:
  * 🆕Custom API filters to retrieve only relevant contacts
  * 🆕Splitting of Dataverse contacts into multiple separate SCA data sources (e.g., by business unit, department, or region)
* **Additional Steps:**
  * Download and install the custom table schema (contact us for details).

**Customization:**

* [**SecContacts.CustomDatasourceNames**](/documentation/app-configuration-policy-name-values-for-sca/sca-configuration-seccontacts.customdatasourcenames.md) → Assign friendly display names for the DVRS source.

#### Requirements to Access Dataverse Contacts

To access DVRS contacts in SCA, a user must have:

* An **appropriate Azure/M365 license assigned for Dataverse**
* **Authorized access to the contact entities in Dataverse**

#### Requirements for DVRS Contacts

Any DVRS contact to be shown in SCA **must have the following fields populated**:

1. **First name**
2. **Last name**
3. **Valid phone number**

**Note:** All eligible DVRS contacts that meet these requirements will appear in SCA

{% hint style="success" %}

* Each data source, including DVRS, can be **hidden by the user** if they do not want to see or use it.
* Hiding the DVRS data source does **not affect Caller Identification** — contacts from hidden sources will still resolve incoming calls.
* The DVRS data source is only available with the **Enterprise Edition** of SCA.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.secure-contacts.com/documentation/data-sources/dvrs-dataverse.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.