Connexion simplifiée à Microsoft Dynamics CRM 2015
Date de publication : novembre 2016
S’applique à : Dynamics CRM 2015
Extensions développeur pour Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015 utilise le concept d’une chaîne de connexion pour se connecter au serveur Microsoft Dynamics 365. C’est similaire au concept des chaînes de connexion utilisées avec Microsoft SQL Server. Les chaînes de connexion sont une partie naturelle de l’infrastructure ADO.NET et ont également une prise en charge native dans les fichiers de configuration, notamment la capacité d’encoder les sections de configuration pour un maximum de sécurité. Cela vous encourage à utiliser un modèle robuste dans lequel les connexions Microsoft Dynamics 365 sont configurées au moment du déploiement et ne sont pas codées en dur dans votre application. Ainsi tous les API d’Extensions développeur pour Microsoft Dynamics 365 fonctionnent avec un objet CrmConnection, utilisé en interne par la classe CrmOrganizationServiceContext tel qu’indiqué dans cette rubrique, qui utilise une chaîne de connexion pour se connecter au serveur.
Vous fournissez cette chaîne de connexion dans le fichier app.config ou web.config pour votre projet, comme illustré dans l’exemple suivant.
<connectionStrings>
<add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>
.jpeg "System_CAPS_security") Sécurité Remarque |
|---|
Si vous ajoutez les informations sensibles au fichier app.config ou web.config, par exemple un mot de passe de compte, veillez à prendre les précautions qui s’imposent pour protéger les informations. |
Contenu de la rubrique
Créer une chaîne de connexion
Paramètres de la chaîne de connexion
Exemples de chaîne de connexion
Créer une chaîne de connexion
La chaîne de connexion est utilisée pour instancier un objet CrmConnection, qui à son tour peut être utilisé pour instancier un objet OrganizationService ou un objet CrmOrganizationServiceContext.
//Use the Microsoft Dynamics CRM Online connection string from the app.config file named "CRMOnline".
var connection = new CrmConnection("CRMOnline");
var service = new OrganizationService(connection);
var context = new CrmOrganizationServiceContext(connection);
Une CrmConnection peut également être créée de façon indépendante du fichier app.config et établie en ligne comme suit.
var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");
Paramètres de la chaîne de connexion
Le format de base de la chaîne de connexion est le même qu’une chaîne de connexion OLEDB. Il s’agit d’une série de paires nom-valeur séparées par des points-virgules. Le tableau suivant répertorie les paramètres pris en charge. Ils peuvent être saisis dans n’importe quel ordre.
Nom du paramètre |
Description |
|---|---|
Server, Url, or Service Uri |
Spécifie l’URL vers le serveur Microsoft Dynamics 365. L'URL peut être http ou https et le port est en option s'il s'agit de http sur port 80 ou https sur port 443. L'URL du serveur est généralement au format http:// crm-server: port/organization-name ou pour Microsoft Dynamics CRM Onlinehttps:// organization-name.crm.dynamics.com. Le nom d’organisation est nécessaire. |
Domain |
Spécifie le domaine qui recherchera les informations d’identification. |
Username or User ID |
Spécifie le nom de l’ID d’utilisateur associé aux informations d’identification. |
Password |
Spécifie le mot de passe d’utilisateur associé aux informations d’identification. |
Device ID or Device User Name |
Spécifie l’identificateur défini par l’utilisateur de l’appareil Compte Microsoft. Il peut s’agir d’une chaîne non vide. Cet ID d’appareil est enregistré avec le mot de passe de l’appareil la première fois qu’une authentification est lancée. Si l’ID et le mot de passe de l’appareil ne correspondent pas aux valeurs précédemment enregistrées, l’authentification est un échec. L'ID de l'appareil s'applique uniquement à CRM Online. |
Device Password |
Spécifie le mot de passe défini par l’utilisateur de l’appareil Compte Microsoft. Il doit être composé au minimum de six caractères. Ce mot de passe est enregistré avec l’ID de l’appareil la première fois qu’une authentification est lancée. Si l’ID et le mot de passe de l’appareil ne correspondent pas aux valeurs précédemment enregistrées, l’authentification est un échec. Le mot de passe de l'appareil s'applique uniquement à CRM Online. |
Timeout |
Est transmis à la propriété Timeout de la classe OrganizationServiceProxy. |
Home Realm Uri |
Est transmis à la propriété HomeRealmUri de la classe OrganizationServiceProxy. |
Types de proxy activés |
True par défaut, ce paramètre active le OrganizationService afin qu’il renvoie les types de proxy plutôt qu’uniquement le type de base Entity. |
Proxy Types Assembly |
Spécifie l’assembly qui contient les types de proxy à partir de Microsoft Dynamics 365, générés via l’outil CrmSvcUtil.exe, avec l’extension Microsoft.Xrm.Client.CodeGeneration. |
Caller ID |
Est transmis à la propriété CallerId de la classe OrganizationServiceProxy. |
Service Configuration Instance Mode |
Peut être défini sur Static, PerName, PerRequest ou PerInstance.PerName est la valeur par défaut ; cela optimise le nombre de fois où une IServiceConfiguration<TService> est créée pour OrganizationService, de telle sorte que seule une configuration est créée pour chaque chaîne de connexion. Pour plus d’informations sur les autres valeurs possibles, voir Spécifier l’attribut instanceMode. |
User Token Expiry Window |
Spécifie un TimeSpan, formaté hh:mm:ss, utilisé comme un décalage lorsqu’un nouveau jeton d’utilisateur est récupéré. Par exemple, si ce paramètre est défini sur « 00:10:00 », un nouveau jeton d’utilisateur sera récupéré 10 minutes avant que le jeton arrive à expiration. |
Exemples de chaîne de connexion
L’exemple suivant illustre la chaîne de connexion avec l’authentification locale intégrée.
Url=http://crm.contoso.com/xrmContoso;
L’exemple suivant illustre la chaîne de connexion avec l’Active Directoryauthentification locale intégrée.
Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode
L’exemple suivant illustre la chaîne de connexion utilisant Compte Microsoft pour se connecter à Microsoft Dynamics CRM Online…
Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode
L’exemple suivant illustre la chaîne de connexion utilisant Microsoft Online Services pour se connecter à Microsoft Dynamics CRM Online.
Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode;
Voir aussi
Exemple : démarrage rapide de la connexion simplifiée avec Microsoft Dynamics CRM
Extensions développeur pour Microsoft Dynamics CRM 2015
Générer du code avec les extensions de l’outil de génération de code (Dynamics CRM 2015)
Procédures pas-à-pas du portail pour Dynamics CRM 2015
© 2017 Microsoft. Tous droits réservés. Copyright