Compartilhar via


Criar uma tabela virtual usando o Excel no Microsoft Dataverse

Crie uma tabela virtual para integrar dados de um arquivo do Excel localizado no OneDrive para usar como uma fonte de dados externa que representa perfeitamente esses dados como tabelas no Microsoft Dataverse. As tabelas virtuais permitem exibir, criar e editar dados externos sem replicá-los no Dataverse.

Pré-requisitos

  • Uma licença do Microsoft Dataverse por meio do Power Apps ou do Microsoft Dynamics 365. As licenças do Microsoft 365 ou do Teams não podem ser usadas para criar tabelas virtuais.
  • O arquivo do Excel que você usa como uma fonte de dados deve ser armazenado no OneDrive.
  • O arquivo do Excel deve conter dados formatados como uma tabela.
  • O arquivo do Excel deve conter uma coluna GUID. Mais informações: Criar a conexão para o provedor de conector virtual do Excel

Baixar e instalar o provedor de conectores virtuais para Excel

  1. Faça download e instale o conector virtual. Vá para o marketplace comercial da Microsoft e procure o Virtual Connector ou selecione o link para fazer download do provedor: Conectores virtuais no Dataverse

    Conectores virtuais no Dataverse

  2. Selecione Instale agora. No diálogo de início de sessão, digite o email de conta corporativa ou de estudante. Selecione Continuar caso concorde com os termos e condições. O centro de administração do Power Platform é aberto automaticamente.

  3. Selecione o ambiente em que deseja instalar a solução. Selecione Instalar caso concorde com os termos e condições. Quando a instalação estiver concluída, você verá o aplicativo dos aplicativos dos Conectores virtuais no Dataverse instalado em Ambientes -> [nome do seu ambiente] -> aplicativos Dynamics 365.

    Selecione o ambiente para instalar o conector

  4. Você também deve ver a solução Provedor de conector virtual e outras soluções habilitadas no ambiente do Power Platform.

    Solução Provedor de conector virtual

Crie a conexão para o provedor de conector virtual do Excel

Assista a um vídeo curto que mostra como criar uma tabela virtual com o provedor de conector virtual do Excel.

  1. Vá para o Power Apps (make.powerapps.com) e selecione o ambiente em que deseja configurar a tabela virtual.
  2. No painel de navegação à esquerda, selecione Conexões e Nova conexão. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
  3. Selecione Conector Virtual do Microsoft Excel Online (Business) na lista de conexões.
  4. Será solicitado que você forneça detalhes adicionais para se conectar à fonte de dados.
  5. Selecionar Criar, suas credenciais de login atuais serão usadas. Conectar ao Excel

Criar a referência de conexão

Você deve criar sua própria referência de conexão ao usar o provedor de conectores virtuais do Excel.

  1. Acesse Soluções.

  2. Selecione a Solução padrão ou qualquer outra solução existente que você tenha em seu ambiente para criar a tabela virtual.

  3. Selecione Novo e, em seguida, selecione Referência de Conexão.

  4. Digite o Nome de Exibição, selecione a conexão que você criou para a opção Conectores e então selecione a conexão de dados que criou.

    Nova referência de conexão

Criar a fonte de dados

Agora crie a fonte de dados da tabela virtual no Dataverse.

Observação

  • Quando você usa o provedor de conector virtual do Excel, uma tabela Catálogo de Entidades é gerada pelo sistema que fornece uma lista de todas as tabelas disponíveis usando as definições de tabela (metadados) do externo fonte de dados. O catálogo de entidades não mantém informações e sempre representa o estado atual da fonte de dados externa. Você pode selecionar tabelas do catálogo de entidades para criar tabelas virtuais. Se você estiver trabalhando com várias fontes de dados externas, um catálogo de entidades será gerado para cada fonte externa. Mais informações: Catálogo de entidade
  1. Selecione o ícone de Engrenagem -> Configurações Avançadas.

    Comando Configurações avançadas

  2. Na barra de navegação superior, selecione Configurações e depois Administração.

    Navegue até administração do sistema

  3. Selecione Fontes de dados da entidade virtual.

    Configurações de fontes de dados da entidade virtual

  4. Selecione Nova. Na caixa de diálogo pop-up, selecione o Provedor de dados do conector virtual.

    Nova Fonte de dados

    Selecione Provedor de Conector Virtual

  5. Nomeie sua Fonte de dados e selecione a Referência de conexão que você criou na lista suspensa.

    Insira um Nome para a fonte de dados e selecione a referência de conexão

    Adicione o valor do seu conjunto de dados

  6. Cole o nome do arquivo incluindo a extensão no Valor do Conjunto de Dados. Lembre-se que o arquivo deve estar no OneDrive que foi usado para a configuração da conexão. (por exemplo: SampleData.xlsx)

  7. Selecione Salvar.

Catálogo de entidades

Com a referência de conexão e a configuração da fonte de dados da tabela virtual, um Catálogo de Entidades é gerado automaticamente. O Catálogo de Entidades é específico para a fonte de dados e listará todas as tabelas que estão na respectivo fonte de dados.

Entidade de Catálogo

Observação

  • A criação do catálogo de entidades é um processo assíncrono. Dependendo do seu ambiente, isso pode levar alguns minutos.
  • As tabelas exibidas no catálogo de entidades não são tabelas virtuais em si. Você precisa selecionar nesta lista de tabelas que representam os dados externos para criar a tabela virtual no Dataverse.

Dica

Se a criação do catálogo de entidades for demorada, você poderá verificar o status de conclusão do trabalho navegando até a exibição Configurações -> Trabalhos do Sistema.

Exibir o catálogo de entidades

  • Selecionar Dados>Tabelas e selecione o catálogo de entidades que foi criado.

  • Selecionar Localização avançada e usar o Procurar:. O catálogo inclui um prefixo Entidade de Catálogo para seguido pela referência de conexão (exemplo: Entidade de Catálogo para Adventure Works). Encontre o catálogo de entidades para sua respectiva conexão de dados e selecione Resultados para exibir todas as tabelas de fonte de dados externas.

    Localização de avançada de catálogo de tabela

    Observação

    Não há suporte para a criação em lotes de tabelas virtuais no momento. Embora o catálogo de entidades permita selecionar várias tabelas, você terá que selecionar uma tabela por vez para criar tabelas virtuais.

  1. Para criar uma tabela virtual, um aplicativo baseado em modelo deve ser criado para o catálogo de entidades. Selecione a tabela do catálogo de entidades.

  2. Selecione Criar um aplicativo na navegação superior.

    Catálogo de entidades com uma tabela selecionada, visualização de tabela

  3. Dê um nome ao aplicativo e selecione Criar.

    Tela Criar um aplicativo baseado em modelo

    O aplicativo é gerado automaticamente usando a tabela do catálogo de entidades.

  4. Quando o aplicativo estiver concluído, você pode selecionar Publicar para concluir o aplicativo e usá-lo mais tarde, ou Executar para criar sua tabela virtual agora sem publicar o aplicativo.

    Aplicativo baseado em modelo concluído

    Todas as tabelas do arquivo do Excel serão fornecidas na exibição do aplicativo.

  5. Selecione o conjunto de dados que deseja usar no catálogo de entidades e, em seguida, selecione Editar na barra de navegação.

    Exibição do Catálogo de Entidades do aplicativo baseado em modelo com um conjunto de dados selecionado

    Aguarde o carregamento completo do formulário antes de editar. Quando carregado, o formulário fica assim:

    Formulário de edição do Catálogo de Entidades todos os campos em branco

  6. No formulário fornecido, defina a coluna Criar ou Atualizar Entidade como Sim.

  7. Selecione a Chave primária e o Campo primário da entidade virtual usando as listas suspensas para localizar as colunas que você deseja usar.

    Formulário de edição do Catálogo de Entidades todos os campos preenchidos

  8. Salve o registro para criar a tabela virtual.

    Observação

    Após a conclusão do salvamento, o formulário será "redefinido" com todos os campos em branco; isso é normal.

  9. Volte para a home page do Power Apps e selecione Dados. Sua tabela virtual agora é criada com um prefixo "Entidade personalizada". Pode levar alguns instantes para a conclusão da criação.

    Maker Portal com tabela virtual selecionada

Importante

  • O provedor mapeia automaticamente a chave primária associada à fonte de dados externa ao criar a tabela virtual. Todas as operações de CRUD podem ser executadas na tabela virtual gerada.
  • Todas as colunas nos dados externos são mapeadas automaticamente para tipos do Dataverse que são compatíveis com o conector. Você pode revisar os detalhes da tabela virtual e fazer alterações navegando até Configurações -> Personalização – Entidades.
  • As tabelas virtuais exigem que haja pelo menos um campo de cadeia de caracteres para usar como a coluna Nome principal.

Depois de criar uma tabela virtual, você pode trabalhar com ela da mesma maneira que qualquer outra tabela. Você pode começar a definir os relacionamentos com outras tabelas no ambiente e usá-los em seus fluxos do Power Apps e Power Automate.

Criar tabelas virtuais usando o provedor de conectores virtuais