Méthodes du service d’organisation

Article
03/04/2017

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Le service Web IOrganizationService comporte un ensemble de méthodes utilisées pour effectuer les opérations les plus courantes sur les entités système et personnalisées et sur les métadonnées pour votre organisation. Ces opérations peuvent également être effectuées à l’aide de la méthode IOrganizationService.Execute et du message correspondant.

Create

Utilisez la méthode IOrganizationService.Create pour créer une instance (enregistrement) d’une entité qui prend en charge le message Create, notamment les entités personnalisées.

Récupérer

Utilisez la méthode IOrganizationService.Retrieve pour extraire une instance (enregistrement) d’une entité.

RetrieveMultiple

Utilisez la méthode IOrganizationService.RetrieveMultiple pour extraire un ensemble d’enregistrements. La requête peut être spécifiée à l’aide d’une expression de requête ou d’une requête FetchXML.

Update

Utilisez la méthode IOrganizationService.Update pour mettre à jour un enregistrement existant.

Delete

Utilisez la méthode IOrganizationService.Delete pour supprimer un enregistrement existant.

Associate

Utilisez la méthode IOrganizationService.Associate pour créer un lien entre deux enregistrements qui participent à une relation.

Disassociate

Utilisez la méthode IOrganizationService.Disassociate pour supprimer le lien entre deux enregistrements.

Execute

Utilisez la méthode IOrganizationService.Execute pour exécuter un message. Cela inclut le traitement courant comme la création et la suppression des enregistrements de données et des métadonnées, ou il peut s’agir d’un traitement spécialisé comme l’importation ou la détection des doublons.

Exemple

Le code suivant montre comment utiliser les méthodes Create, Retrieve et Update avec les types forts.


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

Voir aussi

IOrganizationService
Utilisez le service Organization pour lire et écrire des données ou des métadonnées.
Utiliser les messages (classes de demande et de réponse) avec la méthode Execute
Utiliser ExecuteMultiple pour améliorer les performances du chargement en bloc des données
Messages xRM dans le service d’organisation
Messages Dynamics 365 dans le service d’organisation
Authentifier les utilisateurs dans Microsoft Dynamics 365
Exemple : créer, récupérer, mettre à jour et supprimer des enregistrements (liaison anticipée)
Exemple : créer, récupérer, mettre à jour et supprimer (liaison tardive)

Microsoft Dynamics 365

Partager via