通过

替换参数

  • 项目

 

发布日期： 2016年11月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2013,Dynamics CRM 2015,Dynamics CRM 2016

可以在应用程序中使用替换参数以从数据元素（调用的数据参数）提取在执行增加和包含 Unified Service Desk 上下文的应用程序期间捕获的数据。 上下文包括频繁更改的名称/值字符串对，因为在使用应用程序时会通过各种方式发现数据。 替换参数用于各种任务，例如指定 URL 查询字符串，用 scriptlet 生成脚本输出，为实体搜索指定搜索值，计算机电话集成 (CTI) 以及为在其他承载控件上被调用的操作指定输入。 替换参数是无需使用代码启用 Unified Service Desk 中的高度配置或自定义项的关键元素。

有关如何使用参数替换配置您的代理应用程序的信息，请参阅使用替换参数配置 Unified Service Desk。

备注

因为替换参数基本是数据参数的表示形式，所以有时替换参数可与数据参数互换使用。

本主题内容

查看 Unified Service Desk 中的参数替换

系统替换参数

查看 Unified Service Desk 中的参数替换

客户端应用程序中的调试器控件可用于在指定时间查看可用的替换参数列表。

  1. 启动 Unified Service Desk 客户端，然后登录您已在其中安装示例包的 Microsoft Dynamics 365。

  2. 在 Unified Service Desk 客户端的主屏幕上，请单击右上角的齿轮旁边的向下按钮，然后选择“调试”。 此时，将显示调试器。

    调试选项打开调试程序

  3. 在调试器中，单击“数据参数”查看替换参数。

    “数据参数”选项卡中的替换参数

树视图用于表示可用的变量。 在指定变量时，请在根级别指定名称，后面加上句号 (.)，然后加上列表中的名称。 以下是一些示例：

  • [[$Session.IsGlobal]]

  • [[$User.fullname]]

这些值将根据 Unified Service Desk 客户端中的用户进行更改。 操作调用将提取当前值并在其参数列表或在任意地方使用。 每当更新变量时，都会在基础控件中触发“NotifyContextChange”事件，即使 Unified Service Desk 上下文不会自己更改。 此允许像会话行这样的功能重新检查替换参数的值以确认是否需要更新其显示。

系统替换参数

系统替换参数为由系统定义和填充的系统替换参数，名称以 $ 开始以与用户定义的替换参数区分开来。 例如，$Global。Unified Service Desk 具有以下替换参数：

  • $上下文

  • $调试

  • $全局

  • $面板

  • $资源

  • $返回

  • $会话

  • $设置

  • $主题

  • $SystemParameters

  • $用户

$上下文

本节包含 User Interface Integration (UII) 会话上下文的内容，然后提供一便利的方式使用 UII 会话 Unified Service Desk在应用程序上下文中的变量。

备注

全局管理器托管控件提供允许您将其他替换参数中的值复制到上下文的操作。 在转移呼叫或随后解除冻结的情况下非常有用。 使用标准的 UII 机制可将上下文保存到这些实例中的服务器上。

$调试

这是一个只在 Scriptlet 内使用的特殊替换值以决定是否正在被调试窗口调用。 特别是在 scriptlet 导致在系统上执行操作时，我们测试此参数以决定是否应该跳过代码块以避免调试时的副作用。 在打开调试窗口时，以下 scriptlet 将启动客户承载的控件并显示选项卡。

CRMGlobalManager.GetApp(“Account”);

这是因为这些脚本都在当前上下文中运行以确定他们在系统的当前状态的值。 要防止发生这种副作用，请执行以下步骤：

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

这会避免副作用并继续为调试器提供有用的信息。

$全局

自动添加本节以显示在 Dynamics 365 选项中配置的所有选项和它们的值。 这使得选项可以被轻松访问，因为可将它们用于控制执行或控制在工作流或操作调用中创建的行为。 在本节中所有审计标记都可自动可见。

$面板

在您最后一次启动 Unified Service Desk 客户端后，$Panel 替换参数中会包含所有托管控件及其当前面板名称并将它们作为移动到其他面板的键-值对。 只有在您启动 Unified Service Desk 客户端后至少更改一个托管控件，才能使用替换参数。 本托管参数不能使用其他所有的托管控件和代理桌面中当前加载的现有面板。

$资源

由全局管理器用语言标识符填充这个替换参数集。 在全局管理器托管控件的配置中，可以指定不同的语言资源。 这些资源表现为 .resx 文件的形式，但是作为 XML 文件被上载到 web 资源。 在加载应用程序时，Unified Service Desk 将从 Dynamics 365 读取当前的语言设置，然后在全局管理器语言列表中查找该语言。 如果列出了项目，则语言标志符的资源将被加载到此 $资源集。

无论您打算在哪提供语言中性文本输出，您可以使用该 $Resources 资源集中的替换参数。 例如，您可以为按钮文本使用以下内容。

[[$Resources.MyButtonName]+]

取决于用户选择的语言，将使用相应的本地化文本。

在此注意加载的这些替换参数和 .resx 文件可能自身包含替换参数语法也很重要。 在替换了 $Resources 值以后，就可以为其他替换参数重新检查了。 这样，即使您提供了特定语言的字符串，您也可以将其余的应用程序的数据替换为此字符串。

有关添加本地化资源以 Unified Service Desk 的信息，请参阅为您的代理应用程序添加多语言支持。

$返回

一些操作会返回字符串值。 返回的字符串值将被放到使用操作调用的名称的 $返回替换参数中。 它将遵循下面的模式：

[[$Return.ActionCallName]]

对此可参考的示例为全局管理器上的名为 CreateEntity 的示例。 这将在 Dynamics 365 中创建一个记录并返回新记录的 GUID。 这个新 GUID 位于 $Return 替换参数列表中并可用作下一个操作的输入。

$会话

$Session 节介绍了操作调用所需的有用变量，如会话数，无论当前会话是否全局的、当前活动的会话 ID。StartTime 值可用于编写活动的开始时间。 此部份是自动填充的。

$设置

本节提供只适用于当前用户的用户设置。 开始时自动加载这些设置，在运行时可以使用操作调用进行读取。 这些通常包括用户的主题选择的设置，但可能提供配置程序希望使用的对特定用户设置的访问权限。

在配置 Unified Service Desk 时，在 Dynamics 365 中的“用户设置”区域（“设置”>“用户设置”）中定义这些用户设置。

可以向系统中的其他替换参数那样使用这些设置。 全局管理器托管控件提供一个假定用户拥有写访问权，将用户设置写入服务器的操作，SaveSetting。 这可用于存储用户特定的首选项，比如主题选择和布局。

备注

如果用户拥有写入访问权，则可将用户设置保存到 Dynamics 365 服务器上。

$主题

Unified Service Desk 中的一个有用功能是在代表用户创建的新案例中自动填充主题树。 有时您要自动填充主题字段，但您需要知道要使用的正确值，这个值会根据每个系统而有所不同。

有通过这个条目，在您创建案例时，使用以下替换参数就可以引用特定主题。

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

$SystemParameters

本部分中包含一个名称为 HighContrast 的变量，该变量用于显示 Windows 中是否启用了高对比度模式 (true/false)。 自定义客户端中的主题时，可使用该变量决定启用正常自定义颜色还是系统颜色（兼容高对比度设置）。详细信息：Customize themes for High Contrast settings

$用户

这个替换参数组自动用 Dynamics 365 中的当前用户记录的内容填充。 例如，如果管理员扩展 Dynamics 365 中的系统用户实体以包括代理 id，则该代理 id 将显示在此列表中。 这可以用于配置特定用户设置。

另请参阅

使用替换参数配置 Unified Service Desk
在 Unified Service Desk 中使用 scriptlet 执行脚本
使用 Unified Service Desk 中的实体搜索搜索数据
学习使用统一服务台
全局管理器（承载的控件）

Unified Service Desk 2.0

© 2017 Microsoft。 保留所有权利。 版权