Gerenciar campos personalizadosManage custom fields

É possível criar e atualizar um ou mais campos personalizados em qualquer entidade.You can create and update one or more custom fields in any entity. Quando você cria um campo personalizado, pode especificar um conjunto de propriedades, como o nome do campo, seu nome de exibição e o tipo de dados que ele contém.When you create a custom field, you specify a set of properties, such as the field's name, its display name, and the type of data that it will contain. Para obter mais informações, consulte Tipos de dados de campo de entidade e Propriedades de campo de entidade.For more information, see Enity field data types and Entity field properties.

Observação

Cada entidade tem campos de sistema, como campos que indicam quando um registro foi atualizado pela última vez e quem o atualizou.Every entity has system fields, such as fields that indicate when a record was last updated, and who updated it. Além disso, as entidades padrão têm campos padrão.In addition, standard entities have standard (default) fields. Não é possível modificar nem excluir campos de sistema ou campos padrão.You can't modify or delete system fields or standard fields. Se você criar um campo personalizado, ele deve fornecer funcionalidade além desses campos internos.If you create a custom field, it should provide functionality on top of these built-in fields.

Criar um campoCreate a field

  1. Em powerapps.com, expanda a seção Common Data Service e clique ou toque em Entidades no painel de navegação esquerdo.On powerapps.com, expand the Common Data Service section and click or tap Entities in the left navigation pane. É exibida uma lista de entidades.A list of entities appears. Para mostrar as entidades personalizadas na parte superior da lista, clique ou toque no cabeçalho da coluna Tipo.To show custom entities at the top of the list, click or tap the Type column header. Também pode filtrar a lista digitando um ou mais caracteres na barra de pesquisa.You can also filter the list by typing one or more characters in the search bar.

  2. Clique ou toque em uma entidade e, em seguida, clique ou toque em Adicionar campo, próximo à parte superior da tela.Click or tap an entity, and then click or tap Add field near the top of the screen.

  3. Em Nome de exibição, especifique a cadeia de texto que identificará o campo para os usuários.Under Display name, specify the string of text that will identify the field to users. Para obter mais informações, consulte Criar um aplicativo.For more information, see Create an app.

  4. Em Nome, especifique a cadeia de texto que você usará para se referir ao campo, por exemplo, em uma fórmula ao criar um aplicativo.Under Name, specify the string of text that you will use to refer to the field in, for example, a formula when you build an app.

    Importante

    Especifique um nome exclusivo, claro e significativo porque não será possível alterá-lo depois de criar o campo.Specify a name that's unique, clear, and meaningful, because you can't change the name after you create the field.

  5. Em Tipo, especifique o tipo de dados que o campo conterá, como Texto ou Número.Under Type, specify the type of data that the field will contain, such as Text or Number.

    Importante

    Especifique essa propriedade com cuidado, porque você não será possível alterá-la depois que o campo contiver dados.Specify this property carefully, because you might not be able to change it after the field contains data. Para obter informações sobre os tipos de dados que você pode especificar, consulte Entender entidades.For information about the types of data that you can specify, see Understand entities.

  6. Se solicitado, especifique informações adicionais para o tipo de dados especificado.If you're prompted, specify additional information for the data type that you specified.

  7. Em Exclusivo, marque a caixa de seleção se todos os registros precisarem ter um valor exclusivo neste campo.Under Unique, select the check box if every record must have a unique value in this field.

  8. Em Obrigatório, marque a caixa de seleção se todos os registros precisarem ter um valor neste campo.Under Required, select the check box if every record must have a value in this field.

    Importante

    Não é possível exigir que um campo personalizado em uma entidade padrão contenha dados.You can't require that a custom field in a standard entity contain data. Essa restrição impede a interrupção de todos os aplicativos que dependem dessa entidade.This restriction prevents you from breaking any apps that rely on that entity.

  9. Clique ou toque em Salvar para enviar suas alterações.Click or tap Save to submit your changes.

    Importante

    Suas alterações serão perdidas se você não as salvar antes de abrir outra página no navegador ou sair dele.Your changes will be lost if you don't save them before you open another page in the browser or exit the browser.

Você será notificado quando a operação for concluída com êxito.You're notified when the operation is completed successfully. Se a operação não for bem-sucedida, uma mensagem de erro indicará os problemas ocorridos e como corrigi-los.If the operation is unsuccessful, an error message indicates the issues that occurred and how you can fix them.

Atualizar ou excluir um campoUpdate or delete a field

  1. Em powerapps.com, clique ou toque em Gerenciar, clique ou toque em Entidades e, em seguida, clique ou toque em uma entidade.On powerapps.com, click or tap Manage, click or tap Entities, and then click or tap an entity.
  2. Na lista de campos para a entidade selecionada, clique ou toque em um campo e, em seguida, siga uma destas etapas:In the list of fields for the entity that you selected, click or tap a field, and then follow one of these steps:

    • Altere uma ou mais propriedades do campo.Change one or more properties of the field. Tenha em mente as práticas recomendadas e restrições.Keep in mind the best practices and restrictions.

      Para selecionar a próxima propriedade, pressione a tecla Tab. Para desfazer todas as alterações em um campo, clique ou toque nas reticências (...) do campo e, em seguida, clique ou toque em Desfazer.To select the next property, press Tab. To undo all changes to a field, click or tap the ellipsis (...) for the field, and then click or tap Undo.

    • Exclua o campo clicando ou tocando nas reticências (...) perto da borda direita do campo e, em seguida, clicando ou tocando em Excluir.Delete the field by clicking or tapping the ellipsis (...) near the right edge of the field, and then clicking or tapping Delete.
  3. Clique ou toque em Salvar para enviar suas alterações.Click or tap Save to submit your changes.

    Importante

    Suas alterações serão perdidas se você não as salvar antes de abrir outra página no navegador ou sair dele.Your changes will be lost if you don't save them before you open another page in the browser or exit the browser.

Você será notificado quando a operação for concluída com êxito.You're notified when the operation is completed successfully. Se a operação não for bem-sucedida, uma mensagem de erro indicará os problemas ocorridos e como corrigi-los.If the operation is unsuccessful, an error message indicates the issues that occurred and how you can fix them.

Práticas recomendadas e restriçõesBest practices and restrictions

Quando você criar e modificar campos, tenha estes pontos em mente:As you create and modify fields, keep these points in mind:

  • Você não pode modificar ou excluir campos de sistema ou seus valores.You can't modify or delete system fields or their values.
  • Em uma entidade padrão, não é possível modificar nem excluir um campo padrão, adicionar um campo que requeira dados ou fazer outras alterações que possam interromper um aplicativo que dependa dessa entidade.In a standard entity, you can't modify or delete a standard (default) field, add a field that requires data, or make any other change that might break an app that relies on that entity.
  • Em uma entidade personalizada, é necessário garantir que as alterações realizadas não interromperão nenhum aplicativo que dependa dessa entidade.In a custom entity, you should make sure that the changes that you make won't break any app that relies on that entity.
  • Você deve fornecer a cada campo personalizado um nome exclusivo na entidade, e não será possível renomeá-lo após a criação.You must give each custom field a name that's unique within the entity, and you can't rename a field after you create it.
  • É possível alterar o tipo de dados de qualquer campo, desde que o campo ainda não contém dados.You can change the data type of any field, provided that the field doesn't yet contain data. Se o campo já contiver dados, será possível alterar o tipo de dados, desde que todos os dados existentes atendam aos requisitos do novo tipo de dados.If the field already contains data, you can change the data type, provided that all the existing data meets the requirements of the new data type. Por exemplo, é possível alterar o tipo de dados de um campo de Número para Cadeia de caracteres, mas não será possível alterar o tipo de dados de um campo de Cadeia de caracteres para Número se o campo contiver dados não numéricos.For example, you can change the data type of a field from Number to String, but you can't change the data type from String to Number if the field contains non-numerical data.
  • Você poderá interromper um aplicativo que usa uma entidade se modificar um campo nessa entidade de uma ou mais das seguintes maneiras:You might break an app that uses an entity if you modify a field in that entity in one or more of these ways:
    • Alterar o tipo de dados do campo.You change the field's data type.
    • Exigir valores, mas um ou mais registros não contêm um valor nesse campo.You require values, but one or more records don't contain a value in that field.
    • Exigir valores exclusivos, mas dois ou mais registros contêm o mesmo valor nesse campo.You require unique values, but two or more records contain the same value in that field.

Próximas etapasNext steps

Aviso de privacidadePrivacy notice

Com o Common Data Service do Microsoft PowerApps, nós coletamos e armazenamos os nomes personalizados de entidade e de campo em nossos sistemas de diagnóstico.With the Microsoft PowerApps common data model we collect and store custom entity and field names in our diagnostic systems. Podemos usar esse conhecimento para melhorar o Common Data Service para nossos clientes.We use this knowledge to improve the common data model for our customers. Os nomes de entidade e de campo que os criadores criam nos ajudam a compreender cenários comuns na comunidade do Microsoft PowerApps e a determinar as lacunas na cobertura de entidade padrão do serviço, como esquemas relacionados a organizações.The entity and field names that Creators create help us understand scenarios that are common across the Microsoft PowerApps community and ascertain gaps in the service’s standard entity coverage, such as schemas related to organizations. Os dados nas tabelas de banco de dados associados a essas entidades não são acessados ou usados pela Microsoft nem replicados fora da região em que o banco de dados é provisionado.The data in the database tables associated with these entities is not accessed or used by Microsoft or replicated outside of the region in which the database is provisioned. Observe que, no entanto, os nomes personalizados de entidade e de campo podem ser replicados entre regiões e serão excluídos de acordo com nossas políticas de retenção de dados.Note, however, the custom entity and field names may be replicated across regions and are deleted in accordance with our data retention policies. A Microsoft está comprometida com a sua privacidade conforme descrita posteriormente em nossa Central de Confiabilidade.Microsoft is committed to your privacy as described further in our Trust Center.