MDBREADMI 交易

本文档描述了用于从单个表中读取数据的用户自定义 API MDBREADMI。当没有现有 API 且需要单个表中的数据时，推荐使用 MDBREADMI API。如果需要来自虚拟字段、多个表和复杂 SQL 语句的信息，请使用 CMS100MI（自定义列表设计器 MI）或 EXPORTMI（数据导出）。
注意

MDBREADMI 和 EXPORTMI 都支持通过 XtendM3 创建的表。

限制

有多种方式可在 M3 Business Engine 中创建用户自定义的 API 交易，每种方式都有自己的优势。MDBREADMI 交易定义快速简单，性能良好。但它仅限于使用单个数据库表，且不能使用虚拟字段。

MDBREADMI 定义

MDBREADMI 交易有三种类型：
  • Get - 从表中检索单个记录。
  • List - 检索后跟记录列表的第一个记录。
  • Selection - 检索与输入选择匹配的所有记录。

排序选项是 MDBREADMI 交易输入的基础。如果交易是列表或选择类型，可以删除输入字段以扩展表选择。还可以使用 Infor Enterprise Search 将搜索查询用作输入。至于 MDBREADMI 交易的输出字段，表中的任何字段都可以选择。

通过以特定方式定义 API 元数据完成 MDBREADMI 交易的设置。程序 MRS010-MRS012 旨在简化此设置。

遵循以下步骤

  1. 在 MDBREADMI 交易。打开 (MRS010) 中创建新交易，其中还会列出其他现有的 MDBREADMI 交易。MDBREADMI 事务名由格式为 XxxYYYYYYZZsfxx 的四个要素组成，其中，这些字符对应于：
    • Xxx：API 交易类型，例如：Get、List(Lst) 或 Select (Sel)
    • YYYYYY：事务的表或数据库文件
    • ZZ：事务的排序选项
    • Sfxx：事务名称后缀是可选的
    如果某些要素未知，请在 (MRS010/B) 上创建交易，并稍后在 E 屏幕上定义要素。在创建时，可以使事务使用搜索查询而不是输入字段。对于 MDBREADMI 列表交易，可以使用多个筛选器作为输入，而不是为交易定义固定筛选器集。在 (MRS010) 中创建事务时，它自动创建在“API 事务字段。打开”(MRS012)中查看的流入 API 事务字段。
    注意

    MDBREADMI 列表交易不能使用包含 NFTR - “筛选器数量”字段的自定义排序选项。如果需要，请改用选择交易或 EXPORTMI。

  2. 在使用传出 API 字段。打开 (MRS011) 中设置 MDBREADMI 交易的输出字段。所选表的所有可用字段将会列出。包含在交易中的字段应该具有“已启用字段”。要改变字段的顺序，请在“新建序列号”字段系列中指定一个数字。

    还提供了功能键 F15=“添加所有字段”以将所有字段添加到交易中，F16=“移除所有字段”以移除交易中的所有字段，F17=“添加书签字段”以向交易添加书签字段。

    注意

    所作更改仅适用于程序关闭后的 MDBREADMI 事务。请记住应用更改。

  3. 如有必要，在 API 交易字段。打开 (MRS012) 中更改传入字段。对于“API 交易类型”列表和选择，使用功能键 F15 =“移除最后一个字段”以移除最后一个流入 API 交易字段以及 F16=“添加下一个字段”以添加之前删除的流入 API 交易字段。若交易使用筛选器数量作为输入，则不需要这些功能键。
  4. 使用 (MRS012) 中的标准排序选项 2 列出 API 交易的传入和传出字段，以此验证包含所有的必填字段。

通过导出配置，可以保存或传输 MDBREADMI 交易。使用一个或多个 MDBREADMI 交易中的备选项 20=“导出配置”，并指定配置的文件名和版本号。可以通过打开“配置数据作业。打开 (MNS200)来查找该文件。使用排序顺序 4，然后指定文件名和开始日期。使用备选项 20=“显示 XML 文件”将 XML 下载为压缩 ZIP 文件。

相关主题