Passo a passo da entidade virtual do provedor de dados OData v4

  • Artigo

Imagine que você deseja acessar, criar, atualizar e excluir algumas informações pessoais sobre um contato de um fonte de dados externos em seu aplicativo de negócios personalizado. Como a fonte de dados usada para este passo a passo tem um serviço Web OData v4, podemos usar o Provedor de Dados OData v4 incluído em sua versão do Dynamics 365 Customer Engagement. Mais informações: Passo a passo da tabela virtual usando o 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: Passo a passo da tabela virtual

Sobre este passo a passo da entidade virtual

Imagine que você deseja acessar informações do tíquete de uma fonte de dados externa dentro de seu aplicativo de negócios personalizado ou da área Serviço do Customer Engagement. Neste passo a passo simples, você modelará uma entidade virtual com campos mapeados para o esquema externo que recupera dados do tíquete no tempo de execução de um serviço Web do OData.

Detalhes da fonte de dados:

Como a fonte de dados usada para este passo a passo tem um serviço Web OData v4, podemos usar o Provedor de Dados OData v4 incluído em seu ambiente.

Url do serviços Web: https://contosowebservice.azurewebsites.net/odata/

Importante

A URL de serviço Web usada neste passo a passo não é um serviço Web funcional.

Para este passo a passo, é necessário uma entidade virtual única que contenha os três campos a seguir.

Nome do campo externo Tipo de dados externos Tipo de dados da entidade virtual Objetivo
TicketID Edm.Guid Chave primária Chave primária da entidade
Título Edm.String Linha Única de Texto Título do tíquete
Gravidade Edm.Int32 Número Inteiro Numere o valor de 0 a 4 indicando a gravidade do tíquete

Os metadados OData da entidade do tíquete da fonte de dados externa vistos de um navegador da Web.

Metadados da entidade do tíquete.

Criar a Fonte de Dados

Crie a fonte de dados do provedor de dados OData v4 que usa o serviço Web de exemplo do Protocolo Open Data OASIS (OData).

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

Selecione NOVO, Provedor de Dados OData v4 e, em seguida, OK.

Insira ou selecione as informações a seguir.

  • Nome: Fonte de Dados de Exemplo do Contoso
  • URL: https://contosowebservice.azurewebsites.net/odata
  • Tempo limite: 30
  • Retornar contagem embutida: Verdadeiro

Deixe os outros campos como estão e selecione SALVAR E FECHAR.

Dica

Ao usar o seu próprio serviço Web, verifique se a URL é válida colando-a no navegador da Web.

Criar a entidade virtual

Vá para Configurações>Personalizações>Personalizar o Sistema.

No painel de navegação esquerdo, selecione Entidades e, em seguida, Nova no painel principal.

No formulário Entidade: Nova selecione a opção Entidade Virtual e insira as seguintes informações:

  • Fonte de Dados: fonte de dados de exemplo do Contoso
  • Nome de Exibição: Tíquete
  • Nome no Plural: Tíquetes
  • Nome: new_ticket
  • Nome Externo: Tíquete
  • Nome da Coleção Externa: Tíquetes
  • Selecione para habilitar as seguintes opções de comunicação e colaboração:
    • Anotações (inclui anexos)
    • Atividades

Próximo às Áreas que mostram esta entidade, selecione Serviço e selecione Salvar (mas não fecha o formulário da entidade).

Definição da entidade do tíquete.

Criar os campos da entidade virtual

No painel de navegação esquerdo da página Entidade: Tíquete, selecione Campos. Como parte deste passo a passo, você editará dois campos existentes e adicionará um terceiro campo.

Importante

Nomes externos diferenciam maiúsculas e minúsculas. Consulte os metadados de serviço Web para certificar-se de usar o nome correto.

Um valor anulável ou falso indica que o atributo é exigido. Observe que os campos de chave primária são sempre exigidos pelo sistema.

Abra o campo new_ticketid e altere o seguinte atributo com o valor indicado aqui:

Nome Externo: TicketID

Campo TicketID.

Selecione Salvar e Fechar.

Abra o campo new_name e altere os seguintes atributos para ter os valores indicados aqui:

  • Nome de Exibição: Título
  • Nome Externo: Título

Campo de título.

Selecione Salvar e Fechar.

Selecione Novo e na página Campo: Novo para Tíquete insira as seguintes informações:

  • Nome de Exibição: Gravidade
  • Nome: new_severity
  • Nome Externo: Gravidade
  • Requisito do Campo: Requisito Comercial
  • Tipo de Dados: Número Inteiro
  • Valor Mínimo: 0
  • Valor Máximo: 4

Campo de gravidade.

Selecione Salvar e Fechar.

Adicionar os campos ao Formulário principal

Na janela de Entidade do tíquete, selecione Formulários.

Abra o formulário principal, arraste e solte o campo Gravidade do painel direito para o formulário na seção Geral sob o campo Título.

Campo da gravidade adicionado ao formulário principal.

Na janela de Entidade do tíquete, selecione Salvar e Fechar.

Configurar a exibição padrão

No painel esquerdo do Solution Explorer, em Entidade do tíquete selecione Exibições.

Abra a exibição Todos Tíquetes.

No painel Tarefas Comuns selecione Adicionar Colunas.

Adicionar colunas para exibição.

Selecione Gravidade e, em seguida, OK.

Na janela Exibir: Todos os Tíquetes selecione Salvar e Fechar.

Na janela Solution Explorer selecione Publicar Todas as Personalizações.

Publique todas as personalizações.

Após todas as personalizações serem publicadas, feche a janela Solution Explorer.

Exibir a entidade virtual em ação com o Dynamics 365 Customer Engagement (on-premises)

Vá para Serviço>Extensões>Tíquetes.

Área de tíquete.

A exibição Todos Tíquetes é exibida. Observe que talvez seja necessário atualizar seu navegador para exibir a entidade na área Serviço.

Exibição de Todos os Tíquetes.

Abra um registro de Tíquete para exibir o formulário que inclui os campos Título e Gravidade para o registro determinado.

Registro de tíquete.

Consulte também

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

Criar e editar entidades virtuais que contenham dados de uma fonte de dados externa