Gerir campos personalizadosManage custom fields

Pode criar e atualizar um ou mais campos personalizados numa entidade.You can create and update one or more custom fields in any entity. Quando cria um campo personalizado, especifica um conjunto de propriedades, tais como o nome do campo, o nome a apresentar e o tipo de dados que irá conter.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, veja Entity field data types (Tipos de dados do campo da entidade) e Entity field properties (Propriedades do campo da entidade).For more information, see Enity field data types and Entity field properties.

Nota

Cada entidade tem campos de sistema, tais como campos que indicam quando um registo 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 contêm campos padrão (predefinidos).In addition, standard entities have standard (default) fields. Não pode modificar nem eliminar campos de sistema ou padrão.You can't modify or delete system fields or standard fields. Se criar um campo personalizado, este deve proporcionar funcionalidades acrescidas face a estes campos incorporados.If you create a custom field, it should provide functionality on top of these built-in fields.

Criar um campoCreate a field

  1. No powerapps.com, expanda a secçã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. É apresentada 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 ao escrever um ou mais carateres na barra de pesquisa.You can also filter the list by typing one or more characters in the search bar.

  2. Clique ou toque numa entidade e, em seguida, clique ou toque em Adicionar campo, perto da parte superior do ecrã.Click or tap an entity, and then click or tap Add field near the top of the screen.

  3. Em Nome a apresentar, especifique a cadeia de texto que identificará o campo aos utilizadores.Under Display name, specify the string of text that will identify the field to users. Para obter mais informações, veja Criar uma aplicação.For more information, see Create an app.

  4. Em Nome, especifique a cadeia de texto que vai utilizar para mencionar o campo, por exemplo, numa fórmula quando cria uma aplicação.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 que seja exclusivo, claro e significativo, uma vez que não poderá 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á, tal como Texto ou Número.Under Type, specify the type of data that the field will contain, such as Text or Number.

    Importante

    Especifique esta propriedade cuidadosamente, uma vez que não poderá alterá-la a partir do momento em que o campo contenha 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 pode especificar, veja Understand entities (Compreender entidades).For information about the types of data that you can specify, see Understand entities.

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

  7. Em Exclusivo, selecione a caixa de verificação se todos os registos tiverem de 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, selecione a caixa de verificação se todos os registos tiverem de ter um valor neste campo.Under Required, select the check box if every record must have a value in this field.

    Importante

    Não pode exigir que um campo personalizado numa entidade padrão contenha dados.You can't require that a custom field in a standard entity contain data. Esta limitação impede-o de danificar as aplicações que se baseiam nessa entidade.This restriction prevents you from breaking any apps that rely on that entity.

  9. Clique ou toque em Guardar para submeter as alterações.Click or tap Save to submit your changes.

    Importante

    As suas alterações perder-se-ão se não as guardar antes de abrir outra página do browser ou se sair do mesmo.Your changes will be lost if you don't save them before you open another page in the browser or exit the browser.

Receberá uma notificação 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 que ocorreram e como poderá corrigi-los.If the operation is unsuccessful, an error message indicates the issues that occurred and how you can fix them.

Atualizar ou eliminar um campoUpdate or delete a field

  1. Em powerapps.com, clique ou toque em Gerir, clique ou toque em Entidades e clique ou toque numa entidade.On powerapps.com, click or tap Manage, click or tap Entities, and then click or tap an entity.
  2. Na lista de campos da entidade selecionada, clique ou toque num campo e siga um dos passos abaixo: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 atenção as melhores práticas e limitações.Keep in mind the best practices and restrictions.

      Para selecionar a propriedade seguinte, prima a tecla Tab. Para anular todas as alterações a um campo, clique ou toque nas reticências (…) do campo e clique ou toque em Anular.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.

    • Elimine o campo ao clicar ou tocar nas reticências (...), junto ao limite direito do camp, e clique ou toque em Eliminar.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 Guardar para submeter as alterações.Click or tap Save to submit your changes.

    Importante

    As suas alterações perder-se-ão se não as guardar antes de abrir outra página do browser ou se sair do mesmo.Your changes will be lost if you don't save them before you open another page in the browser or exit the browser.

Receberá uma notificação 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 que ocorreram e como poderá corrigi-los.If the operation is unsuccessful, an error message indicates the issues that occurred and how you can fix them.

Melhores práticas e limitaçõesBest practices and restrictions

À medida que cria e modifica campos, tenha em atenção o seguinte:As you create and modify fields, keep these points in mind:

  • Não pode modificar nem eliminar campos de sistema ou os respetivos valores.You can't modify or delete system fields or their values.
  • Nas entidades padrão, não pode modificar nem eliminar os campos padrão (predefinidos), adicionar campos que exijam dados nem fazer qualquer outra alteração que possa danificar as aplicações que se baseiam nessa 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.
  • Nas entidades personalizadas, deve confirmar se as alterações que faz não danificam qualquer aplicação que se baseie nessa 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.
  • Tem de dar um nome a cada campo personalizado que seja exclusivo no âmbito da entidade e não pode mudar o nome dos campos depois de os criar.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.
  • Pode alterar o tipo de dados de qualquer campo, desde que o campo ainda não contenha 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, poderá alterar o tipo de dados, desde que todos os dados existentes cumpram os 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, poderá alterar o tipo de dados de um campo de Número para Cadeia, mas não poderá alterar o tipo de dados de Cadeia 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.
  • Se modificar um campo numa entidade de uma ou mais das seguintes formas, poderá danificar uma aplicação que utilize essa entidade:You might break an app that uses an entity if you modify a field in that entity in one or more of these ways:
    • Se alterar o tipo de dados do campo.You change the field's data type.
    • Se exigir valores, mas um ou mais registos não contiver nenhum valor nesse campo.You require values, but one or more records don't contain a value in that field.
    • Se exigir valores exclusivos, mas dois ou mais registos contiverem o mesmo valor nesse campo.You require unique values, but two or more records contain the same value in that field.

Passos seguintesNext steps

Aviso de privacidadePrivacy notice

Com o modelo de dados comuns do Microsoft PowerApps, recolhemos e armazenamos nomes de campos e de entidades personalizados nos 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. Utilizamos estes conhecimentos para melhorar o modelo de dados comuns para os nossos clientes.We use this knowledge to improve the common data model for our customers. Os nomes de entidades e de campos que os Criadores criam ajudam-nos a compreender cenários que são comuns na comunidade do Microsoft PowerApps e a determinar as lacunas na cobertura da entidade padrão do serviço, como esquemas relacionados com 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 base de dados associadas a estas entidades não são acedidos ou utilizados pela Microsoft nem replicados fora da região na qual a base de dados é aprovisionada.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. No entanto, tenha em atenção que os nomes de entidades e de campos personalizados podem ser replicados nas regiões e são eliminados de acordo com as 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á empenhada na sua privacidade, conforme descrito mais detalhadamente no nosso Centro de Fidedignidade.Microsoft is committed to your privacy as described further in our Trust Center.