向 Analytics 主菜单添加自定义条目

您可以向 Analytics 主菜单添加自定义条目（如您自己的 Analytics 脚本）和常用命令。自定义条目出现在应用程序菜单的下面。如果您创建脚本以供他人使用，并且您需要单个易于使用的脚本访问位置，则此功能尤其有用。

项目级或全局访问

您可以创建被限制到单个 Analytics 项目的自定义菜单项，也可以使条目每当 Analytics 打开时即可全局使用。

  • 项目级访问 在与 Analytics 项目 (*.acl) 相同的文件夹中查找包含自定义菜单项的文本文件 (*.mnu)
  • 全局访问 在与 Analytics 可执行文件 (ACLWin.exe) 相同的文件夹中查找包含自定义菜单项的文本文件 (*.mnu)

您也可以组合使用这些方法，同时创建项目级和全局自定义菜单项。

说明

如果您希望其他 Analytics 用户具有自定义菜单项，请向其提供该 *.mnu 文件，并且随附有关去何处查找该文件的说明。

可配置的菜单文件 (*.mnu)

您使用一个或多个具有 .mnu 文件扩展名的文本文件来生成您的自定义菜单项。

子菜单条目

每个 *.mnu 文件都会在应用程序菜单下创建一个单独的子菜单条目。例如，Account scripts.mnu 创建账户脚本子菜单条目和此菜单结构：应用程序 > 账户脚本。

子菜单条目按字母数字顺序出现在应用程序菜单上。

自定义菜单项

每个子菜单条目内包含的是单个自定义菜单项。例如，您可能具有两个运行下列脚本的条目：

  • 应付帐款分析

    （应用程序 > 账户脚本 > 应付帐款分析）

  • 应收帐款分析

    （应用程序 > 账户脚本 > 应收帐款分析）

自定义菜单项按照这些菜单项被在 *.mnu 文件中列出的顺序出现在子菜单上。

使用一个或多个 *.mnu 文件，您可以生成多层次、级联式子菜单以满足您的要求。

提示

用户可能被过多的子菜单层次弄得无所适从。最佳做法是将子菜单的层次限制为三层。

自定义菜单项的最大数量

应用程序菜单最多可包含 179 个自定义菜单项。该最大值适用于所有子菜单级别和所有 *.mnu 文件中的自定义菜单项的总数。

菜单文件语法

说明

必须精确指定菜单文件中所需的语法。即使一个多余的空格也可能导致 Analytics 忽略菜单文件，从而使自定义菜单项不出现。

请完全满足下面的要求。

提示

在文本编辑器（如 Notepad++）中创建或者编辑您的菜单文件，并且显示所有非打印字符，以便您可以准确地看到该文件中包含的字符。

请使用等宽或者固定宽度字体，以使各个字符纵向对齐。

在随 Analytics 一起安装的数据文件样例文件夹中包含菜单文件样例 Template.mnu。

  • Template.mnu 在 Sample Project.acl 中的应用程序菜单以及数据文件样例文件夹中包含的其他三个 Analytics 项目样例中创建子菜单条目模板。
  • 模板子菜单条目在第一个层次包含六个自定义菜单项。
  • 第一层自定义菜单项之一 Margins Analysis 包含位于第二层的四个自定义菜单项。
  • Template.mnu 中的大多数自定义菜单项只是占位符，用来说明菜单文件的概念。

下面再现了 Template.mnu 的内容，并且附带了语法要求。

Template.mnu 的内容

MAIN MENU                           6                                        .
Margins Analysis                    8 menu_def                               .
Inventory Analysis                  PAUSE 'SAMPLE INVENTORY ANALYSIS BATCH'  .
Accounts Payable Analysis           PAUSE 'LAUNCH YOUR A/P BATCH(ES)'        .
Accounts Receivable Analysis        PAUSE 'DO A/R BATCH(ES) HERE'            .
Internal Audit Functions            PAUSE 'SAMPLE INTERNAL AUDIT PROCESSES'  .
Quit ACL                            QUIT                                     .
                                                                             .
MARGINS ANALYSIS                    4                                        .
Exception Listing                   PAUSE 'DO Batch where margin<=0'         .
High Margin Products                PAUSE 'Sample Batch top 5 margins'       .
Low Margin Products                 PAUSE 'Calculate lowest 5 margins'       .
Margin Statistics                   STATISTICS                               .

菜单文件语法要求

属性 要求
行长度

菜单文件的每个行都必须具有完全相同的长度。

尽管不硬性要求，但在换行符前使用句点 (.) 来直观地标记每个行的末尾是一种好做法。
行编号

菜单文件中的行从零 (0) 开始计数。

每当您在菜单文件语法中指定行号引用值时，请勿忘记此编号方案。如果您使用的文本编辑器从 1 开始显示和统计行号，您需要在指定菜单文件行号引用值时按 1 递减文本编辑器行号。

在上面的示例中，Margins Analysis 菜单项出现在行 1 上，而 MARGINS ANALYSIS 子菜单语法块出现在行 8 到 12 上。
空白行

空白行可以出现在语法块之间，但不能出现在语法块内。

由空格字符组成的空白行必须与该菜单文件中的其他行具有相同的长度。

尽管不是必需的，但语法块之间的一个或多个空白行可在菜单文件中提供可视化分隔。
语法块

语法块定义了每组自定义菜单项。您可以使用多个语法块来创建多个菜单级别。

  • 语法块的左侧包含菜单项的名称（每行一个菜单项）。这是出现在 Analytics 中的菜单上的名称。
  • 名称最多可包含 35 个字符。
  • 该语法块的右侧包含 ACLScript 命令或低级别语法块的行引用值。
  • 语法块右侧的行必须全部从字符位置 37 开始。
  • 请仅使用空格字符来对齐文本元素。请勿使用制表符。

    说明

    即使是菜单文件中的一个制表符也会导致该文件被忽略。请使用可显示制表符的文本编辑器，以便您可以检查其是否存在。
块标题

每个语法块都以单个标题行开始。

该行的左侧包含大写的块标识符，右侧包含该块内的行数。

在上面的示例中，行 0 包含块标识符 MAIN MENU 并指定该块中有 6 行。标题行不被统计在内。

块标识符是可选的。它们使语法块在菜单文件内部井然有序。它们不会出现在 Analytics 应用程序菜单结构中的任何位置。

如果您省略块标识符，则块中指定数量的行必须仍然从字符位置 37 开始。
对低级别语法块的引用

菜单项中对低级别语法块的引用采用形式 数字 menu_def。数字指定低级别语法块的起始行号–即，低级别语法块的标题行。

在上面的示例中，行 1 包含 Margins Analysis 菜单项，它引用 MARGINS ANALYSIS 低级别语法块的起始行 (8 menu_def)。
自定义菜单项

自定义菜单项可以指定：

  • 任何有效的 ACLScript 命令
  • 对低级别语法块的行引用

要创建运行 Analytics 脚本的自定义菜单项，请指定 DO SCRIPT 脚本名称。例如：

“计算中值”脚本       DO SCRIPT Calculate_Median_Value

说明

必须该脚本包括在自定义菜单项所在的 Analytics 项目中。

对于简短命令，可以将其直接输入到 .mnu 文件中。对于带有多个参数的较长命令，应该将其保存在可使用 DO SCRIPT 脚本引用的脚本中。

创建或编辑菜单文件

创建菜单文件的最简便方式是复制 Analytics 样例菜单文件 (Template.mnu)，然后修改它。

当您编辑现已使用的菜单文件时，请牢记以下几点：

  • 在编辑任何菜单文件之前，请为其制作一个备份副本。
  • 如果您添加或移除行，请确保相应调整任何行号引用值。
  • 只要可能，请在菜单文件的末尾添加新的菜单项，以便保持现有的行引用值。
  1. 将 Template.mnu 从 Analytics 样例数据文件文件夹复制到工作位置。

    警告

    请勿编辑原始模板文件。如果您遇到问题，则可以重新复制原始文件并重新开始。

  2. 请重命名所复制的文件。

    您给予该文件的名称成为 Analytics 应用程序菜单上的子菜单项的名称。

    说明

    如果您从头创建菜单文件，请将文件扩展名更改为 .mnu。

  3. 在文本编辑器（如 Notepad++）中打开重命名的文件，然后编辑它以生成子菜单项和自定义菜单项。

    请严格按照上面的菜单文件语法要求操作。

  4. 执行以下操作之一：
    • 将该文件保存在您希望自定义菜单项出现在其中的 Analytics 项目所在的文件夹中。
    • 将该文件保存在 Analytics 可执行文件文件夹中，以使自定义菜单项可在计算机上打开的所有 Analytics 项目中使用。

    提示

    如果需要，您可以创建项目级和全局菜单文件。

  5. 请关闭并重新打开 Analytics 以刷新应用程序菜单。

    子菜单项和自定义菜单项现在应该可在应用程序菜单中使用。

    如果子菜单项和自定义菜单项未出现，请根据上面的语法要求仔细检查菜单文件的内容。请在您使用的文本编辑器中使所有非打印字符可见。行末尾的额外空格或者菜单文件中任意位置的制表符都会导致该文件被忽略。