Organisationsdienstmethoden

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Der IOrganizationService-Webdienst stellt einen Satz von Methoden bereit, die verwendet werden, um die häufigsten Vorgänge für System- und benutzerdefinierte Entitäten und die Metadaten für die Organisation auszuführen. Diese Vorgänge können auch mithilfe der IOrganizationService.Execute-Methode und der entsprechenden Meldung ausgeführt werden.

Erstellen

Verwenden Sie die IOrganizationService.Create-Methode, um eine Instanz (Datensatz) einer Entität, die die Erstellen-Meldung unterstützt, einschließlich benutzerdefinierter Entitäten zu erstellen.

Abrufen

Verwenden Sie IOrganizationService.Retrieve-Methode, um eine Instanz (Datensatz) einer Entität abzurufen.

RetrieveMultiple

Verwenden Sie die IOrganizationService.RetrieveMultiple-Methode, um eine Sammlung von Datensätzen abzurufen. Die Abfrage kann mithilfe eines Abfrageausdrucks oder einer FetchXML-Abfrage angegeben werden.

Aktualisieren

Verwenden Sie IOrganizationService.Update-Methode, um einen vorhandenen Datensatz zu aktualisieren.

Löschen

Verwenden Sie die IOrganizationService.Delete-Methode, um einen vorhandenen Datensatz zu löschen.

Associate

Verwenden Sie die IOrganizationService.Associate-Methode, um einen Link zwischen zwei Datensätzen zu erstellen, die an einer Beziehung teilnehmen.

Disassociate

Verwenden Sie IOrganizationService.Disassociate-Methode, um den Link zwischen zwei Datensätzen zu löschen.

Ausführen

Verwenden Sie die IOrganizationService.Execute-Methode, um eine Nachricht auszuführen. Dazu gehört die allgemeine Verarbeitung, wie das Erstellen und Löschen von Datensätzen und Metadaten, oder es kann eine spezialisierte Verarbeitung wie das Importieren oder Erkennen von Duplikaten sein.

Beispiel

Die folgende Code zeigt, wie die Create-, die Retrieve- und Update-Methoden mithilfe der starten Typen verwendet werden.

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

Siehe auch

IOrganizationService
Verwenden des Organisationsdienstes, um Daten oder Metadaten zu lesen und zu schreiben
Verwendung von Nachrichten (Anforderungs- und Antwortklassen) mit der Ausführensmethode
Verwenden von "ExecuteMultiple" zur Verbesserung der Leistung bei Massendatenlast
xRM-Meldungen im Organisationsservice
Dynamics 365-Meldungen im Organisationsdienst
Authentifizieren von Benutzern in Microsoft Dynamics 365
Beispiel: Erstellen, Abrufen, Aktualisieren und Löschen von Datensätzen (frühe Bindung)
Beispiel: Erstellen, Abrufen, Aktualisieren und Löschen (späte Bindung)

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright