Usar cadeias de conexão no trabalho realizado com ferramentas de XRM para se 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

Com Microsoft Dynamics 365 (online e local), a ferramenta de XRM habilita conectar a sua instância de Dynamics 365 usando cadeias de conexão. Isto é semelhante ao conceito das cadeias de conexão usadas com o Microsoft SQL Server. As cadeias de conexão têm suporte no modo nativo nos arquivos de configuração, incluindo a capacidade de criptografar seções de configuração para a máxima segurança. Isso permite que você configure conexões de Dynamics 365 do tempo de implantação e, no código não no aplicativo avançado se conectar à instância Dynamics 365.

Neste tópico

Criar uma cadeia de conexão

Parâmetros da cadeia de conexão

Exemplos de cadeias de conexão

Determina o status da conexão

Criar uma cadeia de conexão

Forneça esta cadeia de conexão no arquivo web.config ou app.config do projeto, conforme mostrado no exemplo a seguir.

<connectionStrings>
    <add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
</connectionStrings>
System_CAPS_security Segurança Observação

Se você adicionar quaisquer informações confidenciais ao arquivo web.config ou app.config, por exemplo, a senha de uma conta, verifique se você tomou precauções de segurança adequadas para proteger as informações.

Após criar uma cadeia de conexão, você a usa para criar um CrmServiceClient.

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

Observação

Você terá de usar as diretivas a seguir using em seu código para fazer referência ao namespace System.Configuration para acessar a cadeia de conexão em seu código: using System.Configuration;

Após criar um CrmServiceClient, você poderá usar o objeto para executar ações no Dynamics 365.Para obter mais informações:Usar as ferramentas do XRM para executar ações no Dynamics 365

Parâmetros da cadeia de conexão

A cadeia de conexão contém uma série name=value de pares semi separados por ponto-e-vírgula. A tabela a seguir lista os parâmetros com suporte, que podem ser digitados em qualquer ordem.

Nome do parâmetro

Descrição

ServiceUri, Service Uri, Url, or Server

Especifica a URL para o Servidor do Microsoft Dynamics 365. A URL pode usar o protocolo http ou https, e a porta é opcional. A porta padrão é 80 para o protocolo http e 443 para o protocolo https. A URL do servidor é geralmente no formato de http://crm-server:port/organization-name para Dynamics 365 local e https://organization-name.crm.dynamics.com para Dynamics 365 (online).

O nome da organização é necessário. Você pode especificar um nome amigável ou único para a organização se conectar.

Exemplo: http://contoso/test, http://contoso:5555/test, https://contoso/test, https://test.crm.dynamics.com ou http://10.10.10.2/test.

Domain

Especifica o domínio que verificará as credenciais de usuário.

UserName, User Name, UserId, or User Id

Especifica o nome da identificação de usuário associado às credenciais.

Password

Especifica a senha do nome de usuário associado às credenciais.

HomeRealmUri ou Home Realm Uri

Especifica a região Uri de início.

AuthenticationType ou AuthType

Especifica o tipo de autenticação para conectar-se à instância do Dynamics 365. Valores válidos são: AD, IFD (AD FS habilitado), OAuth ou Office365.

  • AD e IFD são permitidos para Dynamics 365 apenas instâncias locais.

  • OAuth é permitido para Dynamics 365 (online) e instâncias locais.

  • Office365 é permitido para instâncias de Dynamics 365 (online) somente.

RequireNewInstance

Especifica se deve reutilizar uma conexão existente se for chamado novamente quando a conexão estiver ativa. O valor padrão é false que indica que a conexão existente pode ser reutilizada. Se definido como true, forçará o sistema a criar uma conexão exclusiva.

ClientId, AppId ou ApplicationId

Especifica o ClientID atribuído quando você registrou seu aplicativo em Active Directory do Microsoft Azure ou Serviços de Federação do Active Directory (AD FS).

Esse parâmetro é aplicável quando o tipo de autenticação é especificado como OAuth.

RedirectUri ou ReplyUrl

Especifica a URI de redirecionamento do aplicativo registrado em Active Directory do Microsoft Azure ou Serviços de Federação do Active Directory (AD FS).

Esse parâmetro é aplicável quando o tipo de autenticação é especificado como OAuth.

TokenCacheStorePath

Especifica o caminho completo do local onde o cache de token de usuário deve ser armazenado. O processo está em execução deve ter o acesso para o caminho especificado. A responsabilidade define processos e configura esse caminho.

Esse parâmetro é aplicável quando o tipo de autenticação é especificado como OAuth.

LoginPrompt

Especifica se o usuário recebe pedido de credenciais se as credenciais não forem fornecidas. Os valores válidos são:

  • Always: Sempre solicita que o usuário especifique credenciais.

  • Auto: Permite que o usuário selecione na interface de logon do controle a solicitação se exibir ou não.

  • Never: Não solicita que o usuário especifique credenciais. Se usar um método da conexão não tem uma interface de usuário, use esse valor.

Esse parâmetro é aplicável quando o tipo de autenticação é especificado como OAuth.

Exemplos de cadeias de conexão

Os exemplos a seguir mostram como usar cadeias de conexão para as implantações para conexão e cenários diferentes para a autenticação.

Autenticação Integrada local

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

Conta nomeada usando a autenticação de site

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

Conta denominada usando o Office 365

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

OAuth usando conta nomeada no Office 365 com UX para pedir autenticação

<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 usando conta nomeada no Dynamics 365 local com UX para pedir autenticação

<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 usando uma conta com a delegação secundário a uma região

<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" />

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 das propriedades CrmServiceClient. LastCrmError e CrmServiceClient.LastCrmException para a causa da falha na conexão.

Confira Também

CrmServiceClient
Criar aplicativos cliente do Windows usando as ferramentas XRM
Os os construtores para conectar ao Dynamics 365
Usar as ferramentas do XRM para executar ações no Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais