# Dynamics 365

O conector **Dynamics 365** permite integrações com o produto [Microsoft Dynamics 365](https://www.microsoft.com/en-us/dynamics-365) CRM. Ele possibilita consultar, criar, atualizar ou excluir dados armazenados no Dataverse, o banco de dados utilizado pelo Dynamics 365 CRM.

## **Parâmetros**

Configure o conector usando os parâmetros abaixo. Os campos que suportam [expressões Double Braces](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/double-braces) são marcados na coluna **Suporta DB**.

{% tabs fullWidth="true" %}
{% tab title="General" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Alias</strong></td><td>Nome (alias) para a saída deste conector, permitindo que você a referencie posteriormente no fluxo usando expressões Double Braces. <a href="../../double-braces/how-to-reference-data-using-double-braces/previous-steps-access">Saiba mais</a>.</td><td>String</td><td>✅</td><td><code>dynamics-1</code></td></tr><tr><td><strong>Fail on Error</strong></td><td>Se habilitado, interrompe a execução do pipeline ao ocorrer um erro. Se desabilitado, a execução continua, mas a propriedade <code>"success"</code> será definida como <code>false</code>.</td><td>Boolean</td><td>❌</td><td></td></tr></tbody></table>
{% endtab %}

{% tab title="Authentication" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Valor padrão</th></tr></thead><tbody><tr><td><strong>BaseURL</strong></td><td>URL da instância do Dynamics 365.</td><td>String</td><td>✅</td><td><code>https://org10ac0015.crm2.dynamics.com</code></td></tr><tr><td><strong>Dynamics Azure Account</strong></td><td>Conta que contém as credenciais do Azure AD para o Dynamics 365. Tipo compatível: <a href="https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/platform-administration/settings/accounts#azure-key"><strong>Azure Key</strong></a>.</td><td>Conta</td><td>❌</td><td>N/A</td></tr></tbody></table>
{% endtab %}

{% tab title="Dynamics API" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Valor padrão</th></tr></thead><tbody><tr><td><strong>API Version</strong></td><td>Versão da Web API do Dynamics 365 a ser usada.</td><td>String</td><td>✅</td><td><code>9.2</code></td></tr><tr><td><strong>HTTP Method</strong></td><td>Método HTTP da solicitação para o Dynamics 365. Método compatível: <code>GET</code>,<code>POST</code>  </td><td>Select</td><td>❌</td><td><code>GET</code></td></tr><tr><td><strong>Entity Name</strong></td><td>Entidade com a qual interagir no Dynamics 365 (por exemplo, <strong>account</strong> ou <strong>contact</strong>). Dependendo do método e da entidade, campos adicionais de configuração podem aparecer. Exibido apenas após autenticação bem-sucedida.</td><td>Select</td><td>❌</td><td>N/A</td></tr><tr><td><strong>Interactive Mode (<code>POST</code>)</strong></td><td>Quando ativado, exibe campos adicionais no formulário para ajudar a montar a solicitação. Quando desativado, é necessário inserir manualmente o JSON bruto.</td><td>Boolean</td><td>❌</td><td>false</td></tr><tr><td><strong>Body (<code>POST</code>)</strong></td><td>Conteúdo JSON da solicitação.</td><td>json</td><td>✅</td><td>N/A</td></tr></tbody></table>
{% endtab %}

{% tab title="Advanced Settings" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Valor padrão</th></tr></thead><tbody><tr><td><strong>Request timeout (seconds)</strong></td><td>Tempo máximo de espera para solicitações HTTP à API do Dynamics 365.</td><td>Integer</td><td>❌</td><td><code>30</code></td></tr></tbody></table>
{% endtab %}

{% tab title="Documentation" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Documentation</strong></td><td>Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes.</td><td>String</td><td>❌</td><td>N/A</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## **Informações adicionais dos parâmetros**

### **Requisições `GET`**

Ao realizar requisições `GET`, o conector oferece suporte a dois modos de consulta:

* **OData**: Permite a recuperação simples de dados usando consultas baseadas em URL.
* **FetchXML**: Permite consultas avançadas por meio de uma linguagem baseada em XML, semelhante ao SQL.

Esses modos de consulta não estão disponíveis quando o parâmetro **Entity ID** é informado.

### **Requisições `POST`**&#x20;

Ao realizar requisições POST, o conector oferece duas formas principais de definir os dados do registro:

* **Body:** Permite ao usuário inserir manualmente um objeto JSON contendo os campos específicos e seus respectivos valores.
* **Interact Mode**: Gera automaticamente os campos disponíveis, permitindo que o usuário adicione apenas os valores para cada um deles.