Convenções de nomenclatura de entidade e atributo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

No Microsoft Dynamics 365, o método de programação você usa para acessar os dados determina a convenção de nomenclatura usada.

Quando você usa as classes digitadas fortemente geradas pela ferramenta de geração de código (CrmSvcUtil.exe) ou ao usar a classe OrganizationServiceContext, você está programando com associação antecipada. Com a programação de vínculo antecipado, você usa o nome do esquema de uma entidade ou atributo. Os nomes de esquema são definidos nas propriedades Microsoft.Xrm.Sdk.Metadata.EntityMetadata.SchemaName e Microsoft.Xrm.Sdk.Metadata.AttributeMetadata.SchemaName.

O exemplo de código a seguir mostra a associação antecipada e usa nomes de esquema.

// Create new account using early binding and a context object.
AWCServiceContext context = new AWCServiceContext(_serviceProxy);
Account account = new Account()  
{
  Name = "Contoso Services Extensions",
         EMailAddress1 = "contoso-Ext@contoso.com"
};

// Create an account record.context.AddToAccountSet(account);
context.SaveChanges();

Ao usar a classe Entity, está programando a associação posterior. Com a programação de vínculo posterior, você usa o nome lógico de uma entidade ou atributo. Os nomes lógicos são definidos nas propriedades Microsoft.Xrm.Sdk.Metadata.EntityMetadata.LogicalName e Microsoft.Xrm.Sdk.Metadata.AttributeMetadata.LogicalName.

O exemplo de código a seguir mostra a associação posterior e usa nomes lógicos.

//Create new account using late binding and the Entity class.
Entity accountentity = new Entity("account");
accountentity["name"] = "Contoso Services Extensions";
accountentity["emailaddress1"] = "contoso-Ext@contoso.com";

// Create an account record.
_accountId =_serviceProxy.Create(accountentity);

Para localizar os nomes lógicos e de esquema para cada entidade, consulte os metadados para cada entidade.Para exibir os metadados de entidade da sua organização, instale a solução Navegador dos Metadados descrita em Procurar os metadados da sua organização. Também é possível exibir os metadados de uma organização não personalizada no arquivo do Excel chamado EntityMetadata.xlsx, incluído na pasta de nível superior do download do SDK. O arquivo de classes digitadas fortemente geradas também mostra os nomes de esquema e lógicos para cada entidade e atributo.

Confira Também

Usar os serviços do Microsoft Dynamics 365 em código
Assemblies incluídos no Microsoft Dynamics 365 SDK
Use classes de entidade de limite antecipado no código
Usar a classe de entidade late bound no código
Introdução aos atributos de entidade no Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais