Параметры замены

Параметры замены могут использоваться во всех разделах приложения для извлечения данных из элементов данных (под названием «параметры данных»), зарегистрированных во время выполнения приложения, которые дополняют и включают в себя контекст Unified Service Desk. Этот контекст состоит из пар строк имя-значение, которые часто меняются по мере по мере обнаружения данных различными способами в ходе использования приложения. Параметры замены используются для различных задач, таких как указание строк запроса URL-адреса, создание выходных данных скрипта в скриптлете, задание значений поиска для поиска по сущностям, интеграции компьютерной телефонии (CTI) и определения входных данных для вызываемых действий в других размещенных элементах управления. Параметры замены — это ключевые элементы, обеспечивающие широкие возможности настройки в Unified Service Desk без использования кода.

Дополнительные сведения об использовании параметров замены для настройки приложения агента см. в разделе Использование параметров замены для настройки Unified Service Desk.

Содержание

Просмотр параметров замены в Unified Service Desk

Системные параметры замены

Просмотр параметров замены в Unified Service Desk

Для просмотра списка доступных параметров замены в любой момент времени можно использовать элемент управления «Отладчик» в клиентском приложении.

1. Запустите клиент Unified Service Desk и войдите в Microsoft Dynamics CRM с установленными примерами пакетов.

2. В главном окне клиента Unified Service Desk щелкните стрелку вниз рядом с значком шестеренки в правом верхнем углу и выберите команду Отладка. Откроется окно отладчика.

   

3. В отладчике нажмите кнопку Параметры данных, чтобы просмотреть параметры замены.

   

Доступные переменные отображаются в древовидной структуре. При определении переменной следует указать имя корневого уровня, затем точку (.) и соответствующее имя из списка. Ниже приведено несколько примеров:

• [[$Session.IsGlobal]]

• [[$User.fullname]]

Эти значения будут меняться по мере работы пользователя в клиенте Unified Service Desk. Текущее значение будет использоваться в вызовах действий — в списке параметров или в других целях. При каждом обновлении переменных в базовых элементах управления создается событие NotifyContextChange, даже если сам контекст Unified Service Desk не изменился. Это позволяет перепроверить параметры замены в таких функциях, как строки сеанса, и определить, требуется ли обновить его отображение.

Системные параметры замены

Системные параметры замены являются параметрами замены, которые определяются и заполняются системой. Их имена начинаются с знака $ для различения с пользовательскими параметрами замены. Например, $Global. Unified Service Desk имеет следующие параметры замены:

• $Context

• $Debug

• $Debug

• $Resources

• $Return

• $Session

• $Settings

• $Subject

• $User

$Context

В этом разделе приведено содержание контекста сеанса User Interface Integration (UII). Раздел предоставляет простой способ использовать переменные контекста сеанса UII в приложении Unified Service Desk.

$Debug

Это специальное значение замены, которое используется только в скриптлете для определения его вызова в окне отладки. Этот параметр, в частности, проверяется в случае, если скриптлеты ведут к вызову действий для системы, с целью определить, следует ли пропустить этот блок кода при отладке во избежание побочных эффектов. Приведенный ниже скриптлет запустит размещенный элемент управления «Организация» и отобразит эту вкладку при открытии окна отладки.

CRMGlobalManager.GetApp(“Account”);

Это связано с тем фактом, что скрипты выполняются в текущем контексте для определения своих значений в текущем состоянии системы. Чтобы избежать такого побочного эффекта, выполните следующую команду.

If ([[$Debug]]!= true) CRMGlobalManager.GetApp(“Account”);

Это позволит предоставить в отладчик полезные сведения без побочного эффекта.

$Global

Этот раздел добавляется автоматически для отображения всех параметров, настроенных в параметрах CRM, и их значений. Это делает параметры легко доступными, поскольку они могут использоваться для управления выполнением или контроля поведения, созданного в бизнес-процессе или вызове действия. В этом разделе автоматически доступны все флаги аудита.

$Resources

Этот набор параметров замены заполняется идентификаторами языка в глобальном диспетчере. В конфигурации размещенного элемента управления «Глобальный диспетчер» можно указать различные языковые ресурсы. Эти ресурсы состоят из файлов .resx, но загружаются в веб-ресурсы как файлы XML-файлы. После загрузки приложения Unified Service Desk считает текущие языковые настройки из CRM и найдет соответствующий язык в списке языков глобального диспетчера. Если элемент присутствует в списке, данный ресурс идентификаторов языка будет загружен в набор $Resources.

Параметрами замены из этого набора $Resources можно воспользоваться, если в выходных данных должен содержаться независимый от языка текст. Например, можно ввести для текста кнопки приведенную ниже строку.

[[$Resources.MyButtonName]+]

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

Важно также отметить, что эти параметры замены и, соответственно, загруженные файлы .resx могут содержать сам синтаксис параметра замены. После замены значений $Resources они перепроверяются на наличие дополнительных параметров замены. Благодаря этому, даже при предоставлении строк на конкретном языке можно подставить в эту строку данные из остального приложения.

Дополнительные сведения о добавлении локализованных ресурсов для настройки Unified Service Desk см. в разделе Добавление многоязыковой поддержки в приложения агента.

$Return

Некоторые действия возвращают строковое значение. Это строковое значение помещается в параметр замены $Return с использованием имени вызова действия. Используется следующий шаблон:

[[$Return.ActionCallName]]

В качестве примера можно привести вызов действия CreateEntity в глобальном диспетчере. Это приведет к созданию записи в CRM и возврату идентификатора GUID новой записи. Этот новый идентификатор GUID будет доступен в списке параметров замены $Return и может использоваться в качестве входных данных для следующего действия.

$Session

Раздел $Session охватывает полезные переменные, требуемые вызовами действия, такие как число сеансов, является ли активный сеанс глобальным, идентификатор текущего активного сеанса. Значение StartTime может использоваться для записи времени начала в действие. Этот раздел заполняется автоматически.

$Settings

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

Эти пользовательские параметры определяются в области Параметры пользователя (Параметры > Параметры пользователя) в CRM при настройке Unified Service Desk.

Данные параметры можно использовать как любые другие параметры замены в системе. Размещенный элемент управления «Глобальный диспетчер» предоставляет действие SaveSetting, которое запишет параметры пользователя на сервере при условии, что пользователь обладает правами на запись. Эта возможность используется для хранения параметров конкретного пользователя, таких как тема и макет.

$Subject

Полезная возможность в Unified Service Desk — автоматическая подстановка древовидного списка тем в новое обращение, которое создается от имени пользователя. Иногда необходимо автоматически заполнять поле темы, однако требуется знать нужные значения, которые могут меняться в зависимости от системы.

Эта запись позволяет ссылаться на определенную тему при создании обращения при помощи следующего параметра замены.

[[$Subject.Default Subject.Id]][[$Subject.Default Subject.LogicalName]]

$User

Эта группа параметров замены автоматически заполняется содержимым записи текущего пользователя в CRM. Например, если администратор расширяет пользовательскую сущность системного пользователя в CRM с добавлением идентификатора агента, указанный идентификатор будет отображаться в этом списке. Это можно использовать для настройки особых пользовательских параметров.

См. также

Основные понятия:

Использование параметров замены для настройки Unified Service Desk
Выполнение скриптов с помощью сценариев Scriptlet в Unified Service Desk
Поиск данных с помощью поисков по сущностям в Unified Service Desk
Глобальный руководитель (размещенный элемент управления)

Другие ресурсы

Работа в Unified Service Desk

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