Os os construtores para conectar ao Dynamics 365

  • Artigo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Para se conectar ao Microsoft Dynamics 365, crie uma instância da classe CrmServiceClient e use um dos construtores para conectar. Todas as chamadas para o Dynamics 365 que usam a classe CrmServiceClient são livres de thread.

Diferente dos construtores mencionados neste tópico, também é possível usar segmentos de conexão com o CrmServiceClient para conectar ao Dynamics 365.Para obter mais informações:Usar cadeias de conexão no trabalho realizado com ferramentas de XRM para se conectar ao Dynamics 365

Neste tópico

Conecte-se ao Dynamics 365 usando o OrganizationServiceProxy

Conecte-se ao Dynamics 365 usando o OrganizationWebProxyClient

Conectar-se ao Dynamics 365 (online) (Office 365)

Conecte-se ao Dynamics 365 (online) (Office 365) usando o OAuth

Se conectar ao Dynamics 365 local (Active Directory)

Conectar à implantação para a Internet (IFD) do Dynamics 365

Conectar à implantação para a Internet (IFD) do Dynamics 365 usando OAuth

Conecte-se ao Dynamics 365 (baseado em declarações)

Determina o status da conexão

Conecte-se ao Dynamics 365 usando o OrganizationServiceProxy

Use o construtor a seguir para se conectar ao Dynamics 365 usando a instância fornecida pelo usuário do OrganizationServiceProxy.

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceProxy>);

Conecte-se ao Dynamics 365 usando o OrganizationWebProxyClient

Use o construtor a seguir para se conectar ao Dynamics 365 usando a instância fornecida pelo usuário do OrganizationWebProxyClient. Este construtor é introduzido em Microsoft Dynamics 365 (online e local).

CrmServiceClient crmSvc = new CrmServiceClient(<orgWebProxyClient>);

Conectar-se ao Dynamics 365 (online) (Office 365)

Use o seguinte construtor para se conectar à sua instância do Dynamics 365 (online) em Office 365.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>, isOffice365:true);

Valores válidos para o parâmetro <CrmRegion> são: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND, e NorthAmerica2. Se você definir como String.Empty, o sistema buscará servidores em todas as regiões para a organização Dynamics 365. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.

Os parâmetros a seguir são opcionais: useUniqueInstance, useSsl e orgDetail.

Conecte-se ao Dynamics 365 (online) (Office 365) usando o OAuth

Use o seguinte construtor para usar o protocolo OAuth para conectar à sua instância Dynamics 365 (online) no Office 365. O suporte ao OAuth é introduzido ao Microsoft Dynamics 365 (online e local).

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, <orgDetail>,
                  <userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, <externalOrgWebProxyClient>, PromptBehavior.Auto);

Este construtor usa o Biblioteca de autenticação do Active Directory do Microsoft Azure (ADAL) para autenticar usuários. Se as credenciais do usuário (nome de usuário e senha) não forem especificadas, o ADAL solicita o usuário a fornecer credenciais dependendo do parâmetro (opcional) PromptBehavior especificadas no construtor. O ADAL autentica as credenciais usando o protocolo OAuth, obtém o acesso e atualiza o token de Active Directory do Azure, e usa o token do acesso para fazer solicitações ao Dynamics 365.

Valores válidos para o parâmetro <CrmRegion> são: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND 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 Dynamics 365 local (Active Directory)

Use o seguinte construtor para se conectar à instância local com a autenticação Active Directory.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.AD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);

Isso vai executar a autenticação do Active Directory baseada em domínio especificado. Para o parâmetro <Server>, especifique o nome de host de seu servidor Dynamics 365; por exemplo: crmtest. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.

Os parâmetros a seguir são opcionais: useUniqueInstance, useSsl e orgDetail.

Conectar à implantação para a Internet (IFD) do Dynamics 365

Use o criado a seguir para se conectar à instância do IFD Dynamics 365.

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

A autenticação baseada em declarações será executada 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 de seu servidor Dynamics 365; por exemplo, crmtest. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.

Os parâmetros a seguir são opcionais: useUniqueInstance, useSsl e orgDetail.

Conectar à implantação para a Internet (IFD) do Dynamics 365 usando OAuth

Use o criador a seguir para usar o protocolo OAuth em Serviços de Federação do Active Directory (AD FS) no Windows Server 2012 R2 para se conectar à instância do Dynamics 365 IFD. Para que isso funcione, o computador em que o Servidor do Microsoft Dynamics 365 está instalado deve ser configurado para usar o AD FS 2.2 como o serviço de token de segurança (STS). O suporte OAuth para se conectar a uma instância IFD Dynamics 365 é introduzida em Dynamics 365.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<HomeRealm>", "<HostName>", "<Port>", "<OrgName>", useSsl:true, useUniqueInstance:false, 
                        <orgDetail>, <userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, externalOrgWebProxyClient, PromptBehavior.Auto);

Os valores clientId e redirectUri para o aplicativo que suportam o OAuth devem ser registrados no servidor IFD.

Se as credenciais do usuário (nome de usuário e senha) não forem especificadas, o ADAL solicita o usuário a fornecer credenciais dependendo do parâmetro (opcional) PromptBehavior especificadas no construtor. O ADAL autentica o usuário usando o token de segurança no AD FS e usa o token para realizar ações no Dynamics 365.

Conecte-se ao Dynamics 365 (baseado em declarações)

Use o seguinte construtor para usar a autenticação baseada em declarações.

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

A autenticação baseada em declarações será executada em relação ao 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 de seu servidor Dynamics 365; por exemplo, crmtest. Para o parâmetro <OrgName>, você pode especificar a conta ou o nome amigável exclusivo.

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

AuthenticationType
Usar cadeias de conexão no trabalho realizado com ferramentas de XRM para se conectar ao Dynamics 365
Usar cmdlets do PowerShell para ferramentas XRM e conectar ao Dynamics 365
Usar as ferramentas do XRM para executar ações no Dynamics 365
Exemplo: início rápido do Microsoft Dynamics 365
Criar aplicativos cliente do Windows usando as ferramentas XRM

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais