ESQL 编辑器

ESQL 编辑器是“代理应用程序开发”透视图提供的缺省编辑器,用于编辑 ESQL(.esql)文件。

当您对 Compute、Database 或 Filter 节点选择菜单项打开 ESQL,或在导航器视图中双击 ESQL 文件时,将在编辑器区域中启动此编辑器。

ESQL 编辑器视图

ESQL 编辑器具有以下视图:

资源导航器视图
导航器视图显示工作空间中的所有资源,也就是所有消息集资源和所有消息流资源,包括 ESQL 文件。
编辑器视图
编辑器视图显示当前打开的资源的内容。它还显示已打开资源的选项卡,这样您可以在它们之间快速切换了。
大纲视图
大纲视图显示该 ESQL 文件中引用的任何模式、定义的常量、模块和例程。
更新开始问题视图更新结束
更新开始问题视图显示警告和错误消息,它们是您保存 ESQL 文件时由编辑器验证之后生成的。如果双击某个错误,编辑器会通过将光标移动到相应的 ESQL 代码来表明错误所在的位置。更新结束

ESQL 编辑器功能

ESQL 编辑器提供:

  • 上下文有关的内容辅助。您可以从“编辑”菜单或在有些系统上通过按 Ctrl+Space(如果它没有分配为另一个功能)来调用内容辅助。

    内容辅助有助于您构造对“属性”文件夹内容的引用。当您对预定义消息使用 ESQL 编辑器时,内容辅助还有助于您构造字段引用。

    当您对数据库模式定义使用 ESQL 编辑器时,内容辅助有助于您构造模式、表和列引用。您也可以使用 ESQL 编辑器调用用户定义的映射。

    在 ESQL 文件中创建函数和过程时,您定义的名称不能以字符 IBM_(IBM 下划线)开头。

    注: 要使内容辅助起作用,您必须设置从包含 ESQL 或映射的项目到包含消息集的项目的项目引用。有关设置项目引用的信息,请参阅项目引用
  • 自动代码格式化。

在编辑器视图中右键单击以访问以下功能:

  • 更新开始撤销还原。要撤销您对 ESQL 文件所做的更改,单击撤销。如果您要撤销自最后一次保存以来所做的所有更改,则可以单击还原文件来复原它们。更新结束
  • 剪切复制粘贴。这些是标准的编辑器功能。
  • Shift 加向右箭头Shift 加向左箭头。这些是标准的编辑器功能。
  • 保存。单击它以保存您的更改。
  • 注释取消注释。单击注释以将 ESQL 代码的一行更改为注释。单击取消注释以将注释更改为一行 ESQL 代码。
  • 格式化。此功能格式化所有选择的代码行(除非部分选择,当它们被忽略时)或者如果没有选择行,格式化整个文件(改正对齐和缩进)。
  • 组织模式路径添加模式路径。这些功能帮助您进行代理模式管理。

    单击组织模式路径,任何包含 ESQL 文件调用的过程或函数的代理模式自动添加到 PATH 语句(如果您还没有添加它)。此功能扫描 ESQL 文件以查找过程或函数实例,它们驻留在未在该文件中全限定的模式中。

    当您将在其他代理模式中过程或函数的调用编码到在 PATH 语句中包含的任何代理模式时,单击添加模式路径,且此模式将添加到 PATH 语句。确保光标在您调用的过程的名称上。

ESQL 编辑器首选项

可修改影响 ESQL 代码处理方式的设置:

  • 编辑器设置(编辑器视图中如何显示代码):
    • 文本字体
    • 显示的选项卡宽度(缺省值 4)
    • 背景色和前景色(针对注释、语句等)
  • 验证设置(保存文件时执行哪个级别的验证):

    验证检测 4 个潜在问题:

    未解析的标识
    验证器尝试解析已引用的所有标识(例如,消息字段)。
    消息引用与消息定义不匹配
    如果消息定义存在(仅 MRM 域中的消息),验证器会检查引用的使用是否与消息定义一致(例如,对数字字段的操作为有效数字操作)。
    数据库引用与数据库模式不匹配
    验证器会检查引用的使用是否与数据库模式一致(例如,对数字字段的操作为有效数字操作)。
    使用了不推荐的关键字
    验证器检查您是否使用了任何该发行版中不推荐使用的关键字。

    针对以上每种情况,选择以下某个验证设置:

    忽略
    不执行验证。
    警告
    验证器针对它检测到的每个潜在问题,将警告消息写入任务视图。这是缺省设置。
    错误
    验证器针对它检测到的每个潜在问题,将错误消息写入任务视图。

    如果您声明了名称,则验证将不检查是否已指定名称。模块、函数和过程的名称不区分大小写;所有其他名称(模式、常量、变量和标签)都区分大小写。检查所用名称是否与这些名称的声明相匹配;因为代理是以区分大小写的方式处理这些名称的,如果不匹配便会生成运行时错误。

有关如何更改这些首选项的详细信息,请参阅更改 ESQL 首选项

ESQL 编辑器工具栏

ESQL 编辑器在工具栏上不提供任何附加的图标和操作。

相关概念
项目引用
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ab00083_