Configuração, requisitos e práticas recomendadas do Provedor de Dados OData v4

Aplica-se ao Dynamics 365 (online), versão 9.0

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 com o serviço Web do OData v4.

Práticas recomendadas do provedor de dados OData v4

  • Dynamics 365 requer que todas as entidades tenham um atributo 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 em Dynamics 365.

  • 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 Anulável=Falso deve ter o campo mapeado no atributo do Requisito do Campo do Dynamics 365 definido como Requisitos comerciais.

  • 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 de Modelo de Dados de Entidade (EDM) OData com os tipos de dados do Dynamics 365 Customer Engagement.

Tipo de Dados OData Tipo de dados Dynamics 365
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.

  1. Vá para Configurações > Administração > Fontes de Dados da Entidade Virtual.

  2. Na barra de ferramentas Ações, clique em Novo.

  3. Na caixa de diálogo Selecionar Provedor de Dados, selecione uma das fontes de dados a seguir e clique em OK.

    • Provedor de Dados OData v4. O Dynamics 365 inclui um provedor de dados OData v4 que pode ser usado para conexão com fontes de dados compatíveis com o padrão aberto 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

  4. 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 você estiver usando o provedor OData para se conectar a um serviço Web hospedado no Azure, o URI poderá ser semelhante a http://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 Ignorar token ($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. Clique em Cadeia de Caracteres de Consulta para alternar entre o parâmetro e o valor da cadeia de caracteres de consulta e de cabeçalho. Até 10 cadeias de caracteres de consulta ou de cabeçalho podem ser adicionadas.

    Registro de fonte de dados da entidade virtual

Veja também

Criar e editar entidades virtuais que contenham dados de uma fonte de dados externa
Blog TechNet: interaja com dados de sistemas externos usando as novas entidades virtuais