创建自定义对话框

Analytics 对话框生成器使您可以创建一个或更多个自定义对话框，以便在脚本执行过程中收集用户输入。

您可以使用自定义对话框执行各种功能：

• 提示用户输入信息，如表名称、域名称或日期范围
• 允许用户从多个选项中进行选择
• 显示比标准信息框更多的详细信息
• 动态列举 Analytics 项目条目

对话框控件

在对话框生成器中，您可以通过向该对话框中添加用户输入控件来设计和生成自定义对话框。

控件是小型交互式软件组件，提供了收集脚本所需用户输入的不同方式。您可以将一个或更多个控件添加到基本对话框并配置它们以适合您的需要。

以下控件可用：

• 文本标签
• 文本框
• 复选框
• 单选按钮
• 下拉列表
• 项目条目列表

下面的自定义对话框范例提供了每个类型控件的示例。

对话框被自动转换为命令

当您保存刚创建的自定义对话框时，Analytics 会自动将可视化对话框转换为匹配的 ACLScript DIALOG 命令。

该命令会被插入到脚本中的光标所在位置。当您运行该脚本时，该可视化对话框会出现。

下面的示例显示了一个简单的自定义对话框，其中包含一个文本标签和一个下拉列表以及相应的 DIALOG 命令。

自定义对话框

相应的 DIALOG 命令

DIALOG (DIALOG TITLE "Select Branch" WIDTH 464 HEIGHT 116 ) (BUTTONSET TITLE "&OK;&Cancel" AT 336 12 DEFAULT 1 ) (TEXT TITLE "Select the branch:" AT 12 16 ) (DROPDOWN TITLE "Central Branch;East Branch;West Branch" TO "DROPDOWN1" AT 156 12 )

创建自定义对话框 – 一般步骤

1. 打开您想要向其添加自定义对话框的 Analytics 脚本。
2. 将光标定位至脚本中您想要插入 DIALOG 命令的行。

   说明

   请将光标定位至一个空白行中。如果需要，请创建一个新的空白行。

3. 单击生成新对话框 。

   Analytics 将显示具有默认标题“用户对话框”的对话框生成器。

4. 完成以下任一步骤来创建自定义对话框：
   • 双击对话框生成器以修改该对话框的标题或大小。

     您指定该对话框的宽度和高度（以像素为单位）。您还可以通过在对话框生成器中拖动工作区的右下角来调整该对话框的大小（对齐网格必须处于选中状态）。

   • 单击对齐网格 以便在对话框生成器中启用或禁用网格。

     使用网格在布局区域中对齐控件。启用网格后，每个控件的左上角都会与最近的网格点对齐。

   • 在对话框生成器的左侧，单击某个控件图标，然后单击布局区域以添加该控件。

     说明

     下面显示了添加和设计特定控件的步骤。

5. 添加所需的任意数量的控件。
6. 如果您需要在添加控件后修改它，请双击该控件。
7. 如果您需要从对话框生成器中删除某个控件，请选择该控件，然后单击删除 。

   说明

   您不能删除 OK 和 Cancel 按钮，但您可以重命名它们（请参见下面的内容）。

8. 单击关闭退出对话框生成器。
9. 在确认对话框中单击确定以保存更改。

   Analytics 在脚本编辑器中显示相应的 DIALOG 命令。您可以通过向右滚动屏幕来查看自定义对话框中的所有控件。

10. 可选。在脚本的 DIALOG 命令中，编辑 OK 或 Cancel 按钮的标签文本。

    通常，您不应该编辑 OK 和 Cancel 标签。如果您确实编辑这些标签，请确保肯定值（例如，是）位于否定值（例如，否）之前。

    请只编辑标签文本。例如："&Yes;&No"

修改自定义对话框

如果您需要在创建自定义对话框之后修改它，请将光标放在相应的 DIALOG 命令中，然后单击编辑命令 。

添加文本标签

使用文本控件向自定义对话框中添加一个文本标签。

可以将文本标签用于下列任一目的：

• 识别另一控件
• 提供通知
• 提示或指示用户
• 在自定义对话框中提供所需的任何其他基于文本的信息

文本标签仅用于显示，而与任何交互功能无关。

步骤

添加文本框

使用编辑框控件向自定义对话框中添加一个文本框。

文本框收集用户必须键入的信息，如日期或者供应商或客户 ID。

编辑框变量

编辑框控件创建一个用于存储用户输入的字符变量。

步骤

添加复选框

使用复选框控件向自定义对话框中添加复选框。

复选框向用户呈现一个二元选择 — 即关联选项可以是启用或禁用。例如，您可以使用复选框允许用户在人员表中包括或排除数据摘录中的邮箱地址域。

选项组合

使用多个复选框以允许用户在自定义对话框中选择任何选项组合。如果选项是互斥的，请改而使用单选按钮。

复选框变量

复选框控件创建一个用于存储用户输入的逻辑变量。如果该复选框被选定，则该变量存储值“真”；如果该复选框未被选定，则存储值“假”。

步骤

添加单选按钮

使用单选按钮控件向自定义对话框中添加两个或更多个单选按钮。

单选按钮向用户呈现互斥选项 — 即一次只能选择所呈现的选项中的一个。例如，您可以使用两个单选按钮来允许用户选择下列之一：

• 小于 $5000 的金额
• 大于或等于 $5000 的金额

互斥选项

使用多个单选按钮以允许用户从自定义对话框中的多个选项中选择一个选项。如果这些选项不是互斥的，请改而使用复选框。

单选按钮变量

单选按钮控件创建一个用于存储用户输入的数值变量。如果第一个单选按钮被选中，则该变量存储值 1；如果第二个单选按钮被选中，则该变量存储值 2；依此类推。

步骤

添加下拉列表

使用下拉列表控件可以向自定义对话框中添加下拉列表。

下拉列表向用户呈现一个基于文本的自定义选项列表。用户一次只能选择这些选项之一。例如，您可以使用下拉列表允许用户选择：

• 本年度的一个月份
• 一个类别
• 一个公司部门或分支机构

互斥选项

下拉列表中的选项是互斥的。您可以使用单选按钮实现类似的结果，但对于包含多个条目的列表，下拉列表更紧凑并更易于使用。

如果您想要允许用户一次选择一个以上的选项，请改用复选框。

下拉列表变量

下拉列表控件创建一个用于存储用户输入的字符变量。

步骤

添加项目条目列表

使用项目条目列表控件可向自定义对话框中添加项目条目列表。

项目条目列表向用户呈现 Analytics 项目条目，如表或域。该条目列表被基于运行脚本的 Analytics 项目的内容动态填充。

用户一次只能选择这些选项之一。例如，您可以使用项目条目列表来允许用户：

• 从本年度的所有表中选择特定月份的表
• 从某个表内的所有数值域中选择特定数值域
• 从多个可能的子脚本中选择特定子脚本

项目条目的类别

当您创建项目条目列表时，您不是指定实际的项目条目，而是指定项目条目的类别。例如，如果您想要在脚本运行时，在打开的表中向用户呈现所有字符域的列表，则应该指定字符域类别。

基于您指定的一个或多个类别，Analytics 在自定义对话框中动态填充项目条目列表。

可用的类别

下列类别可用：

字符域 数值域 日期时间字段 逻辑域

字符变量 数值变量 日期时间变量 逻辑变量

表 视图 脚本 索引 工作空间

项目条目列表变量

项目条目列表控件创建一个用于存储用户输入的字符变量。

步骤