Exécuter un programme simple à l’aide des services Web Microsoft Dynamics 365

 

Date de publication : janvier 2017

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

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

  • Téléchargez le SDK Microsoft Dynamics CRM.

  • Vous devez être en mesure de vous connecter à Microsoft Dynamics 365 ou Microsoft Dynamics 365 (Online).

  • Microsoft Visual Studio 2012 ou 2013

  • Microsoft .NET Framework 4.5.2

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

  1. Recherchez et ouvrez le dossier SDK\SampleCode\CS\QuickStart.

  2. Ouvrez le fichier QuickStart.csproj dans Visual Studio.

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

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

    Invite

    Description

    Enter a CRM server name and port [crm.dynamics.com]

    Tapez le nom de votre serveur Microsoft Dynamics 365. La valeur par défaut est Microsoft Dynamics 365 (Online) (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 commence par https://, sinon tapez n. Cette invite ne s’affiche pas pour les utilisateurs de Microsoft Dynamics 365 (Online).

    Est-ce que cette organisation est mise en service dans Microsoft Online Services (o/n) [n]

    Tapez y s’il s’agit d’une organisation mise en service par Microsoft Online Services. Sinon, tapez n.

    Cette invite s’affiche seulement pour les utilisateurs de Microsoft Dynamics 365 (Online).

    Enter domain\username

    Pour Microsoft Dynamics 365, tapez votre domaine réseau et votre nom d’utilisateur séparés par une barre oblique inverse (\). Pour Microsoft Dynamics 365 (Online), entrez 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.

    Enter password

    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.

    Specify an organization number (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.

    Do you want these entity records deleted? (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 Microsoft Dynamics 365 pour Outlook.

    Press Enter to exit

    Appuyez sur Entrée pour quitter le programme.

Étapes suivantes

Après avoir exécuté le programme 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

Specify the saved server configuration number (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.

Enter Password:

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.

Do you want these entity records deleted? (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 Microsoft Dynamics 365 pour Outlook.

Press Enter to exit

Appuyez sur Entrée pour quitter le programme.

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

Pour plus d’informations sur les fichiers de code d’assistance utilisés par QuickStart et par un grand nombre d’exemples du Kit de développement logiciel, ou pour apprendre à configurer un nouveau projet à l’aide des références d’assembly requises, consultez Utiliser l’exemple de code et le code d’assistance. Pour plus d’informations sur le code source qui gère l’enregistrement et la réutilisation des informations relatives à la configuration du serveur, voir Code d’assistance : classe ServerConnection.

Un deuxième exemple de projet, appelé QuickStart with Simplified Connection, est inclus dans la solution Microsoft Visual Studio. Ce deuxième exemple illustre une méthode simplifiée pour se connecter au service Web d’organisation Microsoft Dynamics 365 mais, en dehors de cela, il est similaire au premier exemple QuickStart. Cet exemple n’utilise aucun code d’assistance pour établir une connexion au service Web.

Voir aussi

Didacticiels et ressources pour se familiariser avec le développement pour Microsoft Dynamics 365
Exemple : Démarrage rapide de Microsoft Dynamics 365
Exemple : démarrage rapide de la connexion simplifiée avec Microsoft Dynamics 365
Étendre Microsoft Dynamics 365 sur le serveur
Répertoire d’exemples de code pour Microsoft Dynamics 365
Créer une application professionnelle .NET en 60 minutes avec xRM et SharePoint

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright