Usar a ferramenta XRM para se conectar ao CRM
Publicado: novembro de 2016
Aplicável a: Dynamics CRM 2015
Para se conectar ao Microsoft Dynamics 365, crie uma instância da classe CrmServiceClient e use um dos construtores para conectar. Cada chamada de método por um objeto desta classe é considerado uma unidade de trabalho atômica e todas as chamadas para o Microsoft Dynamics 365 são protegidas por thread.
Neste tópico
Conecte-se no CRM usando OrganizationServiceProxy
Se conectar ao CRM Online (Live ID)
Se conectar ao CRM Online (Office 365)
Se conectar ao CRM local (Active Directory)
Conecte-se à implantação da Internet (IFD) do CRM
Conectar ao CRM (baseado em declarações)
Parâmetros opcionais para todos os construtores
Determina o status da conexão
Conecte-se no CRM usando OrganizationServiceProxy
Use o seguinte construtor para se conectar ao CRM usando a instância OrganizationServiceProxy fornecida pelo usuário.
CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);
Se conectar ao CRM Online (Live ID)
Use o seguinte construtor.
CrmServiceClient crmSvc = new CrmServiceClient("<LiveID>", "<Password>", "<CRMonlineRegion>", "<OrgName>");
Os valores válidos do parâmetro <CRMonlineRegion> são: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan e NorthAmerica2. Se você definir isso para String.Empty, pesquisará os servidores em todas as regiões para a organização do Dynamics 365. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.
Se conectar ao CRM Online (Office 365)
Use o seguinte construtor.
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", "<Password>", "<CRMonlineRegion>", "<OrgName>", isOffice365:true);
Os valores válidos do parâmetro <CRMonlineRegion> são: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan e NorthAmerica2. Se você definir isso para String.Empty, pesquisará os servidores em todas as regiões para a organização do Dynamics 365. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.
Se conectar ao CRM local (Active Directory)
Use o seguinte construtor.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”),"<Server>", "<Port>", "<OrgName>");
Isso vai executar a autenticação do Active Directory baseada em domínio especificado. Para o parâmetro <Server>, especifique o nome de host do servidor do Dynamics 365; por exemplo: crmtest. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.
Conecte-se à implantação da Internet (IFD) do CRM
Use o seguinte construtor.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>");
Este método executará uma autenticação baseada em declarações com base no domínio local especificado. Isso é útil para os clientes que usam o AD FS e configuraram o servidor do Dynamics 365 como declarações, onde a população de usuários está no mesmo domínio do AD FS que o servidor do Dynamics 365. Para o parâmetro <Server>, especifique o nome de host do servidor do Dynamics 365; por exemplo: crmtest. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.
Conectar ao CRM (baseado em declarações)
Use o seguinte construtor.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");
Este método executará uma autenticação baseada em declarações no domínio de início especificado. Isso é útil para os clientes que usam o AD FS e configuraram o servidor do Dynamics 365 como declarações, onde a população de usuários está no mesmo domínio do AD FS que o servidor do Dynamics 365. Para o parâmetro <Server>, especifique o nome de host do servidor do Dynamics 365; por exemplo: crmtest. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.
Parâmetros opcionais para todos os construtores
Estes são os parâmetros opcionais que você pode usar com cada um dos construtores mostrados anteriormente.
useUniqueInstance: Indica se deve reutilizar uma conexão existente se for chamado novamente quanto a conexão estiver ativa. O padrão é falso. Se definido como verdadeiro, forçará o sistema a criar uma conexão exclusiva.
useSSL: Indica se usar o SSL para conexão do Dynamics 365. Padrão para false, ou seja, use http://. Se definido como verdadeiro, usará https://.
orgDetail: Padrão para zero. Se definido, é devolvido de uma consulta para o Serviço de descoberta e é usado geralmente como a segundo perna de um processo de seleção da organização.
Determina o status da conexão
Para determinar se a solicitação de conexão for bem-sucedida, verifique o valor da propriedade CrmServiceClient.IsReady. Se verdadeiro, a conexão é bem-sucedida e você está pronto para trabalhar. Caso contrário, verifique os valores do CrmServiceClient.LastCrmError e CrmServiceClient. Propriedades LastCrmException em caso da falha de conexão.
Confira Também
Usar cmdlets do PowerShell para ferramentas XRM e conectar ao CRM
Usar as ferramentas do XRM para executar ações no CRM
Exemplo: início rápido do Microsoft Dynamics CRM
Criar aplicativos cliente do Windows usando as ferramentas XRM
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais