Conexión simplificada a Microsoft Dynamics CRM 2015

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

Las extensiones para desarrolladores de Microsoft Dynamics CRM 2015 y actualización de Microsoft Dynamics CRM Online 2015 utilizan el concepto de una cadena de conexión para conectarse al servidor de Microsoft Dynamics 365. Esto es similar al concepto de cadenas de conexión que se utilizan con Microsoft SQL Server. Las cadenas de conexión son una parte natural del marco de trabajo ADO.NET y también tienen compatibilidad nativa en archivos de configuración, incluida la capacidad de cifrar las secciones de configuración para máxima seguridad. Esto promueve el uso de un modelo sólido en el que las conexiones de Microsoft Dynamics 365 se configuran en el tiempo de implementación y no están codificadas de forma rígida en la aplicación. Como resultado, todas las API en las extensiones para desarrolladores de Microsoft Dynamics 365 trabajan con un objeto CrmConnection, que la clase CrmOrganizationServiceContext usa internamente como se muestra en este tema, que usa una cadena de conexión para conectarse al servidor.

Esta cadena de conexión se suministra en el archivo app.config o web.config del proyecto, como se muestra en el ejemplo siguiente.

<connectionStrings>
  <add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>

[!Security] Si agrega alguna información confidencial al archivo web.config o app.config, como la contraseña de una cuenta, asegúrese de tomar las precauciones de seguridad adecuadas para proteger la información.

En este tema

Crear una cadena de conexión

Parámetros de la cadena de conexión

Ejemplos de cadena de conexión

Crear una cadena de conexión

La cadena de conexión se usa para crear una instancia de un objeto CrmConnection que, a su vez, se puede usar para crear una instancia de un objeto OrganizationService o un objeto 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);

También se puede crear un objeto CrmConnection de forma independiente del archivo app.config y generarse en línea de la siguiente manera.

var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");

Parámetros de la cadena de conexión

El formato básico de la cadena de conexión es el mismo que el de una cadena de conexión OLEDB. Es una serie de pares de nombre/valor separados por punto y coma. La siguiente tabla muestra los parámetros admitidos, que se pueden escribir en cualquier orden.

Nombre del parámetro	Descripción
Server, Url, or Service Uri	Especifica la dirección URL del servidor de Microsoft Dynamics 365. La dirección URL puede ser https o http y el puerto es opcional si es http sobre el puerto 80 o https sobre el puerto 443. La dirección URL del servidor suele encontrarse en el formato de http:// crm-server: port/organization-name o para Microsoft Dynamics CRM Onlinehttps:// organization-name.crm.dynamics.com. Se requiere el nombre de la organización.
Domain	Especifica el dominio que comprobará las credenciales de usuario.
Username or User ID	Especifica el nombre de identificación del usuario asociado con las credenciales.
Password	Especifica la contraseña del nombre de usuario asociado con las credenciales.
Device ID or Device User Name	Especifica el identificador de dispositivo definido por el usuario de Cuenta de Microsoft. Puede ser cualquier cadena que no esté vacía. Este identificador de dispositivo se registra con la contraseña del dispositivo la primera vez que se ejecuta una autenticación. Si el identificador de dispositivo y la contraseña no coinciden con los valores antes registrados, se producirá un error de autenticación. El identificador de dispositivo solo se aplica a CRM Online.
Device Password	Especifica la contraseña del dispositivo definida por el usuario de Cuenta de Microsoft. Debe tener un mínimo de seis caracteres. Esta contraseña se registra con el identificador de dispositivo la primera vez que se ejecuta una autenticación. Si el identificador de dispositivo y la contraseña no coinciden con los valores antes registrados, se producirá un error de autenticación. La contraseña de dispositivo solo se aplica a CRM Online.
Timeout	Pasa a la propiedad Timeout de la clase OrganizationServiceProxy.
Home Realm Uri	Pasa a la propiedad HomeRealmUri de la clase OrganizationServiceProxy.
Tipos de proxy habilitados	True de forma predeterminada, este parámetro permite que OrganizationService devuelva tipos de proxy en lugar de solo el tipo Entity base.
Proxy Types Assembly	Especifica el ensamblado que contiene los tipos de proxy de Microsoft Dynamics 365, generados con la herramienta CrmSvcUtil.exe, con la extensión Microsoft.Xrm.Client.CodeGeneration.
Caller ID	Pasa a la propiedad CallerId de la clase OrganizationServiceProxy.
Service Configuration Instance Mode	Puede establecerse en Static, PerName, PerRequest o PerInstance.PerName es el predeterminado; esto optimiza el número de veces que se creará una IServiceConfiguration<TService> para una OrganizationService, de modo que solo se cree una para cada cadena de conexión. Para obtener más información sobre otros valores posibles, consulte Especificación del atributo instanceMode.
User Token Expiry Window	Especifica un Intervalo de tiempo, con formato hh:mm:ss, usado como un desplazamiento para cuando se recupera un nuevo símbolo (token) de usuario. Por ejemplo, si este parámetro se establece en "00:10:00", se recuperará un nuevo símbolo (token) de usuario 10 minutos antes de que el token caduque realmente.

Ejemplos de cadena de conexión

El siguiente ejemplo muestra la cadena de conexión que usa la autenticación integrada local.

Url=http://crm.contoso.com/xrmContoso;

El siguiente ejemplo muestra la cadena de conexión que usa la autenticación Active Directory.

Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode

El siguiente ejemplo la cadena de conexión que usa Cuenta de Microsoft para conectarse a Microsoft Dynamics CRM Online…

Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode

El siguiente ejemplo muestra la cadena de conexión que usa Microsoft Online Services para conectarse a Microsoft Dynamics CRM Online.

Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode; 

Ver también

Ejemplo: tutorial de conexión simplificada con Microsoft Dynamics CRM
Extensiones de desarrollador para Microsoft Dynamics CRM 2015
Generar código con las extensiones de la herramienta de generación de código (Dynamics CRM 2015)
Tutoriales de portal para Dynamics CRM 2015

© 2017 Microsoft. Todos los derechos reservados. Copyright