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

Uma tabela virtual é uma tabela personalizada no Microsoft Dataverse que tem colunas contendo dados de uma fonte de dados externa. As tabelas virtuais aparecem em seu aplicativo para os usuários como linhas de tabela regulares, mas contêm dados provenientes de um banco de dados externo, como um Banco de Dados SQL do Azure. Linhas baseadas em tabelas virtuais estão disponíveis em todos os clientes, incluindo clientes personalizados desenvolvidos usando os serviços Web 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 tabelas virtuais, você pode se conectar diretamente com uma fonte de dados externa em tempo de execução para que dados específicos da fonte de dados externa estejam disponíveis em um ambiente, sem a necessidade de replicação de dados.

As tabelas virtuais são compostas por três componentes principais, um provedor de dados, uma linha de fonte de dados e uma tabela virtual. O provedor de dados consiste em plug-ins e uma tabela de fonte de dados. A fonte de dados é uma linha de tabela no Dataverse, que inclui metadados que representam o esquema dos parâmetros de conexão. Cada tabela virtual faz referência a uma fonte de dados na definição da tabela.

O Dataverse inclui um provedor de dados OData que você pode usar para se conectar a um serviço Web OData v4 que acessa os 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. Para obter mais informações: Documentação do desenvolvedor: Introdução às tabelas virtuais

Benefícios da mesa virtual

• Os desenvolvedores podem implementar plug-ins para ler, atualizar ou excluir dados externos usando os serviços Web Dataverse e a ferramenta de registro de plug-ins.
• Os personalizadores de sistema usam o gerenciador de soluções do Power Apps para configurar a linha da fonte de dados e criar tabelas virtuais que são usadas para acessar dados externos sem escrever nenhum código.
• Os utilizadores finais trabalham com as linhas criadas pela tabela virtual para visualizar os dados em colunas, grelhas, resultados de pesquisa e relatórios e painéis baseados em Fetch XML.

Adicionar uma fonte de dados para usar em tabelas virtuais

Os desenvolvedores criam um plug-in personalizado para usar como provedor 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>Avançadas.

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

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

4. Na caixa de diálogo Selecionar Provedor de Dados, selecione uma das seguintes fontes de dados e selecione OK.

   Provedor de dados	Description
   Provedor 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 desenvolvedor: Introdução às tabelas virtuais
   Provedor de dados OData v4	O Dataverse inclui um provedor de dados OData que pode ser usado com serviços Web OData v4. Mais informações Configuração, requisitos e práticas recomendadas do provedor de dados OData v4

Adicionar uma coluna segura a uma fonte de dados

Você cria colunas para uma Fonte de Dados da mesma forma que qualquer outra tabela. Para dados criptografados ou confidenciais, habilite o atributo Segredo da Fonte de Dados na coluna personalizada da Fonte de Dados. Por exemplo, para proteger uma coluna que contém uma cadeia de conexão de banco de dados.

Criar uma tabela virtual

Você cria uma tabela virtual como qualquer outra tabela no Dataverse com a adição de alguns atributos extras descritos aqui. As tabelas virtuais devem ser criadas usando o gerenciador de soluções.

Abra o explorador de soluções

Parte do nome de qualquer tabela virtual criada é o prefixo de personalização. Isto é definido com base no fabricante de soluções para a solução em que está a trabalhar. Se você se preocupa com o prefixo de personalização, certifique-se de que está trabalhando em uma solução não gerenciada onde o prefixo de personalização é o desejado para esta tabela virtual. Para mais informações: Mudar o prefixo do publicador da solução

Abrir uma solução não gerida

1. No Power Apps , selecione Soluções no painel de navegação esquerdo e, na barra de ferramentas, selecione Alternar para clássico. 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 gerenciada desejada.

Criar uma tabela virtual

1. No gerenciador 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.

   

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

   Campo	Description
   Nome Externo	Insira o nome da tabela na fonte de dados externa para a qual esta tabela é mapeada.
   Nome da Coleção Externa	Insira o nome plural da tabela na fonte de dados externa para a qual esta tabela é mapeada.

   Aqui está um exemplo de uma tabela virtual chamada Movie que usa um provedor de dados do Azure Cosmos DB para acessar arquivos de documentos.

   

   Importante

   Várias opções, como Access Teams, Queues e Quick Create, não estão disponíveis com tabelas virtuais. Mais informações Considerações ao usar tabelas virtuais

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

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

   Campo	Description
   Nome Externo	Normalmente, esse é o nome exclusivo para identificar os dados que você deseja exibir na coluna.
   Nome do 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. Esse valor inserido é usado para determinar qual item de escolha exibir no aplicativo.

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

5. Selecione Salvar e Fechar na página de propriedades da 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 ao usar tabelas virtuais

As mesas virtuais têm essas restrições.

• As tabelas existentes não podem ser convertidas em tabelas virtuais.
• Por padrão, as tabelas virtuais contêm apenas uma coluna Nome e Id. Nenhuma outra coluna gerenciada pelo sistema, como Status ou Created On/Modified On é suportada.
• As tabelas virtuais não suportam colunas personalizadas com os tipos de dados Moeda, Imagem ou Cliente.
• As tabelas virtuais não suportam 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.
• Painéis e gráficos não são suportados com tabelas virtuais.
• Muitos recursos que afetam as linhas da tabela não podem ser habilitados com tabelas virtuais. Os exemplos incluem filas, gerenciamento de conhecimento, SLAs, deteção de duplicatas, controle de alterações, capacidade offline móvel, segurança de coluna, pesquisa Dataverse e soluções Power Pages.
• As tabelas virtuais pertencem à organização e não suportam os conceitos de segurança do Dataverse em 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 validam na atualização não se aplicam a tabelas virtuais. Por exemplo, uma coluna Número Inteiro em uma coluna de tabela virtual pode ser definida para ter um valor mínimo de zero. No entanto, como o valor é proveniente de uma fonte de dados externa, uma consulta retornará valores menores que zero quando recuperada 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 oferecem suporte ao controle de alterações e não podem ser sincronizadas usando um recurso Dataverse, como o Serviço de Exportação de Dados ou o Azure Synapse Link for Dataverse.
• As tabelas virtuais que usam o provedor de dados OData v4 incluído são habilitadas na porta de saída 443.
• Os fluxos do processo de negócios 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 Mensagem: System.Web.HttpUnhandledException: Exceção do tipo 'System.Web.HttpUnhandledException' foi lançada. ---> Microsoft.Crm.CrmException: O fluxo de processo empresarial não pode ser ativado para a Entidade Virtual

Esse problema ocorre porque as tabelas virtuais não oferecem suporte a fluxos de processos de negócios.

Consulte também

Requisitos e práticas
Criar e editar tabelas
Configurar tabelas virtuais no Power Pages