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

Artigo
07/06/2017

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Importante

Alguns links para métodos neste SDK não estão trabalhando. Acesse a documentação para obter os métodos do serviço da Web dessa página: IOrganizationService.

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
Usar o serviço Web IOrganizationService para ler e escrever dados e 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 do CRM no serviço da organização
Autenticar os usuários com os serviços Web do Microsoft Dynamics CRM 2015
Exemplo: Criar, recuperar, atualizar e excluir registros (limite antecipado)
Exemplo: Criar, recuperar, atualizar e excluir (late bound)

Partilhar via