Conectar-se à uma instância do CRM usando o cliente do Unified Service Desk

O cliente Unified Service Desk é o aplicativo agente que pode ser usado para conectar a instância do Microsoft Dynamics CRM onde você implantou suas entidades e dados de configuração do Unified Service Desk. Ao se conectar por meio do aplicativo cliente, ele lê a configuração do Unified Service Desk na instância do CRM e expõe adequadamente os controles e a funcionalidade do aplicativo.

Neste tópico

Conectar-se ao Unified Service Desk

Configurar informações de logon

Solução de problemas de logon

Conectar-se ao Unified Service Desk

Para configurar a experiência de logon, como preencher valores previamente na caixa de diálogo de logon ou conectar automaticamente usuários sem exibir a caixa de diálogo de logon, consulte Configurar informações de logon.

1. Inicie o cliente Unified Service Desk, clicando duas vezes no atalho do aplicativo na área de trabalho.

2. Na caixa de diálogo de logon do Unified Service Desk, forneça os detalhes de autenticação para se conectar ao servidor do CRM. Se você tiver várias organizações e quiser selecionar a organização em que o Unified Service Desk foi implantado, marque a caixa de seleção Exibir lista de organizações disponíveis. Clique em Logon.

   

3. Se você tiver várias organizações, selecione a organização à qual deseja se conectar.

4. A tela inicial do Unified Service Desk será exibida. A tela exibe as informações sobre os dados de configuração que estão sendo lidos pelo cliente em segundo plano. Em seguida, aparece a janela principal solicitando que você insira suas credenciais do servidor do CRM. Digite suas credenciais e, em seguida, conecte-se ao aplicativo cliente Unified Service Desk.

Sempre que você iniciar o cliente Unified Service Desk para fazer logon novamente, não será necessário fornecer as informações de conexão novamente. Suas credenciais são armazenadas no Windows Credential Manager e as outras informações de conexão são armazenadas no arquivo Default_USD.config em c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD, e serão utilizadas para atividades de logon subsequentes.

Se desejar alterar suas informações de conexão para logon, clique em Alterar credenciais na tela inicial. Você será levado para a tela inicial de conexão em que pode adicionar credenciais diferentes.

Configurar informações de logon

Se necessário, os administradores podem configurar a experiência de logon do Unified Service Desk para preencher previamente os valores na caixa de diálogo de logon (exceto o nome de usuário e senha) para que os usuários possam se conectar à instância específica do CRM, ou podem configurar para conectar automaticamente os usuários a uma instância local do CRM com base em suas credenciais do Active Directory sem exibir a caixa de diálogo de logon.

Para configurar as informações de logon, use o arquivo UnifiedServiceDesk.exe.config disponível no diretório de instalação do cliente (normalmente c:\Program Files\Microsoft Dynamics CRM USD\USD).

1. Execute Bloco de Notas como administrador.

2. Em Bloco de Notas, abra o arquivo UnifiedServiceDesk.exe.config do diretório de instalação do cliente (normalmente c:\Program Files\Microsoft Dynamics CRM USD\USD).

3. Adicione as seguintes chaves sob o nó <appSettings> no arquivo UnifiedServiceDesk.exe.config.

   <add key="CrmDeploymentType" value="<DEPLOYMENT_TYPE>" />
   <add key="CrmUseSSL" value="<VALUE>" />
   <add key="CrmOrg" value="<ORG_NAME>" />
   <add key="CrmPort" value="<PORT_NUMBER>" />
   <add key="CrmServerName" value="<CRM_SERVER_NAME>" />
   <add key="UseDefaultCreds" value="<VALUE>" />
   <add key="CacheCredentials" value="<VALUE>" />
   <add key="CrmOnlineRegion" value="<CRM_ONLINE_REGION>" />
   <add key="AuthHomeRealm" value="<VALUE>" />
   <add key="AskForOrg" value="<VALUE>" />
   <add key="CrmDomain" value="<DOMAIN_NAME>" />
   

4. Forneça um valor adequado para cada uma das chaves conforme necessário. Cada chave mapeia um campo individual na caixa de diálogo de logon. A tabela a seguir mostra os valores de chave válidos.

   Chave	Valor
   CrmDeploymentType	Prem, O365 ou Online Prem deve ser usada se estiver se conectando a um local ou IFD (Implantação para a Internet) do CRM; O365 deve ser usada se estiver se conectando ao CRM Online. A opção Online é obsoleta.
   CrmUseSSL	True ou False
   CrmOrg	Especifique o nome da organização do CRM
   CrmPort	Especifique o número de porta do CRM
   CrmServerName	Especifique o nome do servidor do CRM
   UseDefaultCreds	True ou False Observação Para a instalação local do CRM (<add key="CrmDeploymentType" value="Prem" />) e a autenticação do Active Directory (<add key="AuthHomeRealm" value="Active Directory" />), defina o valor desta chave para True para conectar diretamente os usuários ao servidor ou organização especificada do CRM sem exibir a caixa de diálogo de logon.
   CacheCredentials	True ou False Observação Para forçar a caixa de diálogo de conexão sempre que o cliente Unified Service Desk for iniciado, defina o valor desta chave para False. Por padrão, o cliente armazena em cache as informações mais recentes de conexão e as usa na próxima vez para estabelecer uma conexão com o servidor do CRM, a menos que o usuário cancele e especifique uma conexão diferente.
   CrmOnlineRegion	NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, ou NorthAmerica2 Caso não conheça a região online, deixe o valor em branco: value="" Esta chave só é aplicável se você especificou O365 ou Online na chave CrmDeploymentType.
   AuthHomeRealm	Active Directory ou Internet-facing deployment(IFD). Esta chave só é aplicável se você especificou Prem na chave CrmDeploymentType.
   AskForOrg	True ou False Indica se a caixa de seleção Lista de exibição das organizações disponíveis está marcada na caixa de diálogo de logon.
   CrmDomain	Nome do domínio do Windows.

5. Salve o arquivo UnifiedServiceDesk.exe.config.

6. Faça o seguinte em cada computador de usuário que você deseja configurar as informações de logon:

   1. Copie o arquivo UnifiedServiceDesk.exe.config que você modificou para o diretório de instalação do cliente (normalmente c:\Program Files\Microsoft Dynamics CRM USD\USD) para substituir o arquivo existente.

   2. Remova as informações de logon do Unified Service Desk dos perfis de usuário móveis no computador do usuário. Se o usuário se conectou ao Unified Service Desk a partir de seu computador ao menos uma vez, os seguintes arquivos são criados no diretório c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD: Default_USD.config e Default_USD. Você deve excluir esses dois arquivos para que as definições de configuração do UnifiedServiceDesk.exe.config entrem em vigor.

Quando um usuário inicia o aplicativo Unified Service Desk no computador:

• A caixa de diálogo de logon exibe os valores especificados no arquivo UnifiedServiceDesk.exe.config, e também cria o arquivo Default_USD.config no diretório c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD para armazenar as informações de conexão (exceto o nome de usuário e senha; estes são armazenados em Gerenciador de Credenciais do Windows). Em seguida, o aplicativo cliente usará o arquivo Default_USD.config para exibir as informações de entrada ou para se conectar ao Unified Service Desk automaticamente.

• Para uma instalação local do CRM com autenticação do Active Directory, se você tiver configurado para conectar automaticamente o usuário sem exibir a caixa de diálogo de logon (<add key="UseDefaultCreds" value="True" />), a caixa de diálogo de logon não será exibida, mas o arquivo Default_USD.config file será criado no diretório c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD para armazenar as informações de conexão (exceto o nome de usuário e senha). Em seguida, o aplicativo cliente usará o arquivo Default_USD.config para se conectar ao Unified Service Desk automaticamente.

Se precisar alterar as informações padrão de logon, você deverá repetir etapas de 1 a 6 mencionadas nesta seção.

Solução de problemas de logon

O Unified Service Desk oferece suporte de registro para erros de log que podem ocorrer ao se conectar ao Microsoft Dynamics CRM. Um arquivo de log, Login_ErrorLog.log, é criado em c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Version> na primeira vez em que você encontra qualquer problema de conexão no aplicativo cliente. Depois disso, o arquivo de log é usado para gravar as informações sobre problemas de conexão subsequentes. Estas informações podem ser úteis para solucionar problemas relacionados à conexão no Microsoft Dynamics CRM a partir do aplicativo cliente.

Consulte também

Conceitos

Segurança no Unified Service Desk

Outros recursos

Administrar e gerenciar o Unified Service Desk
Aprenda a usar o Unified Service Desk
Passo a passo de configuração do Unified Service Desk

Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.