Dialog中的变量和输入参数

在以前的博客Dialog Part 1和Dialog Part 2中，我们讲述了Microsoft Dynamics CRM 2011中的新功能Dialog。Dialog支持变量（Variables）和输入参数（Input Arguments）。在这篇博客中，我将介绍他们是什么，如何使用它们。Dialog编辑器中有一个区域可以定义变量和输入参数，如下图所示：

 图1：变量和输入参数区域

什么是变量？

变量被用来在Dialog运行时提供临时数据存储。你可以在图1中的变量区域点击Add来创建一个新的变量。每个变量都有名称、类型和值。当创建一个变量时，你按照下图来填入相应值。在这里，我们创建了一个变量叫做CustomerName, 类型是单行文本，默认值为John Doe。默认值是这个变量最初的值。

 图2：创建新变量

什么是输入参数？

输入参数和子Dialog（Child Dialog）一起使用。当你希望从一个Dialog转向控制另一个Dialog，这时就可以使用子Dialog。之前运行的Dialog叫做父Dialog（Parent Dialog），得到控制的Dialog叫做子Dialog。考虑这样一种情况，你希望创建多个Dialog，他们的最后几步都是相同的。这时，最好为这些相同步骤创建一个单独的子Dialog。这样，如果你要修改这些相同的步骤，就不必去修改多个Dialog。你只需要修改这个子Dialog而不需要修改父Dialog。在父子Dialog之间传递控制时，可能需要传递数据，这就是通过输入参数来实现的。在创建Dialog时，你可以在Available to run区域中来指定这是一个子Dialog，如图1所示：

 · 勾选As a child process

· 去掉As an on-demand process

这样，你就可以创建输入参数来指定希望从父Dialog得到什么数据。可以点击图1中Input Arguments section的区域的Add链接来创建输入参数。跟变量一样，输入参数也有名称、类型和值。配置输入参数属性的用户界面和创建变量的界面很相似。对于输入参数来说，当父Dialog没有指定任何值时，子Dialog就会使用默认值。

在创建父Dialog时，你需要将它连接到子Dialog。你可以在编辑器中点击Link Child Dialog步骤来实现。你可以查找到子Dialog进行链接，如图3所示：

图3：链接到子Dialog

当然，你可以点击Set Properties按钮来设置链接的属性（图3所示）。在设置属性UI中，你可以为每个输入参数设置一个值。你也可以使用动态值，例如一个变量或者dialog运行在的CRM记录的一个属性。唯一需要注意的是，两种数据类型必须相同（或者能够转换）。图4是链接属性的一个截图。在这里输入参数Name（显示为String_Name）是从当前account所关联的Primary contact的Full Name属性传递来，输入参数Age是从用户对于Request for age的输入传递来，输入参数DiscountRate是从父dialog中定义的变量DiscountRate的值传递而来。

 图4：设置子dialog的属性

其他注意事项

除了使用目的，变量和输入参数还有一些共通的特性。这一小节，我将介绍一些他们之间共通的特性。之前曾提到过，每一个变量/输入参数都有名称、类型和值。

· 名称：在一个dialog中，一个变量的名称必须是唯一的。而且，名称不能设为变量或者输入参数。名称的长度限制在1000个字符以内，仅能包括字母、数字或下划线“_”。

· 类型：变量和输入参数支持三种类型：单行文本、整数和浮点数。整数支持的范围为2,147,483,648 至 2,147,483,647；浮点数支持的范围为-100,000,000,000 至 100,000,000,000。

· 值：创建变量时，你可以给它设置一个默认值。你可以将其值更改为一些操作的结果，例如Append With (若变量的类型为单行文本)，或者更改为运行dialog的用户所输入的值。你可以在需要赋值的时候使用/引用变量的值：创建/更新记录或显示提示信息。当给变量或输入参数赋值时，其数据类型必须和变量或输入参数的数据类型兼容。下表列出了可能的组合：

· 在创建dialog时，在删除变量或输入参数时要注意，如果它们被一些其他步骤所引用（如Prompt and Response步骤），那么这些步骤会失效(disabled)。 因此，建议在删除变量/输入参数之前移除这些引用关系。

· 一旦创建了变量或输入参数，他们的类型就不能被改变。

· 链接到子dialog的步骤必须是父dialog中的最后一步。Link child dialog步骤会将控制传递给子dialog。在运行父dialog时，一旦控制传递给了子dialog，就无法回到父dialog中之前的步骤了。

· 使用数字类型的变量和输入参数时没有溢出保护。需要再创建dialog时候注意这点。

· 如果在父dialog发布以后更改了子dialog中的输入参数， 那么父dialog不会自动更新。这可能会导致运行父dialog时出现错误。

谢谢！

Jackie Chen

https://blogs.msdn.com/b/crm/archive/2011/02/15/dialogs-using-variables-and-input-arguments.aspx