服务定义

操作场景

通过服务定义能够支持对第三方系统，如接口、数据库、消息的通用访问能力。

基本信息

1. 进入流程定义，选择“流程管理 > 服务定义”，进入服务定义列表页面。
2. 单击“新增”，进入新增页面。
3. 填写自定义服务的“基本信息”。
   图1 基本信息
   
   • 服务名称：服务定义的名称。
   • 服务版本：服务定义的版本。
   • 服务描述：关于服务定义的描述。
   • 是否异步执行：设置服务定义是否立即返回，默认否；选择是时，显示查询方式。
   • 驱动方式：API，对外提供一个接口，通过API方式调用。模板，该类型可以在流程模板中直接使用，即通过Camunda本地方法调用。

4. 单击“下一步”。

配置信息

1. 选择服务类型。目前支持HTTP和APIEDIT类型，默认为HTTP。
2. 输入服务地址，需要调用的外部URL地址。
3. 选择方法类型，GET/POST/PUT。
4. 根据类型的不同设置参数，包含Header参数、Query参数及Body参数。
   图2 参数设置
   
   • 参数名称：目标接口地址需要的参数。
   • 参数值：使用${}获取入参配置的参数。
     

     • 参数中变量来自于当前请求上下文。服务定义用于流程模板时，会从流程变量、请求参数中获取；用于UI页面时，会从请求参数中获取。
     • 如果需要调用电子流自身服务，需在header中增加x-jwt-token=${x-jwt-token}用于服务间认证。
   • 请求类型：类型选择POST或PUT时，需要配置Body参数，其中：
     • 参数类型是FORM_DATA时，可以配置多行的参数。
     • 参数类型是JSON时，输入Rest模板。

5. 设置返参模板。

   为页面设置返回参数格式。

请求参数（可选）

基本信息中，驱动方式选择API时，需要设置请求参数。设置完成后可以在UI编辑器中直接将参数绑定在API组件中。

1. 单击“新增”，进入“设置请求参数”页面。
2. 根据界面提示，设置请求参数。
   图3 请求参数
   

3. 单击“下一步”。

响应参数（可选）

基本信息中，驱动方式选择API时，需要设置响应参数。设置完成后可以在UI编辑器中直接将参数绑定在API组件中。

1. 单击“新增”，进入“设置响应参数”页面。
2. 根据界面提示，设置响应参数。
   图4 响应参数
   

3. 单击“保存”。

管理服务定义

进入流程定义，选择“流程管理 > 服务定义”，进入服务定义列表页面，参照表1管理服务定义。