iPaaS文档库
00 概述
06 接口服务说明

# 新建中介接口

  1. 选择左侧树上中介服务节点，点击API创建按钮，选择右侧的”API编排“页签，点击”API编排“按钮，进入在线编排页面。

  • 1.1. 或者点击中介服务，点击API编排按钮进入在线编排页面。如下图：

  1. 在线编排页面中，在通用业务目录上点击右键，点击新建，点击新建HTTP接口，然后如下图所示填写数据并点击保存确定。

# 接口在线编排

  1. 保存成功后系统自动打开中介编排页面，如下图所示。从左侧拖一个值获取图元、一个赋值图元、一个JAVA图元，单击实体图元，拖动删除实体图元到右侧画布的HTTP请求和结束图元之间，并如图所示依次连接所有图元。如下图：

  1. 双击编排背景画布，进入属性编辑页面，点击“变量定义”右侧的“添加变量”按钮，新增变量字符串类型的 id(用于指定实体的id)、 int类型的 del_count(用于接收删除实体的数量)、前置条件中新增的实体的名称类型的book_obj(用于指定前置条件中的实体) 注意:变量名必须符合java变量命名规则，点击“确定”按钮。如下图：

  1. 双击值获取图元，进入编辑页面，参数选择outMessage，返回值选择outMessage，选择“从协议头获取“页签，点击右侧的“添加“按钮，添加变量id， 从报文头获取id的key为X-DEL-BOOK-ID，点击“确定”按钮保存。如下图：

  1. 双击赋值取图元，进入编辑页面，点击“编辑参数“右侧的“添加基本属性“按钮，编辑新增参数，在“左值“列下拉选择定义的变量book_obj/id(输入技巧:先输入book， 选择book_obj，然后输入\，选择id)，在“右值“列输入值获取图元返回的变量id，右值类型选择“变量“， 点击“确定”按钮保存。此操作的目的是将从报文头获取相关字段赋值给实体属性。如下图：

流程梳理:

1. 画布背景打开设置的全局变量，id，del_count，book_obj(实体对象)
2. 通过值获取图元从报文头获取 X-DEL-BOOK-ID 赋值给 id 变量
3. 赋值取图元将 id 赋值给 book_obj/id，完成实体赋值
  1. 双击打开删除实体图元，参数名称为dsName的值填写数据源的编码，值类型选择常量，参数名称为dataObject的值填写实体变量名称book_obj， 参数名称为template的值填写实体变量名称book_obj，值类型选择变量，返回值名称为out的值填写实体变量名称del_count，值类型选择变量，点击“确定”按钮保存。如下图：

  1. 双击打开JAVA图元，选择逻辑运算符选择JmsDataBaseUtil.createOutHttpITipMessagePayload(inMessage, text)，参数名称为inMessage的值填写inMessage， 参数名称为text的值填写del_count，返回值名称为out的值填写outMessage，所有值类型选择变量，点击“确定”按钮保存。如下图：

  1. 点击右上角“保存”按钮或者按Ctrl+S快捷键，系统提示保存成功。如下图：

# 接口调用

前置条件：参考实体新增 创建实体，并获取实体id。

  1. 在线编排页面保存成功后，点击界面上方的测试按钮，如下图：

  1. 在弹出的测试对话框，将请求方式设置为GET，新增请求头参数X-DEL-BOOK-ID的值填写删除的实体id1，点击测试，返回1表明根据id删除1条数据成功。如下：

← 2.9.31.4 实体查询 →