Exécuter un programme simple à l’aide des services web d’engagement client

  • Article

Cette rubrique vous explique comment compiler et exécuter un programme qui crée un enregistrement de compte, récupère l’enregistrement, met à jour l’enregistrement, puis vous adresse une invite pour vérifier si vous souhaitez supprimer l’enregistrement.

Conditions préalables

Compiler et exécuter l’exemple Démarrage rapide

  1. Extrayez le fichier téléchargé et ouvrez le fichier \C#\QuickStart.csproj

  2. Ouvrez le fichier \C#\QuickStart.csproj dans Visual Studio.

  3. Cliquez avec le bouton droit sur le projet QuickStart dans l’explorateur de solutions et sélectionnez Gérer les packages NuGet…

  4. Sélectionnez le package Microsoft.CrmSdk.CoreAssemblies et mettez-le à jour à la dernière version stable.

  5. Appuyez sur F5 pour compiler et exécuter le programme.

  6. À l’invite, entrez les informations suivantes :

    Invite Description
    Entrer un nom de serveur et de port CRM [crm.dynamics.com] Tapez le nom du serveur Dynamics 365 Server. La valeur par défaut est Dynamics 365 for Customer Engagement (crm.dynamics.com) en Amérique du Nord.

    Exemple : myservername

    Exemple : myprefix.myservername:5500

    Exemple : crm5.dynamics.com

    N’incluez pas le nom de votre organisation ou protocole Internet (HTTP ou HTTPS). Vous serez invité à les renseigner ultérieurement.
    Ce serveur est-il configuré pour SSL (Secure Sockets Layer) (https) (o/n) [n] Tapez y si l’URL qui vous permet d’accéder à Dynamics 365 (online), version 8.2 commence par https://, sinon tapez n. Les utilisateurs de Dynamics 365 for Customer Engagement ne voient pas cette invite.
    Est-ce que cette organisation est mise en service dans les services en ligne de Microsoft (y/n) [n] ? Tapez y s’il s’agit d’une organisation mise en service dans les services en ligne de Microsoft. Sinon, tapez n.

    Seuls les utilisateurs de Dynamics 365 for Customer Engagement voient cette invite.
    Entrez le domaine\nomutilisateur. Pour Dynamics 365 for Customer Engagement, tapez votre domaine réseau et votre nom d’utilisateur séparés par une barre oblique inverse (\). Pour Dynamics 365 for Customer Engagement (on-premises), saisissez votre compte Microsoft.

    Exemple local/IFD : mydomain\tadams

    Exemple en ligne : terryadams@somedomain.onmicrosoft.com

    Si vous appuyez uniquement sur <Entrée> pour le nom d’utilisateur, le programme recherchera et utilisera les informations d’identification enregistrées. Si aucune information d’identification n’est enregistrée, le programme échouera.
    Entrez le mot de passe. Tapez votre mot de passe. Dans la fenêtre, les caractères s’afficheront sous la forme de « * ». Le mot de passe est enregistré de façon sécurisée dans le gestionnaire d’informations d’identification Microsoft pour être réutilisé ultérieurement.
    Spécifiez un numéro d’organisation (1-n) [1] Dans la liste des organisations auxquelles vous appartenez, tapez le numéro correspondant. La valeur par défaut est 1, indiquant la première organisation de la liste.
    Souhaitez-vous que ces enregistrements d’entité soient supprimés ? (y/n) [y] Tapez y pour oui et n pour non. Une fois que le programme s’exécute et montre comment créer, récupérer et mettre à jour un enregistrement de compte, vous pouvez supprimer l’enregistrement qui a été créé ou de le laisser, afin de l’afficher dans l’application.
    Appuyez sur Entrée pour quitter Appuyez sur Entrée pour quitter le programme.

Étapes suivantes

Après avoir exécuté le programme de démarrage rapide (QuickStart) ou la plupart des autres exemples du Kit de développement logiciel basés sur la console, les informations saisies relatives au serveur, à l’organisation et au nom d’utilisateur sont enregistrées dans un fichier de configuration XML afin d’être réutilisées à la prochaine exécution d’un exemple. Ainsi, vous n’avez pas besoin d’entrer à nouveau ces informations lorsque vous exécutez d’autres exemples. Après la première fois, les invites de la console sont les suivantes.

Invite Description
Spécifiez le numéro de configuration du serveur enregistré (1-x) \[x\]: Entrez zéro (0) pour créer une configuration de serveur et suivez les invites, comme illustré dans le tableau ci-dessus. Sinon, entrez le numéro d’une configuration enregistrée, comme illustré dans la liste affichée.
Entrez le mot de passe : Tapez votre mot de passe. Dans la fenêtre, les caractères s’afficheront sous la forme de « * ». Si votre mot de passe a été enregistré lors d’une précédente exécution d’un exemple, cette invite ne s’affichera pas.
Souhaitez-vous que ces enregistrements d’entité soient supprimés ? (y/n) [y] Tapez y pour oui et n pour non. Une fois que le programme s’exécute et montre comment créer, récupérer et mettre à jour un enregistrement de compte, vous pouvez supprimer l’enregistrement qui a été créé ou de le laisser, afin de l’afficher dans l’application web ou dans Dynamics 365 for Outlook.
Appuyez sur Entrée pour quitter Appuyez sur Entrée pour quitter le programme.

Si vous souhaitez ajouter ou modifier des fonctionnalités de ce programme de démarrage rapide, vous pouvez modifier le code dans le fichier CRUDOperations.cs.

Pour plus d’informations sur les fichiers de code d’aide que le Démarrage rapide et bien d’autres exemples de Kit de développement logiciel (SDK) utilisent, reportez-vous au code source d’aide qui gère l’enregistrement et la réutilisation des informations de configuration du serveur dans le dossier « Code d’aide du Kit de développement logiciel (SDK) » de l’exemple de Démarrage rapide.

Un deuxième exemple de projet, appelé Démarrage rapide avec connexion simplifiée, est inclus dans la solution Visual Studio. Ce deuxième exemple illustre une méthode simplifiée pour se connecter au service d’organisation Dynamics 365 Customer Engagement (on-premises) mais, en dehors de cela, il est similaire au premier exemple de démarrage rapide. Cet exemple n’utilise aucun code d’assistance pour établir une connexion au service web.

Voir aussi

Didacticiels pour se familiariser avec Dynamics 365 Customer Engagement (on-premises)
Exemple : Démarrage rapide de Dynamics 365 Customer Engagement
Exemple : Démarrage rapide de la connexion simplifiée avec Dynamics 365 Customer Engagement (on-premises)
Écrire du code pour Dynamics 365 Customer Engagement (on-premises)
Répertoire d’exemples de code pour Dynamics 365 Customer Engagement (on-premises)
Créer une application professionnelle .NET en 60 minutes avec xRM et SharePoint