Skip to main content
Version: 1.0.0

接口映射

接口映射的作用是什么?

接口映射是将页面组件与后台服务的输入输出字段进行绑定,这样页面组件的数据就可以传递到后台服务中。

页面、接口、服务、任务之间的关系是什么?

怎么找到“接口映射”功能?

要找到“接口映射”功能,首先进入“我的任务”菜单。 然后找到需要“接口映射”的任务。 在任务详情页面,点击“服务配置”按钮,就可以看到“接口映射”功能。 以下图为例,展示了“接口映射”的操作界面。 任务列表

字段映射

“接口映射”操作介绍

1. “接口映射”操作界面介绍

字段映射界面介绍

如图所示,“接口映射”操作界面分为四个部分:

  • 第1部分是“选择服务”的下拉框,用于选择需要映射的后台服务。当然,选中的服务要实现当前接口的业务逻辑;

  • 第2部分是页面展示切换页签,展示的内容包括主页面、对话框弹层以及隐藏容器等,page页签会展示触发事件的页面的内容,页面上的组件都可以作为事件的输入;同理,页面如果包含:隐藏容器,弹出层以及根据条件显示的各种组件,都可以作为事件的输出;所以将上述这些无法叠加在一个页面进行展示的页面组件以页签的形式进行单独展示,方便用户进行选择;

  • 第3部分是页面组件选取区,用于选择与服务字段进行映射的页面组件;为了能更直观的进行映射操作,这里还原了页面的结构和样式,可以使用鼠标来进行选取;

  • 第4部分是字段映射区,用于展示当前选择的页面组件与后台服务的字段映射情况,可以进行修改;同时,提供了“自动关联”和“取消关联”两个按钮,方便用户快速的进行字段映射;

2. “接口映射”详细说明

  • 首先选择服务,选定服务后,服务的输入,输出参数会自动展示在“字段映射”区;(服务的输入,输出参数在服务编排时进行维护)

  • 映射类型,服务的参数不仅仅可以与页面元素(组件)进行映射,还可以与“常量”、“上下文变量”进行映射,如下图所示; 接口映射2

  • 进入选取状态,当映射类型是“页面元素”时,点击“页面元素”框右边的“箭头”按钮,就进入选取状态,这个时候就可以在右边的“页面组件选取区”中进行选择;用鼠标直接左键点击页面中的组件元素,元素的属性就会出现在对应“页面元素”的框中,如果选取的页面元素有多个属性可以作为参数进行映射,则鼠标点击页面元素后,会出现悬浮框,提示我们选择其中一个属性进行映射; 选取table的属性

  • 选取状态,进入“选取状态”后,“页面展示”几个字旁边出现“点击选择页面元素”的提示时,说明当前处在选取状态,同时,页面元素选取区会被一个黄色的框框起来。映射区也会有一个映射项被黄色的框框中,说明当前选取的元素会配置到当前框中的映射项中。 选取状态

  • 退出选取状态,进入选取状态后,如果不需要进行元素选取,想要直接退出选取状态,可以将鼠标在字段映射区的空白处左键单击,即可退出选取状态

  • 当映射类型是“上下文”时,点击上下文输入框,输入上下文对象名,会提示目前支持的上下文对象,选择对象合适的属性即可;如下图所以,系统提示有User和Url两个U开头的上下文对象,User对象有User.id,User.name两个属性值; 上下文配置1 上下文配置2

  • 当映射类型是“常量”时,点击常量输入框,输入常量值即可;

  • 点击“自动关联”按钮,会自动将页面元素与服务参数进行关联,如果页面元素与服务参数的中文名称相同,则会自动关联;如果页面有多个相同名称的元素,则会与第一个元素进行关联;

  • 点击“取消关联”按钮,会将页面元素与服务参数的关联关系全部取消,包括输入参数和输出参数;

  • 输出参数支持一个服务输出对应多个页面元素;