Dynamics 365

Saiba mais sobre o conector Dynamics 365 e como usá-lo na Digibee Integration Platform.

O conector Dynamics 365 permite integrações com o produto Microsoft 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 são marcados na coluna Suporta DB.

General

Parâmetro	Descrição	Tipo	Suporta DB	Padrão
Alias	Nome (alias) para a saída deste conector, permitindo que você a referencie posteriormente no fluxo usando expressões Double Braces. Saiba mais.	String	✅	dynamics-1
Fail on Error	Se habilitado, interrompe a execução do pipeline ao ocorrer um erro. Se desabilitado, a execução continua, mas a propriedade "success" será definida como false.	Boolean	❌

Authentication

Parâmetro	Descrição	Tipo	Suporta DB	Valor padrão	Visível quando
BaseURL	URL da instância do Dynamics 365.	String	✅	https://org10ac0015.crm2.dynamics.com	—
Use Dynamic Account	Se habilitado, o conector usa a conta de forma dinâmica via o conector Store Account; caso contrário, usa a conta estática configurada em Contas na Plataforma.	Boolean	❌	false	—
Scoped	Se habilitado, isola a conta armazenada de outros subprocessos. Não é suportado para contas usadas em headers ou body. Para saber mais, consulte a documentação de Dynamic Accounts.	Boolean	❌	false	Dynamic Account está habilitado
Account Name	Nome da conta definida no conector Store Account.	String	✅	N/A	Dynamic Account está habilitado
Dynamics Azure Account	Conta que contém as credenciais do Azure AD para o Dynamics 365. Tipo suportado: Azure Key.	Account	❌	N/A	Dynamic Account está desabilitado

Dynamics API

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

Advanced Settings

Parâmetro	Descrição	Tipo	Suporta DB	Valor padrão
Request timeout (seconds)	Tempo máximo de espera para solicitações HTTP à API do Dynamics 365.	Integer	❌	30

Documentation

Parâmetro	Descrição	Tipo	Suporta DB	Padrão
Documentation	Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes.	String	❌	N/A

Operações compatíveis

O conector Dynamics 365 oferece suporte a operações que seguem o padrão REST. É possível executar os seguintes métodos HTTP:

• GET: Recupera registros

• POST: Cria novos registros

• PATCH: Atualiza registros existentes

• DELETE: Remove registros do Dataverse

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 ou PATCH

Ao realizar requisições POST ou PATCH, 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.

• Interactive Mode: Gera automaticamente os campos disponíveis, permitindo que o usuário adicione apenas os valores para cada um deles.