1 前言
最近和开发一起梳理改造以前老的业务接口时遇到了两个问题:
- SAP B1 表的字段 开发接口中传参用的 value 和 数据库查询语句的 value,是不一样的,我们从哪找到这个对应字段。
- 将接口里面 以前直接查询SAP B1数据库 来获取数据的实现方式 统一改造成 调用 Service Layer 来获取,是否支持。
2 获取接口字段value
在我们没有找到SAP 提供的开发接口字段 和 数据库表字段的映射表的前提下,一般我们可以通过以下两种办法找到这个信息。
2.1 DTW数据模板
DTW 是基于DI API 的数据导入导出工具,因此我们可以查看其自带的标准数据模板或者导出当前客户的数据模板,模板里面会显示接口字段和 数据库字段的对应信息。
说明:上图为从DTW导出SAP B1标准表。
说明:上图第一行 为接口字段,第二行为对应数据库字段。
2.2 程序获取SAP表信息
开发通过程序获取SAP表内容,并打印出来。
由于客户使用的SAP B1 为 HANA版本,而且开发以前也没有直接通过Service Layer获取过表信息,因此和开发一起研究了下。
说明 :浏览器访问 https://localhost:50000 可以查看SAP B1 Service Layer 的相关文档,即用户手册 和 API参考。
3 Service Layer调用
Service Layer支持OData 3.0 协议,请求响应使用的是JSON格式,因此我们使用了一款接口测试工具 PostMan,下载地址如下:https://www.getpostman.com/downloads/,安装和操作说明请自行百度。
3.1 连接数据库
参考 Working_with_SAP_Business_One_Service_Layer.pdf 用户手册 3.1 Login and Logout
说明
- 打开PostMan新建连接
- 选择POST 方法,输入数据库访问地址 https://localhost:50000/b1s/v1/Login
- Body页签,选择 raw,格式选为 JSON
- 输入链接信息
{"CompanyDB":"SAP账套名","UserName":"SAP账套登录账户","Password":"登录密码"} - 点击 Send ,成功则会返回上图下方Body区域的信息
-
如果失败,请检查PostMan SSL设置,由于一般我们安装SAP时都选择的自己颁发证书,因此需要去掉PostMan SSL访问校验
说明
- 点击 File — Settings — General ,将SSL certificate venfication 关闭。
3.2 获取表内容
我们通过浏览器打开Service Layer API参考,API参考分为两部分,上半部分区域 即以Service结尾的方法,提供些SAP预制的一些调用操作;下半部分区域 则为真正开发过程中使用的具体业务的Service Layer调用方法。
说明:API参考上半部分 Action
说明:API参考下半部分 Entities
说明: 上半部分提供的方法
说明:下半部分提供的方法
说明:使用上半部分中的 获取模板的POST方法,输出无数据的表结构
说明:使用下半部分的GET方法,获取该表中所有的数据
说明:使用下半部分的GET方法,获取该表中某张单据的数据(直接赋值DocEntry)
说明:使用下半部分的GET方法,获取该表中某张单据的数据(通过SQL语句实现)
SQL语句的写法请自行百度 ODate查询语句
3.3 增删改查SAP B1
点开API参考,会有一些固定的方法,如关闭单据,取消单据,更新单据字段,创建单据等。
我们拿取消销售订单为例,来做说明:
说明
- 上图可知 取消单据方法为: POST https://localhost:50000/b1s/v1/方法(DocEntry)/Cancel
说明
-
上图销售订单 DocEntry=27000,单据状态为 打开
说明
- 选择POST,输入 https://localhost:50000/b1s/v1/Orders(27000)/Cancel
-
点击 Send,执行该方法
说明
- 此时打开SAP看该单据,状态变为取消
结算生产订单实例
方法:PATCH https://localhost:50000/b1s/v1/ProductionOrders(123)
传入JSON 字符串: {"ProductionOrderStatus": "boposClosed"}
3.4 批量处理
以后实施过程中,遇到需要大批量取消单据时,无法及时得到开发的支持的情况下,或许我们可以自己动手,至于PostMan怎么批处理数据则需要自行百度。