Utiliser les outils XRM pour se connecter à CRM

  • Article

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Pour se connecter à Microsoft Dynamics 365, vous créez une instance de la classe CrmServiceClient, puis utilisez l’un des constructeurs pour se connecter. Chaque appel de méthode par un objet de cette classe est considéré comme unité atomique de travail et tous les appels de Microsoft Dynamics 365 sont thread-safe.

Contenu de la rubrique

Se connecter à CRM avec OrganizationServiceProxy

Se connecter à CRM Online (Live ID)

Se connecter à CRM Online (Office 365)

Se connecter à CRM localement (Active Directory)

Se connecter au déploiement avec accès via Internet de CRM.

Se connecter à CRM (basé sur les revendications)

Paramètres optionnels pour tous les constructeurs

Déterminer l’état de votre connexion

Se connecter à CRM avec OrganizationServiceProxy

Utilisez le constructeur suivant pour vous connecter à CRM à l’aide de l’instance OrganizationServiceProxy fournie par l’utilisateur.

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);

Se connecter à CRM Online (Live ID)

Utilisez le constructeur suivant.

CrmServiceClient crmSvc = new CrmServiceClient("<LiveID>", "<Password>", "<CRMonlineRegion>", "<OrgName>");

Les valeurs valides du paramètre <CRMonlineRegion> sont : NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan et NorthAmerica2. Si vous le définissez avec String.Empty, il recherchera les serveurs dans toutes les régions de l’organisation Dynamics 365. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Se connecter à CRM Online (Office 365)

Utilisez le constructeur suivant.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", "<Password>", "<CRMonlineRegion>", "<OrgName>", isOffice365:true);

Les valeurs valides du paramètre <CRMonlineRegion> sont : NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan et NorthAmerica2. Si vous le définissez avec String.Empty, il recherchera les serveurs dans toutes les régions de l’organisation Dynamics 365. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Se connecter à CRM localement (Active Directory)

Utilisez le constructeur suivant.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”),"<Server>", "<Port>", "<OrgName>");

Il s’ensuivra l’exécution d’une authentification Active Directory basée sur le domaine spécifié. Pour le paramètre <Server>, spécifiez le nom d’hôte de votre serveur Dynamics 365 : crmtest, par exemple. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Se connecter au déploiement avec accès via Internet de CRM.

Utilisez le constructeur suivant.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>");

Cette méthode exécute une authentification basée sur les revendications selon le domaine local spécifié. Cette fonction est utile pour les clients qui utilisent AD FS et ont configuré leur serveur Dynamics 365 en tant que revendications, où la population de l’utilisateur réside dans le même domaine AD FS que le serveur Dynamics 365. Pour le paramètre <Server>, spécifiez le nom d’hôte de votre serveur Dynamics 365 : crmtest, par exemple. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Se connecter à CRM (basé sur les revendications)

Utilisez le constructeur suivant.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");

Cette méthode exécute une authentification basée sur les revendications sur l’accueil de domaine spécifié. Cette fonction est utile pour les clients qui utilisent AD FS et ont configuré leur serveur Dynamics 365 en tant que revendications, où la population de l’utilisateur réside dans le même domaine AD FS que le serveur Dynamics 365. Pour le paramètre <Server>, spécifiez le nom d’hôte de votre serveur Dynamics 365 : crmtest, par exemple. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Paramètres optionnels pour tous les constructeurs

Voici les paramètres optionnels que vous pouvez utiliser avec les constructeurs affichés précédemment.

  • useUniqueInstance : indique s’il faut réutiliser une connexion existante en cas de rappel lorsque la connexion est toujours active. La valeur par défaut est false. Si la valeur est true, le système sera contraint de créer une connexion unique.

  • useSSL : indique si SSL doit être utilisé pour se connecter à Dynamics 365. La valeur par défaut est false, à savoir, utiliser http://. Si la valeur est true, https:// sera utilisé.

  • orgDetail : la valeur par défaut est null. Si la valeur est définie, elle est renvoyée à partir d’une requête au service de découverte et elle est généralement utilisé comme deuxième étape du processus de sélection de l’organisation.

Déterminer l’état de votre connexion

Pour déterminer si la demande de connexion a été réussie, vérifiez la valeur de la propriété CrmServiceClient.IsReady. Si la valeur est true, la connexion est réussie et vous êtes prêt à travailler. Sinon, vérifiez les valeurs des propriétés CrmServiceClient.LastCrmError et CrmServiceClient.LastCrmException pour identifier la cause de l'échec de la connexion.

Voir aussi

Utiliser les applets de commande PowerShell pour que les outils XRM se connectent à CRM
Utiliser les outils XRM pour exécuter des actions dans CRM
Exemple : Démarrage rapide de Microsoft Dynamics CRM
Créer des applications clientes Windows à l’aide des outils XRM

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