Подключение к приложению на основе модели

Клиент Unified Service Desk — это приложение агента, которое можно использовать для подключения к экземпляру Microsoft Dataverse, в котором вы развернули сущности и данные конфигурации Unified Service Desk. При входе с помощью клиентского приложения он считывает конфигурацию Unified Service Desk в экземпляре Dataverse и соответственно предоставляет элементы управления и функциональные возможности в приложении.

Вход в Unified Service Desk

Если вы хотите настроить интерфейс входа, например путем предварительного заполнения значений в диалоговом окне входа или автоматического входа пользователей без отображения диалогового окна входа, перейдите к разделу "Настройка сведений о входе".

1. Запустите клиент Unified Service Desk, дважды щелкнув ярлык приложения на рабочем столе.

2. В диалоговом окне входа в Unified Service Desk укажите сведения о проверке подлинности для подключения к серверу Dataverse.

   • Для Dataverse выберите Microsoft 365.

   • Для развертываний Dynamics 365 Customer Engagement (локальная среда) выберите локальную среду и выберите из следующих источников проверки подлинности.

     • Active Directory. Выберите этот источник проверки подлинности, если вы подключаетесь к Customer Engagement (локально) внутри сети и не подключаетесь к Dataverse через Интернет.

     • Развертывание с подключением к Интернету (IFD). Выберите этот источник проверки подлинности, если вы подключаетесь к Customer Engagement (локально) через Интернет.

     • OAuth. Выберите этот источник проверки подлинности, если вы подключаетесь к Customer Engagement (локально) с помощью службы маркеров безопасности (STS), отличной от Windows Server, которая поддерживает открытую платформу OAuth.

   • Если у вас несколько организаций и хотите выбрать организацию, в которой развернута служба Unified Service Desk, установите флажок "Отобразить список доступных организаций " и нажмите кнопку "Войти".

3. Если у вас несколько организаций, выберите организацию, к которой вы хотите подключиться.

4. Появится экран заставки Unified Service Desk. На этом экране показаны сведения о данных конфигурации, считываемых клиентом в фоновом режиме. Затем появится главное окно и появится запрос на ввод учетных данных сервера Dataverse. Введите учетные данные и войдите в клиентское приложение Unified Service Desk.

   При запуске клиента Unified Service Desk и повторного входа вам не придется предоставлять сведения о подключении. Ваши учетные данные хранятся безопасно в диспетчере учетных данных Windows, а другие сведения о подключении хранятся в файле Default_USD.config на C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> и используются для последующих действий входа.

   Если вы хотите изменить сведения о подключении для входа, выберите "Изменить учетные данные " на экране-заставке. Откроется диалоговое окно начального входа, в котором можно ввести разные учетные данные.

   "

Настройка сведений о входе

При необходимости администраторы могут настроить интерфейс входа для Unified Service Desk путем предварительного заполнения значений (за исключением имени пользователя и пароля) в диалоговом окне входа, чтобы пользователи могли подключаться к указанному экземпляру Dataverse или настроить его для автоматического входа пользователей в локальный экземпляр Dataverse на основе учетных данных Пользователя Active Directory, даже не отображая диалоговое окно входа.

Чтобы настроить сведения о входе, используйте файл UnifiedServiceDesk.exe.config, доступный в каталоге установки клиента (обычно C:\Program Files\Microsoft Dynamics CRM USD\USD).

1. Запустите Блокнот от имени администратора.

2. В Блокноте откройте файл UnifiedServiceDesk.exe.config из каталога установки клиента (обычно C:\Program Files\Microsoft Dynamics CRM USD\USD).

3. Добавьте следующие ключи под <appSettings> узлом в файл 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. Укажите соответствующее значение для каждого ключа. Каждый ключ сопоставляется с отдельным полем в диалоговом окне входа. В следующей таблице показаны допустимые значения ключей.

   Key	Ценность
   CrmDeploymentType	Prem или O365 Prem необходимо использовать, если вы подключаетесь к Customer Engagement (локально); O365 необходимо использовать при подключении к Dataverse.
   CrmUseSSL	True или False Этот ключ применим только в том случае, если вы указали PremCrmDeploymentType в ключе.
   CrmOrg	Укажите имя организации Dataverse.
   CrmPort	Укажите номер порта Dataverse. Этот ключ применим только в том случае, если вы указали PremCrmDeploymentType в ключе.
   CrmServerName	Укажите имя сервера Dataverse. Этот ключ применим только в том случае, если вы указали PremCrmDeploymentType в ключе.
   UseDefaultCreds	True или False Заметка: Для установки (<add key="CrmDeploymentType" value="Prem" />Customer Engagement (локальной) и проверки подлинности (<add key="AuthHomeRealm" value="Active Directory" />Active Directory задайте значение этого ключа для True непосредственного входа пользователей на указанный сервер или организацию Dataverse, даже не отображая диалоговое окно входа.
   CacheCredentials	True или False Заметка: Чтобы принудительно отобразить диалоговое окно подключения при каждом открытии клиента Unified Service Desk, задайте значение этого ключа False. По умолчанию клиент кэширует последние сведения о подключении и использует его при следующем создании подключения к серверу Dataverse (если пользователь не отменяет и не указывает другое подключение).
   CrmOnlineRegion	NorthAmerica, EMEA, APACSouthAmericaOceaniaJPNCANINDNorthAmerica2 Если вы не знаете онлайн-регион, оставьте значение пустым: value="" Этот ключ применим только в том случае, если вы указали O365CrmDeploymentType в ключе.
   AuthHomeRealm	Active Directory или Internet-facing deployment(IFD) Этот ключ применим только в том случае, если вы указали PremCrmDeploymentType в ключе.
   AskForOrg	True или False Указывает, установлен ли флажок "Вывод списка доступных организаций " в диалоговом окне входа.
   CrmDomain	Укажите имя домена Windows. Этот ключ применим только в том случае, если вы указали PremCrmDeploymentType в ключе.

5. Сохраните файл UnifiedServiceDesk.exe.config.

6. Выполните следующие действия на компьютере каждого пользователя, где требуется настроить сведения о входе:

   1. Скопируйте файл UnifiedServiceDesk.exe.config, который вы только что изменили в каталог установки клиента (обычно C:\Program Files\Microsoft Dynamics CRM USD\USD), чтобы заменить существующий файл.

   2. Удалите сведения о входе в Unified Service Desk из перемещаемых профилей пользователей на компьютере пользователя. Если пользователь выполнил вход в Unified Service Desk с компьютера по крайней мере один раз, в каталоге C:\Users\USER_NAME<\>AppData\Roaming\Microsoft Dynamics 365 Unified Service Desk: Default_USD.config и Default_USD. Эти файлы необходимо удалить, чтобы параметры конфигурации в файле UnifiedServiceDesk.exe.config вступают в силу.

   Когда пользователь запускает приложение Unified Service Desk на своем компьютере:

   • В диалоговом окне входа отображаются значения, указанные в файле UnifiedServiceDesk.exe.config, а также создается файл Default_USD.config в каталоге C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk для хранения сведений о подключении (за исключением имени пользователя и пароля; они хранятся в Диспетчере учетных данных Windows). После этого клиентское приложение использует файл Default_USD.config для отображения сведений о входе или автоматического входа в Unified Service Desk.

   • Для установки Customer Engagement (локальной) с проверкой подлинности Active Directory, если вы настроили автоматический вход пользователя без отображения диалогового окна входа (<add key="UseDefaultCreds" value="True" />), диалоговое окно входа не отображается, но файл Default_USD.config создается в каталоге C:\Users\USER_NAME<\AppData\>Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk для хранения сведений о подключении (за исключением имени пользователя и пароля). После этого клиентское приложение использует файл Default_USD.config для автоматического входа в Unified Service Desk.

Если необходимо изменить сведения о входе по умолчанию, необходимо повторить шаги 1–6.

Устранение неполадок при входе

Unified Service Desk обеспечивает поддержку ведения журнала ошибок, которые могут возникнуть при входе в Dataverse. Файл журнала, Login_ErrorLog.log, создается в C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> при первом возникновении проблем входа в клиентском приложении. После этого файл журнала используется для записи сведений о последующих проблемах входа. Эти сведения могут быть полезны для устранения неполадок, связанных с входом в Dataverse из клиентского приложения.

См. также

Управление доступом в Unified Service Desk
Узнайте, как использовать Unified Service Desk
Пошаговое руководство по настройке Unified Service Desk
Общие сведения об администрировании и управлении ими