Métodos de serviço da organização

Artigo
03/03/2017

Publicado: janeiro de 2017

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

O serviço Web IOrganizationService fornece um conjunto de métodos usados para executar as operações mais comuns do sistema e entidades personalizadas e os metadados da organização. Essas operações também podem ser executadas com o método IOrganizationService.Execute e a mensagem correspondente.

Criar

Use o método IOrganizationService.Create para criar uma instância (registro) de qualquer entidade que ofereça suporte para a mensagem Criar, incluindo entidades personalizadas.

Recuperar

Use o método IOrganizationService.Retrieve para recuperar uma instância de uma entidade (registro).

RetrieveMultiple

Use o método IOrganizationService.RetrieveMultiple para recuperar uma coleção de registros. A consulta pode ser especificada usando uma expressão de consulta ou consulta XML de Busca.

Atualização

Use o método IOrganizationService.Update para atualizar um registro existente.

Excluir

Use o método IOrganizationService.Delete para excluir um registro existente.

Associar

Use o método IOrganizationService.Associate para criar um link entre dois registros que participam de um relacionamento.

Desassociar

Use o método IOrganizationService.Disassociate para excluir o link entre dois registros.

Executar

Use o método IOrganizationService.Execute para executar uma mensagem. Isso inclui o processamento comum como criar e excluir os registros de dados e metadados ou pode ser processamento especializado como importação ou detecção de duplicidades.

Exemplo

O código a seguir mostra como usar os métodos Create, Retrieve e Update usando os tipos fortes.


//Define the account for which we will add letters                
Account accountToCreate = new Account
{
    Name = "Example Account"
};

//Define the IDs of the related letters we will create
_letterIds = new[] { Guid.NewGuid(), Guid.NewGuid(), Guid.NewGuid() };

//This acts as a container for each letter we create. Note that we haven't
//define the relationship between the letter and account yet.
EntityCollection relatedLettersToCreate = new EntityCollection
{
    EntityName = Letter.EntityLogicalName,
    Entities =
    {
        new Letter{Subject = "Letter 1", ActivityId = _letterIds[0]},
        new Letter{Subject = "Letter 2", ActivityId = _letterIds[1]},
        new Letter{Subject = "Letter 3", ActivityId = _letterIds[2]}
    }
};

//Creates the reference between which relationship between Letter and
//Account we would like to use.
Relationship letterRelationship = new Relationship("Account_Letters");

//Adds the letters to the account under the specified relationship
accountToCreate.RelatedEntities.Add(letterRelationship, relatedLettersToCreate);

//Passes the Account (which contains the letters)
_accountId = _service.Create(accountToCreate);

Console.WriteLine("An account and {0} letters were created.", _letterIds.Length);


//Now we run through many of the same steps as the above "Create" example
Account accountToUpdate = new Account
{
    Name = "Example Account - Updated",
    AccountId = _accountId
};

EntityCollection relatedLettersToUpdate = new EntityCollection
{
    EntityName = Letter.EntityLogicalName,
    Entities =
    {
        new Letter{Subject = "Letter 1 - Updated", ActivityId = _letterIds[0]},
        new Letter{Subject = "Letter 2 - Updated", ActivityId = _letterIds[1]},
        new Letter{Subject = "Letter 3 - Updated", ActivityId = _letterIds[2]}
    }
};

accountToUpdate.RelatedEntities.Add(letterRelationship, relatedLettersToUpdate);

//This will update the account as well as all of the related letters
_service.Update(accountToUpdate);
Console.WriteLine("An account and {0} letters were updated.", _letterIds.Length);

Confira Também

IOrganizationService
Use o Serviço da organização para ler e gravar dados ou metadados
Usar mensagens (classes de solicitação e resposta) com o método Execute
Uso ExecuteMultiple para melhorar o desempenho do carregamento de dados em massa
Mensagens do xRM no serviço da organização
Mensagens no serviço de organização do Dynamics 365
Autenticar usuários no Microsoft Dynamics 365
Exemplo: Criar, recuperar, atualizar e excluir registros (limite antecipado)
Exemplo: Criar, recuperar, atualizar e excluir (late bound)

Microsoft Dynamics 365

Partilhar via