Compartilhar via

Conectando-se a uma instância do Dynamics 365 usando o cliente do Unified Service Desk

  • Artigo

 

Publicado: novembro de 2016

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

O cliente Unified Service Desk é o aplicativo de agente que pode ser usado para estabelecer conexão com a instância do Microsoft Dynamics 365 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 Dynamics 365 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 Dynamics 365.

    Tela de login do cliente do Unified Service Desk

    • Para Microsoft Dynamics 365 (online), selecione Office 365.

    • Para implantações do local, selecione Local e escolha uma das Origens de Autenticação a seguir.

      • Active Directory. Escolha essa origem de autenticação se você estiver se conectando ao Dynamics 365 (local) internamente, por meio da rede, e não ao Microsoft Dynamics 365 pela Internet.

      • IFD (Implantação para a Internet). Escolha essa origem de autenticação se você estiver se conectando ao Dynamics 365 (local) pela Internet.

      • OAuth. Escolher essa origem de autenticação se você estiver se conectando ao Dynamics 365 (local) usando um serviço de token de segurança (STS) que não seja o Windows Server, mas que ofereça suporte à estrutura aberta do OAuth.

    • 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 e clique em Fazer 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. Esta tela mostra 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 Dynamics 365. Digite suas credenciais e, em seguida, conecte-se ao aplicativo cliente Unified Service Desk.

Sempre que você iniciar o cliente Unified Service Desk e precisar fazer logon novamente, não será necessário fornecer as informações de conexão novamente. Suas credenciais são armazenadas com segurança no Windows Credential Manager e outras informações de conexão são armazenadas no arquivo Default_USD.config em c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD, e usadas 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 caixa de diálogo inicial de conexão em que pode inserir credenciais diferentes.

Tela de alteração de credenciais do Unified Service Desk

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 Dynamics 365, ou podem configurar para conectar automaticamente os usuários a uma instância local do Dynamics 365 com base em suas credenciais do Active Directory sem exibir a caixa de diálogo de logon.

Dica

Não é possível adicionar ou remover os campos na caixa de diálogo de entrada Unified Service Desk. Você só pode especificar os valores que serão exibidos nos campos, quando um usuário tentar fazer logon. Entretanto, os usuários podem alterar os valores preenchidos previamente na caixa de diálogo de logon Unified Service Desk antes de fazer 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. 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 ou O365

    Prem deve ser usada se estiver se conectando a um local ou Implantação para a Internet (IFD) do Dynamics 365; O365 deve ser usada se estiver se conectando ao Dynamics 365 (online).

    CrmUseSSL

    True ou False

    Esta chave só é aplicável se você especificou Prem na chave CrmDeploymentType.

    CrmOrg

    Especifique o nome da organização do Dynamics 365

    CrmPort

    Especifique o número de porta do Dynamics 365

    Esta chave só é aplicável se você especificou Prem na chave CrmDeploymentType.

    CrmServerName

    Especifique o nome do servidor do Dynamics 365

    Esta chave só é aplicável se você especificou Prem na chave CrmDeploymentType.

    UseDefaultCreds

    True ou False

    Dica

    Para a instalação local do Dynamics 365(<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 Dynamics 365 sem exibir a caixa de diálogo de logon.

    CacheCredentials

    True ou False

    Dica

    Para forçar a caixa de diálogo de conexão a ser exibida 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 Dynamics 365, a menos que o usuário cancele e especifique uma conexão diferente.

    CrmOnlineRegion

    NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND 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 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.

    Esta chave só é aplicável se você especificou Prem na chave CrmDeploymentType.

    1. Salve o arquivo UnifiedServiceDesk.exe.config.

    2. 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 o usuário inicia o aplicativo Unified Service Desk no computador:

    • A caixa de diálogo de logon mostra 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 Dynamics 365 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 a 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.

    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 365. 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 365 a partir do aplicativo cliente.

    Dica

    O Unified Service Desk também cria outro arquivo de log, UnifiedServiceDesk.log, no mesmo local, para registrar os erros operacionais no aplicativo cliente. O arquivo de log é criado na primeira vez em que você encontra qualquer problema no aplicativo cliente.Para obter mais informações:Configurar registro de diagnóstico do cliente no Unified Service Desk

    Confira Também

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

    Unified Service Desk 2.0

    © 2016 Microsoft. Todos os direitos reservados. Direitos autorais