Configuração, requisitos e práticas recomendadas do Provedor de Dados OData v4
Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Configuração do Provedor de Dados OData v4
Este tópico descreve como configurar o provedor de dados OData v4, bem como os requisitos e práticas recomendadas de uso do provedor de dados OData v4 para conectar-se com o serviço Web do OData v4.
Práticas recomendadas do provedor de dados OData v4
A sua instância requer que todas as entidades tenham um atributo de ID. Essa ID é conhecida como um identificador exclusivo e o valor deve ser um GUID. Só é possível mapear campos de ID para campos externos com o tipo de dados EDM.Guid. Não é possível mapear um tipo de dados EDM.Int32 para um campo de tipo de dados uniqueidentifer.
As entidades OData com propriedades nulas devem ser configuradas para corresponder ao campo mapeado na entidade virtual. Por exemplo, uma propriedade da entidade OData com Nullable=False deve ter o campo mapeado com o atributo Requisito do Campo definido como Requisito Comercial.
Para recuperar várias consultas, como quando você carrega dados em uma grade, controle o tamanho do conjunto de dados retornado da fonte de dados externa usando os parâmetros de consulta de seleção e filtro.
Caso ainda não tenha sido habilitado, os administradores do sistema devem habilitar o rastreamento de plug-in. Depois de habilitado, todos os erros do ponto de extremidade OData são capturados no log de rastreamento do plug-in. Mais informações: Caixa de diálogo Configurações do Sistema - guia Personalização
Mapeamento de tipo de dados
A tabela a seguir lista os mapeamentos de tipo de dados do EDM (Modelo de Dados de Entidade) OData com o tipo de dados apropriado.
| Tipo de Dados OData | Tipo de dados |
|---|---|
| Edm.Boolean | Duas Opções |
| Edm.DateTime | Data e Hora |
| Edm.DateTimeOffset | Data e Hora |
| Edm.Decimal | Número Decimal ou Moeda |
| Edm.Double | Número de Ponto Flutuante |
| Edm.Guid | Identificador Exclusivo |
| Edm.Int32 | Número Inteiro |
| Edm.Int64 | Número Inteiro |
| Edm.String | Linha Única de Texto ou Várias Linhas de Texto |
Tipos de dados EDM OData que não oferecem suporte para mapeamento com entidades virtuais
Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte
Adicionar uma fonte de dados usando o Provedor de Dados OData v4
Este procedimento mostra como usar o Provedor de Dados OData pronto para uso como o provedor de dados da entidade virtual.
Vá para Configurações>Administração>Fontes de Dados da Entidade Virtual.
Na barra de ferramentas de ações, selecione Novo.
Na caixa de diálogo Selecionar Provedor de Dados, selecione uma das fontes de dados a seguir e OK.
Provedor de Dados OData v4. Seu ambiente tem um provedor de dados Odata v4 que pode ser usado para conectar-se às fontes de dados que suportam o padrão aberto do OData v4.
Provedor de dados personalizado. Se você tiver importado um plug-in de provedor de dados, o provedor de dados aparecerá aqui. Mais informações: Introdução às entidades virtuais
Na página de propriedades Nova Fonte de Dados, preencha os campos a seguir e então salve o registro.
Nome.. Digite um nome que descreva a fonte de dados.
Uri. Se você estiver usando o Provedor de Dados OData, insira o uri do serviço Web OData. Por exemplo, se estiver usando o provedor OData para estabelecer conexão a um serviço Web hospedado no Azure, a URI pode ser semelhante a
https://contosodataservice.azurewebsites.net/odata/Tempo limite em segundos. Insira o número de segundos para aguardar por uma resposta do serviço Web antes do tempo limite da solicitação de dados. Por exemplo, insira 30 para aguardar até 30 segundos antes que o tempo limite ocorra.
Modo de Paginação. Selecione usar a paginação do cliente ou do servidor para controlar como os resultados de consulta são paginados. O valor padrão é paginação do cliente. Com uma paginação do servidor, o servidor controla como os resultados são paginados usando o parâmetro $skiptoken, que é adicionado à cadeia de consulta. Mais informações: Opção de consulta do sistema de token de omissão ($skiptoken)
- Retornar contagem embutida. Retorna o número total de registros no conjunto de resultados. Essa configuração é usada para habilitar a funcionalidade da página seguinte quando você retorna dados para uma grade. Use um valor falso se seu ponto de extremidade OData não suportar o parâmetro OData $inclinecount. O valor padrão é false.
Parâmetros da Solicitação. Opcionalmente, é possível adicionar parâmetros de cadeia de caracteres de cabeçalho ou de consulta personalizados usados na conexão com o serviço Web OData, como os parâmetros de autenticação no serviço externo. Selecione Cadeia de Consulta para alternar entre o parâmetro e o valor do cabeçalho e da string de consulta. Até 10 cadeias de caracteres de consulta ou de cabeçalho podem ser adicionadas.
Confira também
Criar e editar entidades virtuais que contenham dados de uma fonte de dados externa
TechNet Blog: Interagir com dados de sistemas externos usando as novas entidades virtuais