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

# 新建中介接口

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

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

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

# 接口在线编排

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

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

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

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

流程梳理:

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

  1. 双击打开JAVA图元，选择逻辑运算符选择XMLDataBaseUtil.createXMLToITipMessagePayload(objects, message)，参数名称为objects的值填写查询结果变量book_list， 参数名称为message的值填写inMessage，参数名称为out的值填写outMessage，点击“确定”按钮保存。如下图：

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

# 接口调用

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

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

  1. 在弹出的测试对话框，将请求方式设置为GET，新增请求头参数X-BOOK-ID的值填写查询实体id1，点击测试，返回查询结果，如下图：

← 2.10 审核场景（一级） →