Conexão simplificada do Microsoft Dynamics CRM 2015
Publicado: novembro de 2016
Aplicável a: Dynamics CRM 2015
As Extensões do Desenvolvedor para o Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 usam o conceito de uma cadeia de conexão para se conectar ao servidor do Microsoft Dynamics 365. Isto é semelhante ao conceito das cadeias de conexão usadas com o Microsoft SQL Server. As cadeias de conexão são uma parte da estrutura natural do ADO.NET e também 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 incentiva o usuário a usar um modelo robusto no qual as conexões do Microsoft Dynamics 365 são configuradas no tempo de implantação e não são codificadas no aplicativo. Assim, todas as APIs das Extensões do Desenvolvedor para o Microsoft Dynamics 365 funcionam com um objeto CrmConnection, usado internamente pela classe CrmOrganizationServiceContext, conforme mostrado neste tópico, que usa uma cadeia de conexão para se conectar ao servidor.
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="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>
.jpeg "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. |
Neste tópico
Criar uma cadeia de conexão
Parâmetros da cadeia de conexão
Exemplos de cadeias de conexão
Criar uma cadeia de conexão
A cadeia de conexão é usada para criar uma instância de um objeto CrmConnection que, por sua vez, pode ser usado para criar uma instância de um objeto OrganizationService ou um objeto CrmOrganizationServiceContext.
//Use the Microsoft Dynamics CRM Online connection string from the app.config file named "CRMOnline".
var connection = new CrmConnection("CRMOnline");
var service = new OrganizationService(connection);
var context = new CrmOrganizationServiceContext(connection);
Um CrmConnection também pode ser criado de forma independente do arquivo app.config e desenvolvido de forma embutida da seguinte maneira.
var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");
Parâmetros da cadeia de conexão
O formato básico da cadeia de conexão é o mesmo que a cadeia de conexão OLEDB. É uma série de pares de nomes/valores 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 |
|---|---|
Server, Url, or Service Uri |
Especifica a URL ao servidor do Microsoft Dynamics 365. A URL pode ser http ou https e a porta é opcional se for http na porta 80 ou https na porta 443. A URL do servidor normalmente está no formato http:// crm-server: port/organization-nameMicrosoft Dynamics CRM Onlineou parahttps:// organization-name.crm.dynamics.com. O nome da organização é necessário. |
Domain |
Especifica o domínio que verificará as credenciais de usuário. |
Username 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. |
Device ID or Device User Name |
Especifica o identificador do dispositivo do Conta da Microsoft definido pelo usuário. Pode ser qualquer cadeia de caracteres não vazia. Este ID do dispositivo será registrado com a senha do dispositivo na primeira vez que a autenticação for executada. Se o ID e a senha do dispositivo não corresponderem aos valores anteriormente registrados, ocorrerá uma falha na autenticação. A ID do dispositivo se aplica apenas ao CRM Online. |
Device Password |
Especifica a senha do dispositivo do Conta da Microsoft definida pelo usuário. Deve ter no mínimo seis caracteres. Esta senha será registrada com o ID do dispositivo na primeira vez que a autenticação for executada. Se o ID e a senha do dispositivo não corresponderem aos valores anteriormente registrados, ocorrerá uma falha na autenticação. A senha do dispositivo se aplica apenas ao CRM Online. |
Timeout |
É transmitido para a propriedade Timeout da classe OrganizationServiceProxy. |
Home Realm Uri |
É transmitido para a propriedade HomeRealmUri da classe OrganizationServiceProxy. |
Tipos de proxy habilitados |
True por padrão, este parâmetro habilita o OrganizationService para retornar os tipos de proxy em vez de somente o tipo de Entity base. |
Proxy Types Assembly |
Especifica o assembly que contém os tipos de proxy do Microsoft Dynamics 365, gerados com a ferramenta CrmSvcUtil.exe, com a extensão de Microsoft.Xrm.Client.CodeGeneration. |
Caller ID |
É transmitido para a propriedade CallerId da classe OrganizationServiceProxy. |
Service Configuration Instance Mode |
Pode ser definido como Static, PerName, PerRequest ou PerInstance.PerName é padrão. Isso otimiza o número de vezes que um IServiceConfiguration<TService> será criado para um OrganizationService, para que somente um seja criado para cada cadeia de caracteres de conexão. Para obter mais informações sobre outros valores possíveis, consulte Especifique o atributo instanceMode. |
User Token Expiry Window |
Especifica um TimeSpan formatado hh:mm:ss, usado como uma compensação para quando um novo token de usuário é recuperado. Por exemplo, se este parâmetro for definido para "00:10:00", um novo token de usuário será recuperado 10 minutos antes de o token realmente expirar. |
Exemplos de cadeias de conexão
O exemplo a seguir mostra a cadeia de conexão usando a autenticação integrada local.
Url=http://crm.contoso.com/xrmContoso;
O exemplo a seguir mostra a cadeia de conexão usando a autenticação do Active Directory.
Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode
O exemplo a seguir mostra a cadeia de conexão usando o Conta da Microsoft para se conectar ao Microsoft Dynamics CRM Online.
Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode
O exemplo a seguir mostra a cadeia de conexão usando o Microsoft Online Services para se conectar ao Microsoft Dynamics CRM Online.
Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode;
Confira Também
Exemplo: início rápido de conexão simplificada usando o Microsoft Dynamics CRM
Extensões de desenvolvedor do Microsoft Dynamics CRM 2015
Gerar código com as extensões da ferramenta de geração de código (Dynamics CRM 2015)
Instruções passo a passo do portal do Dynamics CRM 2015
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais