步骤二：配置服务定义

服务定义即接口，当前调用BOM接口都需先调用获取机机认证token接口，然后再调用相应的业务接口。

若不需要配置机机认证，则按照配置BOM业务接口方式进行配置。
若需要配置机机认证，则按照配置组合接口方式进行配置，需要提前根据实际情况配置一个机机接口。

获取机机认证token接口

在左侧导航中，选择“流程管理 > 服务定义”，进入服务定义列表页面，搜索token查看接口详情。

系统已配置好可以直接使用。

图1 token接口
点击放大

配置BOM业务接口

进入流程定义，选择“流程管理 > 服务定义”，进入服务定义列表页面，单击“新增”，进入新增页面。

设置“基本信息”，如图2所示。

图2 基本信息

设置“配置信息”。

图3 配置信息

服务地址：接口地址。

方法类型：选择接口对应的“GET”或“POST”，GET类型无需设置Body参数。

Header参数：参照表1添加Header参数。

表1 Header参数
参数名称	参数值	加密
x-jwt-token	${x-jwt-token}	否
Cookie	${Cookie}	否
X-Pdm-Isc-Common-Token	${ipdctoken}	否

Query参数（可选）：根据实际情况填写参数信息。
图4 Query参数
Body参数：参数类型选择“JSON”，“Rest模板”中设置参数为接口入参。

设置“请求参数”。基本信息中，当驱动方式选择API时，需要设置请求参数。

图5 请求参数
设置“响应参数”。
响应参数按照实际情况填写，如果接口反参为json格式，按照图6所示填写即可。

图6 响应参数
单击“保存并发布”。

配置组合接口

进入流程定义，选择“流程管理 > 服务定义”，进入服务定义列表页面，单击“新增”，进入新增页面。

设置“基本信息”，如图7所示。

图7 基本信息
设置“配置信息”。
服务类型选择“APIEDIT”，然后单击“编辑流程”，绘制如图8所示的接口流程图。

图8 配置信息
1. 选择第一个“服务任务”组件，设置属性信息，如图9所示。
  图9 服务任务1
  - 调用服务：获取token
  - 输入Key：inputParam
  - 输出Key：resultData
  - 输出类型：Text
2. 选择第二个“服务任务”组件，设置属性信息，如图10所示。
  图10 服务任务2
  - 调用服务：配置业务接口对应的服务定义，这里我们选择“自制件部件修改状态”。
  - 输入Key：inputParam
  - 输出Key：resultData
  - 输出类型：输出类型根据实际接口来填写，通常选择Map。
3. 选择“脚本任务”组件，填写JS脚本信息，如图11所示。
  表示将“服务任务1”获取的token传入“服务任务2”。
  
  图11 脚本任务
  
  脚本信息如下：
```
var v1 = process.getVariable('resultData', 'defaultValue');
var inputParam = process.getVariable('inputParam', 'defaultValue');
inputParam.ipdctoken = v1;
process.setVariable('inputParam', inputParam);
```
4. 可选：对于需要对反参数据进行后处理的接口（如格式转换），可以在“服务任务2”后面衔接一个脚本任务，JS脚本用于对反参的处理。
  图12 返回参数处理
  
  示例脚本信息如下：
```
var res = process.getVariable('resultData');
var data = [];
for (var i = 0; i < res.data[0].roles.length; i++) {
    data.push(res.data[0].roles[i].members[0])
};
res.data = data;
process.setVariable('resultData', res);
```