Criar uma entidade personalizadaCreate a custom entity

Pode criar uma entidade personalizada para armazenar dados específicos da sua organização.You can create a custom entity to store data that is specific to your organization. Em seguida, pode mostrar esses dados ao desenvolver uma aplicação que menciona a entidade.You can then show that data by developing an app that refers to the entity.

Existem duas formas de criar uma entidade:There are two ways to create an entity:

Em qualquer um dos casos, o Microsoft PowerApps armazena automaticamente e ajuda a proteger os dados.In both cases, Microsoft PowerApps automatically stores and helps secure the data. Depois de criar uma entidade, pode criar ou modificar um ou mais dos campos e criar relações entre as entidades.After you create an entity, you can create or modify one or more of its fields, and build relationships between entities.

Nota

Antes de criar uma entidade, veja a lista de entidades padrão.Before you create an entity, see the list of standard entities. Estas entidades abrangem os cenários típicos, tais como contas e contactos.These entities cover typical scenarios, such as accounts and contacts. Se uma destas entidades cumprir os requisitos desde início ou após algumas pequenas alterações, poderá poupar tempo ao começar com essa entidade.If one of these entities will meet your requirements out of the box or after only minor changes, you can save yourself some time by starting with that entity.

Criar uma entidadeCreate an entity

  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.
  2. Se ainda não criou uma base de dados, terá de criar uma.If you haven't created a database, you need to create one. Para obter mais informações, consulte Create a Common Data Service database (Criar uma base de dados do Common Data Service).For more information, see Create a Common Data Service database.
  3. Junto ao canto superior direito, clique ou toque em Nova entidade.Near the upper-right corner, click or tap New entity.
  4. No campo Nome da entidade, introduza um nome para a entidade.In the Entity name field, enter a name for the entity. Confirme se o nome é claro e significativo, uma vez que não poderá alterá-lo depois de criar a entidade.Make sure that the name is clear and meaningful, because you can't change it after you create the entity. Quando desenvolver uma aplicação, irá mencionar a entidade por este nome numa fórmula.When you develop an app, you will reference the entity by this name in a formula.
  5. Especifique um nome a apresentar e, opcionalmente, uma descrição para a entidade e clique ou toque em Seguinte.Specify a display name and, optionally, a description for the entity, and then click or tap Next.
  6. Opcional: mude o valor no campo Título para algo que seja mais significativo para os seus dados.Optional: Change the value in the Title field to something that is more meaningful for your data.
  7. Clique ou toque em Criar para criar a entidade.Click or tap Create to create the entity.

A entidade é apresentada na lista de entidades da base de dados.Your entity appears in the list of entities in your database. Para mostrar a entidade na parte superior da lista, clique ou toque no cabeçalho da coluna Tipo.To show your entity at the top of the list, click or tap the Type column header. As entidades serão ordenadas por tipo, com todas as entidades personalizadas apresentadas acima de todas as entidades padrão.The entities will be sorted by type, and all custom entities will appear above all standard entities.

Campos de sistema e o campo de título do registoSystem fields and the record title field

Todas as entidades têm cinco campos de sistema.All entities have five system fields. Estes campos são só de leitura.These fields are read-only. Como tal, não pode alterar, eliminar nem atribuir valores a estes campos.Therefore, you can't change or delete these fields, and you don't assign values to them.

Nome a apresentarDisplay name Nome do campo de sistemaSystem field name Tipo de dadosData type DescriçãoDescription
IdId Nome do campo de sistemaSystem field name Número Inteiro GrandeBig Integer O identificador exclusivo do registo.The unique identifier for the record.
Criada PorCreated By CreatedByUserCreatedByUser TextoText O utilizador que criou o registo.The user who created a record.
Data de Criação do RegistoCreated Record Date CreatedOnDateTimeCreatedOnDateTime DateTimeDateTime A data e hora de criação de um registo.The date and time when a record was created.
Última Modificação PorLast modified By LastModifiedByUserLastModifiedByUser TextoText O utilizador que modificou o registo mais recentemente.The user who most recently modified the record.
Data de Modificação do RegistoModified Record Date LastModifiedDateTimeLastModifiedDateTime DateTimeDateTime A data e hora da última modificação de um registo.The date and time when a record was most recently modified.

Se criar uma entidade do zero, também conterá um campo personalizado com o nome Título.If you create an entity from scratch, it also contains a custom field that is named Title. Este campo está definido como o campo Título do registo.This field is set as the record's Title field. O valor do campo Título é o identificador amigável de utilizador de um registo sempre que utilizar uma aplicação.The Title field value is the user-friendly identifier of a record whenever you use that record in an app. Pode alterar que campo é o campo Título, mas cada entidade tem de ter um campo Título.You can change which field is the Title field, but every entity must have a Title 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.