Criar e editar campos (atributos)

Aplica-se aos aplicativos do PowerApps e do Dynamics 365 for Customer Engagement, versão 9.x
Aplica-se aos aplicativos do Dynamics 365 for Customer Engagement, versão 9.x (on-premises)

Com o Dynamics 365 for Customer Engagement, os campos definem os itens de dados individuais que podem ser usados para armazenar dados em uma entidade. Os campos são às vezes chamados de atributos por desenvolvedores. É possível usar as ferramentas de personalização no gerenciador de soluções para editar campos do sistema que permitem personalização ou para criar, editar ou excluir entidades personalizadas.

Criar e editar campos

Antes de criar um campo personalizado, avalie se deve usar um campo existente que atenda seus requisitos. Para obter mais informações: Criar novos metadados ou usar metadados existentes

Parte do nome de qualquer campo personalizado 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 Fornecedor de soluções.

Você pode acessar os campos no aplicativo de várias formas:

  • No gerenciador de soluções, é possível expandir a entidade e selecione o nó Campos. Na lista de campos, clique em Novo para criar um novo campo ou clique duas vezes em qualquer um dos campos na lista para editá-los.

  • Expanda a entidade e selecione o nó Formulários. Abra um formulário do editor de formulários e abaixo do Gerenciador de Campo, clique em Gerenciador de Campos para criar um novo campo. Para todos os campos já adicionados ao formulário, é possível clicar duas vezes no campo para exibir as Propriedades do Campo. Na guia Detalhes, clique em Editar. Outra maneira de ir até o editor de formulários é usar o comando Formulário na barra de comandos para qualquer registro da entidade.

  • Se você usar a ferramenta do navegador de metadados, use a página Navegador de Metadados da Entidade para exibir os detalhes sobre uma entidade específica e clique no botão Atributos. Se um campo for editável, é possível clicar no botão Editar Atributo para editar o campo. Para obter mais informações: Use o navegador de metadados.

    Todos os campos têm as propriedades descritas na seguinte tabela.

Propriedade Descrição
Nome para Exibição O nome exibido como uma etiqueta no cabeçalho para listas onde esse atributo é incluído. Também é a etiqueta padrão quando esse campo for exibido em um formulário, mas o texto da etiqueta em cada formulário poderá ser editado separadamente.
Nome Esse campo é preenchido com base no Nome para Exibição inserido. Inclui o prefixo de personalização do fornecedor de soluções. Você pode alterar o Nome de Exibição posteriormente, mas o Nome não pode ser alterado depois que o campo for salvo.
Requisito do Campo Há três opções:

- Opcional
O registro pode ser salvo, se não houver dados nesse campo.
- Recomendações Comerciais
O registro pode ser salvo, se não houver dados nesse campo. Entretanto, um asterisco azul aparece próximo ao campo para indicar que ele é importante.
- Requisitos Comerciais
O registro não pode ser salvo, se não houver dados nesse campo.
Tome cuidado ao tornar campos de negócios necessários. As pessoas resistirão ao uso do aplicativo não puderem salvar registros porque faltam as informações corretas para inserir em um campo obrigatório. Os usuários poderão inserir dados incorretos somente para salvar o registro e continuar com seu trabalho.
Você pode usar as regras de negócios ou scripts de formulário para alterar o nível de requisito conforme os dados no registro sejam alterados quando os usuários trabalharem nele. Para obter mais informações: Criando e editando regras de negócios
Pesquisável Quando um campo for pesquisável, ele aparece na Localização Avançada e estão disponíveis durante a personalização de exibições. Use isso quando houver campos para a entidade que você não usar. Definir isso para Não reduzirá o número de opções mostrado para as pessoas usando a localização avançada.
Segurança de Campo Para campos personalizados, habilite essa opção para permitir que o campo participe na segurança em nível de campo.
Auditoria Desabilite para que os dados nesse campo não sejam incluídos com dados de auditoria.
Descrição Informe o texto que será exibido como uma dica de ferramenta quando o campo for exibido em um formulário. Para obter mais informações: Vídeo: Dicas de ferramentas personalizáveis do Microsoft Dynamics CRM
Tipo Selecione o tipo de registro. Dependendo do tipo selecionado, você terá opções diferentes. Para obter mais informações: Tipos de campos

Todos os campos que oferecem a entrada de texto direta têm um Modo IME. O editor do método de entrada (IME) é usado para os idiomas asiáticos como japonês. Os IMEs permitem que o usuário insira milhares de caracteres diferentes usados para idiomas do leste asiático usando o teclado de 101 teclas padrão.

Criar ou editar campos de entidades

Criar novos campos para capturar dados nas entidades do sistema existente sem campos que atendam aos seus requisitos. Após criar novos campos, certifique-se de incluí-los nos formulários e nas exibições da entidade para que eles estejam disponíveis na interface do usuário do aplicativo relevante. Você também pode adicionar novos campos a relatórios, mas lembre-se das seguintes restrições:

  • Algumas entidades de sistema ou entidades personalizadas incluídas em uma solução gerenciada não podem permitir que você adicione novos campos.

  • Alguns campos do sistema ou campos personalizados que estão incluídos em uma solução gerenciada não podem permitir a você editá-los.

  • A solução padrão é a solução especial, não gerenciada que exibe todos os componentes de solução das suas soluções gerenciadas ou não gerenciadas. Você não pode editar tudo no contexto de uma solução gerenciada; porém, tudo que você encontrar lá, estará na solução padrão, dessa forma, e não será necessário.

  1. Vá para Configurações > Personalizações.

  2. Selecione Personalizar o sistema.

  3. Em Componentes, expanda Entidades e depois expanda a entidade desejada.

  4. Selecione Campos.

    • Para adicionar um novo campo, na barra de ferramentas Ações, selecione Novo e insira um Nome de exibição para gerar o Nome.

      ou

    • Para editar um ou mais campos, selecione o campo ou os campos (usando a tecla Shift) que deseja alterar e na barra de ferramentas Ações, selecione Editar. Você pode realizar mudanças nos seguintes campos:

      • Para Requisito do Campo, selecione se é opcional, recomendável ou obrigatório.

      • Em Pesquisável, selecione se esse campo deverá ser incluído na lista de campos mostrados na Localização Avançada dessa entidade e também na lista de campos disponíveis ao personalizar as colunas de localização na exibição Localização Rápida Pesquisa.

      • Em Segurança de Campo, habilite ou desabilite o recurso para esse campo.

      • Em Auditoria, habilite ou desabilite o recurso para esse campo.

    Observação

    Ao selecionar vários campos para edição, será exibida a caixa de diálogo Editar Vários Campos. É possível editar Requisito do campo, Pesquisável e Auditoria.

  5. Para novos campos, em Tipo, insira as informações necessárias para o tipo especificado. Para campos existentes, você não pode modificar o tipo, mas pode modificar as configurações do tipo. Mais informações: tipos de campos.

  6. Selecione Tipo de Campo, Formato e Duração Máxima do campo.

  7. Selecione o Modo IME desse atributo.

    Observação

    Isso especifica se o estado ativo de um editor de método de entrada (IME) está habilitado. Um IME permite digitar e editar caracteres em chinês, japonês e coreano. Os IMEs podem estar em um estado ativo ou inativo. O estado ativo aceita caracteres em chinês, japonês ou coreano. O estado inativo tem comportamento semelhante ao de um teclado normal e usa um conjunto limitado de caracteres.

  8. Para um novo campo, certifique-se de adicionar uma Descrição do campo - que forneça instruções para os seus usuários sobre como usar o campo.

  9. Selecione Salvar e Fechar.

  10. Publique sua personalização.

    • Para publicar as alterações para uma entidade, em Componentes, selecione Entidades e a entidade na qual realizou as alterações. Na barra de ferramentas Ações, selecione Publicar.

    • Para publicar todas as alterações feitas em várias entidades ou componente, na barra de ferramentas Ações, selecione Publicar Todas as Personalizações.

Observação

A instalação de uma solução ou a publicação de personalizações pode interferir na operação normal do sistema. É recomendável que você agende uma publicação de solução quando isso for menos prejudicial aos usuários.

Ferramentas da comunidade

O Attribute Manager é uma ferramenta desenvolvida pela comunidade XrmToolbox para o Dynamics 365 Customer Engagement. Consulte o tópico Ferramentas do desenvolvedor para as ferramentas desenvolvidas pela comunidade.

Observação

As ferramentas da comunidade não são um produto do Microsoft Dynamics e ele não estende o suporte às ferramentas da comunidade. Se você tiver dúvidas sobre a ferramenta, contate o editor. Mais informações: XrmToolBox.

Consulte também

Visão geral de entidades e de metadados
Criar e editar entidades

Criar e editar conjuntos de opções globais
Definir campos cumulativos
Definir campos calculados