Partilhar via


Criar e editar tabelas virtuais que contêm dados a partir de uma origem de dados externa

Uma tabela virtual é uma tabela personalizada no Microsoft Dataverse que tem colunas que contêm dados provenientes de uma origem de dados externa. As tabelas virtuais são apresentadas na aplicação aos utilizadores sob a forma de linhas de tabelas normais, mas contêm dados com origem numa base de dados externa, tal como uma Base de Dados SQL do Azure. As linhas baseadas em tabelas virtuais estão disponíveis em todos os clientes, incluindo clientes personalizados desenvolvidos com os serviços Web do Dataverse.

No passado, para integrar as origens de dados diferentes, era necessário criar um conector para mover os dados ou desenvolver um plug-in personalizado, do lado do cliente ou do servidor. No entanto, com as tabelas virtuais é possível ligar diretamente com uma origem de dados externa em tempo de execução para que os dados específicos da origem de dados externa estejam disponíveis num ambiente, sem necessidade de duplicação de dados.

As tabelas virtuais são constituídas por três componentes principais, um fornecedor de dados, uma linha de origem de dados e uma tabela virtual. O fornecedor de dados é composto por plug-ins e uma tabela de origem de dados. A origem de dados é uma linha de tabela no Dataverse, que inclui metadados que representam o esquema dos parâmetros de ligação. Cada tabela virtual referencia uma origem de dados na definição da tabela.

O Dataverse inclui um Fornecedor de Dados OData que pode utilizar para estabelecer ligação com um serviço Web OData v4 que acede aos dados externos.

Alternativamente, os programadores podem criar os próprios fornecedores de dados. Os fornecedores de dados são instalados num ambiente como uma solução. Mais informações: Documentação do Programador: Começar a utilizar tabelas virtuais

Benefícios da tabela virtual

  • Os programadores podem implementar plug-ins para ler, atualizar ou eliminar dados externos com os serviços Web do Dataverse e a Plug-in Registration Tool.
  • Os personalizadores de sistema utilizam o explorador de soluções do Power Apps para configurar a linha de origem de dados e criar tabelas virtuais que são utilizadas para aceder a dados externos sem escrever qualquer código.
  • Os utilizadores finais trabalham com as linhas criadas pela tabela virtual para verem os dados nas colunas, grelhas, resultados da pesquisa e relatórios e dashboards baseados em Fetch XML.

Adicionar uma origem de dados a utilizar para tabela virtuais

Os programadores criam um plug-in personalizado para utilizar como fornecedor de dados para uma tabela virtual. Em alternativa, pode utilizar o Fornecedor de Dados OData v4 fornecido. Mais informações: Configuração, requisitos e melhores práticas do Fornecedor de dados OData v4

  1. Inicie sessão no Power Apps e, em seguida, selecione Definições > Definições avançadas.

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

  3. Na barra de ferramentas Ações, selecione Novo.

  4. Na caixa de diálogo Selecionar Fornecedor de Dados, selecione as seguintes origens de dados e, em seguida, selecione OK.

    Fornecedor de Dados Descrição
    Fornecedor de dados personalizado Se tiver importado um plug-in de fornecedor de dados, o fornecedor de dados será apresentado aqui. Mais informações Documentação do Programador: Começar a utilizar tabelas virtuais
    Fornecedor de Dados OData v4 Dataverse inclui um Fornecedor de Dados OData que pode ser utilizado com serviços web OData v4. Mais Informações: Configuração, requisitos e melhores práticas do Fornecedor de dados OData v4

Adicionar uma coluna protegida a uma Origem de Dados

Pode criar colunas para uma Origem de Dados da mesma forma que cria qualquer outra tabela. Para dados confidenciais ou encriptados, ative o atributo Origem de Dados Secreta na coluna personalizada da Origem de Dados. Por exemplo, para proteger uma coluna que contém uma cadeia de ligação à base de dados.

Nota

O atributo Origem de Dados Secreta só está disponível com colunas adicionadas a um formulário de Origem de Dados.

Atributo secreto da origem de dados.

Criar uma tabela virtual

Pode criar uma tabela virtual tal como cria qualquer outra tabela no Dataverse com o acréscimo de alguns atributos adicionais aqui descritos. As tabelas virtuais têm de ser criadas através do explorador de soluções.

Nota

Embora seja possível criar uma tabela virtual selecionando Nenhuma enquanto Origem de Dados, uma tabela virtual necessita de uma origem de dados para obter dados. Mais Informações: Adicionar uma origem de dados para utilizar para tabelas virtuais

Abra o explorador de soluções

A parte do nome de qualquer tabela virtual 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. Se estiver interessado em personalizar o prefixo, 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 virtual. 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 uma tabela virtual

  1. No explorador de soluções, crie uma nova tabela. Para tal, selecione Entidades no painel de navegação esquerdo e, em seguida, selecione Novo.

  2. No separador Geral de Definição da Entidade, selecione Entidade Virtual e, em seguida, na lista pendente Origem de Dados, selecione a origem de dados que pretende.

    Opção de tabela virtual na definição de tabela.

  3. Na Definição da Entidade, preencha as seguintes colunas obrigatórias.

    Campo Descrição
    Nome Externo Introduza o nome da tabela na origem de dados externa com a qual esta tabela estabelece o mapeamento.
    Nome da Coleção Externa Introduza o nome plural da tabela na origem de dados externa com a qual esta tabela estabelece o mapeamento.

    Segue-se um exemplo de uma tabela virtual denominada Filme que utiliza um fornecedor de dados Azure Cosmos DB para aceder a ficheiros de documento.

    Definição da tabela virtual utilizando o fornecedor de dados do Azure Cosmos DB.

    Importante

    Várias opções, como Equipas de Acesso, Filas e Criação Rápida, não estão disponíveis com tabelas virtuais. Mais Informações: Considerações quando utiliza tabelas virtuais

    Preencha as propriedades obrigatórias e opcionais adicionais, como nomes a apresentar e plural, conforme necessário. Para mais informações sobre estas propriedades, consulte Criar e editar tabelas.

  4. Crie e adicione uma ou mais colunas para a tabela virtual. Para além das propriedades de coluna padrão necessárias para criar uma coluna personalizada, estas propriedades opcionais estão disponíveis para cada coluna personalizada que criar para uma tabela virtual.

    Campo Descrição
    Nome Externo Normalmente, é o nome exclusivo para identificar os dados que pretende apresentar na coluna.
    Nome de Tipo Externo Se o tipo de coluna criado é OptionSet: esta propriedade mapeia para o nome externo do conjunto de valores no serviço externos para a escolha. Normalmente, isto pode ser uma enumeração ou nome de uma classe de valor de cadeia. O Nome de Tipo Externo pode ser utilizado quando é necessário um nome totalmente qualificado. Por exemplo, como o Nome do Tipo com OData em que os parâmetros de consulta precisam do nome completamente qualificado, como [Nome do Tipo].[Valor].
    Valor Externo Se o tipo de coluna criado é OptionSet: esta propriedade mapeia para o valor correspondente no serviço de dados externos para o item de escolha. Este valor introduzido é utilizado para determinar o item da escolha a apresentar na aplicação.

    Preencha as propriedades adicionais conforme necessário. Para mais informações sobre estas propriedades, consulte Criar e editar colunas.

  5. Selecione Guardar e Fechar na página de propriedades de Coluna.

  6. Na barra de ferramentas do Explorador de Soluções, selecione Guardar.

  7. Na barra de ferramentas do Explorador de Soluções, selecione Publicar.

  8. Feche o Explorador de Soluções.

Considerações quando utiliza tabelas virtuais

As tabelas virtuais tem estas restrições.

  • As tabelas existentes não podem ser convertidas em tabelas virtuais.
  • Por predefinição, as tabelas virtuais contêm apenas uma coluna Nome e ID. Não são suportadas quaisquer outras colunas geridas pelo sistema, tais como Estado ou Criado em/Modificado em.
  • As tabelas virtuais não suportam colunas personalizadas com os tipos de dados Moeda, Imagem ou Cliente.
  • As tabelas virtuais não suportam a auditoria.
  • Não é possível utilizar colunas de tabela virtual em rollups ou colunas calculadas.
  • Uma tabela virtual não pode ter um tipo de atividade de tabela.
  • Os dashboards e gráficos não são suportados com tabelas virtuais.
  • Muitas funcionalidades que afetam linhas de tabela de tabela não podem ser ativadas em tabela virtuais. Exemplos incluem filas, gestão de conhecimento, SLAs, deteção duplicada, controlo de alterações, capacidade móvel offline, segurança de colunas, pesquisa do Dataverse e soluções do Power Pages.
  • As tabelas virtuais são propriedade de organização e não suportam os conceitos de segurança Dataverse ao nível de linha. Recomendamos que implemente o seu próprio modelo de segurança para a origem de dados externa.
  • As propriedades de metadados de coluna que são validadas durante a atualização não se aplicam a tabelas virtuais. Por exemplo, uma coluna de Número Inteiro numa coluna de tabela virtual pode ser definida a ter um valor mínimo do zero. No entanto, uma vez que o valor é proveniente de uma origem de dados externa, uma consulta irá devolver valores inferiores a zero quando obtida a partir de uma tabela virtual. A propriedade de valor mínimo não está implicada na consulta. Ainda assim, tem de filtrar os valores para serem maiores que 0, caso seja o que pretende.
  • As tabelas virtuais não suportam o controlo de alterações e não podem ser sincronizadas utilizando uma funcionalidade Dataverse, como o Serviço de Exportação de Dados ou o Azure Synapse Link for Dataverse.
  • As tabelas virtuais que utilizam o fornecedor de dados OData v4 incluído estão ativadas na porta de saída 443.
  • Os fluxos de processo empresarial não são suportados com tabelas virtuais. Mais informações: Erro inesperado recebido quando um utilizador ativa um fluxo de processo empresarial

Erro inesperado recebido quando um utilizador ativa um fluxo de processo empresarial

Quando um utilizador tenta ativar um fluxo de processo empresarial, pode receber uma mensagem "erro inesperado". Ao ver o ficheiro de registo, é apresentada a entrada de registo que se segue.

ErrorCode: 0x80040216 Message: System.Web.HttpUnhandledException: Exception of type 'System.Web.HttpUnhandledException' was thrown. ---> Microsoft.Crm.CrmException: O fluxo de processo empresarial não pode ser ativado para a Entidade Virtual

Este problema ocorre porque as tabelas virtuais não suportam fluxos de processo empresarial.

Consulte também

Configuração, requisitos e melhores práticas do Fornecedor de dados OData v4
Criar e editar tabelas
Configurar tabelas virtuais no Power Pages

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).