Use a classe da Entidade para criar, atualizar e excluir

Publicado: janeiro de 2017

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

Em Microsoft Dynamics 365 (online e local), você pode usar a classe de Entity, para criar, atualizar e excluir entidades e atributos de entidade.

Use a classe da Entidade para criar, atualizar e excluir

Quando você trabalha com a classe de Entity e usa a associação tardia, você trabalha com o nome da entidade e do atributo lógico. Isso contrasta com a associação inicial onde você com a entidade e com o nome do esquema do atributo. O nome lógico do atributo é todo em letras minúsculas enquanto o nome do atributo de esquema usa as primeiras letras maiúsculas.

Para criar uma nova entidade, primeiro você cria uma nova instância da classe de Entity e passe um nome de entidade. O seguinte exemplo código mostra como criar um novo registro de conta.

// Instantiate an account object.
Entity account = new Entity("account");

// Set the required attributes. For account, only the name is required. 
// See the metadata to determine 
// which attributes must be set for each entity.
account["name"] = "Fourth Coffee";

// Create an account record named Fourth Coffee.
_accountId = _orgService.Create(account);

Por exemplo, um novo objeto de entidade do tipo "conta" é criado, atributos são definidos e então o método IOrganizationServiceCreate é solicitado para criar um novo registro.

Para atualizar uma entidade, defina um valor para o atributo a ser atualizado e então solicite o método IOrganizationServiceUpdate. O seguinte código de exemplo mostra como atualizar um atributo em uma conta.

Entity account = new Entity("account");
// Create a column set to define which attributes should be retrieved.
ColumnSet attributes = new ColumnSet(new string[] { "name", "ownerid" }); 

// Retrieve the account and its name and ownerid attributes.
account = _orgService.Retrieve(account.LogicalName, _accountId, attributes);

// Update the postal code attribute.
account["address1_postalcode"] = "98052";

// Update the account.
_orgService.Update(account);

Para excluir uma entidade, você pode passar as informações principais de atributo para o método IOrganizationService.Delete. O exemplo de código a seguir mostra como usar o método Delete.

_orgService.Delete("account", _accountId);

Confira Também

Use a classes Entity para adicionar ou atualizar associações entre registros relacionados
Usar a classe de entidade late bound no código

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais