Partilhar via

Procedimento da tabela virtual com o Fornecedor de Dados OData v4

  • Artigo

Imagine que pretende aceder, criar, atualizar e eliminar algumas informações pessoais sobre um contacto de uma origem de dados externa dentro da sua aplicação condicionada por modelo. Neste procedimento simples, poderá modelar uma tabela virtual chamada Pessoa com colunas mapeadas para um esquema externo a estas operações em runtime a partir de um serviço Web OData.

Detalhes da origem de dados

Como a origem de dados utilizada para este procedimento tem um serviço Web OData v4, podemos utilizar o Fornecedor de Dados OData v4 incluído com o seu ambiente.

URL do serviço Web: https://contosowebservice.azurewebsites.net/odata/

Importante

  • O serviço Web do url utilizado para este procedimento não é um serviço Web funcional.
  • Não é possível utilizar o Fornecedor de Dados OData v4 para se ligar a outro ambiente.

Para este procedimento, é necessária uma tabela virtual única que contém as seguintes colunas.

Nome da coluna externa Tipo de dados externos Tipo de dados de tabela virtual Finalidade
ID Edm.Guid Chave primária Chave primária para a tabela
FirstName Edm.String Uma linha de texto Nome próprio da pessoa
LastName Edm.String Uma linha de texto Apelido da pessoa
Antiguidade Edm.Int32 Número inteiro Idade da pessoa
LastModifiedOn Edm.DateTimeOffset Dados e hora Dados e hora da última modificação do registo da pessoa

Os metadados de OData da tabela de pessoa de origem de dados externos:

Parte 2 do XML da origem de dados externos OData.

Criar a origem de dados

Crie a origem de dados para o fornecedor de dados OData v4 que utiliza o serviço Web de exemplo do OASIS Open Data Protocol (OData).

  1. Aceda a Definições > Administração > Origens de Dados de Entidade Virtual.

  2. Selecione NOVO, selecione Fornecedor de Dados OData v4 e selecione OK.

  3. Introduza ou selecione as seguintes informações.

    Campo valor
    Nome Origem de dados OData de Exemplo da Pessoa
    URL https://contosowebservice.azurewebsites.net/odata
    Tempo limite 30
    Devolver Contagem Inline Paginação do lado do cliente
    Devolver Contagem Inline Verdadeiro

Deixe as outras colunas tal como estão e selecione GUARDAR E FECHAR.

Dica

Quando utiliza o próprio serviço Web, verifique se o URL é válido ao colá-lo no browser. Se quiser compreender as colunas e tipos de dados respetivos à tabela em que está interessado, pode anexar /$metadata ao final do seu URL para ver a definição de tabelas no seu serviço Web.

Abra o explorador de soluções

A parte do nome da tabela personalizada que criar é o prefixo de personalização. Isto é definido com base no fabricante de soluções para a solução em que está a trabalhar. Certifique-se de que está a trabalhar numa solução não gerida em que o prefixo de personalização é o pretendido para esta tabela. Mais informações: Alterar o prefixo do fabricante de soluções

Abrir uma solução não gerida

  1. No portal do Power Apps, selecione Soluções no painel de navegação esquerdo e, na barra de ferramentas, selecione Mudar para clássica. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.

  2. Na lista Todas as Soluções, abra a solução não gerida que pretende.

Criar a tabela virtual

  1. No painel de navegação esquerdo do explorador de soluções, selecione Entidades e selecione Novo no painel principal.

  2. No formulário Entidade: Nova, selecione a opção Tabela virtual e, em seguida, introduza as seguintes informações:

    Campo valor
    Origem de Dados Origem de dados OData de Exemplo da Pessoa
    Nome a Apres. Pessoa
    Nome Plural Pessoas
    Nome new_person
    Nome Externo Pessoas
    Nome da Coleção Externa Pessoas
    Notas (inclui anexos) selecionadas
    Atividades selecionadas

    Nota

    A semântica do caminho do recurso OData utiliza EntitySet para identificar o recurso. No serviço Web OData de exemplo, o EntitySet é definido como Pessoa. Este valor é utilizado como o Nome Externo para a Pessoa da tabela virtual.

  3. Junto a Áreas que apresentam esta entidade, selecione Vendas e, em seguida, selecione Guardar (mas não feche o formulário da tabela). Definição da tabela de pessoa.

Criar as colunas para a tabela virtual

No painel de navegação esquerdo da página Entidade: Pessoa, selecione Campos. Como parte desta orientação, irá editar duas colunas existentes e adicionar mais três colunas que estão disponíveis na origem de dados externos.

Importante

Os nomes externos são sensíveis a maiúsculas e minúsculas. Consulte os metadados do serviço Web para se certificar de que utiliza o nome correto. Um valor Anulável Falso indica que o atributo é obrigatório. Tenha em atenção que colunas chave primárias são sempre exigidas pelo sistema.

  1. Abra a coluna new_personid e altere a seguinte propriedade com o valor aqui indicado:

    Nome Externo: ID

    Criar coluna de ID.

  2. Selecione Guardar e Fechar.

  3. Abra a coluna new_name e altere as seguintes propriedades para ter os valores aqui indicados:

    • Nome a Apresentar: Apelido
    • Nome Externo: LastName

    Criar coluna de apelido.

  4. Selecione Guardar e Fechar.

  5. Selecione Novo e, na página Campo: Novo para Pessoa, introduza as seguintes informações:

    Campo valor
    Nome a Apres. Nome Próprio
    Nome new_firstname
    Nome Externo FirstName
    Requisito de Campo Campo Necessário
    Tipo de Dados Uma Linha de Texto

    Criar coluna de idade para pessoa.

  6. Selecione Guardar e Fechar.

  7. Selecione Novo e, na página Campo: Novo para Pessoa, introduza as seguintes informações:

    Campo valor
    Nome a Apres. Antiguidade
    Nome new_age
    Nome Externo Antiguidade
    Requisito de Campo Campo Necessário
    Tipo de Dados Número Inteiro

    Criar coluna de idade.

  8. Selecione Guardar e Fechar.

  9. Selecione Novo e, na página Campo: Novo para Pessoa, introduza as seguintes informações:

    Campo valor
    Nome a Apres. Última Modificação Em
    Nome new_lastmodifiedon
    Nome Externo LastModifiedOn
    Requisito de Campo Campo Necessário
    Tipo de Dados Data e Hora

    Criar coluna de última modificação.

Adicionar as colunas ao formulário principal

  1. Na janela da tabela Pessoa, selecione Formulários.

  2. Abra o formulário principal, arraste e largue as colunas Nome Próprio, Idade e Última Modificação Em do painel direito para o formulário na secção Geral.

    Colunas Nome próprio, Idade e Última modificação em adicionadas ao formulário principal.

  3. Na janela da tabela Pessoa, selecione Guardar e Fechar.

Configurar a vista predefinida

  1. No painel esquerdo do explorador de soluções, na Entidade Pessoa, selecione Vistas.
  2. Abra a vista Todas as Pessoas.
  3. No painel Tarefas Comuns, selecione Adicionar Colunas. Adicionar colunas à vista.
  4. Selecione as colunas Nome Próprio, Idade e Última Modificação Em e, em seguida, selecione OK.
  5. Na janela Vista: Todas as Pessoas, organize a ordem das colunas selecionando as setas de mover para a esquerda e para a direita e, em seguida, selecione Guardar e Fechar.
  6. Na janela Explorador de Soluções, selecione Publicar Todas as Personalizações.
  7. Depois de publicadas todas as personalizações, feche a janela Explorador de Soluções.

Utilizar a tabela virtual numa aplicação condicionada por modelo

Crie uma aplicação condicionada por modelo e adicione a tabela Pessoa ao mapa do site. Em seguida, selecione o formulário principal de Pessoa e a vista Localização Avançada de Pessoa. Publicar a aplicação. Mais informações: Criar a primeira aplicação condicionar por modelo do zero

Em seguida, os utilizadores da aplicação podem efetuar as operações ler, criar, atualizar e eliminar utilizando a tabela virtual, tal como qualquer outra tabela no Microsoft Dataverse.

Criar, ver e eliminar registos utilizando a tabela virtual

  1. Executar a aplicação condicionada por modelo. Selecione Novo, preencha as colunas necessárias e, em seguida, guarde o registo.
  2. Selecione Novo novamente para criar outro registo e guardá-lo.
  3. Deve agora ter dois registos semelhantes aos seguintes na vista Todas as Pessoas. Ver Todas as Pessoas.
  4. Para eliminar um registo, selecione um registo pessoal e, em seguida, selecione Eliminar. Confirme a eliminação do registo na página de confirmação.

Consulte também

Configuração, requisitos e melhores práticas do Fornecedor de dados OData v4
Criar e editar tabelas virtuais que contêm dados a partir de uma origem de dados externa

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).