Compartir a través de

Usar herramientas XRM para conectarse a CRM

  • Artículo

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

Para conectarse a Microsoft Dynamics 365, cree una instancia de la clase CrmServiceClient y después use uno de los constructores para conectarse. Cada llamada a un método realizada por un objeto de esta clase se considera una unidad atómica de trabajo, y todas las llamadas a Microsoft Dynamics 365 son seguras para el hilo.

En este tema

Conexión a CRM mediante OrganizationServiceProxy

Conexión a CRM Online (Live ID)

Conexión a CRM Online (Office 365)

Conexión a CRM local (Active Directory)

Conexión a la implementación con conexión a Internet (IFD) de CRM

Conexión a CRM (basada en notificaciones)

Parámetros opcionales para todos los constructores

Determinación del estado de la conexión

Conexión a CRM mediante OrganizationServiceProxy

Use el siguiente constructor para conectarse a CRM mediante la instancia de OrganizationServiceProxy proporcionada por el usuario.

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);

Conexión a CRM Online (Live ID)

Use el constructor siguiente.

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

Los valores válidos para el parámetro <CRMonlineRegion> son: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan y NorthAmerica2. Si lo establece en String.Empty, buscará los servidores de todas las regiones de la organización de Dynamics 365. Para el parámetro <OrgName>, puede especificar el nombre único o el nombre descriptivo.

Conexión a CRM Online (Office 365)

Use el constructor siguiente.

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

Los valores válidos para el parámetro <CRMonlineRegion> son: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan y NorthAmerica2. Si lo establece en String.Empty, buscará los servidores de todas las regiones de la organización de Dynamics 365. Para el parámetro <OrgName>, puede especificar el nombre único o el nombre descriptivo.

Conexión a CRM local (Active Directory)

Use el constructor siguiente.

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

Esto ejecutará una autenticación de Active Directory en función del dominio especificado. Para el parámetro <Server>, especifique el nombre de host del servidor de Dynamics 365; por ejemplo: crmtest. Para el parámetro <OrgName>, puede especificar el nombre único o el nombre descriptivo.

Conexión a la implementación con conexión a Internet (IFD) de CRM

Use el constructor siguiente.

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

Este método ejecutará una autenticación basada en notificaciones en el dominio local especificado. Esto es útil para los clientes que usan AD FS y han configurado el servidor de Dynamics 365 para la autenticación basada en notificaciones, donde la población de usuarios pertenece al mismo dominio de AD FS que el servidor de Dynamics 365. Para el parámetro <Server>, especifique el nombre de host del servidor de Dynamics 365; por ejemplo: crmtest. Para el parámetro <OrgName>, puede especificar el nombre único o el nombre descriptivo.

Conexión a CRM (basada en notificaciones)

Use el constructor siguiente.

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

Este método ejecutará una autenticación basada en notificaciones en el dominio de inicio especificado. Esto es útil para los clientes que usan AD FS y han configurado el servidor de Dynamics 365 para la autenticación basada en notificaciones, donde la población de usuarios pertenece al mismo dominio de AD FS que el servidor de Dynamics 365. Para el parámetro <Server>, especifique el nombre de host del servidor de Dynamics 365; por ejemplo: crmtest. Para el parámetro <OrgName>, puede especificar el nombre único o el nombre descriptivo.

Parámetros opcionales para todos los constructores

Estos son los parámetros opcionales que puede usar en cada uno de los constructores citados anteriormente.

  • useUniqueInstance: 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. Si se establece en true, se obliga al sistema a crear una conexión única.

  • useSSL: indica si se debe usar SSL para conectarse a Dynamics 365. El valor predeterminado es false, es decir, usar http://. Si se establece en true, usará https://.

  • orgDetail: tiene el valor predeterminado null. Si se establece, se obtiene a partir de una consulta al servicio de detección y normalmente se usa como segunda parte de un proceso de selección de la organización.

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 la causa del error de conexión.

Ver también

Usar cmdlets de PowerShell para que las herramientas de XRM se conecten a CRM
Usar herramientas XRM para ejecutar acciones en CRM
Ejemplo: Inicio rápido para Microsoft Dynamics CRM
Crear aplicaciones cliente de Windows mediante las herramientas XRM

© 2017 Microsoft. Todos los derechos reservados. Copyright