Compartir a través de

Usar cadenas de conexión en útiles de XRM para conectarse a Dynamics 365

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Con Microsoft Dynamics 365 (en línea y local), los útiles de XRM le permiten conectarse a la instancia de Dynamics 365 mediante cadenas de conexión. Esto es similar al concepto de cadenas de conexión que se utilizan con Microsoft SQL Server. Las cadenas de conexión tienen compatibilidad nativa en archivos de configuración, incluida la capacidad de cifrar las secciones de configuración para máxima seguridad. Esto permite configurar las conexiones de Dynamics 365 en tiempo de implementación, y no codificar de forma rígida en su aplicación para conectarse a la instancia de Dynamics 365.

En este tema

Crear una cadena de conexión

Parámetros de la cadena de conexión

Ejemplos de cadena de conexión

Determinación del estado de la conexión

Crear una cadena de conexión

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

<connectionStrings>
    <add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
</connectionStrings>
System_CAPS_security Seguridad Nota

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.

Después de crear la cadena de conexión, úsela para crear un objeto CrmServiceClient.

//Use the connection string named "MyCRMServer"
//from the configuration file
CrmServiceClient crmSvc = new CrmServiceClient(ConfigurationManager.ConnectionStrings["MyCRMServer"].ConnectionString);

Nota

Tendrá que usar la directiva using en siguiente el código para hacer referencia al espacio de nombres de System.Configuration para obtener acceso a la cadena de conexión en el código: using System.Configuration;

Después de crear un objeto CrmServiceClient, puede usar el objeto para realizar acciones en Dynamics 365.Más información:Usar herramientas XRM para ejecutar acciones en Dynamics 365

Parámetros de la cadena de conexión

La cadena de conexión contiene una serie de pares de name=value 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

ServiceUri, Service Uri, Url, or Server

Especifica la dirección URL del Microsoft Dynamics 365 Server. La dirección URL puede usar el protocolo http o https y el puerto es opcional. El puerto predeterminado es 80 para el protocolo http y 443 para el protocolo https. La dirección URL del servidor está normalmente en el formato http://crm-server:port/organization-name para Dynamics 365 local y https://organization-name.crm.dynamics.com para Dynamics 365 (online).

Se requiere el nombre de la organización. Puede especificar el nombre descriptivo o único de la organización a la que conectarse.

Ejemplo: http://contoso/test, http://contoso:5555/test, https://contoso/test, https://test.crm.dynamics.com o http://10.10.10.2/test.

Domain

Especifica el dominio que comprobará las credenciales de usuario.

UserName, User Name, UserId, 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.

HomeRealmUri o Uri de dominio de inicio

Especifica el Uri de dominio de inicio

AuthenticationType o AuthType

Especifica el tipo de autenticación para conectarse a la instancia de Dynamics 365. Los valores válidos son: AD, IFD (AD FS habilitado), OAuth o Office365.

  • AD y IFD se permiten para instancias locales de Dynamics 365 únicamente.

  • OAuth se permite para instancias locales de Dynamics 365 (online) únicamente.

  • Office365 se permite para las instancias de Dynamics 365 (online) únicamente.

RequireNewInstance

Indica si se debe volver a usar una conexión existente si se vuelve a hacer la llamada mientras la conexión sigue activa. El valor predeterminado es false que indica que la conexión existente se reutilizará. Si se establece en true, se obliga al sistema a crear una conexión única.

ClientId, AppId o ApplicationId

Especifica la ClientID asignada cuando registró su aplicación en Microsoft Azure Active Directory o Servicios de federación de Active Directory (AD FS).

Este parámetro es aplicable solo cuando especifica el tipo de autenticación como OAuth.

RedirectUri o ReplyUrl

Especifica el URI de redirección de la aplicación que registró en Microsoft Azure Active Directory o Servicios de federación de Active Directory (AD FS).

Este parámetro es aplicable solo cuando especifica el tipo de autenticación como OAuth.

TokenCacheStorePath

Especifica la ruta de acceso completa a la ubicación donde la memoria caché del símbolo de usuario debe ser almacenada. El proceso en ejecución debe tener acceso a la ruta especificada. Es responsabilidad de los procesos establecer y configurar esta ruta.

Este parámetro es aplicable solo cuando especifica el tipo de autenticación como OAuth.

LoginPrompt

Especifica si se le piden al usuario credenciales si las credenciales no se proporcionan. Los valores válidos son:

  • Always: Pide siempre al usuario que especifique credenciales.

  • Auto: Permite que el usuario seleccione en la interfaz de control de inicio de sesión si se muestra un mensaje o no.

  • Never: No pide al usuario que especifique credenciales. Si usa un método de conexión que no tiene interfaz de usuario, debe usar este valor.

Este parámetro es aplicable solo cuando especifica el tipo de autenticación como OAuth.

Ejemplos de cadena de conexión

Los ejemplos siguientes muestran cómo usar cadenas de conexión para conectar con distintas implementaciones y escenarios de autenticación.

Autenticación local integrada

<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />

Cuenta con nombre utilizando autenticación local

<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test; Domain=CONTOSO; Username=jsmith; Password=passcode" />

Cuenta con nombre utilizando Office 365

<add name="MyCRMServer" connectionString="AuthType=Office365;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso.crm.dynamics.com"/>

OAuth utilizando cuenta con nombre en Office 365 con UX para solicitar autenticación

<add name="MyCRMServer" connectionString="AuthType=OAuth;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contosotest.crm.dynamics.com;AppId=<GUID>;RedirectUri =app://<GUID>;TokenCacheStorePath =c:\MyTokenCache;LoginPrompt=Auto"/>

OAuth utilizando cuenta con nombre en Dynamics 365 local para solicitar autenticación

<add name="MyCRMServer" connectionString="AuthType=OAuth;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso:8080/Test;AppId=<GUID>;RedirectUri=app://<GUID>;TokenCacheStorePath =c:\MyTokenCache;LoginPrompt=Auto"/>

IFD utilizando una cuenta con nombre con delegación a un subdominio

<add name="MyCRMServer" connectionString="AuthType=IFD;Url=http://contoso:8080/Test; HomeRealmUri=https://server-1.server.com/adfs/services/trust/mex/;Domain=CONTOSO; Username=jsmith; Password=passcode" />

Determinación del estado de la conexión

Para determinar si la solicitud de conexión se realizó correctamente, compruebe el valor de la propiedad CrmServiceClient.IsReady. Si es true, la conexión se realizó correctamente y está listo para trabajar. De lo contrario, compruebe los valores de las propiedades CrmServiceClient. LastCrmError y CrmServiceClient.LastCrmException para determinar la causa del error de conexión.

Ver también

CrmServiceClient
Crear aplicaciones cliente de Windows mediante las herramientas XRM
Usar constructores CrmServiceClient para conectarse a Dynamics 365
Usar herramientas XRM para ejecutar acciones en Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright