Visão geral dos metadados da entidade e do navegador de metadados

  • Artigo

Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Entidades e metadados no Dataverse

Este tópico examina os metadados e a forma como você pode usá-los para criar um aplicativo do Dynamics 365 Customer Engagement (on-premises) ou personalizar um aplicativo existente do Dynamics 365 para Customer Engagement.

Metadados usados com personalização

Metadados significam dados sobre dados. O Dynamics 365 Customer Engagement (on-premises) fornece uma plataforma flexível porque é relativamente fácil editar as definições dos dados que o ambiente usará. No Dynamics 365 Customer Engagement (on-premises), os metadados são um conjunto de entidades. Entidades descrevem os tipos de dados que são armazenados no banco de dados. Cada entidade corresponde a uma tabela do banco de dados e cada campo (também conhecido como atributo) em uma entidade representa uma coluna nessa tabela. Os metadados da entidade controlam os tipos de registros que podem ser criados e o tipo de ações podem ser executadas. Usando apenas os metadados da entidade e os serviços Web de um desenvolvedor para redigir um código para executar ações com dados em seu ambiente. Você tem a capacidade de editar esses metadados com as ferramentas de personalização para criar ou editar entidades, campos e relacionamentos de entidades.

O aplicativo Web ou diferentes clientes que as pessoas utilizam para interagir com os dados de seu ambiente dependem dos metadados da entidade e se adaptam conforme a alteração dos metadados da entidade. Esses clientes também dependem de outros dados para controlar quais elementos visuais exibir, qualquer lógica personalizada aplicar e como aplicar a segurança. Esses dados do sistema também são armazenados nas entidades, mas as próprias entidades não estão disponíveis para personalização.

Usar o navegador de metadados

O gerenciador de soluções permite acesso a todas as entidades que você pode personalizar, mas isso é apenas uma fração de todas as entidades que definem os metadados usados no sistema. Para a maioria das tarefas de personalização básica, a informação apresentada no gerenciador de soluções será tudo que você precisa. Os desenvolvedores precisam frequentemente de mais informações e de uma maneira fácil de exibir os metadados. Se você precisa ter discussões detalhadas com desenvolvedores sobre metadados ou se apenas quiser compreender mais profundamente os metadados, tente instalar a solução de Navegador de Metadados. O Navegador de Metadados é uma solução gerenciada contendo apenas recursos da Web HTML que você pode instalar, permitindo exibir todos os metadados e filtrar entidades e campos para obter uma melhor compreensão do que o metadado contém.

Baixar e instalar o navegador de metadados

Use o link apropriado abaixo para baixar a solução de navegador dos metadados, de forma que possa instalá-la.

Versão Baixar
Aplicativos do Dynamics 365 for Customer Engagement, versão 9.0 (v9.0) Download da Microsoft: MetadataBrowser_3_0_0_5_managed.zip
Dynamics 365 (v8.2) Dynamics CRM Online 2016 Atualização 1 e Dynamics CRM 2016 Service Pack 1 local (v8.1) Download da Microsoft: MetadataBrowser_3_0_0_4_managed.zip
Atualização do Dynamics CRM Online 2016 e do CRM 2016 (v8.0) Download da Microsoft: MetadataBrowser_3_0_0_2_managed.zip

Instalar a solução

Após baixar a solução, será necessário instalá-la. Para obter informações sobre como instalar uma solução gerenciada, consulte Importar, atualizar e exportar soluções

Abrir como um aplicativo

O Dynamics 365 for Customer Engagement, versão 9.0 (v9.0) está cofigurado como um app. Depois que você instalar a solução Navegador de Metadados da Entidade, localize o aplicativo Ferramentas de Metadados e abra-o. Entidades a exibição padrão. Na área de navegação Ferramentas você pode selecionar Metadados da Entidade para inspecionar entidades específicas.

Abra a página configuração da solução

Para versões anteriores você deve usar as seguintes etapas, mas essas também funcionam para a versão mais recente.

Após a instalação da solução Navegador dos metadados da entidade, abra a solução gerenciada, clicando duas vezes na linha na lista de soluções e visualize a página Configuração para exibir informações sobre o navegador dos metadados da entidade e botões para lançar duas exibições diferentes.

  • Navegador de Metadados é equivalente à exibição Entidades no aplicativo.
  • Navegador de Metadados da Entidade é equivalente à exibição Metadados da Entidade no aplicativo.

Exibição de entidades

Você pode executar as seguintes ações:

  • Exibir Detalhes da Entidade: Selecione a entidade a ser exibida usando a exibição Metadados da Entidade.
  • Editar Entidade: Abra o formulário da entidade selecionada na organização padrão, se a entidade suportar.
  • Pesquisa de Texto: Execute uma pesquisa de texto para filtrar as entidades exibida usando as seguintes propriedades da entidade: SchemaName, LogicalName, DisplayName, ObjectTypeCode e MetadataId.
  • Filtrar as Entidades: Defina critérios simples para exibir um subconjunto de entidades. Todos os critérios são avaliados usando a lógica AND.
  • Filtrar Propriedades: Filtre as propriedades exibidas para qualquer entidade selecionada. Há quase 100 propriedades na lista. Use esta seleção para usar apenas aquelas que você está interessado.

Exibição de Metadados da Entidade

Você pode executar as seguintes ações para uma única entidade:

  • Entidade: Altere a entidade que deseja exibir.

  • Propriedades: Exiba todas as propriedades da entidade e filtre as propriedades exibidas.

    • Editar Entidade: Abra o formulário de edição da entidade selecionada na organização padrão, se a entidade suportar.
    • Filtrar Propriedades: Filtre as propriedades exibidas para qualquer entidade selecionada. Há quase 100 propriedades na lista. Use esta seleção para usar apenas aquelas que você está interessado.

  • Atributos: Exiba os atributos da entidade em uma exibição mestre/detalhada. Com essa exibição é possível:

    • Editar Atributo: Abra o formulário do atributo selecionado na organização padrão, se o atributo suportar.
    • Pesquisa de Texto: Execute uma pesquisa de texto para filtrar os atributos exibidos usando as seguintes propriedades do atributo: SchemaName, LogicalName, DisplayName e MetadataId.
    • Filtrar Atributos: Filtre os atributos por qualquer valor de propriedade do atributo.
    • Filtrar Propriedades: Filtrar as propriedades exibidas para o atributo selecionado.

  • Chaves: Se as chaves alternativas forem habilitadas para uma entidade é possível revisar como elas estão configuradas. Mais informações: Definir chaves alternativas

  • Relacionamentos: Exiba os três tipos de relacionamentos entre entidades: Um para muitos, Muitos para um, Muitos para muitos. Com essas exibições você pode:

    • Editar Relacionamento: Abra o formulário de relacionamento selecionado na organização padrão, se o relacionamento suportar.
    • Pesquisa de Texto: Faça uma pesquisa de texto para filtrar relacionamentos exibidos com os valores relevantes para o tipo de relacionamento.
    • Filtrar Propriedades: Filtra o relacionamento por qualquer valor de propriedade do relacionamento.

  • Privilégios: Exiba os privilégios da entidade. Com essa exibição é possível:

    • Filtrar o privilégio exibido usando o PrivilegeId.

Nota

Para exibir as propriedades dos detalhes da entidade, você verá que há muitas propriedades complexas expansíveis. O valor mais útil é exibido com um link que permite alterar para uma exibição mais detalhada. A exibição detalhada reflete a estrutura de dados se você deseja recuperar de forma programática. A exibição detalhada também revela outros dados relevantes que podem ser recuperados na mesma área, por exemplo, se qualquer rótulo localizado estiver presentes para as propriedades Nome de Exibição.

Gorjeta

Para copiar texto da página, selecione apenas o texto e use o atalho de teclado Ctrl+C ou o menu de contexto do comando Copiar.

Criar novos metadados ou usar metadados existentes

O Dynamics 365 Customer Engagement (on-premises) é fornecido várias entidades do sistema que suportam os principais recursos do aplicativo de negócios. Por exemplo, os dados sobre os clientes ou clientes potenciais que serão armazenados usando as entidades conta ou contato. A entidade cliente potencial é onde as informações sobre possíveis clientes ou oportunidades de vendas devem ser mantidas. A entidade oportunidade deve ser usada para acompanhar possíveis eventos de geração de receita.

Cada uma dessas entidades também contém uma série de campos que representam os dados comuns que o sistema pode precisar para armazenar a respectiva entidade.

Para a maioria das organizações, é vantagem usar as entidades do sistema e os atributos para os fins para os quais foram fornecidos. Mesmo que você possa criar novas entidades personalizadas, as entidades do sistema podem ter recursos especiais que você não poderá facilmente replicar sem escrever código.

Por exemplo,

  • Os registros de entidade de cliente potencial podem ser qualificados. Essa ação de qualificação desativará o cliente potencial e criará uma nova oportunidade e um registro de conta ou contato para permitir o encaminhamento no seu processo de negócios.

  • Os registros de entidade de ocorrência têm uma conexão especial com entidades do contrato para ajudar a definir direitos para atendimento ao consumidor.

    Se você deseja instalar uma solução, é possível esperar que o desenvolvedor da solução tenha aproveitado as entidades e os atributos do sistema. Criar uma nova entidade personalizada que substitua uma entidade do sistema ou um atributo significará que qualquer soluções disponível pode não funcionar para sua organização.

    Por esse motivo, é recomendável usar as entidades do sistema fornecidas e os campos quando fizer sentido para sua organização. Se não fizer sentido e não puder ser editado para atender às suas necessidades, você precisará avaliar se é necessário criar uma nova entidade. Lembre-se de que você pode modificar o nome de exibição da entidade para que corresponda à nomenclatura usada pela organização. Por exemplo, é muito comum que os usuários alterem o nome de exibição da entidade da conta para "Empresa" ou o nome da entidade de contato para "Individual". Isso pode ser feito em entidades ou atributos sem alterar o comportamento da entidade. Para obter mais informações sobre como renomear entidades, consulte Alterar o nome de uma entidade.

    Não é possível excluir entidades do sistema ou campos. São considerados como parte da solução do sistema e cada organização deve tê-los. Se você deseja ocultar uma entidade do sistema, altere os privilégios da função de segurança para sua organização para remover o privilégio de leitura dessa entidade. Isso removerá a entidade de grande parte do aplicativo. Se houver um campo do sistema que não seja necessário, remova-o do formulário e qualquer exibição que o use. Altere o valor Pesquisável na definição do campo de forma que ele não apareça na localização avançada. Mais informações: Criar e editar campos

Limitações na criação de itens de metadados

Há um limite no número de entidades que você pode criar. Você pode encontrar informações sobre o número máximo na página Recursos em Uso. Se você precisar de mais entidades personalizadas, entre em contato com o suporte técnico do Dynamics 365 Customer Engagement (on-premises). Esse limite superior pode ser ajustado.

Em cada entidade há um limite superior sobre o número de campos que podem ser criados. Esse limite se baseia nas restrições técnicas sobre a quantidade de dados que podem ser armazenados em uma linha da tabela do banco de dados. É difícil fornecer um número específico porque cada tipo de campo pode usar uma quantidade de espaço diferente. O limite superior depende do espaço total usado por todos os campos da entidade.

A maioria das pessoas não cria campos personalizados suficientes para atingir o limite, mas se você estiver planejando adicionar centenas de campos personalizados a uma entidade, será necessário considerar se é o melhor design. Todos os campos planejados para serem adicionados descrevem propriedades para um registro dessa entidade? Você realmente espera que as pessoas que usam sua organização poderão gerenciar um formulário que inclui um número tão alto de campos? O número de campos adicionado ao formulário aumenta a quantidade de dados que precisam ser transferidos sempre um registro for editados e irá afetar o desempenho do sistema. Leve esses fatores em consideração ao adicionar campos personalizados a uma entidade.

Os campos de conjunto de opções oferecem um conjunto de opções que serão exibidas em um controle suspenso em um formulário ou um controle de lista de seleção ao usar a localização avançada. Seu ambiente pode oferecer suporte à milhares de opções em um Conjunto de opções, mas não deve considerar isso como o limite superior. Os estudos de utilidade mostram que as pessoas têm problemas para usar um sistema onde um controle suspenso fornece um grande número de opções. Use o campo do conjunto de opções para definir as categorias para dados. Não use os campos de conjuntos de opções para selecionar categorias que realmente representam itens separados de dados. Por exemplo, em vez de manter um campo do conjunto de opções que armazena todas as centenas de possíveis fabricantes de um tipo de equipamento, considere criar uma entidade que armazena as referências de cada fabricante e usar um campo de pesquisa ao invés de um conjunto de opções.

As exibições estão limitados a 1.000 atributos por exibição. Se uma exibição for criada em uma entidade que exceda esse limite, um subconjunto de atributos disponíveis deverá ser usado na exibição. Adicionar um atributo acima do limite de 1.000 resultará em uma mensagem de erro indicando que o número máximo de atributos foi excedido.

Consulte também

Criar e editar entidades
Criar e editar relacionamentos de entidades
Criar e editar campos

Criar e projetar formulários