Criar uma entidade personalizadaCreate a custom entity

Você pode criar uma entidade personalizada para armazenar dados específicos para a sua organização.You can create a custom entity to store data that is specific to your organization. Em seguida, você pode mostrar dados ao desenvolver um aplicativo que faz referência à entidade.You can then show that data by developing an app that refers to the entity.

Há duas maneiras de criar uma entidade:There are two ways to create an entity:

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

Observação

Antes de criar uma entidade, veja a lista de entidades padrão.Before you create an entity, see the list of standard entities. Essas entidades abrangem cenários típicos, como contas e contatos.These entities cover typical scenarios, such as accounts and contacts. Se uma dessas entidades atender aos seus requisitos imediatamente ou se precisar somente de pequenas alterações, você pode economizar tempo, usando 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.

Crie uma entidadeCreate an entity

  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.
  2. Se você ainda não criou um banco de dados, você precisa criar um.If you haven't created a database, you need to create one. Para obter mais informações, consulte Criar um banco de dados do Common Data Service.For more information, see Create a Common Data Service database.
  3. No 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, insira um nome para a entidade.In the Entity name field, enter a name for the entity. Certifique-se de que o nome seja claro e significativo, pois você não pode 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. Você irá referenciar a entidade por esse nome em uma fórmula ao desenvolver um aplicativo.When you develop an app, you will reference the entity by this name in a formula.
  5. Especifique um nome de exibição e, opcionalmente, uma descrição para a entidade e, em seguida, clique ou toque em Avançar.Specify a display name and, optionally, a description for the entity, and then click or tap Next.
  6. Opcional: Altere o valor no campo Título para algo mais significativo para 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 é exibida na lista de entidades no banco 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 classificadas por tipo com todas as entidades personalizadas acima de todas as entidades padrões.The entities will be sorted by type, and all custom entities will appear above all standard entities.

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

Todas as entidades contêm cinco campos do sistema.All entities have five system fields. Esses campos são somente para leitura.These fields are read-only. Portanto, você não pode alterá-los ou excluí-los, e também não pode atribui valores a eles.Therefore, you can't change or delete these fields, and you don't assign values to them.

Nome de exibiçãoDisplay name Nome de campo de sistemaSystem field name Tipo de dadosData type DescriçãoDescription
IDId Nome de campo de sistemaSystem field name Inteiro GrandeBig Integer O identificador exclusivo para o registro.The unique identifier for the record.
Criado porCreated By CreatedByUserCreatedByUser TextText O usuário que criou um registro.The user who created a record.
Data de registro de criaçãoCreated Record Date CreatedOnDateTimeCreatedOnDateTime DateTimeDateTime A data e hora em que um registro foi criado.The date and time when a record was created.
Última modificação porLast modified By LastModifiedByUserLastModifiedByUser TextText O usuário que modificou por último o registro.The user who most recently modified the record.
Data de registro de modificaçãoModified Record Date LastModifiedDateTimeLastModifiedDateTime DateTimeDateTime A data e hora mais recente em que um registro foi modificado.The date and time when a record was most recently modified.

Se você criar uma entidade a partir do zero, ela também contém um campo personalizado chamado Título e definido como o campo de título do registro.If you create an entity from scratch, it also contains a custom field that is named Title. Esse campo é definido como o campo Título do registro.This field is set as the record's Title field. O valor do campo Título é o identificador amigável ao usuário de um registro sempre que você usá-lo em um aplicativo.The Title field value is the user-friendly identifier of a record whenever you use that record in an app. Você pode alterar qual é o campo de Título, mas cada entidade deve ter um campo Título.You can change which field is the Title field, but every entity must have a Title 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.