Criar uma entidade personalizada

Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Criar uma entidade personalizada

Antes de criar uma entidade personalizada, avalie usar uma entidade existente atenderá seus requisitos. Mais informações: Criar novos metadados ou usar metadados existentes

Parte do nome de qualquer entidade personalizada que você criar é o prefixo de personalização. Isso é definido com base no fornecedor da solução para a solução que você está trabalhando. Se você se importar com o prefixo de personalização, certifique-se de estar trabalhando em uma solução não gerenciada ou solução padrão onde o prefixo de personalização é aquele que você deseja para essa entidade. Para obter informações sobre como alterar o prefixo de personalização, consulte Alterar o prefixo do fornecedor de soluções.

Visão geral da criação de uma entidade

Os campos obrigatórios mínimos para criar uma entidade personalizada são:

Campo	Descrição
Nome para Exibição	Este é o nome exclusivo para a entidade que será mostrado no aplicativo.
Nome no Plural	Este é o nome no plural para a entidade que será mostrado no aplicativo.
Nome	Esse campo é preenchido previamente com base no nome para exibição que você digitar. Inclui o prefixo de personalização do fornecedor de soluções.
Propriedade	É possível escolher propriedade do usuário ou da equipe ou propriedade da organização. Mais informações: Propriedade da entidade

Nota

• Se estiver usando o Safari como o navegador, você poderá receber uma mensagem de erro de tempo limite quando tentar salvar ou publicar uma nova entidade personalizada. Se isso ocorrer, recomendamos usar um navegador diferente para criar entidades.
• Para que o nome da entidade funcione com a pesquisa de conhecimento incorporada do Dynamics 365 for Customer Service, o comprimento máximo do nome da entidade, incluindo o prefixo do fornecedor, não pode exceder 24 caracteres.

Para criar uma entidade de atividade, selecione Definir como uma entidade de atividade antes de salvar a entidade. Mais informações: Entidades de atividade

Em Áreas que exibem esta entidade, selecione em quais áreas disponíveis na barra de navegação você deseja que a entidade esteja disponível. Isso não é obrigatório, mas se você precisar que as pessoas possam descobrir a entidade facilmente, escolha uma delas. Fazer as alterações atualiza os dados que definem o painel de navegação. Não é possível alterar as configurações de entidades do sistema. Entretanto, é possível editar esses dados para alterar onde cada entidade é exibida e como elas são exibidas editando o mapa do site.

Há várias opções que são definidas por padrão. Se não tiver certeza que as deseja para a entidade personalizada, desabilite-as antes de salvar. Você sempre poderá optar por habilitá-las posteriormente, mas determinadas opções podem não ser desabilitadas após serem habilitadas. Notas, Atividades e Conexões são habilitadas por padrão e não podem ser desabilitadas posteriormente. Para obter mais informações sobre as opções disponíveis, consulte Editar uma entidade.

Cada entidade personalizada tem um campo principal. Isso é definido na guia Campo Principal. Esse campo é usado quando os registros da entidade são exibidos em uma lista. O campo principal é normalmente um link para abrir o registro. Este campo deve ser um campo Linha Única de Texto com o formato Texto. Ao criar a entidade, o único valor que não pode ser alterado posteriormente é Nome. Por padrão, o Nome de Exibição é “Nome” e o Nome e o prefixo de personalizações do fornecedor de soluções, um sublinhado e “name”. Se isso não for o que você deseja alterar, altere antes de criar a entidade. Depois de salvar a entidade, você não pode editar valores de campo principais na guia Campo Principal da entidade. Você deverá localizar esse campo nos campos da entidade. Você poderá editá-lo como qualquer outra linha única de texto do campo.

As pessoas com funções de segurança de administrador do sistema ou personalizador do sistema podem ver todas as novas entidades personalizadas. Isso permite testar suas entidades personalizadas antes de exibir para as pessoas que irão usar o sistema. Antes que os usuários com outros direitos de acesso possam ver essas entidades, é preciso editar os direitos de acesso e conceder acesso a outros usuários para que eles possam vê-las. Quando uma entidade personalizada for criada, ela será incluída na guia Entidades Personalizadas de cada direito de acesso Forneça pelo menos acesso de leitura no nível do usuário para a entidade personalizada para que as pessoas possam ver nos aplicativos.

Quando uma nova entidade é criada, vários registros do sistema de suporte e metadados são criado para ela. Você continua a editar a entidade trabalhando com elas.

Criar uma entidade

Como um criador ou personalizador de aplicativos, você pode criar e editar entidades usando o gerenciador de soluções.

1. Entre em sua instância do Dynamics 365 Customer Engagement (on-premises).
2. Inicie o gerenciador de soluções. Configurações>Personalizações>Personalizar o Sistema.
3. Na lista Tipo de Componente, selecione Novo e depois Entidade.
4. Insira as seguintes informações necessárias. Para obter mais informações sobre as propriedades opcionais disponíveis, consulte Opções de entidade que podem somente ser habilitadas e Habilitação ou desabilitação de opções de entidade.
   • Nome para Exibição. Define o rótulo exibido nos aplicativos de referências de entidade e nos registros criados com base na entidade, tais como Widget.
   • Nome no Plural. Este é o rótulo exibido nos aplicativos das referências a registros de entidade que podem incluir vários registros, tais como Widgets.
   • Nome.. Este campo é preenchidos automaticamente com base no Nome de Exibição que você inseriu e inclui um prefixo de personalização do fornecedor de soluções, como new_widget. Você pode alterar o Nome de Exibição posteriormente, mas o Nome não pode ser alterado depois que o campo for salvo. Mais informações: Alteração do prefixo do fornecedor de soluções para o fornecedor padrão

Consulte também

Criar e editar campos (atributos)
Criar ou editar um formulário principal para uma entidade
Noções básicas sobre exibições (listas)