开发服务编排

背景信息

服务编排是一种通过简单的拖拉拽式流程编排以及参数配置的方式来进行服务开发的能力。开发者能够在服务编排编辑器内以图形化编排的形式快速地进行服务的开发并扩展出更丰富的业务功能，同时能够与API接口进行绑定，以API的形式对外提供服务。

通过服务编排，也可以将已实现的脚本、服务编排等功能进行复用，只需要进行图形化编排以及相关参数配置，即可针对您自己的独特业务需求并以流程的方式将业务需求所要实现的功能展现出来，甚至不需要有任何编程经验即可完成服务的开发，降低了开发难度提高了开发效率。

场景描述

本节以调用开发脚本中的脚本（addAccruedLeaveRecord1）开发一个服务编排为例，描述开发服务编排（addAccruedLeaveRecord）的过程。

操作步骤

1. 创建服务编排。
   1. 如图1所示，在应用的开发页面，选择存放服务编排的目录（控制逻辑），单击目录对应的，选择“服务编排”。
      图1 创建服务编排
      
   2. 在弹出的“添加服务编排”页面，如图2所示，选择创建一个新的添加服务编排，输入“标签”和“名称”为“addAccruedLeaveRecord”，“类型”选择“Autolauched Flow”，单击“添加”。
      创建完成后，自动进入编辑页面。

      图2 添加服务编排
      

2. 创建该服务编排的入参和出参变量。由于该服务编排封装的是脚本，则该服务编排的入参和出参的字段类型和字段名与脚本保持一致。

   表1 服务编排变量

   量类型	参数名	Data Type	Input/Output Type
   普通变量Variable	personCode	文本	Input Only
   	personName	文本	Input Only
   	shiftId	文本	Input Only
   	shiftName	文本	Input Only
   	recallStart	文本	Input Only
   	recallEnd	文本	Input Only
   	bpmName	文本	Input Only
   	bpmLable	文本	Input Only
   	bpmInstanceId	文本	Input Only
   	recallReason	文本	Input Only
   	statusCode	文本	Output Only
   	message	文本	Output Only

   1. 如图3所示，在服务编排编辑器页面右侧单击，在全局上下文页面单击“变量”后的加号。
      图3 全局上下文
      
   2. 如图4所示，单击新增变量后的，选择“设置”。
      图4 设置变量
      
   3. 如图5所示，配置普通变量“personCode”，参数配置说明请参见表2，配置完成后单击“保存”。
      图5 配置普通变量
      

      表2 参数说明

      参数	参数说明	如何配置
      名称	变量名称，必填。	直接输入“personCode”。
      数据类型	变量的数据类型。必填。支持以下几种。 文本 数字 货币 日期 日期/时间 复选框	从下拉列表选择“文本”。
      默认值	变量的默认取值。	不用配置。
      描述	该变量的描述说明。	选填项，建议填写该变量的作用。
      是否为数组	是否为数组型变量即集合变量。	不勾选。

   4. 参考2.a~2.c配置表1中其他普通变量。
   5. 如图6所示，在服务编排编辑器页面右侧单击，按照表1从全局上下文页面中拖曳参数到相应的入参和出参区域。
      图6 配置出入参
      
   6. 如图7所示，拖拽“基本”下“脚本”图标至画布中，松开鼠标左键。
      图7 添加脚本网元
      
   7. 如图8所示，选择脚本，单击，配置网元基本信息。
      图8 配置网元基本信息
      
   8. 如图9所示，单击，选择调用的脚本，单击，自动映射同名出入参。
      图9 配置调用的脚本
      
   9. 如图10所示，连接元素。
      图10 连接元素
      
   10. 单击页面上方的，保存服务编排。

3. 调试服务编排。

   如图11所示，单击页面上方的，输入参数后单击“运行”。

   图11 运行
   

   如图12所示，检查输出页签的调试结果是否符合预期。

   图12 输出结果
   

4. 启用服务编排。
   单击页面上方的，启用服务编排。

   

   编排服务开发完成后，可以封装成一个接口，供调用，具体请参见如何自定义调用服务编排的URL。