Servicemethoden van organisaties

Artikel
07/06/2017

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Belangrijk

Sommige koppelingen naar methoden in deze SDK werken niet. U vindt de documentatie voor de webservicemethoden op deze pagina: IOrganizationService.

De IOrganizationService-webservice is een reeks methoden die worden gebruikt om de meestvoorkomende bewerkingen op systeem- en aangepaste entiteiten uit te voeren en op de metagegevens van uw organisatie. Deze bewerkingen kunnen ook worden uitgevoerd met de IOrganizationService.Execute-methode en het corresponderende bericht.

Maken

Gebruik de IOrganizationService.Create-methode om een exemplaar (record) te maken van elke entiteit die het Maken-bericht ondersteunt, inclusief aangepaste entiteiten.

Ophalen

Gebruik de IOrganizationService.Retrieve-methode om een exemplaar (record) van een entiteit op te halen.

RetrieveMultiple

Gebruik de IOrganizationService.RetrieveMultiple-methode om een verzameling records op te halen. De query kan worden opgegeven met een query-expressie of een FetchXML-query.

Bijwerken

Gebruik de IOrganizationService.Update-methode om een bestaande record bij te werken.

Verwijderen

Gebruik de IOrganizationService.Delete-methode om een bestaande record te verwijderen.

Associate

Gebruik de IOrganizationService.Associate-methode om een koppeling te maken tussen twee records die deel uitmaken van een relatie.

Ontkoppelen

Gebruik de IOrganizationService.Disassociate-methode om de koppeling tussen twee records te verwijderen.

Uitvoeren

Gebruik de IOrganizationService.Execute-methode om een bericht uit te voeren. Hieronder valt algemene verwerking zoals het maken en verwijderen van gegevensbestanden en metagegevens, of het kan gaan om gespecialiseerde verwerking zoals duplicaten importeren of detecteren.

Voorbeeld

De volgende code toont hoe u de methoden Create, Retrieve en Update gebruikt met de sterke typen.


//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);

Zie ook

IOrganizationService
Gebruik de IOrganizationService-webservice om metagegevens of gegevens te lezen en schrijven
Berichten (aanvraag- en responsklassen) gebruiken met de methode Execute
ExecuteMultiple gebruiken om de prestaties voor bulkgegevenslading te verbeteren
xRM-berichten in de organisatieservice
CRM-berichten in de organisatieservice
Gebruikers verifiëren met Microsoft Dynamics CRM 2015-webservices
Voorbeeld: Records maken, ophalen, bijwerken en verwijderen (vroeg gebonden)
Voorbeeld: Maken, ophalen, bijwerken en verwijderen (later gebonden)

Delen via