Criar ou editar uma entidade virtual com dados a partir de uma origem de dados externa
Este tópico aplica-se ao Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Criar e editar entidades virtuais que contêm dados a partir de uma origem de dados externa
Uma entidade virtual é uma entidade personalizada no Dynamics 365 Customer Engagement (on-premises) 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 Dynamics 365 Customer Engagement.
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 Dynamics 365 Customer Engagement (on-premises), 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 Dynamics 365 Customer Engagement (on-premises) 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: Introdução às entidades virtuais
Vantagens da entidade virtual
Os programadores podem implementar plug-ins para ler dados externos, utilizando os serviços Web do Dynamics 365 Customer Engagement e a Plug-in Registration Tool.
Os personalizadores de sistema utilizam Dynamics 365 Customer Engagement (on-premises) 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
Aceda a Definições>Administração>Origens de Dados de Entidade Virtual.
Na barra de ferramentas Ações, selecione Novo.
Na caixa de diálogo Selecionar Fornecedor de Dados, selecione as seguintes origens de dados e, em seguida, selecione OK.
Fornecedor de dados personalizado. Se tiver importado um plug-in de fornecedor de dados, o fornecedor de dados será apresentado aqui. Mais informações: Introdução às entidades virtuais
Fornecedor de Dados OData v4. Dynamics 365 Customer Engagement (on-premises) 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.
Nota
O atributo Origem de Dados Secreta só está disponível com campos adicionados a um formulário de Origem de Dados.
Criar uma entidade virtual
Pode criar uma entidade virtual tal como cria qualquer outra entidade no Customer Engagement com o acréscimo de alguns atributos adicionais aqui descritos.
Nota
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 a utilizar para entidades virtuais
Aceda a Definições>Personalizações>Personalizar o Sistema.
No Explorador de soluções, crie uma nova entidade. Para tal, selecione Entidades no painel de navegação esquerdo e, em seguida, selecione Novo.
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.
Na Definição da Entidade, preencha os seguintes campos obrigatórios.
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.
Importante
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.
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.
- Nome Externo. Normalmente, é o nome exclusivo para identificar os dados que pretende apresentar no campo.
Nota
Se o tipo de campo que criar for OptionSet, os seguintes campos adicionais estão disponíveis.
- Nome de Tipo Externo. 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. Esta propriedade mapeia para o valor correspondente na origem de dados externos para o item de 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.
Selecione Guardar e Fechar na página de propriedades de Campo.
Na barra de ferramentas do Explorador de Soluções, selecione Guardar.
Na barra de ferramentas do Explorador de Soluções, selecione Publicar.
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 Customer Engagement (on-premises), 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 do Common Data Service for Apps 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 Dataverse 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 Customer Engagement, como o Serviço de Exportação de Dados.
Os fluxos de processo empresarial não são suportados com entidades 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 entidades virtuais não suportam fluxos de processo empresarial.
Consulte também
Requisitos e melhores práticas do Fornecedor de Dados OData v4
Criar e editar entidades
Criar e editar campos
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários