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

Uma entidade virtual é uma entidade personalizada no Common Data Service que tem campos que contêm dados provenientes de uma origem de dados externa. As entidades virtuais são apresentadas na aplicação aos utilizadores sob a forma de registos de entidades normais, mas contêm dados com origem numa base de dados externa, tal como uma Base de Dados SQL do Azure. Os registos baseados em entidades virtuais estão disponíveis em todos os clientes, incluindo clientes personalizados desenvolvidos com os serviços Web do Common Data Service.

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 entidades 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 entidades virtuais são constituídas por três componentes principais, um fornecedor de dados, um registo de origem de dados e uma entidade virtual. O fornecedor de dados é composto por plug-ins e uma entidade de origem de dados. A origem de dados é um registo de entidade no Common Data Service, que inclui metadados que representam o esquema dos parâmetros de ligação. Cada entidade virtual referencia uma origem de dados na definição da entidade.

O Common Data Service 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 entidades virtuais

Diagrama de entidade virtual

Vantagens da entidade virtual

  • Os programadores podem implementar plug-ins para lerem dados externos com os serviços Web do Common Data Service e a ferramenta Registo do Plug-in.
  • Os personalizadores de sistema utilizam o explorador de soluções do Power Apps para configurar o registo de origem de dados e criar entidades virtuais que são utilizadas para aceder a dados externos sem escrever qualquer código.
  • Os utilizadores finais trabalham com os registos criados pela entidade virtual para verem os dados nos campos, grelhas, resultados da pesquisa e relatórios e dashboards baseados em Fetch XML.

Adicionar uma origem de dados para utilizar para entidades virtuais

Os programadores criam um plug-in personalizado para utilizar como fornecedor de dados para uma entidade 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. Aceda a Definições > Administração > Origens de Dados de Entidade Virtual.

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

  3. 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 entidades virtuais
    Fornecedor de Dados OData v4 Common Data Service 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 um campo protegido a uma Origem de Dados

Pode criar campos para uma Origem de Dados da mesma que cria campos para qualquer outra entidade. Para dados confidenciais ou encriptados, ative o atributo Origem de Dados Secreta no campo personalizado da Origem de Dados. Por exemplo, para proteger um campo que contém uma cadeia de ligação à base de dados.

Note

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

Atributo secreto da origem de dados

Criar uma entidade virtual

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

Note

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

Abra o explorador de soluções

A parte do nome de qualquer entidade virtual 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. 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 entidade virtual. Mais informações: Alterar o prefixo do fabricante de soluções

  1. No portal do Power Apps, selecione Soluções e, na barra de ferramentas, selecione Mudar para clássica.

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

Criar uma entidade virtual

  1. No explorador de soluções, crie uma nova entidade. 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 Entidade Virtual na definição da entidade

  3. Na Definição da Entidade, preencha os seguintes campos obrigatórios.

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

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

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

    Important

    Várias opções, como Equipas de Acesso, Filas e Criação Rápida, não estão disponíveis com entidades virtuais. Mais Informações: Considerações quando utiliza entidades 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 entidades.

  4. Crie e adicione um ou mais campos para a entidade virtual. Para além das propriedades de campo padrão necessárias para criar um campo personalizado, estas propriedades opcionais estão disponíveis para cada campo personalizado que criar para uma entidade virtual.

    Campo Descrição
    Nome Externo Normalmente, é o nome exclusivo para identificar os dados que pretende apresentar no campo.
    Nome de Tipo Externo Se o tipo de campo criado é OptionSet: esta propriedade mapeia para o nome externo do conjunto de valores no serviço externos para o conjunto de opções. 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 campo criado é OptionSet: esta propriedade mapeia para o valor correspondente no serviço de dados externos para o conjunto de opções. Este valor introduzido é utilizado para determinar o item do conjunto de opções a apresentar na aplicação.

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

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

  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 entidades virtuais

As entidades virtuais tem estas restrições.

  • Todas as entidades virtuais são só de leitura.
  • As entidades existentes não podem ser convertidas para entidades virtuais.
  • Por predefinição, as entidades virtuais contêm apenas um campo Nome e ID. Não são suportados quaisquer outros campos geridos pelo sistema, tais como Estado ou Criado em/Modificado em.
  • As entidades virtuais não suportam campos personalizados com os tipos de dados Moeda, Imagem ou Cliente.
  • As entidades virtuais não suportam a auditoria.
  • Não não possível utilizar campos de entidade virtual em rollups ou campos calculados.
  • Uma entidade virtual não pode ter um tipo de atividade de entidade.
  • Muitas funcionalidades que afetam linhas de tabela não podem ser ativadas em entidades virtuais. Os exemplos incluem filas, gestão do conhecimento, SLAs, deteção de duplicados, controlo de alterações, capacidade Mobile Offline, segurança de campo, pesquisa por relevância, Portais de soluções Web de portais para o Dynamics 365, e relações N:N entre entidade virtuais.
  • As entidades virtuais são propriedade de organização e não suportam os conceitos de segurança Common Data Service ao nível de linha. Recomendamos que implemente o seu próprio modelo de segurança para a origem de dados externa.
  • Recomendamos que utilize como destino uma origem de dados única quando utiliza entidades virtuais na em Localizações Avançadas. Por exemplo, não é suportada a criação de uma Localização Avançada que crie uma associação entre os dados nativos do Common Data Service e os dados externos da entidade virtual.
  • As propriedades de metadados de campo que são validadas durante a atualização não se aplicam a entidades virtuais. Por exemplo, um campo de Número Inteiro num campo de entidade virtual pode ser definido 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 entidade 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 entidades virtuais não suportam o controlo de alterações e não podem ser sincronizadas utilizando uma funcionalidade do Common Data Service, como o Data Export Service.
  • As entidades virtuais que utilizam o fornecedor de dados OData v4 incluído estão ativadas na porta de saída 443.

Consulte também

Configuração, requisitos e melhores práticas do Fornecedor de dados OData v4
Criar e editar entidades
Criar e editar campos