Organisationstjenestemetoder

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Vigtigt

Nogle links til metoder i denne SDK fungerer ikke. Du kan hente dokumentationen til webtjenestemetoder på denne side: IOrganizationService.

Webtjenesten IOrganizationService indeholder en række metoder, der bruges til at udføre de mest almindelige handlinger på systemet og brugerdefinerede objekter og metadataene til din organisation. Disse handlinger kan også udføres ved hjælp af metoden IOrganizationService.Execute og den tilsvarende meddelelse.

Opret

Brug metoden IOrganizationService.Create til at oprette en forekomst (post) af ethvert objekt, der understøtter meddelelsen Create (Opret), herunder brugerdefinerede objekter.

Hent

Brug metoden IOrganizationService.Retrieve til at hente en forekomst (post) af et objekt.

RetrieveMultiple

Brug metoden IOrganizationService.RetrieveMultiple til at hente en samling af poster. Forespørgslen kan angives ved hjælp af et forespørgselsudtryk eller en Fetch XML-forespørgsel.

Opdatering

Brug metoden IOrganizationService.Update til at opdatere en eksisterende post.

Slet

Brug metoden IOrganizationService.Delete til at slette en eksisterende post.

Tilknyt

Brug metoden IOrganizationService.Associate til at oprette en kæde mellem to poster, der er medlem af en relation.

Ophæv tilknytning

Brug metoden IOrganizationService.Disassociate til at slette kæden mellem to poster.

Udfør

Brug metoden IOrganizationService.Execute til at udføre en meddelelse. Dette omfatter fælles behandling som oprettelse og sletning af dataposter og metadata, eller det kan være specialiseret behandling som import eller registrering af dubletter.

Eksempel

Følgende kode viser, hvordan du bruger metoderne Create, Retrieve og Update ved hjælp af stærke typer.

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

Se også

IOrganizationService
Brug webtjenesten IOrganizationService til at læse og skrive data eller metadata
Brug meddelelser (anmodnings- og svarklasser) med metoden Execute
Bruge ExecuteMultiple til at forbedre ydelsen for massedatabelastninger
xRM-meddelelser i organisationstjenesten
CRM-meddelelser i organisationstjenesten
Godkende brugere med Microsoft Dynamics CRM 2015-webtjenester
Eksempel: Oprette, hente, opdatere og slette poster (tidligt bundne)
Eksempel: Oprette, hente, opdatere og slette (sent bundne)

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret