Démarrage rapide : Exemple de service Organisation (C#)

Notes

Vous n’êtes pas sûr de l’entité par rapport à la table ? Voir Développeurs : Comprendre la terminologie dans Microsoft Dataverse.

C’est ici que vous commencez à utiliser les assemblys .NET SDK pour utiliser des données à l’aide de Microsoft Dataverse.

Dans ce démarrage rapide, vous allez créer une application console minimale pour se connecter au service Organisation via la classe CrmServiceClient. Vous passerez vos informations de connexion avec une chaîne de connexion passée au constructeur.

Vous pourrez utiliser la propriété IOrganizationService.Execute la méthode passant une instance de la classe WhoAmIRequest, et vous verrez la valeur WhoAmIResponse.UserId .

Notes

Cet exemple de démarrage rapide n’inclut pas la gestion des erreurs. Il s’agit d’un exemple minimum de ce dont vous avez besoin pour vous connecter et utiliser le service Organisation.

Conditions préalables

• Visual Studio (recommandé 2019)
• Connexion Internet
• Compte d’utilisateur valide pour une instance Dataverse
  • Votre nom d’utilisateur
  • Votre mot de passe
• URL vers l’environnement Dataverse auquel vous souhaitez vous connecter
• Présentation de base du langage Visual C #

Créer un projet Visual Studio

1. Créer une nouvelle application de console (.NET Framework) à l’aide de .NET Framework 4.6.2

   

   Notes

   Cette capture d’écran affiche le nom OrgServiceQuickStart, mais vous pouvez choisir de nommer le projet et la solution comme vous le souhaitez.

2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet que vous avez créé, puis sélectionnez Gérer les packages NuGet… dans le menu contextuel.

   

3. Accédez à la dernière version du package Microsoft.CrmSdk.XrmTooling.CoreAssembly NuGet et installez-la.

   

Notes

Vous devez cliquer sur J’accepte dans la boîte de dialogue Acceptation de la licence.

Modifiez Program.cs

1. Ajoutez-les à l’aide d’instructions au-dessus de Program.cs

   using Microsoft.Crm.Sdk.Messages;
   using Microsoft.Xrm.Tooling.Connector;
   

2. Remplacez la méthode Main par le code suivant. Les valeurs prises en charge pour AuthType sont répertoriées dans Paramètres de chaîne de connexion.

   static void Main(string[] args)
   {            
       // e.g. https://yourorg.crm.dynamics.com
       string url = "<your environment url>";
       // e.g. you@yourorg.onmicrosoft.com
       string userName = "<your user name>";
       // e.g. y0urp455w0rd 
       string password = "<your password>";
   
       string conn = $@"
       Url = {url};
       AuthType = OAuth;
       UserName = {userName};
       Password = {password};
       AppId = 51f81489-12ee-4a9e-aaae-a2591f45987d;
       RedirectUri = app://58145B91-0C36-4500-8554-080854F2AC97;
       LoginPrompt=Auto;
       RequireNewInstance = True";
   
       using (var svc = new CrmServiceClient(conn))
       {
   
           WhoAmIRequest request = new WhoAmIRequest();
   
           WhoAmIResponse response = (WhoAmIResponse)svc.Execute(request);
   
           Console.WriteLine("Your UserId is {0}", response.UserId);
   
           Console.WriteLine("Press any key to exit.");
           Console.ReadLine();
       }
   }
   

3. Modifiez les valeurs suivantes pour ajouter des informations pour votre environnement. Vous trouverez l’URL de votre environnement dans l’application Web sous Paramètres > Personnalisation > Ressources de développeur.

   // e.g. https://yourorg.crm.dynamics.com
   string url = "<your environment url>";
   // e.g. you@yourorg.onmicrosoft.com
   string userName = "<your user name>";
   // e.g. y0urp455w0rd
   string password = "<your password>";
   

Exécuter le programme

1. Appuyez sur la touche F5 pour exécuter le programme. La sortie doit se présenter comme suit :

   Your UserId is 969effb0-98ae-478c-b547-53a2968c2e75
   Press any key to exit.
   

Félicitations !

Vous vous êtes connecté(e) avec succès au service Organisation.

Étapes suivantes

Ces articles expliquent comment utiliser les tables Dataverse :

Opérations de classe d’entité utilisant le service d’organisation
Créer des lignes de table à l’aide du service Organisation
Récupérer une ligne de table à l’aide du service Organisation
Mettre à jour et supprimer des lignes de table à l’aide du service Organisation
Associer et dissocier des lignes de table à l’aide du service Organisation

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).