Criar novas entidades no CDS (Common Data Service) usando o Power QueryCreate new entities in the Common Data Service (CDS) using Power Query

Com a integração do Power Query, os desenvolvedores de aplicativos de negócios podem criar novas entidades no CDS (Common Data Service) com base em uma ampla variedade de fontes de dados.With the integration of Power Query, business app developers can create new entities in the Common Data Service (CDS) from a wide range of data sources.

O Common Data Service permite que os usuários armazenem e gerenciem com segurança dados em um conjunto de entidades padrão e personalizadas.The Common Data Service lets users securely store and manage data within a set of standard and custom entities. Uma entidade é um conjunto de campos usados para armazenar dados de maneira semelhante a uma tabela em um banco de dados.An entity is a set of fields used to store data, similar to a table within a database. Depois que os dados são armazenados no Common Data Service, é possível usar o Microsoft PowerApps para criar aplicativos avançados que usam os dados armazenados.Once the data is stored in the Common Data Service, you can use Microsoft PowerApps to build rich applications that use the stored data.

Com a integração ao Power Query, os desenvolvedores de aplicativos de negócios que usam o PowerApps podem criar novas entidades no Common Data Service com base em dados de fontes de dados externas, por exemplo, fontes de dados locais como os bancos de dados relacionais (SQL Server, IBM DB2 e assim por diante), arquivos do Excel, do Access e de texto, bem como serviços online como Salesforce, Banco de Dados SQL do Azure e Data Warehouse, APIs Web, feeds OData e muitas outras fontes.With Power Query integration, business app developers using PowerApps can create new entities in the Common Data Service based on data from external data sources, such as on-premises data sources like relational databases (SQL Server, IBM DB2, and so on), Excel, Access, and text files, as well as online services such as Salesforce, Azure SQL Database and Data Warehouse, Web APIs, OData feeds, and many more sources. Além da ampla variedade de fontes de dados à qual você poderá conectar-se, usar o Power Query também permitirá filtrar, transformar e combinar dados antes de carregá-los no Common Data Service.In addition to the wide array of data sources to which you can connect, using Power Query also lets you filter, transform, and combine data before loading it into the Common Data Service.

Nova entidade de dados

Habilitando o recurso de novas entidades do CDS com base no Power QueryEnabling the CDS New Entities from Power Query feature

Esse recurso está disponível no seu locatário do PowerApps, mas não está ativado por padrão.This feature is available in your PowerApps tenant, but is not turned on by default. Você pode habilitá-lo em web.powerapps.com.You can enable it in web.powerapps.com.

Observação: é possível criar novas entidades personalizadas somente nos bancos de dados que você criou.Note: You can create new custom entities only in databases that you have created.

No portal do PowerApps, siga as etapas abaixo para habilitar esse recurso:In the PowerApps portal, take the following steps to enable this feature:

  1. Acesse a guia Common Data Service > Entidades no painel de navegação esquerdo.Browse to the Common Data Service > Entities tab, in the left navigation pane.
  2. Na lista Entidades, selecione o menu suspenso Nova Entidade.From the Entities list, select the New Entity dropdown.
  3. Na lista que aparece no menu suspenso, selecione Novas entidades de dados (Technical Preview), conforme mostrado na imagem a seguir.From the list that appears in the dropdown menu, select New Entity from Data (Technical Preview) as shown in the following image.

    Nova entidade de dados

  4. Depois de selecionar Novas entidades de dados (Technical Preview) no menu, uma caixa de diálogo aparecerá com a lista dos conectores disponíveis nesta Technical Preview, conforme mostrado na imagem a seguir.Once you select New Entity from Data (Technical Preview) from the menu, a dialog appears with the list of available connectors in this Technical Preview, as shown in the following image.

    Conectores disponíveis

  5. Depois de selecionar o conector que deseja usar, você poderá prosseguir para as próximas etapas para especificar as credenciais e os detalhes da conexão da fonte de dados, selecionar as tabelas a serem importadas e assim por diante.Once you've selected the connector you want to use, you can continue to the next steps to specify data source connection details and credentials, select which tables to import, and so on. Você também poderá acessar o Editor de Consultas (usando o botão Editar na exibição Navegador) e, dessa forma, aplicar filtros ou etapas de transformação de dados antes de importar os dados para o CDS.You may be able to access the Query Editor as well (using the Edit button in the Navigator view) and thereby apply filters or data transformation steps before importing data into CDS.

Ajustar as configurações de carregamento e outros comportamentosAdjust load settings and other behavior

Depois de concluir as etapas da seção anterior e de preparar uma fonte de dados para ser usada para criar novas entidades no CDS usando o Power Query, você poderá ajustar configurações adicionais de carregamento, como o comportamento de atualização e as configurações específicas das entidades (como o Nome de Exibição, as Chaves Primárias, etc.).Once you've completed the steps in the previous section, and have a data source ready to use to create new entities in CDS using Power Query, you can adjust additional load settings, such as refresh behavior and entity-specific settings (such as Display Name, Primary Keys, and others).

Ao concluir essas etapas e selecionar Carregar, você criará novas entidades personalizadas no CDS.Once those steps are completed and you select Load, you will have created new custom entities in CDS. Você também poderá editar as consultas depois do carregamento inicial acessando o menu Entidade de uma entidade específica.You can also edit queries after the initial load by accessing the Entity menu for a specific entity.

Estamos muito empolgados com essa funcionalidade e ansiosos por receber os seus comentários.We're very excited about this functionality, and are eager to hear your feedback. Envie-nos seus comentários e sugestões sobre esse recurso!Please send us your suggestions and feedback about this feature!