审批流管理

描述

审批流配置为审批流运行态的应用，提供审批流的管理，可以直接集成应用进行使用，上层应用也可以基于此应用快速定制开发自己的审批流应用。

开放能力

审批流管理为应用资产，为一个完整的审批流管理应用，实现了审批流的创建、修改和删除等。

如何使用资产（集成及使用）

1. 订购并安装部署审批流管理应用到对应的AppCube生产环境。

   相关操作请参见如何订购&部署资产。

2. 配置集成应用到ISDP+，支持在移动端进行审批。

   相关操作请参见集成PC端应用到ISDP+系统。

   

   移动端不涉及到应用的添加，只涉及到待办和消息，在集成PC端应用到ISDP+系统时，需要增加如下配置：

   • 在涉及到设置业务权限凭证时，勾选SSO_Login时，同时需要勾选Mobile_SSO（移动端登录权限）。
   • 分配单点登录认证凭证时，在分配PC端同时，也需要分配移动端，且移动端的单点登录认证凭证固定为：isdp-saas-mobile-appcube。
   • 在配置单点登录应用的系统参数时，需要配置移动端的单点登录认证凭证参数，即clientID_sso和clientSecret_sso。

   配置中涉及到相关参数说明：

   • 审批流管理应用系统参数：

     参数名称	描述	值
     需要修改参数
     ISDP__client_secret_isdp_ss_APM	《审批流管理》isdp+上的应用secret	对应ISDP+环境中创建用来订阅OpenAPI的应用ID和令牌。
     ISDP__client_id_isdp_ss_APM	《审批流管理》isdp+上的应用id
     ISDP__appcube_client_id_process_APM	《审批流管理》appcube账号	AppCube的“管理 > 系统管理 > OAuth”中记录的client_id和client_secret值。
     ISDP__appcube_client_secret_process_APM	《审批流管理》appcube密码
     ISDP__domain_appcube_process_APM	《审批流管理》appcube域名	https://AppCube域名
     ISDP__appcube_client_secret_process	《审批流管理》appcube密码	AppCube的“管理 > 系统管理 > OAuth”中记录的client_id和client_secret值。
     ISDP__appcube_client_id_process	《审批流管理》appcube账号
     ISDP__domain_appcube_process	《审批流管理》appcube域名	https://AppCube域名
     ISDP__tenantId_appcube_APM	《审批流管理》appcube的租户id	AppCube租户ID
     ISDP__msms_template_complete_APM	《审批流管理》短信中完成的模板名称	红柳林矿业公司-专项方案评审 说明： 使用的MSMS连接器中的模板的名称。
     ISDP__msms_template_reject_APM	《审批流管理》短信中驳回的模板名称	红柳林矿业公司-专项方案驳回 说明： 使用的MSMS连接器中的模板的名称。
     ISDP__msms_template_review_APM	《审批流管理》短信中审批的模板名称	红柳林矿业公司-专项方案完成 说明： 使用的MSMS连接器中的模板的名称。
     ISDP__mobileClientID_APM	《审批流管理》在ISDP+的oauth2中为移动端申请的id	配置为：isdp-saas-mobile-appcube 说明： 检查一下，与“SSO单点登录”页签中分配给移动端的单点登录认证凭证中的客户端ID一致，即“clientID_sso”的值一致。
     ISDP__msms_connector_APM	《审批流管理》短信的配置的MSMS的连接器	AppCube的“管理 > 应用管理 > 链接器”的“消息通知 > 消息&短信”中使用的MSGSMS连接器名称。 说明： 如果没有短信服务，请配置该参数值为空。
     ISDP__domain_isdp_ss_APM	《审批流管理》ISDP+的域名	https://ISDP+的域名
     ISDP__domain_appcube_ss_APM	《审批流管理》APPCUBE域名	https://AppCube域名
     无需修改参数
     ISDP__get_High_level	《审批流管理》查询审批流最高层级	/service/ISDP__ApprovalProcessManage/1.0.1/queryHighLevel
     ISDP__queryLevelProcess	《审批流管理》专项开放接口	/service/ISDP__ApprovalProcessManage/1.0.1/queryLevelProcess
     ISDP__syncReviewProcessURl	《审批流管理》appcube服务url，同步公共组及成员信息到审批流层级配置表	/service/ISDP__ApprovalProcessManage/1.0.1/syncReviewProcess
     ISDP__AppcubeGroupsMember_APM	《审批流管理》查询appcube平台上公共组中的成员	/u-route/baas/sys/v1.0/groups
     ISDP__AppcubeOauthToken_process_APM	《审批流管理》查询appcubetoken值的接口地址	/baas/auth/v1.0/oauth2/token
     ISDP__isdp_rest_token_APM	《审批流管理》isdp+获取token的url后缀	/oauth2/oauth/rest_token
     ISDP__AppcubeOauthToken_process	《审批流管理》查询appcubetoken值的接口地址	/baas/auth/v1.0/oauth2/token
     SS_modifyPageThirdURL_APM	《审批流管理》审批流管理APP端（制表人）修改页面	/approvePage
     SS_modifyPageURL_APM	《审批流管理》审批流管理PC端（制表人）修改页面	/approvePage
     SS_approvePageURL_APM	《审批流管理》审批流管理PC端审批页面地址	/approvePage
     ISDP__mobilePreviewScheme_APM	《审批流管理》手机端方案详情页面	/mobilePreviewScheme
     ISDP__viewSchemeDetail_APM	《审批流管理》方案详情页面	/viewSchemeDetail
     completeMyTodoUAT_APM	《审批流管理》iSDP的UAT环境的完结待办接口	/openapi/v1/myTodoWrap/completeMyTodo
     addMyMessage_APM	《审批流管理》新增isdp消息	/openapi/v1/messageFacede/addMessages
     addMyTodoUAT_APM	《审批流管理》iSDP的UAT环境的新增待办接口	/openapi/v1/myTodoWrap/addMyTodo
     SS_approvePageThirdURL_APM	《审批流管理》审批流管理APP端审批页面地址	/approvalRecord

   • 审批流管理应用业务权限凭证：bpmManage
   • 审批流管理应用需要订购的API：addMessages、addMyTodo、completeMyTodo
   • 需要分配PC端和移动端的单点登录认证凭证，移动端的单点登录认证凭证固定为：isdp-saas-mobile-appcube
   • 审批流管理要挂载的高级页面地址：https://AppCube域名/magno/render/ISDP__ApprovalProcessManage_AppCube租户ID/approvalProcessList

3. 登录ISDP+系统，进入到配置的审批流管理菜单，单击进入审批流管理页面，如图1所示。
   图1 审批流管理
   

4. 单击“新增”，进入“审批流新建”页面。
5. 如图2所示，在 “审批流新建”页面，输入标签、名称和描述信息，单击“确定”，进入“审批流详情”页面。
   图2 审批流新建
   

6. 如图3所示，在“审批流详情”页面，进行审批流的编排，配置说明请参见表1。
   图3 审批流详情
   

   表1 配置说明

   区域	配置说明
   1	：返回“审批流列表”。 ：启用审批流。 ：保存审批流。 ：复制审批流。
   2	图元区域，从区域2拖入图元到区域3。
   3	编排审批流程区域。
   4	在区域3选择对应图元后，该区域展示图元的配置信息。

7. 配置完成后，单击，保存审批流。
8. 单击，启用审批流。
   审批流管理页面其他操作说明：

   操作名称	操作方法
   查看审批流详情	单击审批流“操作”列的“查看”，查看审批流详情。
   查询审批流	在查询条件输入框中输入审批流标签，单击“查询”，查询符合条件的审批流。
   删除审批流	单击待删除审批流“操作”列的“删除”，删除审批流。
   修改审批流	单击待修改审批流“操作”列的“查看”，查看审批流详情，在查看页面，可以对审批流进行修改。 说明： 在审批流详情页面，已启用的版本无法修改，需要切换至未启用的版本可进行修改。

如何使用资产（二次开发）

1. 订购并安装部署审批流配置应用资产到对应的开发环境。

   相关操作请参见如何订购&部署资产。

2. 创建Addon应用。
   1. 在开发环境首页，如图4所示，单击“项目”，再单击“行业应用”，进入行业应用页面。
      图4 进入行业应用
      
   2. 如图5所示，单击“创建Addon应用”，弹出“创建Addon应用”页面。
      图5 进入创建Addon应用
      
   3. 如图6所示，输入标签和名称，选择依赖的APP“审批流管理”，单击“创建”。
      图6 创建Addon应用
      
      创建后，页面跳转到Addon应用开发页面，在页面上方为Addon应用定制内容，“External dependencies”里为依赖的应用目录树。

      图7 Addon应用开发页面
      

3. 开发定制内容，基于依赖的App进行定制（可以基于依赖App中的对象、页面和脚本进行定制，以基于依赖App中的脚本为例进行说明，对象和页面的类似）。

   例如基于依赖App中的脚本进行定制。

   1. 如图8所示，鼠标放置于Addon应用定制目录下的Logic文件夹旁会出现加号，单击加号，选择“脚本”。
      图8 进入新增脚本
      
   2. 如图9所示，在“新增脚本”页面选中“使用已有脚本”，勾选需要依赖的脚本（支持多选），单击“添加”。
      图9 新增脚本
      

      添加后，在Addon应用定制目录下的Logic文件夹下会出现该定制脚本，如图10所示。

      图10 添加后效果
      
   3. 如图11所示，单击定制的脚本，右侧展示该脚本的编译页面，单击。
      图11 复制脚本
      
   4. 如图12或图13所示，在弹出的“脚本详情”页面，根据规划，选择“新建版本”或“新建脚本”，配置脚本信息，单击“保存”。
      图12 新建版本
      
      图13 新建脚本
      
      • 新建版本后，在当前脚本编辑区域右上角可以查看到当前脚本包含的版本，选择新建的版本信息，进行脚本的定制开发。
        图14 新建的版本
        
      • 新建脚本后，在左侧可以看到新建的脚本，单击脚本右侧展示脚本编辑页面，进行脚本的定制开发。
        图15 新建的脚本
        
   5. 定制修改脚本中内容，具体与应用脚本开发类似，可参见脚本开发。
      

      后续就是应用的开发过程，开发完成将Addon应用打包时，只能将定制内容打包出去，依赖的内容不会随Addon应用打包发布出去，在其他环境中也需要订购部署依赖的资产包。