造数脚本--OPENAPIV1.0脚本编写指引

1 概述

苍穹的开放平台对外提供多种接口类型，包括操作服务、自定义服务、AI服务。

• 操作服务是将业务对象（单据、基础资料）的操作（保存，提交，查询等）一键发布成为OpenAPI，系统自动生成服务接口及服务契约；

• 自定义服务可以将任何功能开发出来，这类服务不依附任何业务对象，出入参数可以完全自定义；

• AI服务是对接金蝶AI平台的一种特殊服务，可以将AI平台的命令与插件适配，并执行对应插件逻辑。

本文主要介绍没有自定义接口服务的情况下，如何使用操作服务的OpenAPI，发出接口请求，可用来做接口测试和性能测试等。

2  OpenAPI脚本编写

样例：以【制造云】→【生产任务管理】→【生产工单】“新增”为例。

目标：使用OpenAPI接口创建生产工单。

具体操作如下。

2.1  建立API服务

步骤1：新增OpenAPI服务

【苍穹首页】→【开发服务云】→【开放平台】→【API服务管理】→"新增"，选择"操作服务"→"创建"，进入API的配置页。填写完成后，点击"保存"。

步骤2：查询API服务

在API服务管理列表中搜索“生产工单”，新建的“生产工单新增”已创建。

2.2 确定字段类型

确定字段的类型，可进入表单设计器查看。

进入路径有两种：

1.在生产工单的单据页面，快捷键Ctrl+Alt+G进入“生产工单”的设计器；

2.通过【苍穹首页】→【开发服务云-】→【开发平台】→【制造云】→【生产任务管理】→【生产工单 】，进入“生产工单”的设计器。

如下图所示，左边为表单的字段、元素列表，右边为属性，中间区域为可视化展示表单界面，点击相应位置，左右两边会切换到相应属性。

通过表单设计器中可以识别必填和非必填字段，必填字段在表单中以“*”标记。通过右边的属性栏，可以看到字段类型，从而确定字段类型。设计器看到的字段类型不同于自定义接口中规定的类型。

2.3 确定键值对

新建OpenAPI，HTTP请求使用post方式，内容格式一般为application/json，所以需要确定JSON对象和数组，通过表单设计器获取字段的属性、字段名，部分值。

确定字段名和字段格式后，开始写接口请求，具体的传值与请求的目的相关。在接口测试中，不同的传值对应不同的用例。

字段类型—引用字段

请先看“生产组织”这个字段。首先定位到“生产组织”，查看右边的属性，“生产组织”的标识为org，也即OpenAPI的字段名为org。

在右边的属性区域可以看到组织的字段类型为“组织”，说明生产工单中的组织通过关联组织表获得，引用属性中有number，可通过number来引用具体的值，比如"org":{"number":"Org-00014"}，也可通过ID来引用，ID在数据库中存储的字段名为fid。

如何获取生产组织表中number值？

1.可以通过生产工单打开生产组织的F7，编码直接展示在F7的页面；

2.去数据库中查询生产组织的number值。

比如在F7的页面，可以通过number为"0001”取名称为“fenfen"的组织。

字段类型—下拉列表

生产工单中，组件清单异步状态字段 类型为下拉列表。通过标识得到字段名为asyncstatuspom。

点击下拉项，查看下拉项的下拉值，我们得到“处理中”的下拉值为“A”。

即 “组件清单异步状态”字段在API请求中传值为："asyncstatuspom":"A" （表示组件清单异步状态为处理中）。

字段类型—表单分录

分录以JSON数组形式组装（可以去详细了解JSON格式）。

生产工单的分录的标识为treeentryentity。

分录中的每条分录以数组的形式组装，比如一条分录可以表示为：

"treeentryentity":[{"producttype":"C","material":{"